You may specify any number of different types of transforms. For a more detailed explanation of this kind of technique see the Transform Explanation.

Note: The transform takes place after the object has been positioned. This means that if you transform an object it may appear drawn outside the rectangle you specified as a positioning parameter. Try to avoid mixing positioning and transform parameters as this can be confusing.

Rotates the object by a number of degrees clockwise around an optional anchor point.

The following example draws a roundrect rotated 45 degrees about the origin and then a rectangle rotated 90 degrees about its own center.

[VBScript]
DrawShape "roundrect", "Rect=20,20,40,40 Rotate=45"
DrawShape "rect", "Rect=10,10,30,30 Rotate=90,20,20"

Stretches the object horizontally and vertically.

You can specify two parameters to indicate the amount of horizontal and vertical stretch. A value of one indicates no stretching, more than one will enlarge the object proportionally and less than one will shrink it proportionally. Negative values will 'flip' the object around the horizontal or vertical axis.

If you specify only one parameter the horizontal and vertical stretch are taken to be the same.

By default the stretch is anchored at the origin. You can enter a further two parameters to specify a different anchor point.

The following draws a canvas scaled to 200% of its normal size anchored at the origin.

[VBScript]
DrawCanvas mycanvas.Image, "Scale=2,2,0,0"

Skews the object by a specified horizontal and vertical amount.

You can specify two parameters to indicate the amount of skew. Zero is no skew and higher numbers indicate progressively larger amounts of skew.

By default the skew is anchored at the origin. You can enter a further two parameters to specify a different anchor point.

Shifts the object by a specified horizontal and vertical amount.

The following are equivalent.

[VBScript]
DrawShape "rect", "Translate=40,40 Size = 100,100"
DrawShape "rect", "Pos=40,40 Size = 100,100"

Pins the top left of the object to a particular position.

When performing transforms on an object it is easy to end up transforming the object in such a way that it no longer appears on the canvas. You can ensure that your object always appears on the canvas using the pin parameter.

After the object has been transformed ImageGlue finds the bounding rectangle that encloses the transformed object. It then shifts this rectangle to pin it at the point you specify.

For example the following code will rotate an image by 45 degrees and ensure that the top and left of the rotated image are flush with the top and left of the canvas.

[VBScript]
DrawFile "c:\mypic.jpg", "Rotate=45 Pin=0,0"

The pin operation is always performed after other transforms but before the limit transforms are applied.

Scales the size of a transformed image to limit its height.

ImageGlue finds the bounding rectangle that encloses the transformed object. If the rectangle is taller than the limiting height it scales the entire object proportionally to shrink it down to the specified height.

For example the following ensures that the height of the final canvas is never more than 120.

[VBScript]
DrawFile "c:\mypic.jpg", "LimitHeight=120"

The limiting transforms are the final transforms to be applied.

Scales the size of a transformed image to limit its width.

This performs a similar role to the LimitHeight parameter but limits width rather than height.