THPDFHeadlessDocument

HPDFHeadlessDocument تزوّد واجهة مستندات تزامنية لـ Linux وWindows الأصليين مستخدمةً محلل كائنات HotPDF القائم ومساعدات Direct File ومفككات الخطوط ومفسّر المحتوى ومفككات الفلاتر وكاتب xref

محمل المستند يقبل جداول مراجع متقاطعة كلاسيكية ومسارات xref ومقاطع xref هجينة وسلاسل Prev تزايديّة وكائنات مباشرة ومضغوطة وموارد صفحات موروثة ومصفوفات محتوى وForm XObjects وأشجار حقول AcroForm

مسارات الجانب الهجينة تتقدم على الجدول المرافق، والمراجعات الأحدث تتقدم على الأقدم؛ وأعضاء مسارات الكائنات تفك وتُحلل كسولةً عبر محلل الكائنات المشترك

دورة الحياة والملكية

Create تستخدم THPDFHeadlessDocumentOptions.Default، بينما التحميل ذو الخيارات يقبل ميزانيات صريحة وtoken إلغاء مملوكًا للمستدعي

LoadFromFile تغلق المستند السابق وتفتح المصدر للقراءة فقط وتحمّل الرسم البياني الحالي للكائنات وتغلق الحالة الجزئية عند الفشل؛ وClose تحرر المصدر وكل الكائنات المحمَّلة

LoadFromFile(FileName, Password) تصادق مستندات Standard AES-256 بقيمة R5 أو R6 عبر THPDFHeadlessAES256Security; والتحميل الأصلي بوسيط واحد يستخدم كلمة سر فارغة

كلمات سر المستخدم يجب أن تمنح استخراج النص أو تعبئة النماذج قبل تنفيذ تلك العمليات، بينما كلمات سر المالك تتجاوز قيود أذونات المستخدم؛ وكلمات السر الخاطئة وعدم تطابق Perms المصادق والعمليات المرفوضة وحمولات الشفرة المشوهة لها تشخيصات مستند مميزة

السلاسل والمسارات المباشرة تفك تشفيرها بالشيفرة التشفيرية المشتركة والأعضاء المضغوطة تفك مع حاويتها فقط، والبدائل التزايديّة المشفرة تبقى مشفرة بالمفاتيح وسياسة الأذونات الأصلية

كلمات السر بايتات UTF-8 مقصوصة عند 127 بايتًا بلا تطبيع SASLprep؛ والمعالجات غير المدعومة وفلاتر Crypt الصريحة وسياسات PDF MAC تُشخَّص بدلًا من تجاهلها

مفاتيح القواميس المرمَّزة وأسماء الموارد تفك قبل الاستخدام وتبقى الحالة مهمة والمفاتيح المفكوكة المكررة تُرفض؛ وأعلام الحقول وMaxLen يجب أن تتسعا في نطاق 32-بت غير سالب مدعوم

النسخ ليست آمنة الخيوط؛ استخدم نسخة واحدة لكل عامل وأبقِ token إلغائها حيًا حتى يُهلك الكائن

الصفحات والنص

PageCount تبلّغ عدد أوراق شجرة الصفحات؛ وExtractPageText(PageIndex) تقبل فهرسًا ذات أساس صفري وتعيد نص Unicode مجمعًا من مفسّر المحارف الرسومية المشترك

ExtractPageTextBounded تطبق حدود محارف ومسارات مؤقتة قبل تحضير النص وتستعيد كل خيارات الموارد الأصلية بعد النجاح أو الفشل أو الإلغاء

GetObjectAccess تكشف الوصول للكتالوج والمعلومات والكائنات المستعار للقراءة فقط بتخصيص فهرس محدود السقف لـ المقارنة البنيوية والكاملة الأصلية

فك النص يتبع ترميزات الخطوط واختلافات الترميز وخرائط ToUnicode المضمّنة والعروض الصريحة ومزوّد قياسات الخطوط القياسية؛ وForm XObjects المتداخلة تطبق مصفوفاتها وتستخدم قواميس مواردها الخاصة أو الموروثة

fallback الخطوط القياسية على Linux يتطلب Fontconfig وخطوط TrueType مثبتة؛ وخطوط المستندات المعقدة يجب أن تزوّد استراتيجية فك مدعومة والموارد الخطية المفقودة تنتج تشخيصًا

AppendPageText تضيف نص Unicode مرئيًا أو خفيًا ملائمًا مع حفظ محتوى الصفحة الأصلي وسياسات الأمان المشفرة

AppendImportedPages تستنسخ رسوم موارد الصفحات المنتقاة والهندسة الموروثة ومظاهر عادية مرئية مع حفظ مراجعات الوجهة القائمة وسياسة التشفير المصادق عليها

قيم نص AcroForm

FormFieldCount وGetFormField(FieldIndex) وFindFormField(Name) تعدّ الحقول الطرفية بأسماء مؤهلة كاملةً وأنواع حقول موروثة وأعلامًا وأطوالًا قصوى وقيمًا؛ والفهارس ذات أساس صفري والاسم المفقود يعيد -1

SetTextFieldValue(FieldIndex, Text) تقبل حقول Tx قابلة للكتابة وتكتب سلسلة PDF بترميز UTF-16BE وتضبط NeedAppearances=true على قاموس AcroForm

هذا الأسلوب للقيمة فقط يعتمد على إعادة توليد العارض؛ والعارضات التي لا تعيد توليد المظاهر قد تواصل عرض مظهر قديم أو widget فارغًا

SetTextFieldValueWithAppearance تولّد مظاهر Unicode صريحة لكل widget قائم مستخدمةً خط TrueType من المستدعي وقياسات محارف فعلية وترميز Identity-H وToUnicode وتضمين FontFile2 كاملًا

ملف المظهر يدعم النص أحادي السطر والمتعدد والالتفاف وخلایا comb ودورانات ربع الدورة وحجمًا ثابتًا أو auto-fit ومحاذاة وتشكيلًا معقدًا اختياريًا بـ HarfBuzz/FriBidi أصليًا

SetChoiceFieldValuesWithAppearance تعالج صناديق قوائم متعددة الانتقاء وخيارات موروثة ومصفوفات تصدير مرتبة وكل صف مختار مرئيًا؛ والمساعد أحادي القيمة يدعم أيضًا تسميات تصدير/عرض للـ combo

GetChoiceFieldValues تقرأ مصفوفة التصدير المختار كاملةً؛ وSetButtonFieldValueWithAppearance وSetPushButtonAppearance تولّدان حالات أزرار وcaptions فعلية

كائنات ومسارات المظاهر الجديدة محدودة السقف قبل تغييرات الحقول وتبقى مشفرة تحت سياسة أمان AES الأصلية عند الحفظ؛ وCairo الأصلي على Linux والقراء المستقلون يستهلكون نفس الكائنات المولَّدة

الحقول للقراءة فقط والقيم الأطول من MaxLen بوحدات UTF-16 code وغير حقول النص ونماذج XFA والحقول الموقَّعة وأذونات مستند مُصدَّق تُرفض للتحرير

المستندات الموقَّعة تستخدم سياسات DocMDP وFieldMDP مصادقًا عليها: تحديثات النماذج المسموحة تحفظ المراجعات الموقَّعة القائمة، بينما الحقول المقفلة وقيود P1 ومحاولات الكتابة فوق حقول التواقيع الموقَّعة تُرفض

أدلة DSS/VRI متحققًا منها تضيف شهادةً وبيانات إبطال مصادقًا عليها إلى مراجعة تزايديّة دون تغيير تواقيع ByteRange القائمة

التحقق من التواقيع

SignatureCount تعدّ حقول توقيع AcroForm الموقَّعة وVerifySignature(SignatureIndex, Options) تتحقق من تواقيع ذات أساس صفري مستخدمةً المحلل المشترك ومزوّد OpenSSL 3 متدفقًا لـ CMS

ملف PDF يقبل adbe.pkcs7.detached وETSI.CAdES.detached المعروف تلقائيًا بمحتويات Contents سداسية عشرية أو حرفية قياسية؛ وCAdES تصادق دائمًا على ربط شهادة التوقيع بـ ESS بينما تقيّم إعدادات CA الصريحة الثقة منفصلةً

DocTimeStamp بقيمة ETSI.RFC3161 تصادق تلقائيًا على TSTInfo مغلفة حقيقيةً وESS وغرض TSA واسم الموقّع والبصمة الدقيقة للـ PDF؛ وجذور الطوابع الزمنية المهيأة وCRLs تقيمان ثقة TSA منفصلةً

التحقق يتأكد من الفجوة غير الموقَّعة الدقيقة بما يشمل محدديها ويربط بايتاتها المفكوكة بقاموس التوقيع الحالي قبل التحقق التشفيري

النتيجة تميز السلامة وثقة CA المقيمة صراحةً والبايتات غير الموقَّعة بعد المراجعة المصادق عليها؛ وملفات تواقيع PDF غير المدعومة تنتج تشخيصًا مكتوب النوع

انظر HPDFVerifyHeadlessCMS لمتطلبات runtime وTHPDFHeadlessCMSOptions للميزانيات وإعدادات الثقة

تواقيع الاعتماد التزايديّة

SignToFile توقّع حقل Sig قائمًا قابلًا للكتابة غير موقَّع وتنشر PDF محدَّثًا تزايديًا مستقلًا باستخدام شهادة PEM من المستدعي ومفتاح خاص PEM غير مشفر

AddSignatureField تنشئ widget صفحة وروابط AcroForm الخاصة بها، بما يشمل AcroForm جديدة على PDF مستوردًا عاديًا؛ وSetSignatureFieldAppearance تولّد caption مرئيًا وSignPFXToFile تحمّل هوية شهادة/مفتاح PKCS12 بسلسلتها

CertificationPermission تنشئ أول توقيع تصديق DocMDP؛ وP2 وP3 تسمحان تواقيع اعتماد لاحقة في حقول قائمة بينما P1 ترفض التواقيع الإضافية

بايتات المصدر الأصلية والرسم البياني المحمَّل للكائنات يبقيان دون تغيير؛ وتواقيع الاعتماد اللاحقة تحفظ بايتات التواقيع السابقة وحدود مراجعاتها المصادق عليها

تشفير Standard AES-256 بقيمة R5 وR6 وكلمات السر والمعرّفات والأذونات تبقى سارية، بما يشمل مصادر مسارات كائنات مشفرة؛ وسلسلة Contents للتوقيع تتبع الإعفاء من التشفير في PDF

قيم التواقيع القائمة والحقول للقراءة فقط وسياسات مستند مُصدَّق وأذونات تعبئة نماذج مرفوضة وtokens إلغاء متفارقة وميزانيات مخرجات مستنفدة تُرفض دون نشر مخرج

طوابع المستندات الزمنية

TimestampToFile تنشئ طابعًا زمنيًا حقيقيًا للمستند بـ RFC 3161 في حقل توقيع قائم غير موقَّع دون مفتاح توقيع تطبيقي، بناقلة TSA مملوكة للمستدعي وثقة TSA صريحة

الكاتب يحفظ المراجعات الأصلية وأمان AES ويعلن امتداد ESIC لإدخال قبل PDF 2.0 وينشر ذريًا فقط بعد اجتياز فحوص nonce والبصمة والتوقيع والشهادة والإبطال المهيأ وseed

تغييرات الطوابع الزمنية للمستند المصادق عليها الضرورية مسموحة تحت DocMDP وFieldMDP؛ وتعديلات النماذج العادية وتواقيع الاعتماد تحفظ قيودها الأصلية

تبادل نماذج FDF وXFDF

ExportAnnotationsFDF تصدّر رسوم كائنات تعليقات محدودة السقف وموارد مظهرها المشتركة؛ وSaveAnnotationsFDFToFile تجهّز استبدالات مسماة وتُلحق في مراجعة PDF ذرية مستقلة

يحفظ الملف التعريفي الثنائي لتعليقات FDF سياسة تشفير وتوقيع المستند المصادَق عليه ومراجع صفحات GoTo المحلية الحساسة للسياق ونشرًا دون تغيير بدقة؛ ويترك المستند المحمَّل دون تغيير بعد الحفظ

SaveAnnotationsXFDFToFile تُلحق تعليقات مُخططة محدودة السقف بمراجعة تزايديّة مستقلة؛ وHPDFExportHeadlessAnnotationsXFDF تعيد بايتات XFDF الخاصة بها

ExportFormData تعيد بيانات حقول Unicode محدودة السقف، بما يشمل مصفوفات اختيار فعلية وحالات تصدير checkbox أو radio

ImportFormDataToFile تعيد توليد مظاهر حقيقية على رسم بياني لمراجعة خاصة مصادقًا عليه وتنشر PDF تزايديًا ذريًا مع حفظ حالة المصدر المحمَّل

ImportRichFormDataToFile تستورد ملف XHTML المحدود السقف من RV في FDF أو value-richtext في XFDF ببرامج خطوط regular وbold وitalic وbold-italic فعلية

SaveRichTextFieldUpdatesToFile تطبق حقول scalar ومسارات rich مكتوبة النوع أصلية في مراجعة ذرية مستقلة واحدة محفظةً برامج الخطوط الفعلية ودقة أعداد PDF؛ والحقول المحمية دون تغيير تتطلب مظاهر مفكوكة مطابقة وموارد محلولة لكل widget

التشفير القائم وأعلام القراءة فقط وDocMDP وFieldMDP المصادق عليهما والتواقيع الأصلية والإلغاء وميزانيات الموارد تبقى مفروضة؛ انظر بيانات نماذج FDF وXFDF الأصلية للصياغة المدعومة وحدود تبادل scalar

وصول التصيير المستعار

GetRenderAccess(PageIndex) تزوّد قاموس الصفحة القائم والموارد الموروثة وحل الخطوط وحل الكائنات وفحص الأذونات وtoken الإلغاء وcallbacks مسارات مفكوكة محدودة السقف عبر THPDFHeadlessRenderAccess

هذا مشهد مستعار مسلسل للقراءة فقط؛ والمستند يجب أن يبقى محمَّلًا ودون تغيير حتى ينتهي المُصيِّر وعلى المستدعين عدم تحويل رسمه البياني المكشوف للكائنات

callback RequireOutputPath للمشهد يفحص مخرجًا محتملًا مقابل المسار المقنّن للمصدر وهوية ملفه الفيزيائية دون إنشاء أو تعديل ملف

مخرجات مستقلة

ExtractPageGlyphs تعيد محارف رسومية موجَّهة عبر الجالب المتداخل للمحتوى المحدود السقف؛ وAnalyzePageSemanticText تزوّد نصًا دلاليًا وهندسة مصدر لـ المقارنة التعاقدية الأصلية

SaveToFile(FileName) تنسخ البايتات الأصلية وتُلحق قيم كائنات بديلة وجدول xref كلاسيكيًا ومقطعًا مرتبطًا عبر Prev; وأعضاء الكائنات المضغوطة تجسد كائنات مباشرة في المراجعة الملحقة وبايتات المسارات الأصلية محفوظة

المخرج يجب ألا يعيد استخدام مسار المصدر أو هوية ملفه؛ والكتابة تستخدم ملف staging منشأًا حصريًا في مجلد الوجهة وتفرغه وتنشره بإعادة تسمية ذرية

فشل ميزانية أو إلغاء أو تسلسل يحفظ وجهة قائمة ويحذف ملف staging غير المنشور؛ والمصدر يبقى للقراءة فقط

PDF مراجعة مشروحة أصلي يصدّر إبرازات Unicode فعلية ومظاهر مرئية بأذونات تعليقات مصادق عليها محفظًا المستند المحمَّل الأصلي ومراجعات التواقيع

حدود الصيغة

الملف الحالي يدعم تشفير Standard AES-256 بقيمة R5 وR6 ويشخّص صراحةً معالجات أمان وفلاتر مسارات غير مدعومة ويرفض أجيال كائنات حرة متقادمة لا يستطيع كاتبها تمثيلها

مسارات xref التمهيدية تتطلب قيم قواميس مباشرة وLength مباشرةً محدودة السقف؛ والعروض المشوهة وتداخلات الأقسام الفرعية وإزاحات غير موقَّعة فوق Int64 وعدم تطابق أعضاء مضغوطين وحلقات مراجع والحدود المهيأة تنتج تشخيصات مكتوبة النوع

المحتوى المفكوك يدعم فلاتر Flate وASCIIHex وASCII85 وLZW بمتنبئات مدعومة وأطوال مسارات غير مباشرة؛ وحمولات الصور لا تفك لاستخراج النص

سير عمل التوقيع الأصلي يغطي حقول التواقيع والمظاهر المرئية والتصديق؛ وسياسات النماذج الموقَّعة المصادق عليها وواجهات الطوابع الزمنية والتحقق طويل الأمد تحفظ خيارات سلامتها وثقتها الصريحة

القبول

عائلات الخطوط الغنية المسمّاة تضيف عائلات مقدَّمة فعلية متعددة عبر SetRichTextFieldValueWithFamilies وImportRichFormDataWithFamiliesToFile بسياسات الحقول والأمان والمعاملات القائمة

حقول rich-text الأصلية تزوّد مسارات منسقة مكتوبة النوع ومظاهر خطوط أنماط مضمّنة فعلية وقيم V وRV متزامنة ومخرجًا تزايديًا مشفرًا وتعديلات transactional محدودة السقف؛ وGetRichTextFieldValue تقرأ XHTML مخزنًا أو موروثًا

Tests/Linux/Run-HeadlessDocumentTests.sh يبني ملفًا تنفيذيًا ELF أصليًا بمتغيرات سطح مكتب ممسوحة ويفحص اعتماديات مكتبات GUI؛ وRun-HeadlessDocumentTests-Windows.cmd Win32 وWin64 تمارسان واجهة المستند المشتركة نفسها

انظر THPDFHeadlessFormField وEHPDFHeadlessDocumentError وTHPDFHeadlessDiagnosticCode للقيم المعادة والتشخيصات المكتوبة النوع

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

احذف تعليقات الصفحة بهوية الصفحة واسم Unicode الدقيقين عبر SaveAnnotationRemovalsToFile، مع سلاسل popup وردود متتالية وتجهيز محدود السقف ومخرج منفصل ذري

يبقى المستند المحمَّل دون تغيير؛ والانتقاء دون تغيير ينسخ المراجعة الحالية بدقة، والإزالة التزايدية تحتفظ بالبايتات التاريخية