DynaPDF Manual - Page 221

Previous Page 220   Index   Next Page 222

Function Reference
Page 221 of 839
ClosePath
Syntax:
LBOOL pdfClosePath(
const PPDF* IPDF,
// Instance pointer
TPathFillMode FillMode) // see below
typedef enum
{
// Nonzero Winding Number Rule
fmFillNoClose,
// Fill but do not close the path
fmStrokeNoClose,
// Stroke but do not close the path
fmFillStrokeNoClose,
// Fill and stroke but do not close the path
fmFill,
// Fill the path
fmStroke,
// Stroke the path
fmFillStroke,
// Fill and stroke the path
// Even-Odd Rule
fmFillEvOdd,
// Fill the path
fmFillStrokeEvOdd,
// Fill and stroke the path
fmFillEvOddNoClose,
// Fill but do not close the path
fmFillStrokeEvOddNoClose, // Fill and stroke but do not close the path
fmNoFill,
// Discard the path
fmClose
// Close the path and begin a new sub path
}TPathFillMode;
In PDF all vector graphics are paths. Paths can be filled, stroked, or both. Filled path can be drawn
by applying the nonzero winding number rule or the even-odd rule (see Path Construction and
Painting for further information). Both rules produce different results on complex paths but they
have no effect on simple paths like rectangles, circles, and so on.
The filling rules are can be used to produce holes in a path; an area that is left unpainted. The draw
direction is important when drawing simple shapes like rectangles and so on. See
SetDrawDirection() for further information.
The flag fmNoFill can be used to discard a path that was already drawn.
Remarks:
Paths are invisible until they will be filled or stroked. DynaPDF displays a warning if an unused
path is in memory when drawing an image, text, or when closing the page. The function checks
whether a path is in memory prior execution. If no open path is detected the function returns with
an error message.
Return values:
If the function succeeds the return value is 1. If the function fails the return value is 0.
 

Previous topic: CloseImage, CloseImportFile, CloseImportFileEx

Next topic: CloseTag, ComputeBBox, ConnectPageBreakEvent