DrawPath

رسومات المتجهات، تعريف المسارات ورسمها

الوصف

يرسم المسار الحالي — المجمَّع بـ StartPath وAddLineToPath وAddCurveToPath وAddArcToPath وClosePath — بقاعدة تعبئة اللف غير الصفري. وبعد رسم المسار تُعاد حالة المسار، فيبدأ StartPath التالي شكلًا جديدًا

الصيغة

Delphi

Function TPDFlib.DrawPath(PathOptions: Integer): Integer;

ActiveX

Function PDFlib::DrawPath(PathOptions As Long) As Long

DLL

int DLDrawPath(int InstanceID, int PathOptions);

المعاملات

PathOptionsوضع الرسم:

0 — مخطط فقط‏ (حد بالإعدادات الخطية الحالية).
1 — تعبئة فقط‏ (بلون التعبئة الحالي وقاعدة اللف غير الصفري).
2 — تعبئة ومخطط

قيم الإرجاع

0فشل — PathOptions خارج النطاق، أو لا يوجد مستند مفتوح، أو لم يبدأ أي مسار
1رُسم المسار بنجاح

ملاحظات

اضبط ألوان الحد والتعبئة وخصائص الخط‏ (SetLineWidth وSetLineCap وSetLineDash) قبل استدعاء DrawPath. وتُأخذ عينة حالة الرسومات الحالية عند موقع الاستدعاء

في المسارات المتداخلة أو المتقاطعة ذاتيًا تعامل قاعدة اللف غير الصفري كل مشوار فرعي كجزء من المنطقة نفسها: الثقب المقطوع من شكل أكبر يتطلب لف المشوار الفرعي الداخلي بالاتجاه المعاكس للخارجي. وعندما يكون ذلك غير مريح استدعِ DrawPathEvenOdd بدلًا من ذلك — قاعدة الزوجي-الفردي تتبادل ببساطة بين الداخل والخارج عند كل تقاطع، ما يجعل ثقوب الطرد تافهة

مثال

// Filled outlined diamond
PDF.SetStrokeColor(0, 0, 0);
PDF.SetFillColor(0.6, 0.8, 1);
PDF.SetLineWidth(1.5);

PDF.StartPath(150, 100);
PDF.AddLineToPath(200, 150);
PDF.AddLineToPath(150, 200);
PDF.AddLineToPath(100, 150);
PDF.ClosePath;
PDF.DrawPath(2);                       // 2 = fill and outline

انظر أيضا

DrawPathEvenOdd, StartPath, AddLineToPath, AddCurveToPath, AddArcToPath, ClosePath, SetLineWidth