Xojo Developer Conference
25/27th April 2018 in Denver.
MBS Xojo Conference
6/7th September 2018 in Munich, Germany.

DynaPDF Manual - Page 610

Previous Page 609   Index   Next Page 611

Function Reference
Page 610 of 750
If the parameter Value is NULL or if it contains an empty string the subject string is deleted in the
annotation.
Remarks:
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.
SetBBox
Syntax:
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
{
pbArtBox,
// Art box
pbBleedBox, // Bleed box
pbCropBox,
// Crop box
pbTrimBox,
// Trim box
pbMediaBox
// Media box
}TPageBoundary;
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
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.
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: SetAnnotSubject

Next topic: SetBidiMode