DynaPDF Manual - Page 478

Previous Page 477   Index   Next Page 479

Function Reference
Page 478 of 839
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 return the orientation of the page in degrees. The function accesses the page object
without any overhead, and hence, is very fast.
Remarks:
The functions of the rendering engine should be fast as possible and use less error checking than
normal DynaPDF functions. For example, the function does not check whether a valid page pointer
or NULL was passed to the function.
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!)
 

Previous topic: GetPageLabelCount, GetPageLayout, GetPageMode, GetPageNum

Next topic: External CMaps, Order of Text records