The SetTransformPlus (or SetTransform or SetScale) function sets the transformation matrix of the Power Engine document specified by the document instance power_doc.
This matrix is respected when the document is drawn by calling the Draw function. This allows applications to easily scale, stretch, rotate, skew or transform using an arbitrary transform matrix the entire output of this function.
The only difference between SetTransformPlus and SetTransform is that SetTransformPlus uses a 3x3 transformation matrix while SetTransform uses a 2x2 transformation matrix. Therefore, SetTransform is more limited (i.e. this function cannot be used to apply a perspective transform to a Power Engine document). Finally, the SetScale function is even more limited — it is a special case of SetTransform.
Parameter | Description |
---|---|
transform |
For SetTransformPlus, this is a 3x3 transformation matrix. This matrix represents a 2D perspective (or projective) transform to apply to the specified Power Engine document. For more information, see the description of the DT_TM3X3 basic data type in this manual. For SetTransform, this is a 2x2 transformation matrix. This matrix represents the top two rows and columns of a 2D perspective transform to apply to the specified Power Engine document. For more information, see the description of the DT_TM2X2 basic data type in this manual. |
scale |
For SetScale only, a simple scale to apply to the specified Power Engine document. Same as calling SetTransform with the following: |