Index

C/C++ Functions

txTextGetTransformPlus

void txTextGetTransformPlus(DT_TXDOC text_doc, DT_TM3X3 transform)

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

txTextGetTransform

void txTextGetTransform(DT_TXDOC text_doc, DT_TM2X2 transform)

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

The txTextGetTransformPlus (or txTextGetTransform) function returns the text document's current transformation matrix.

This matrix is respected when the document is drawn by calling the txTextDraw function and is set by calling txTextSetTransformPlus, txTextSetTransform or txTextSetScale.

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

txTextGetTransformPlus is a convenience function. It has the same effect as the following code:

DT_PDDOC power_doc; txTextGetPowerDoc(text_doc, &power_doc);
pdDocGetTransformPlus(power_doc, transform);

txTextGetTransform is a convenience function. It has the same effect as the following code:

DT_PDDOC power_doc; txTextGetPowerDoc(text_doc, &power_doc);
pdDocGetTransform(power_doc, transform);

Parameters

ParameterDescription

power_doc

Handle of the associated text document instance.

transform

For txTextGetTransformPlus, this is a 3x3 transformation matrix. This matrix represents a 2D perspective (or projective) transform to apply to the specified text document. For more information, see the description of the DT_TM3X3 basic data type in this manual.

For txTextGetTransform, 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 text document. For more information, see the description of the DT_TM2X2 basic data type in this manual.

Related Functions

txTextSetTransformPlus, txTextSetTransform

 

Index