تبادل التعليقات عبر C ABI الأصلي في Linux

hpdf_document_execute_json_v1 تُتيح annotations.export وannotations.import عبر موصف العملية المسنود بالإصدارات القائم وواجهات callback IO

حمل PDF إلى سياق المستند أولًا؛ واستيراد التعليقات يستخدم InputIO لبايتات XFDF وOutputIO للـ PDF المحفوظة وResultIO لبيانات وصف نتيجة JSON

{"schemaVersion":1,"type":"annotations.export","format":"xfdf"}

التصدير يكتب XFDF بـ UTF-8 إلى OutputIO ويبلغ annotationCount وskippedAnnotationCount وdecodedAttachmentBytes وoutputBytes

{"schemaVersion":1,"type":"annotations.import","format":"xfdf",
 "annotationLimits":{"maxBytes":1048576,"maxAnnotations":1000,
 "maxNodes":100000,"maxDepth":32,"maxWorkingBytes":67108864}}

الاستيراد يبلغ updated وannotationProfile ثم يتبنى المراجعة المحفوظة فقط بعد نجاح callbackي PDF والنتيجة معًا

فشول callback الإدخال/الإخراج وفشول callback النتيجة والإلغاء تحفظ السياق الملتزم السابق بدقة؛ وcallbacks خارجية يمكن أن تكون تلقت تدفقًا جزئيًا سلفًا قبل فشل callback لاحق

JSON للقدرات يعلن annotationData بملف النوع المخطط ونمط الاستيراد الإلحاقي والبيانات المضمّنة والردود المحالة وكائنات popup؛ وappearanceImport تساوي false

حدود التعليقات يمكنها خفض سعات العملية ولا يمكنها زيادتها؛ وMaxBytes أيضًا تُسقف بذاكرة العملية مقسومةً على 64 والتخزين العملي بنصف ذاكرة العملية وبايتات التصدير بحد الإخراج

الاستيراد يقبل كائن signaturePolicy القائم لإعدادات CAdES والثقة والطوابع الزمنية ويفرض صلاحيات التعليقات وسياسة DocMDP الموثوقة

استيرادات ABI الفارغة تحفظ بايتات PDF الملتزمة مع إعادة صفر تحديثات

الوجهات المحلية المسماة والصريحة وأعمال GoTo تحفظ مراجع الصفحات الفعلية وإحداثيات عشرية دقيقة محدودةً بحدود عبر مرماز التعليقات المشترك

SONAME لـ ELF وإصدار الرمز HOTPDF_1.0 يبقيان غير متغيرين، ومستهلكو C القائمون تواصلوا استخدام موصف العملية العام نفسه

الملف المخطط وواجهة API الأصلية · C ABI في Linux · عمليات بيانات النماذج

نقل مظاهر الختم القياسي يحفظ تدفقات Form الفعلية وموارد الخطوط والصور والرسوميات الحلقية المحدودة بحدود عبر XML موسوم بـ base64

عمليات رسم كائنات FDF

{"schemaVersion":1,"type":"annotations.import","format":"fdf"}

اختر format="fdf" لرسوم التعليقات الثنائية عبر موصف العملية نفسه وcallbacks بـ InputIO وOutputIO وResultIO؛ وannotations.export يكتب بايتات FDF إلى OutputIO

ملف FDF التعريفي يحفظ موارد AP وRO المورودة والكائنات غير المباشرة المشتركة ومراجع صفحات GoTo المحلية الحساسة للسياق؛ والتعليق المتطابق NM في الصفحة نفسها يحدد استبدالًا، بينما التعليقات بلا اسم أو غير المتطابقة تُلحق

استيراد FDF الناجح يبلغ annotationProfile="pdf-object-graph-v1" وعدًا صحيحًا updated؛ والعملية صفرية التحديث تحفظ بايتات PDF الملتزمة الأخيرة بدقة

يقبل annotationLimits لـ FDF أيضًا maxObjects؛ وتبقى كل الحدود مقيَّدة بالعملية المحتوية، مع إبقاء الفشل والإلغاء لضمانات معاملة callback القائمة

العمليات الخاصة بالتعليقات فقط ترفض حقول Fields غير فارغة واختلافات Differences مضمّنة؛ وبيانات action تُنقل دون تنفيذها

راجع سلوك رسم FDF وحدوده وحدود FDF الأصلية

حذف التعليقات التوضيحية

{"schemaVersion":1,"type":"annotations.remove","annotations":[{"page":0,"name":"review-note"}]}

annotations.remove يستخدم المستند الحالي أو PDF مستقلة مورودة عبر InputIO، ثم ينشر PDF إلى OutputIO وJSON إلى ResultIO قبل الالتزام بالسياق

النتيجة تبلغ removed وannotationProfile="page-and-nm-removal-v1"؛ ويقيّد annotationLimits عدد التعليقات والعمليات وبايتات الأسماء والتخزين العملي

الفشل أو الإلغاء يحفظ السياق الملتزم؛ والمستدعون يجهّزون أحواض callback بأنفسهم لأن البايتات المكتوبة سلفًا لا يمكن سحبها