ClosePath

גרפיקה וקטורית, הגדרת נתיבים וציור

תיאור

סוגר את תת-הנתיב הנוכחי של הנתיב שהתחיל StartPath. קו ישר מצויר מהנקודה הנוכחית בחזרה אל נקודת ההתחלה של הנתיב, וזה מבטיח שהצורה היא צורה סגורה אחת ולא שתי נקודות קצה המחוברות רק בחיבור קו. קריאת ClosePath אינה מציירת את הנתיב — קראו אחר כך ל-DrawPath או ל-DrawPathEvenOdd כדי לקוות ו/או למלא אותו.

תחביר

Delphi

Function TPDFlib.ClosePath: Integer;

ActiveX

Function PDFlib::ClosePath() As Long

DLL

int DLClosePath(int InstanceID);

ערכי החזרה

0	Failed — no document is open or no path has been started.
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