THotPDF.BuildLoadedPageSVG Method

يبني مستند SVG مستقلًا من صفحة PDF المحمَّلة المحددة

التصريح

function BuildLoadedPageSVG(PageIndex: Integer): AnsiString; overload;
function BuildLoadedPageSVG(PageIndex: Integer;
  EmbedFonts: boolean): AnsiString; overload;

الوحدة

HPDFDoc

المعاملات

القيمة المُعادة

تُعيد مستند SVG كاملاً، أو سلسلة فارغة عندما يتعذّر تصدير الصفحة

ملاحظات الاستخدام

• تُصدَر المسارات، والنص المفكوك الترميز، وعناصر الصورة XObject، والصور المضمَّنة (inline)، وعناصر Form XObject التكرارية عبر مفسِّر جهاز المحتوى المشترك؛ وتبدأ Form XObject بالألوان السائدة في الموضع الذي تُرسم فيه
• تغطي اللوحة الجزء المرئي من الصفحة، أي /CropBox مقصوصًا على /MediaBox (انظر GetLoadedPageVisibleBox)، بعد تطبيق /Rotate؛ وتقابل زاوية الصندوق السفلية اليسرى زاوية اللوحة حتى عندما لا يبدأ الصندوق من نقطة الأصل
• يُكتب النص بصيغة UTF-8 مع موضع x واحد لكل محرف ومع xml:space="preserve"، فتبقى المسافات محفوظة؛ محارف الليغاتشر تتوسع إلى كل المحارف التي تمثلها، والرموز التي لا يقبلها XML 1.0 تصبح U+FFFD
• يتبع وضع النص مصفوفة النص الكاملة، بما في ذلك تباعد الأحرف وتباعد الكلمات والتحجيم الأفقي والرفع وتعديلات TJ؛ أنماط العرض من 0 إلى 2 تعبئة أو حدود أو كلاهما، والنمط 3 لا يرسم شيئًا، ومحارف النص المعروض بالأنماط من 4 إلى 7 تصبح أيضًا مسار قص من نهاية كائن النص (ET) إلى نهاية الحالة الرسومية
• بشكل افتراضي يستخدم النص الخطوط المثبتة: عائلات الـ 14 القياسية ونظيراتها من TrueType تقابل Helvetica أو Arial وTimes New Roman وCourier New، وتُسمّى الخطوط الأخرى باسم عائلتها، مع الفراغات بين كلماتها أيضًا (MyriadPro, Myriad Pro)، يليها عائلة عامة تُؤخذ من أعلام واصف الخط أو من الاسم. ويحصل النص الغامق والمائل على font-weight وfont-style من جزء النمط في اسم الخط (Arial-BoldMT وHelvetica-Oblique وMinionPro-It) ومن الوزن والأعلام وزاوية الميل في واصف الخط
• عند ضبط EmbedFonts على True، يُرسم النص الذي برنامجُ خطه TrueType أو CFF مضمَّن في PDF من المسارات المحيطية لمحارف البرنامج. ويُعرَّف كل محرف مرة واحدة كـ <path> داخل <defs> ويوضع بـ <use> أينما ورد، فلا يُكرِّر تكرار المحارف مساراتها المحيطية؛ وتتبع أنماط التعبئة والتحديد وسمك الخطوط وقص النص النصَ كما هو الحال في نص SVG. ويُحفظ النص نفسه كنص SVG شفاف فوق المسارات المحيطية، فيظل قابلًا للتحديد والبحث والقراءة عبر تقنيات المساعدة
• الخطوط غير المضمَّنة، وبرامج خطوط Type 1 (/FontFile)، والكتابة العمودية للغات CJK، والمقاطع التي تحمل رمزًا لا محرف له في البرنامج المضمَّن تبقى نص SVG حتى مع ضبط EmbedFonts. وتكبّر المسارات المحيطية حجم الملف، وغالبًا إلى ضعفين أو ثلاثة أضعاف للصفحات الغزيرة بالنص
• ألوان التعبئة والتحديد المضبوطة في أي فضاء لوني (DeviceGray وDeviceRGB وDeviceCMYK وICCBased وcalibrated وLab وIndexed وSeparation وDeviceN) تُحوَّل إلى sRGB كما يحوّلها عارض الصفحات
• المسارات المعبأة بنمط بلاطي (tiling pattern) تُعبأ بـ <pattern> في SVG يكرر خلية النمط عند كل XStep وYStep مقصوصة على /BBox؛ والأنماط غير الملونة تُرسم الخلية باللون المعطى مع النمط. والمسارات المعبأة بنمط تظليل تأخذ التدرج أو الشبكة الخاصة بتظليله مقصوصة على المسار. وتُطبَّق مصفوفة النمط في فضاء الصفحة، أو فضاء الـ form الذي يستخدم النمط. والحدود المرسومة بنمط تستخدم لونه، وأسود للأنماط الملونة
• التظليلات المحورية من Type 2 والشعاعية من Type 3 تستخدم تدرجات SVG بنقاط توقف مُعاينة محدودة العدد؛ الطرف الذي لا يمدّه Extend يبقى دون رسم، كما في PDF
• تظليلات الشبكة من Type 4 إلى Type 7 تستخدم data URI بصيغة PNG شفافة ومحدودة بحد أقصى 16 مليون بكسل
• تفك الصور المضمنة عبر مسار صور المستند المحمّل نفسه وتضمَّن كـ data URIs بصيغة PNG
• أقنعة الصور، المضمَّنة منها كذلك، تصبح صور PNG بلون التعبئة الحالي تكون شفافة حيث لا يُرسم شيء؛ وتمنح قوالب /SMask و/Mask الصورة قناة ألفا، بدقة القناع عندما تكون أدق من الصورة. مصفوفات /Mask القائمة على مفاتيح اللون تجعل البكسلات المطابقة شفافة في صور Flate وLZW وغير المفلترة
• مسارات القص W وW* تصبح عناصر <clipPath> في SVG تنتهي مع الحالة الرسومية التي ضُبت فيها؛ وتُقص عناصر Form XObjects على /BBox الخاصة بها، وكذلك التظليلات المحورية والشعاعية على حدودها
• يُرسم نص خطوط Type 3 بإجراءات محارف الخط موضوعًا عبر /FontMatrix الخاص به بدل نص SVG؛ والمحارف التي تبدأ بـ d1 تُرسم بلون التعبئة الحالي. ولا تضيف محارف Type 3 إلى مسار القص لأنماط العرض من 4 إلى 7
• لون Background للتظليل يملأ مساحة نمط التظليل قبل التظليل، فيظهر حيثما لا يرسم التظليل؛ وكما في PDF يُتجاهل عندما يُرسم التظليل بـ sh
• تُعاين التظليلات القائمة على دالة Type 1 فوق Domain الخاصة بها في data URI بصيغة PNG يصل إلى 256×256 عينة، توضع عبر Matrix الخاصة بالتظليل؛ ويمهّدها العارض عند تحجيمها

واجهات برمجة التطبيقات ذات الصلة

• THotPDF
• THPDFPage
• المحتويات