ClosePath
矢量图形、路径定义和绘制
描述
关闭由 StartPath 开始的路径的当前子路径。从当前点向路径起点绘制一条直线,以确保该图形是单一闭合形状,而非仅由描边连接的两个端点。调用 ClosePath 不会绘制路径——之后请调用 DrawPath 或 DrawPathEvenOdd 进行描边和/或填充
语法
Delphi
Function TPDFlib.ClosePath: Integer;
ActiveX
Function PDFlib::ClosePath() As Long
DLL
int DLClosePath(int InstanceID);
返回值
| 0 | 失败 — 未打开文档或尚未开始路径 |
|---|---|
| 1 | 当前子路径已闭合 |
备注
需要描边形状时,闭合路径很重要:开放路径会在最后一点和第一点之间留下可见间隙,该顶点处的描边连接会渲染为平头端点而非正确的线连接,对于填充路径,填充规则隐含闭合线,但显式闭合仍可产生更干净的输出,并且在使用另一个 StartPath 开始新子路径前是必需的
示例
// Draw a closed triangle, stroked
PDF.SetStrokeColor(0, 0, 0);
PDF.SetLineWidth(1);
PDF.StartPath(100, 100);
PDF.AddLineToPath(200, 100);
PDF.AddLineToPath(150, 180);
PDF.ClosePath; // line back to (100, 100)
PDF.DrawPath(0); // 0 = outline only另请参阅
StartPath、AddLineToPath、AddCurveToPath、DrawPath、DrawPathEvenOdd