DynaPDF Manual - Page 760

Previous Page 759   Index   Next Page 761

Function Reference
Page 760 of 839
SetListFont
Syntax:
LBOOL pdfSetListFont(
const PPDF* IPDF, // Instance pointer
UI32 Handle)
// Font handle
The function marks an arbitrary font as list font. The font is used in WriteFText() when a list
operator was found. The symbol to be used as list symbol can be set with the list operator. See
WriteFText() for further information. The parameter Handle must be a valid font handle that was
returned by SetFont(), SetFontEx(), or LoadFont().
Return values:
If the function succeeds the return value is 1. If the function fails the return value is 0.
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.
 

Previous topic: SetLineWidth, SetLinkHighlightMode

Next topic: SetMaxErrLogMsgCount, SetMaxFieldLen