If you create an image using
iSurface.createImage({width: 350, height: 350, src: fileName});
where the surface has also been defined as having dimensions of 350 x 350
an image is drawn to fill the full area if it is square. If the image is oblong, say 40 x 256, it is drawn to
that smaller dimension, whereas
image.src=fileName;
will stretch the image to the full square area.
Is there a way to do this with createImage?

You best bet is to transform
You best bet is to transform it to desired size.
How to transform?
I am afraid I have not been able to follow the brief examples on transforms.
If I draw an image by
iSurface2.createImage({width: 350, height: 350, src: fileName});
how do a write a transform to stretch the image vertically? In my case, the image is actually 256 x 34.
James W Cooper
If you know that your image
If you know that your image is 256 by 34 why do you specify 350 by 350? You could do it like that:
You can try to transform the image to the desired size:
iSurface2.createImage({width: 350, height: 350, src: fileName}).setTransform(m.scale(256/350, 34/350));
Making a reference to "transform" I was kind of hoping that you'll look it up in the documentation. It is still the best way to understand the code and the concepts behind it.
Transform in the documentataion
I try to look into the documentation, but I really have found very little for gfx. The book of Dojo gives a link to one general overview page. A search for transform under the API docs provided a number of API calls but very little detail under any of them. Should I be looking elsewhere?
James W Cooper
http://docs.google.com/Doc?id
http://docs.google.com/Doc?id=d764479_1hnb2tn describes all objects, methods, and properties. What kind of documentation are you looking for?