ClosePath

گرافیک برداری، تعریف و ترسیم مسیر

توضیحات

زیرمسیر جاری مسیری را که با StartPath آغاز شده می‌بندد. یک خط راست از نقطهٔ جاری به نقطهٔ آغاز مسیر کشیده می‌شود تا شکل، یک پیکرهٔ بستهٔ واحد باشد نه دو نقطهٔ انتهایی که فقط با اتصال stroke به هم رسیده‌اند. فراخوانی ClosePath مسیر را ترسیم نمی‌کند — بعدش برای stroke و/یا پرکردن، DrawPath یا DrawPathEvenOdd را فراخوانی کنید

نحو

Delphi

Function TPDFlib.ClosePath: Integer;

ActiveX

Function PDFlib::ClosePath() As Long

DLL

int DLClosePath(int InstanceID);

مقادیر بازگشتی

ملاحظات

بستن مسیر هر وقت قرار است شکل stroke شود اهمیت دارد: مسیر باز بین آخرین و نخستین نقطه یک شکاف قابل‌مشاهده باقی می‌گذارد و اتصال stroke در آن رأس به‌صورت butt cap، نه یک اتصال خط مناسب، render می‌شود. در مسیرهای پُرشده، خط پایانی از قانون fill نتیجه می‌شود، اما بستن صریح مسیر همچنان خروجی تمیزتری می‌دهد و پیش از شروع یک sub-path جدید با 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