التحكم في الخطوط وتنسيق النص في NextPDF Connect

لمحة سريعة

أنشئ مستندًا يضم أنماط نص متعددة بتبديل الخطوط بين كتل النص. يحدد set_font المحرف والنمط والحجم النشط. وتنطبق هذه الحالة على كل استدعاء add_text تالٍ حتى تغيّرها. تحتاج إلى create_pdf وset_font وadd_text وoutput_pdf — وكلها أدوات ⁨Core.⁩ تتحكم معاملات حالة النص في عرض المحارف الرسومية (⁨ISO 32000-2⁩ §9).

التثبيت

composer require nextpdf/server

اربط ناقلًا. يمكنك استخدام ثلاث عائلات خطوط مدمجة من دون إضافة ملفات خطوط: helvetica وtimes وcourier.

نظرة عامة مفاهيمية

يقبل set_font المعاملات family وstyle ("" أو "B" أو "I" أو "BI" أو "U") وsize. ينطبق الخط الذي تحدده على كل استدعاء add_text لاحق حتى تستدعي set_font مجددًا. لا توجد إعادة تعيين تلقائية. عندما يتضمن add_text المعامل font_size، تتجاوز هذه القيمة الحجم النشط لذلك الاستدعاء الواحد فقط. ويعود الحجم المضبوط عبر set_font في الاستدعاء التالي. يُصدَر النص بواسطة عوامل إظهار النص بترتيب دفق المحتوى (⁨ISO 32000-2⁩ §9.4). لا يتضمن add_text معامل لون. يأتي لون النص من لون حبر حالة الرسوميات في المستند.

سطح واجهة ⁨API⁩

الأداة	الدور	مستوى المخاطرة
`create_pdf`	فتح الجلسة	آمن
`set_font`	ضبط ⁨typeface/style/size⁩ النشط	احترس
`add_text`	كتابة نص بالخط النشط	احترس
`output_pdf`	عرض ملف ⁨PDF⁩ وإرجاعه	موافقة مطلوبة / مراجعة (⁨base64⁩)

كتالوج الأدوات هو الكتالوج المرجعي. تعتمد الأدوات التي يمكنك استخدامها على المستوى المثبّت.

عينة شيفرة — البدء السريع

create_pdf (⁨A4⁩ عمودي) ← document_id.
set_font (⁨helvetica⁩، B، 24) ثم add_text (العنوان، موسَّط).
set_font (⁨helvetica⁩، ""، 12) ثم add_text (متن مضبوط الحواف).
set_font (⁨courier⁩، I، 10) ثم add_text (مقتطف شيفرة).
output_pdf.

عينة شيفرة — الإنتاج

حدّد الخط صراحةً قبل كل كتلة يكون التنضيد الطباعي فيها مهمًا. لا تعتمد أبدًا على الحالة الموروثة عبر الأقسام المنطقية. استخدم تجاوز font_size لكل استدعاء للتأكيد المؤقت فقط، لأنه لا يستمر. أنشئ المستند قسمًا تلو الآخر، وتحقّق من أن كل add_text يُرجِع position.

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

عائلة غير معروفة. يُرفَض أي شيء خارج helvetica/times/courier (على سبيل المثال arial).
عائلة فارغة. يجب أن يكون family سلسلة غير فارغة.
نمط غير صالح. استخدم الرموز الكبيرة؛ يُرفَض "bold".
حجم غير موجب. يجب أن يكون size عددًا موجبًا.
الحجم على مستوى الاستدعاء مؤقت. فهو لا يغيّر حالة set_font.

الأداء

تضيف الخطوط المدمجة وزنًا لا يُذكَر، ويكون حجم المخرجات بضعة ⁨KB.⁩ السمة هي structural.

ملاحظات أمنية

لا يترتب على وضع ⁨base64⁩ أي أثر جانبي على نظام الملفات. لا تستقبل الخطوط المدمجة ملفات خطوط خارجية، لذا لا يوجد لهذه الوصفة سطح هجوم لتحليل الخطوط.

المطابقة

العبارة	المواصفة	البند	⁨reference_id⁩
يُظهَر النص بواسطة عوامل النص بترتيب الدفق.	⁨ISO 32000-2⁩	§9.4
تتحكم معاملات حالة النص في عرض المحارف الرسومية.	⁨ISO 32000-2⁩	§9

السياق التجاري

غير قابل للتطبيق — جميع الأدوات ⁨Core.⁩

توفّر النواقل

الناقل	متوفّر	ملاحظات
⁨MCP⁩ (⁨stdio⁩)	نعم	`tools/call` لكل أداة.
⁨REST⁩	نعم	عملية واحدة لكل أداة.
⁨gRPC⁩	نعم	استدعاء أحادي لكل أداة.

مستوى مخاطرة ⁨HITL⁩

create_pdf آمن؛ set_font/add_text احترس؛ output_pdf موافقة مطلوبة، وتنخفض إلى مراجعة في وضع ⁨base64⁩ (مستويات مخاطرة ⁨HITL⁩).

غلاف ⁨JSON⁩ لبوابة التأكيد

مخرجات ⁨base64⁩:

{ "allowed": true }