ClosePath

ベクターグラフィックス、パスの定義と描画

説明

StartPath で開始したパスの現在のサブパスを閉じます。現在のポイントからパスの開始ポイントまで直線が描画され、図形はストローク結合だけで接続された 2 つの終点ではなく、単一の閉じた形状になります。ClosePath の呼び出しではパスは描画されません。後で DrawPath または DrawPathEvenOdd を呼び出してストロークまたは塗りつぶしを行います

構文

Delphi

Function TPDFlib.ClosePath: Integer;

ActiveX

Function PDFlib::ClosePath() As Long

DLL

int DLClosePath(int InstanceID);

戻り値

0失敗 — ドキュメントが開いていないか、パスが開始されていません
1現在のサブパスは閉じられた

備考

図形をストロークする場合、パスを閉じることが重要です。開いたパスでは最後の点と最初の点の間に見える隙間が残り、その頂点のストローク結合は適切な線結合ではなく butt cap として描画されます。塗りつぶしパスでは閉じ線が塗りつぶし規則によって暗黙に補われますが、明示的に閉じると出力がよりきれいになり、別の 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