DynaPDF Manual - Page 507

Previous Page 506   Index   Next Page 508

Function Reference

Page 507 of 874

GetPageObject (Rendering Engine)

Syntax:

IPGE* pdfGetPageObject(

const PPDF* IPDF, // Instance pointer

UI32 PageNum)

// Page number

The function returns the pointer of a page object to enable fast access to certain properties of it, e.g.

the bounding boxes or the page orientation. This function is mostly used during rendering because

it provides fast access to page properties without any unnecessary overhead.

The live time of a page pointer ends when the PDF file in memory will be released, e.g. when

CloseFile() or FreePDF() was called.

Return values:

If the function succeeds the return value is a pointer of the page object. If the function fails the

return value is NULL. The function can only fail when an invalid page number was passed to the

function.

GetPageOrientation (Rendering Engine)

Syntax:

SI32 pdfGetPageOrientation(

IPGE* PagePtr) // Pointer of a page object

The function returns the orientation of the page in degrees. The function accesses the page object

without any overhead, and hence, is very fast.

GetPageText

Syntax:

LBOOL pdfGetPageText(

const PPDF* IPDF,

// Instance pointer

struct TPDFStack* Stack) // Operation stack, see below

struct TTextRecordA

{

float Advance; // Negative values move the cursor to the right

BYTE* Text;

// Raw text

UI32 Length;

// Raw text length in bytes

};

struct TTextRecordW

{

float Advance; // Negative values move the cursor to the right

UI16* Text;

// Translated Unicode string (not null-terminated!)

UI32 Length;

// Length in characters

float Width;

// String width measured in text space

};

struct TPDFStack

{

struct TCTM

ctm;

// Pre-multiplied global transf. matrix

struct TCTM

tm;

// Pre-multiplied text transf. matrix

Previous topic: GetPageLabelCount, GetPageLayout, GetPageMode, GetPageNum

Next topic: External CMaps