THotPDF.RegisterMultiStopRadialGradient Method

يسجل تظليلًا شعاعيًا (radial shading) أصليًا في PDF قابلًا لإعادة الاستخدام، يجري استيفاءً لونيًا بين توقفين أو أكثر ممتدين من دائرة داخلية إلى دائرة خارجية

التصريح

function RegisterMultiStopRadialGradient(X0, Y0, R0, X1, Y1, R1: Single; const StopPositions: array of Single; const StopColors: array of Single; ComponentsPerStop: Integer): AnsiString;

الوحدة

HPDFDoc

المعاملات

الاسم	الغرض
`X0`، `Y0`، `R0`	مركز الدائرة الداخلية ونصف قطرها غير السالب
`X1`، `Y1`، `R1`	مركز الدائرة الخارجية ونصف قطرها غير السالب
`StopPositions`	إزاحتان متزايستان بدقة ومنتهيتان أو أكثر، ضمن المجال المغلق من صفر إلى واحد
`StopColors`	مكوّنات لونية منتهية ومعبأة بشكل مسطّح، ضمن المجال المغلق من صفر إلى واحد
`ComponentsPerStop`	`1` يختار DeviceGray، و`3` يختار DeviceRGB، و`4` يختار DeviceCMYK

قيمة الإرجاع

يعيد اسم مورد Pattern المولَّد لاستخدامه مع THPDFPage.SetFillPattern أو THPDFPage.SetStrokePattern

السلوك

يبني دالة خياطة (stitching) واحدة من Function Type 3 من مقاطع Function Type 2 محدودة الحجم
يصدر قاموس Shading Type 3 ويلفّه في مورد Pattern Type 2 قابل لإعادة الاستخدام
يمدّ لوني التوقفين الأول والأخير إلى ما بعد المجال الشعاعي
يرفض الإحداثيات غير المنتهية، وأنصاف الأقطار السالبة، ومصفوفات الألوان غير السليمة، والإزاحات المكررة، والإزاحات أو المكوّنات اللونية الخارجة عن نطاقاتها الصالحة
يتطلب PDF 1.3 ويتبع سياسة قفل إصدار المستند

مثال

PatternName := Document.RegisterMultiStopRadialGradient(
  300, 400, 0, 300, 400, 250,
  [0.0, 0.5, 1.0],
  [1.0, 0.0, 0.0,
   0.0, 1.0, 0.0,
   0.0, 0.0, 1.0], 3);
Document.CurrentPage.SetFillPattern(PatternName);