DynaPDF Manual - Page 295

Previous Page 294   Index   Next Page 296

Function Reference
Page 295 of 839
LabelDistance is the label for the distance tool, e.g. "mm".
LabelArea is the label for the area tool, e.g. "mm²".
Example (C++):
PPDF* pdf = pdfNewPDF();
if (!pdf) return -1; // Out of memory?
pdfCreateNewPDF(pdf, "e:/cppout.pdf");
// We use top down coordinates in this example
pdfSetPageCoords(pdf, pcTopDown);
pdfAppend(pdf);
// Just a test object of a known size that can be measured...
pdfSetLineWidth(pdf, 0.5);
pdfRectangle(pdf, 50.0, 50.0, 144, 72.0, fmStroke);
TPDFRect bbox;
pdfGetBBox(pdf, pbMediaBox, bbox);
SI32 vp = pdfCreateViewport(
pdf,
// Instance pointer
NULL,
// Optional viewport name
bbox.Left,
// Lowever left corner
bbox.Bottom,
// Lowever left corner
bbox.Right,
// Upper right corner
bbox.Top);
// Upper right corner
pdfCreateRectilinearMeasure(
pdf,
// Instance pointer
vp,
// Viewport handle
25.4/72.0,
// Conversion factor from 1/72 inch to mm
"inch to mm",
// Description of the measure dictionary
"mm",
// Unit label for the distance tool
"mm²");
// Unit label for the area tool
pdfEndPage(pdf);
pdfCloseFile(pdf);
pdfDeletePDF(pdf);
Remarks:
This function is implemented in an Ansi and Unicode compatible variant.
Return values:
If the function succeds the return value is a measure handle, a value greater or equal zero. If the
function fails the return value is a negative error code.
 

Previous topic: CreateRectilinearMeasure

Next topic: CreateResetAction, CreateSeparationCS