DynaPDF Manual - Page 372

Previous Page 371   Index   Next Page 373

Function Reference
Page 372 of 839
GetBBox
Syntax:
LBOOL pdfGetBBox(
const PPDF* IPDF,
// Instance pointer
TPageBoundary Boundary,
// see below
struct TPDFRect ADDR BBox) // Bounding box
typedef enum
{
pbArtBox,
// Art box
pbBleedBox, // Bleed box
pbCropBox,
// Crop box
pbTrimBox,
// Trim box
pbMediaBox
// Media box
}TPageBoundary;
struct TPDFRect
{
double Left;
double Bottom;
double Right;
double Top;
};
The function returns a bounding box of a PDF page. A PDF page may be prepared either for a
finished medium, such as a sheet of paper, or as part of a prepress process in which the content of
the page is placed on an intermediate medium, such as film or an imposed reproduction plate.
In the latter case, it is important to distinguish between the intermediate page and the finished page.
The intermediate page may often include additional production-related content, such as bleeds or
printer marks that falls outside the boundaries of the finished page. To handle such cases, a PDF
page can define as many as five separate boundaries to control various aspects of the imaging
process.
The function requires an open page because each page can use its own boundaries.
Return values:
If the function succeeds the return value is 1 and the structure BBox is filled with values. If the
function fails the return value is 0.
 

Previous topic: GetAscent, GetBarcodeDict

Next topic: Bounding boxes:, GetBidiMode