1. المنتجات
  2.   Aspose.Page
  3.   Aspose.Page FOSS for Python

Aspose.Page FOSS لـ Python

مكتبة Python مجانية، MIT-licensed لتصدير مستندات PS و EPS و XPS كملفات PDF وصور نقطية. لا يلزم Office.

Aspose.Page FOSS for Python Aspose.Page FOSS
for Python

توثيق GitHub

مكتبة Python مفتوحة المصدر لتحويل PS و EPS و XPS

Aspose.Page FOSS لـ Python هو مكتبة مجانية ومفتوحة المصدر لتحويل PostScript (PS)، ملفات Encapsulated PostScript (EPS) و XPS في تطبيقات Python. قم بتثبيتها باستخدام أمر pip install aspose-page-foss واحد وابدأ تصدير المستندات إلى PDF و صور نقطية بدون أي تبعية لوقت تشغيل أو نظام مملوك.

تُظهر المكتبة واجهة برمجة تطبيقات نظيفة مبنية حول PsDocument و XpsDocument. حمّل مستندًا. مع from_file() أو from_bytes()، ثم استدعِ to_pdf() للحصول على تدفق بايتات PDF، أو to_image() مع كائن ImageSaveOptions لتصوير إلى PNG أو JPEG بدقة DPI محددة. يُظهر خادم MCP اختياري ps_to_pdf، ps_to_image، xps_to_pdf، وxps_to_image. كأدوات تحويل عن بُعد باستخدام FastMCP.

لأن المكتبة لا تعتمد على مكتبات Office الأصلية أو Ghostscript، فإنها تعمل بنفس الشكل على Windows, Linux, و macOS, بما في ذلك مشغلات CI وحاويات Docker. The قاعدة الشيفرة مرخصة بموجب رخصة MIT ومستضافة على GitHub. المطورون الذين يحتاجون إلى واجهة برمجة التطبيقات التجارية الكاملة يمكنك استخدام Aspose.Page لـ Python إلى جانب هذه الموارد المفتوحة المصدر. لعائلة منتجات المؤسسة، راجع Aspose.Page — Enterprise Product Family.

تحويل مستندات PS و EPS

  • PS to PDF: استدعِ PsDocument.from_file() ثم to_pdf() لتصدير المستند كمصفوفة بايت PDF.
  • EPS to PDF: PsDocument.from_file() يقبل كلًا من امتدادات الملف .ps و .eps.
  • PS/EPS إلى صورة: مرّر ImageSaveOptions(format="png", dpi=150) إلى to_image() للحصول على إخراج PNG أو JPEG.
  • المعالجة داخل الذاكرة: جميع التحويلات تُعيد bytes — لا حاجة لملفات مؤقتة.
  • من البايتات: استخدم PsDocument.from_bytes() لمعالجة بيانات PS/EPS من تدفق شبكة أو تحميل.

أين يُستخدم تحويل PS/EPS

  • قنوات المستندات: تصدير تقارير PostScript القديمة إلى PDF للأرشفة أو التوزيع.
  • Print workflows: تحويل مخرجات PS من برامج تشغيل الطباعة إلى معاينات PDF أو الصور.
  • معالجة أصول EPS: تحويل رسومات EPS إلى PNG للاستخدام على الويب أو في الوثائق.
  • أتمتة الدُفعات: معالجة الأدلة التي تحتوي على ملفات PS/EPS في CI أو وظائف cron دون واجهة رسومية.

تحويل مستندات XPS

  • XPS to PDF: استدعِ XpsDocument.from_file() ثم to_pdf() لتصدير ملف XPS كمصفوفة بايت PDF.
  • XPS إلى صورة: استدعِ to_image() مع ImageSaveOptions لتحويل صفحات XPS إلى PNG أو JPEG.
  • من البايتات: استخدم XpsDocument.from_bytes() لبيانات XPS في الذاكرة من التحميلات أو التدفقات.
  • الوصول إلى الصفحة: استخدم add_page()، get_page()، وremove_page() للعمل مع الصفحات الفردية.
  • قراءة حزمة XPS: استخدم XpsPackage.from_file() لتفقد أجزاء حزمة XPS الخام.

أين يُستخدم تحويل XPS

  • Windows print spool: تصدير ملفات XPS spool من نظام الطباعة في Windows إلى PDF أو صورة.
  • أرشفة المستندات: تحويل ملفات XPS إلى PDF يمكن قراءتها عالميًا للتخزين طويل الأمد.
  • إنشاء المعاينة: تحويل صفحات XPS إلى صور مصغرة PNG لأنظمة إدارة المستندات.
  • استخدام متعدد المنصات: معالجة ملفات XPS على خوادم Linux و macOS حيث لا تتوفر عارضات أصلية.

خادم MCP للتحويل عن بُعد

  • كشف الأدوات: create_server() يسجل ps_to_pdf، ps_to_image، xps_to_pdf، وxps_to_image كأدوات MCP عبر FastMCP.
  • بيانات تعريف EPS: الأداة eps_metadata تستخرج صندوق الحدود وحقول رأس DSC من ملفات EPS.
  • أنواع الإدخال/الإخراج: McpInput يقبل مسار ملف أو بايتات مشفرة بقاعدة64; McpOutput يُعيد بايتات base64 أو يكتب إلى مسار.
  • خيارات التحويل: McpConversionOptions يتحكم في تنسيق الإخراج و DPI لتحويلات الصور.
  • الاعتماد الاختياري: FastMCP مطلوب فقط لاستضافة خادم MCP؛ التحويل الأساسي يعمل بدونه.

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

  • خطوط أنابيب الوكيل الذكي: كشف تحويل المستندات كأداة يمكن استدعاؤها بواسطة Claude أو وكلاء آخرين متوافقين مع MCP.
  • Microservices: تشغيل خدمة تحويل خفيفة الوزن تقبل PS/EPS/XPS عبر HTTP.
  • ملحقات IDE: عرض وظيفة التحويل للمحررات التي تدعم خوادم أدوات MCP.
  • أتمتة سير العمل: دمج التحويل في n8n أو منصات أتمتة منخفضة الكود المشابهة.

نموذج العرض وإخراج PDF

  • RenderModelBuilder: بناء RenderDocument باستخدام begin_page()، add_path()، add_text()، add_image()، وend_page().
  • PdfWriter: مرّر كائن PdfMetadata واستدعِ write(doc) لإنشاء مصفوفة بايت PDF من أي RenderDocument.
  • PdfMetadata: تعيين الحقول title، creator، producer، creation_date و trapped في ملف PDF الناتج.
  • RasterRenderer: تحويل RenderDocument إلى RasterSurface؛ الترميز باستخدام encode_png() أو encode_bmp().
  • ترميز Unicode: طبقة إخراج PDF تكتب نص Unicode متعدد النصوص بما في ذلك CJK والسيريلية.

حالات استخدام العرض منخفض المستوى

  • إنشاء PDF مخصص: بناء صفحات باستخدام مسارات متجهة، نص، وصور دون ملف وسيط PS/XPS.
  • اختبار بدقة البكسل: استخدم RasterRenderer لتوليد المستندات ومقارنة مخرجات البكسل في الاختبارات الآلية.
  • تضمين الخط: تضمين خطوط TrueType باستخدام FontResolver و build_embedded_font() للحصول على عرض صحيح.
  • إدارة الألوان: تطبيق كائنات Paint مع مساحات ألوان DeviceRGB أو المستندة إلى CIE على المسارات والنص.

تحويل PS إلى PDF

استدعِ PsDocument.from_file() للوصول إلى ملف PostScript واستدعِ to_pdf() لتصديره كتيار بايت PDF.

from pathlib import Path
from aspose.page.ps.document import PsDocument
ps = PsDocument.from_file("input.ps")
output_pdf = ps.to_pdf()
Path("output.pdf").write_bytes(output_pdf)

تحويل EPS إلى PNG

تتعامل الفئة PsDocument نفسها مع ملفات EPS. مرّر ImageSaveOptions مع الصيغة المطلوبة و DPI إلى to_image().

from aspose.page.ps.document import PsDocument
from aspose.page.ps.output import ImageSaveOptions
eps = PsDocument.from_file("input.eps")
output_png = eps.to_image(ImageSaveOptions(format="png", dpi=150))
with open("output.png", "wb") as f:
    f.write(output_png)

تحويل XPS إلى PDF

استدعِ XpsDocument.from_file() للوصول إلى مستند XPS واستدعِ to_pdf() لتصديره كتيار بايت PDF.

from pathlib import Path
from aspose.page.xps.document import XpsDocument
xps = XpsDocument.from_file("input.xps")
output_pdf = xps.to_pdf()
Path("output.pdf").write_bytes(output_pdf)

الأسئلة الشائعة

ما الرخصة التي يستخدمها Aspose.Page FOSS لـ Python؟

Aspose.Page FOSS لـ Python يتم إصداره تحت رخصة MIT، مما يسمح بالاستخدام في التطبيقات التجارية والملكية.

هل هناك أي تبعيات أصلية؟

لا. المكتبة لا تعتمد على Ghostscript أو Adobe Reader أو أي بيئة تشغيل أصلية. تعمل على Windows وLinux وmacOS.

ما صيغ الإدخال التي تدعمها المكتبة؟

المكتبة تقرأ ملفات PostScript (.ps) وEncapsulated PostScript (.eps) وXPS (.xps).

ما هي صيغ الإخراج التي ينتجها المكتبة؟

المكتبة تصدر إلى PDF عبر to_pdf() وإلى صور نقطية PNG أو JPEG عبر to_image() باستخدام ImageSaveOptions.

هل يمكنني معالجة الملفات في الذاكرة دون عمليات إدخال/إخراج على القرص؟

نعم. استخدم from_bytes() للتحميل من بايتات خام والبايتات المعادة من to_pdf() أو to_image() مباشرةً دون كتابة ملفات.

  

الدعم وموارد التعلم

 العربية