PDFium Delphi Component Docs

CreatePath メソッド

コンポーネント: TPdf  ·  ユニット: PDFium
初期位置に新しいパスオブジェクトを作成します

構文

procedure CreatePath(X, Y: Single; FillMode: TPdfFillMode = fmNone; FillColor: TColor = clBlack; FillAlpha: Byte = $FF; Stroke: Boolean = True; StrokeColor: TColor = clBlack; StrokeAlpha: Byte = $FF; StrokeWidth: Single = 1.0; LineCap: TPdfLineCap = lcDefault; LineJoin: TPdfLineJoin = ljDefault; BlendMode: TPdfBlendMode = bmDefault);

FillModeTPdfFillMode. パス内部の塗りつぶし規則:fmNone(塗りつぶしなし)、fmAlternate(偶奇規則)、または fmWinding(非ゼロワインディング規則)。既定値は fmNone です
FillColorTColor. FillMode が fmNone でない場合に適用される塗りつぶし色。既定値は clBlack です
FillAlphaByte. 塗りつぶしの不透明度。$00 が完全な透明、$FF が完全な不透明です。既定値は $FF です
StrokeBoolean. True の場合、StrokeColor、StrokeAlpha、StrokeWidth を使用してパスの輪郭が描画されます。既定値は True です
StrokeColorTColor. パスの輪郭の色。既定値は clBlack です
StrokeAlphaByte. ストロークの不透明度。$00 が完全な透明、$FF が完全な不透明です。既定値は $FF です
StrokeWidthSingle. PDF ユーザー単位(ポイント)でのストローク線の幅。既定値は 1.0 です
LineCapTPdfLineCap. 開いたパスの端点に適用されるスタイル:lcDefault、lcButt、lcRound、lcProjectingSquare。既定値は lcDefault です
LineJoinTPdfLineJoin. パスセグメントの接合部に適用されるスタイル:ljDefault、ljMiter、ljRound、ljBevel。既定値は ljDefault です
BlendModeTPdfBlendMode. パスオブジェクトの合成ブレンドモード。既定値は bmDefault で、bmNormal として合成されます

 

procedure CreatePath(X, Y, Width, Height: Single; FillMode: TPdfFillMode = fmNone; FillColor: TColor = clBlack; FillAlpha: Byte = $FF; Stroke: Boolean = True; StrokeColor: TColor = clBlack; StrokeAlpha: Byte = $FF; StrokeWidth: Single = 1.0; LineCap: TPdfLineCap = lcDefault; LineJoin: TPdfLineJoin = ljDefault; BlendMode: TPdfBlendMode = bmDefault);

FillModeTPdfFillMode. 矩形内部の塗りつぶし規則。既定値は fmNone です
FillColorTColor. 矩形の塗りつぶし色。既定値は clBlack です
FillAlphaByte. 塗りつぶしの不透明度($00–$FF)。既定値は $FF です
StrokeBoolean. True の場合、矩形の輪郭が描画されます。既定値は True です
StrokeColorTColor. 矩形の輪郭の色。既定値は clBlack です
StrokeAlphaByte. ストロークの不透明度($00–$FF)。既定値は $FF です
StrokeWidthSingle. ポイント単位での輪郭ストロークの幅。既定値は 1.0 です
LineCapTPdfLineCap. 矩形の角に適用される線端スタイル。既定値は lcDefault です
LineJoinTPdfLineJoin. 矩形の角に適用される結合スタイル。既定値は ljDefault です
BlendModeTPdfBlendMode. 合成ブレンドモード。既定値は bmDefault です

説明

CreatePath は、新しいベクターパスオブジェクトの構築を開始します。パス構築メソッド(MoveTo、LineTo、BezierTo、ClosePath)のいずれかより前に呼び出す必要があり、この一連の処理は AddPath の呼び出しでパスを現在ページに確定させて完了しなければなりません

利用できるオーバーロードは 2 つです。2 座標形式の CreatePath(X, Y, ...) は、現在点を (X, Y) に持つ空のパスを初期化します。その後、パスセグメントメソッドを使って自由に図形を構築できます。4 座標形式の CreatePath(X, Y, Width, Height, ...) は、閉じた矩形パスを直接生成します。AddPath の前に追加のセグメント呼び出しは不要です

パスのすべての視覚プロパティ(塗りつぶしの色と規則、ストロークの色、幅、不透明度、線端スタイル、結合スタイル、ブレンドモード)は、作成時に省略可能なパラメーターで設定します。既定値では、塗りつぶしなしの 1 ポイント黒ストローク輪郭になります

同時に構築できるパスは 1 つだけです。AddPath の前に再度 CreatePath を呼び出すと、以前の未確定パスは破棄されます

例

// Draw a filled blue triangle with a 2-pt black outline
Pdf1.NewPage(595, 842);
Pdf1.CreatePath(100, 100, fmWinding, clBlue, $FF, True, clBlack, $FF, 2.0);
Pdf1.LineTo(200, 300);
Pdf1.LineTo(300, 100);
Pdf1.ClosePath;
Pdf1.AddPath;

// Draw a red filled rectangle using the 4-coordinate overload
Pdf1.CreatePath(50, 400, 200, 80, fmWinding, clRed);
Pdf1.AddPath;

関連項目

MoveTo, LineTo, BezierTo, ClosePath, AddPath