Index

C/C++ Functions

pdDocSetTransformPlus

void pdDocSetTransformPlus(DT_PDDOC power_doc, const DT_TM3X3 transform)

Short Description: Set document's transform - 3X3 transformation matrix

pdDocSetTransform

void pdDocSetTransform(DT_PDDOC power_doc, const DT_TM2X2 transform)

Short Description: Set document's transform - 2X2 transformation matrix

pdDocSetScale

void pdDocSetScale(DT_PDDOC power_doc, DT_FLOAT scale)

Short Description: Set document's transform - simple scale

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.

Parameters

ParameterDescription

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:
transform[0][0] = scale, transform[0][1] = 0.0, transform[1][0] = 0.0 and transform[1][1] = scale.

Related Functions

pdDocDraw
pdDocGetTransformPlus, pdDocGetTransform

 

Index