one of the more fun features of the canvas is the abillity to use images. these can be used to do dynamic photo compositing or used as backdrops of graphs etc. it's currently also the only way to add text to them (the specification does not contain any functions to draw text). external images can be used in any format supported by gecko (eg png, gif or jpeg format). other canvas elements on the same page can also be used as the source.
canvas 相當有趣的一項功能就是可以引入圖像，它可以用於圖片合成或者製作背景等。而目前僅可以在圖像中加入文字（標准說明中並沒有包含繪製文字的功能）。只要是gecko 支持的圖像（如png，gif，jpeg等）都可以引入到canvas 中，而且其它的canvas 元素也可以作為圖像的來源。
importing images is basically a two step process:
引入圖像只需要簡單的兩步：
let's look at step one first. there are basically four options available:
先來看看第一步，基本上有四種可選方式：
we can access all images on a page by using either the document.images collection, the document.getelementsbytagname method, or if we know the id attribute of the image, the document.getelementbyid method.
我們可以通過document.images 集合、document.getelementsbytagname 方法又或者document.getelementbyid 方法來獲取頁面內的圖片（如果已知圖片元素的id。
just as with normal images we access other canvas elements using either the document.getelementsbytagname method or the document.getelementbyid method. make sure you've drawn something to the source canvas before using it in your target canvas.
和引用頁面內的圖片類似地，用document.getelementsbytagname 或document.getelementbyid 方法來獲取其它canvas 元素。但你引入的應該是已經準備好的canvas。
one of the more practical uses of this would be to use a second canvas element as a thumbnail view of the other larger canvas.
一個常用的應用就是為另一個大的canvas 做縮略圖。
<another option is to create new image objects in our script. the main disadvantage of this approach is that if we don't want our script to halt in the middle because it needs to wait for an image to load, we need some form of image preloading.
另外，我們可以用腳本創建一個新的image 對象，但這種方法的主要缺點是如果不希望腳本因為等待圖片裝置而暫停，還得需要突破預裝載。
basically to create a new image object we do this:
我們可以通過下面簡單的方法來創建圖片：
var img = new image(); // create new image objectimg.src = 'myimage.png'; // set source path
when this script gets executed, the image starts loading. if loading isn't finished when a drawimage statement gets executed, the script halts until the image is finished loading. if you don't want this to happen, use an onload event handler:
當腳本執行後，圖片開始裝載。若調用drawimage 時，圖片沒裝載完，腳本會等待直至裝載完畢。如果不希望這樣，可以使用onload 事件：
var img = new image(); // create new image objectimg.onload = function(){ // execute drawimage statements here}img.src = 'myimage.png'; // set source pathif you're only using one external image this can be a good approach but once you need to track more than one we need to resort to something more cunning. it's beyond the scope of this tutorial to look at image preloading tactics but you can check out javascript image preloader for a complete solution.
如果你只用到一張圖片的話，這已經夠了。但一旦需要不止一張圖片，那就需要更加複雜的處理方法，但圖片預裝載策略超出本教程的範圍，感興趣的話可以參考javascript image preloader。
another possible way to include images is via the data: url. data urls allow you to completely define an image as a base64 encoded string of characters directly in your code. one advantage of data urls is that the resulting image is available immediately without another round trip to the server. ( another advantage is that it is then possible to encapsulate in one file all of your css, javascript, html, and images, making it more portable to other locations. ) some disadvantages of this method are that your image is not cached, and for larger images the encoded url can become quite long:
我們還可以通過data: url 方式來引用圖像。 data urls 允許用一串base64 編碼的字符串的方式來定義一個圖片。其優點就是圖片內容即時可用，無須再到服務器兜一圈。 （還有一個優點是，可以將css，javascript，html 和圖片全部封裝在一起，遷移起來十分方便。）缺點就是圖像沒法緩存，圖片大的話內嵌的url 數據會相當的長：
var img_src = 'data:image/gif;base64,r0lgodlhcwalaiaaaaaa3pn/zih5baeaaaealaaaaaalaasaaaiuha+hkcuo4lmnvindo7qyrixigbyaow==';
once we have a reference to our source image object we can use the drawimage method to render it to the canvas. as we we'll see later the drawimage method is overloaded and has three different variants. in its most basic form it looks like this.
一旦獲得了源圖對象，我們就可以使用drawimage 方法將它渲染到canvas 裡。 drawimage 方法有三種形態，下面是最基礎的一種。
drawimage (image, x, y)where image is a reference to our image or canvas object. x and y form the coordinate on the target canvas where our image should be placed.
其中image 是image 或者canvas 對象，x 和y 是其在目標canvas 裡的起始坐標。
in the following example i will be using an external image as the backdrop of a small line graph. using backdrops can make your script considerably smaller because we don't need to draw an elaborate background. i'm only using one image here so i use the image object's onload event handler to execute the drawing statements. the drawimage method places the backdrop on the coordinate (0,0) which is the top left corner of the canvas.
下面一個例子我用一個外部圖像作為一線性圖的背景。用背景圖我們就不需要繪製負責的背景，省下不少代碼。這裡只用到一個image 對象，於是就在它的onload 事件響應函數中觸發繪製動作。 drawimage 方法將背景圖放置在canvas 的左上角(0,0) 處。
functiondraw(){
function draw() { var ctx = document.getelementbyid('canvas').getcontext('2d'); var img = new image(); img.onload = function(){ ctx.drawimage(img,0,0); ctx.beginpath(); ctx.moveto(30,96); ctx.lineto(70,66); ctx.lineto(103,76); ctx.lineto(170,15); ctx.stroke(); } img.src = 'images/backdrop.png'; }the second variant of the drawimage method adds two new parameters and it allows us to place scaled images on the canvas.
drawimage 方法的又一變種是增加了兩個用於控製圖像在canvas 中縮放的參數。
drawimage (image, x, y, width, height)where width and height is the image's size on the target canvas. 當中width 和height 分別是圖像在canvas 中顯示大小。
in this example i'm going to use an image as a wallpaper and repeat it several times on the canvas. this is done simply by looping and placing the scaled images at different positions. in the code below the first for loops through the rows the second for loop the columns. the image is scaled one third of its original size which is 50x38 pixels. we'll see how this could also have been achieved, by creating a custom pattern, later in this tutorial.
在這個例子裡，我會用一張圖片像背景一樣在canvas 中以重複平鋪開來。實現起來也很簡單，只需要循環鋪開經過縮放的圖片即可。見下面的代碼，第一層for 循環是做行重複，第二層是做列重複的。圖像大小被縮放至原來的三分之一，50x38 px。這種方法可以用來很好的達到背景圖案的效果，在下面的教程中會看到。
note : images can become blurry when scaling up or grainy if they're scaled down too much. scaling is probably best not done if you've got some text in it which needs to remain legible.注意：圖像可能會因為大幅度的縮放而變得起雜點或者模糊。如果您的圖像裡面有文字，那麼最好還是不要進行縮放，因為那樣處理之後很可能圖像裡的文字就會變得無法辨認了。
functiondraw(){
function draw() { var ctx = document.getelementbyid('canvas').getcontext('2d'); var img = new image(); img.onload = function(){ for (i=0;i<4;i++){ for (j=0;j<3;j++){ ctx.drawimage(img,j*50,i*38,50,38); } } } img.src = 'images/rhino.jpg'; }the third and last variant of the drawimage method has eight new parameters. we can use this method to slice parts of a source image and draw them to the canvas.
drawimage 方法的第三個也是最後一個變種有8個新參數，用於控製做切片顯示的。
drawimage (image, sx, sy, swidth, sheight, dx, dy, dwidth, dheight)the first parameter image, just as with the other variants, is either a reference to an image object or a reference to a different canvas element. for the other eight parametes it's best to look at the image on the right. the first four parameters define the location and size of the slice on the source image. the last four parameters define the position and size on the destination canvas.
第一個參數和其它的是相同的，都是一個圖像或者另一個canvas 的引用。其它8個參數最好是參照右邊的圖解，前4個是定義圖像源的切片位置和大小，後4個則是定義切片的目標顯示位置和大小。
slicing can be a useful tool when you want to make compositions. you could have all elements in a single image file and use this method to composite a complete drawing. for instance, if you want to make a chart you could have a png image containing all the necessary text in a single file and depending on your data could change the scale of your chart without very much diffculty. another advantage is that you don't need to load every image individually.
切片是個做圖像合成的強大工具。假設有一張包含了所有元素的圖像，那麼你可以用這個方法來合成一個完整圖像。例如，你想畫一張圖表，而手上有一個包含所有必需的文字的png 文件，那麼你可以很輕易的根據實際數據的需要來改變最終顯示的圖表。這方法的另一個好處就是你不需要單獨裝載每一個圖像。
in this example i'm going to use the same rhino as we've seen above, but now i'm going to slice its head out and composite it into a picture frame. the image of the picture frame includes a dropshadow which has been saved as a 24-bit png image. because 24-bit png images include a full 8-bit alpha channel, unlike gif and 8-bit png images, i can place it onto any background and don't have to worry about a matte color.
在這個例子裡面我用到上面已經用過的犀牛圖像，不過這次我要給犀牛頭做個切片特寫，然後合成到一個相框裡面去。相框帶有陰影效果，是一個以24-bit png 格式保存的圖像。因為24-bit png 圖像帶有一個完整的8-bit alpha 通道，與gif 和8-bit png 不同，我可以將它放成背景而不必擔心底色的問題。
i took a different approach to the loading of the images than the example above. i just placed the images directly in my html document and used a css rule to hide them from view (display:none). i assigned both images an id attribute to make them easier to select. the script itself is very simple. i first draw the sliced and scaled image on the canvas (first drawimage statement), and then place the frame on top (second drawimage statement).
我用一個與上面用到的不同的方法來裝載圖像，直接將圖像插入到html 裡面，然後通過css 隱藏(display:none)它。兩個圖像我都賦了id ，方便後面使用。看下面的腳本，相當簡單，首先對犀牛頭做好切片(第一個drawimage )放在canvas 上，然後再上面套個相框(第二個drawimage )。
function draw() { var canvas = document.getelementbyid('canvas'); var ctx = canvas.getcontext('2d'); // draw slice ctx.drawimage(document.getelementbyid('source'), 33,71,104,124,21,20,87,104); // draw frame ctx.drawimage(document.getelementbyid('frame'),0,0);}in the final example of this chapter i've made a little art gallery. the gallery consists of a table containing several images. when the page is loaded, for each image in the page a canvas element is inserted and a frame is drawn arround it.
in my case, all images have a fixed width and height, and so does the frame that's drawn around it. you could enhance the script so that it uses the image's width and height to make the frame fit perfectly around it.
the code below should be self-explanatory. we loop through the images array and add new canvas elements accordingly. probably the only thing to note, for those not so familar with the dom, is the use of the insertbefore method. insertbefore is a method of the parent node (a table cell) of the element (the image) before which we want to insert our new node (the canvas element).