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