AddInkAnnotation

التعليقات التوضيحية وروابط النقاط الفعالة

الوصف

يضيف تعليقًا توضيحيًا من نوع حبر (PDF ‏/Subtype /Ink) يمثل ضربة يدوية واحدة أو أكثر أو علامات حرة أو رسومات باليد مرسومة على الصفحة. ويحتوي مدخل قاموس /InkList مصفوفة من الضربات؛ وكل ضربة مصفوفة من إحداثيات x/y متبادلة تمثل المسار الذي رسمه جهاز تأشير بين حدثي نزول القلم ورفعه. وتُعبَّر مركّبات اللون والعتامة على مقياس 0–1؛ أما Transparency فتُعطى على مقياس 0–100 (‏0 = معتم تمامًا، 100 = شفاف تمامًا). ولأن نقطة الدخول هذه تصدر مفتاح عتامة التعليق التوضيحي /CA الخاص بـ PDF 1.4، ترفع المكتبة المستندات الأدنى غير المقفلة إلى PDF 1.4 قبل الحفظ؛ وترفض بوابة التوافق الأهداف الأدنى المقفلة. معرَّف في ISO 32000-1 §12.5.6.13

الصيغة

Delphi

Function TPDFlib.AddInkAnnotation(Const InkPaths: WideString; BorderWidth: Double; InkRed, InkGreen, InkBlue: Double; Const Title, Contents: WideString; Transparency: Integer): Integer;

المعاملات

InkPaths — ضربة واحدة أو أكثر مرمزة كسلسلة واحدة. وتفصل بين الضربات '|' أو سطر جديد‏ (CR / LF / CRLF). وداخل كل ضربة تستخدم أزواج الإحداثيات اصطلاح الفاصل نفسه الذي تستخدمه AddPolygonAnnotation: قيم x/y متبادلة مفصولة بمسافات أو فواصل أو فواصل منقوطة أو جدولات. مثال: "100 100 110 105 120 110 | 200 200 210 205" يصف ضربتين منفصلتين. ويجب أن تحتوي كل ضربة زوجي إحداثيات على الأقل (أربعة أعداد) وعددًا كليًا زوجيًا من القيم، وإلا يُرجع الاستدعاء 0

BorderWidth — عرض حد الحبر، بالوحدات الحالية

InkRed وInkGreen وInkBlue — مركّبات RGB (0–1) للون الحبر، وتُكتب في /C

Title — اسم المؤلف الذي يُكتب في مدخل /T الخاص بالتعليق التوضيحي. مرِّر سلسلة فارغة لتجاهله

Contents — متن النافذة المنبثقة المرتبطة بالتعليق التوضيحي. مرِّر سلسلة فارغة لتجاهله

Transparency — العتامة معبَّرًا عنها كنسبة مئوية للشفافية (0–100). تحوّلها المكتبة إلى ‎/CA = 1 - Transparency/100 في PDF مع تقييدها ضمن النطاق

قيمة الإرجاع

1 يفعّل الارتباطات التلقائية؛ و0 يعطلها

ملاحظات

يُحسب /Rect للتعليق التوضيحي تلقائيًا من المدى المجمع لجميع الضربات زائدًا حشوًا صغيرًا متناسبًا مع عرض الإطار فتبقى الضربات المرسومة داخل الصندوق المحيط للتعليق التوضيحي

نقطة الدخول هذه مناسبة للكتابة اليدوية المرقمنة الملتقطة من شاشة لمس