Xojo Developer Conference
25/27th April 2018 in Denver.
MBS Xojo Conference
6/7th September 2018 in Munich, Germany.

DynaPDF Manual - Page 681

Previous Page 680   Index   Next Page 682

Function Reference
Page 681 of 750
SetMatrix
Syntax:
LBOOL pdfSetMatrix(
const PPDF* IPDF,
// Instance pointer
struct TCTM* Matrix) // Transformation matrix
struct TCTM
{
double a;
double b;
double c;
double d;
double x;
double y;
};
The function left multiplies the current transformation matrix with the new one. The transformation
matrix is part of the graphics state. When changing the coordinate system it is usually best to save
the graphics state beforehand with SaveGraphicState(). This makes it possible to restore the
coordinate system with RestoreGraphicState().
Notice:
The native coordinate system in PDF is bottom up. Changing the base coordinate system with
SetPageCoords() to top down results in a mirrored coordinate system that is applied with the current
transformation matrix. DynaPDF makes sure that text functions and so on produce correct results in
the mirrored coordinate system.
However, when multiplying a new matrix with the already changed transformation matrix
DynaPDF must set the base coordinate system back to bottom up after multiplying the matrices. This
is required because multiplying the transformation matrix again with another one would otherwise
produce incorrect results.
Matrix multiplications and every other transformation of the coordinate system should always be
applied in bottom up coordinates. It is the only way to avoid side effects when changing the
coordinate system arbitrary often.
Return values:
If the function succeeds the return value is 1. If the function fails the return value is 0.
SetMaxErrLogMsgCount
Syntax:
void pdfSetMaxErrLogMsgCount(
const PPDF* IPDF, // Instance pointer
UI32 Value)
// New limit
 

Previous topic: SetListFont

Next topic: SetMetaConvFlags