Monkeybread Software - DynaPDF Manual

DynaPDF Manual - Page 139

Function Reference

Page 139 of 883

Function Reference

This section describes all supported functions of DynaPDF in detail. Most examples in this chapter

are written in C, C++, or Delphi. However, as you can see, the usage of DynaPDF is nearly identical

with all programming languages.

Abort (Rendering Engine)

Syntax:

void rasAbort(

IRAS* RasPtr) // Instance pointer of the rasterizer

This function provides a safe way to stop the function RenderPage() very quickly when it is running

in a separate thread. The function sets an internal abort flag so that the rendering engine can safely

terminate the current rendering process. The flag is automatically reset when the function

RenderPage() is called the next time.

AbortPath

Syntax:

void pdfAbortPath(

const PPDF* IPDF) // Instance pointer

The function discards the current path in memory.

ActivateAltFontList

Syntax:

LBOOL pdfActivateAltFontList(

const PPDF* IPDF,

// Instance pointer

SI32 Handle,

// -1 or a list handle -> CreateAltFontList()

LBOOL EnableSysFonts)

The function activates or deactivates an alternate font list that was created by CreateAltFontList().

An alternate font list represents a list of fallback fonts which are tested if one or more required

glyphs were not found in the current font.

If no compatible font was found in the list, then system fonts are tested if EnableSysFonts was set to

true. Although EnableSysFonts should be set to true in most cases, it is sometimes useful to disable

system fonts, e.g. to restrict the number of fonts which can be embedded.

In order to disable the current alternate font list set the parameter Handle to -1. The value of

EnableSysFonts is ignored this case. To fully deactivate font substitution disable system fonts with

SetUseSystemFonts() before calling a text function.

Please note that alternate font lists are used only, if complex text layout was enabled. This can be

done by setting the flag gfComplexText with SetGStateFlags().