PDFium Delphi Component Docs

מתודת CreatePath

Component: TPdf  ·  Unit: PDFium
יוצר אובייקט נתיב חדש במיקום התחלתי

Syntax

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 (כלל even-odd) או fmWinding (כלל non-zero winding). ברירת המחדל היא 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. מצב מיזוג (blend) ל-compositing עבור אובייקט הנתיב. ברירת המחדל היא 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. מצב מיזוג ל-compositing. ברירת המחדל היא bmDefault.

Description

CreatePath פותח את בנייתו של אובייקט נתיב וקטורי חדש. יש לקרוא לו לפני כל אחת מהמתודות לבניית נתיב (MoveTo, LineTo, BezierTo, ClosePath), ואת הרצף יש להשלים בקריאה ל-AddPath כדי לשמור את הנתיב בעמוד הנוכחי.

קיימות שתי העמסות. הצורה בת שתי הקואורדינטות CreatePath(X, Y, ...) מאתחלת נתיב ריק עם נקודתו הנוכחית ב-(X, Y); לאחר מכן בונים את הצורה בחופשיות באמצעות מתודות המקטעים. הצורה בת ארבע הקואורדינטות CreatePath(X, Y, Width, Height, ...) יוצרת ישירות נתיב מלבני סגור — אין צורך בקריאות מקטע נוספות לפני AddPath.

כל התכונות החזותיות של הנתיב — צבע וכלל המילוי, צבע הקו, הרוחב, האטימות, סגנון הקצה, סגנון החיבור ומצב המיזוג — נקבעים בעת היצירה באמצעות הפרמטרים האופציונליים. ערכי ברירת המחדל מניבים קו מתאר שחור בעובי נקודה אחת ללא מילוי.

נתיב אחד בלבד יכול להיבנות בכל רגע. קריאה חוזרת ל-CreatePath לפני AddPath משליכה את הנתיב הממתין הקודם.

Example

// 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;

See Also

MoveTo, LineTo, BezierTo, ClosePath, AddPath