The pdDocSetTransformPlus (or pdDocSetTransform or pdDocSetScale) 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 pdDocDraw 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 pdDocSetTransformPlus and pdDocSetTransform is that pdDocSetTransformPlus uses a 3x3 transformation matrix while pdDocSetTransform uses a 2x2 transformation matrix. Therefore, pdDocSetTransform is more limited (i.e. this function cannot be used to apply a perspective transform to a Power Engine document). Finally, the pdDocSetScale function is even more limited — it is a special case of pdDocSetTransform.
Parameter | Description |
---|---|
power_doc |
Handle of the associated Power Engine document. |
transform |
For pdDocSetTransformPlus, 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 pdDocSetTransform, 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 pdDocSetScale only, a simple scale to apply to the specified Power Engine document. Same as calling pdDocSetTransform with the following: |
pdDocDraw
pdDocGetTransformPlus, pdDocGetTransform