Index

C/C++ Functions

pdDocGetTransformPlus

void pdDocGetTransformPlus(DT_PDDOC power_doc, DT_TM3X3 transform)

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

pdDocGetTransform

void pdDocGetTransform(DT_PDDOC power_doc, DT_TM2X2 transform)

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

The pdDocGetTransformPlus (or pdDocGetTransform) function returns the current 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 and is set by calling pdDocSetTransformPlus, pdDocSetTransform or pdDocSetScale.

The only difference between pdDocGetTransformPlus and pdDocGetTransform is that pdDocGetTransformPlus returns a 3x3 transformation matrix while pdDocGetTransform returns a 2x2 transformation matrix. Therefore, pdDocGetTransform is more limited (i.e. this function cannot be used to retrieve the full perspective transform associated with a Power Engine document).

Parameters

ParameterDescription

power_doc

Handle of the associated Power Engine document.

transform

For pdDocGetTransformPlus, 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 pdDocGetTransform, 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.

Related Functions

pdDocSetTransformPlus, pdDocSetTransform

 

Index