Xojo Conferences

DynaPDF Manual - Page 629

Previous Page 628   Index   Next Page 630

Function Reference
Page 629 of 770
If the parameter Value is NULL or if it contains an empty string the subject string is deleted in the
This function is implemented in an Ansi and Unicode compatible variant.
Return values:
If the function succeeds the return value is 1. If the function fails the return value is 0.
LBOOL pdfSetBBox(
const PPDF* IPDF,
// Instance pointer
TPageBoundary Boundary, // Bounding box
double LeftX,
// lower left x
double LeftY,
// lower left y
double RightX,
// upper-right x
double RightY)
// upper-right y
typedef enum
// Art box
pbBleedBox, // Bleed box
// Crop box
// Trim box
// Media box
The function sets a specific bounding box of the current open 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
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
A bounding box is defined as rectangle giving the coordinates of a pair of diagonally opposite
corners. The media box of a page is normally expressed in a normalized form where the coordinates
of the lower-left point are set to zero.
A normalized bounding box can be easily defined as follows:
pdfSetBBox(pdf, pbMediaBox, 0, 0, 612, 792);
The parameters RightX, RightY represent the width and height of the media box (this is the paper
format if no crop box is present). The media box should normally be defined in the normalized form

Previous topic: SetAnnotString, SetAnnotSubject

Next topic: Bounding boxes:, SetBidiMode