SetGlobalOrigin

Version history

This function was introduced in Quick PDF Library version 17.15.

Description

Sets the origin for all subsequent drawing operations. This function is similar to the SetOrigin function which will change the origin for the selected document (either loaded using LoadFromFile, LoadFromStream or LoadFromString or subsquently selected with SelectDocument).

However, this version of the function will also set the origin for standalone functions (such as ExtractFilePageText) and direct access functions (such as DAExtractPageText).

Origin options 1, 2 and 3 are included for compatibility with SetOrigin, however they should not be used as there is a historical error for documents with a MediaBox that is not positioned exactly at the coordinate system origin. Rather use origin options 4, 5, 6 or 7 to ensure compatibility with all documents.

Syntax

Delphi

function TDebenuPDFLibrary1811.SetGlobalOrigin(Origin: Integer): Integer;

ActiveX

Function DebenuPDFLibrary1811.PDFLibrary::SetGlobalOrigin(Origin As Long) As Long

DLL

int DPLSetGlobalOrigin(int InstanceID, int Origin)

Parameters

Origin

Specifies which page corner to use for the origin:
0 = (0,0) of underlying coordinate system
1 = Top left (deprecated, rather use 5 or 7)
2 = Top right (deprecated)
3 = Bottom right (deprecated)
4 = Bottom left of crop box
5 = Top left of crop box
6 = Bottom left of media box
7 = Top left of media box
Anything else = same as 0