مقدمة
Aspose.Page FOSS for Python is a free, open-source library for converting PostScript (PS), وثائق PostScript (EPS) و XPS المغطاة إلى PDF وصور الرستير في Python التطبيقات. يتم توزيعه تحت ترخيص MIT ويتم الحصول عليه على PyPI كـ aspose-page-foss.
توفر المكتبة فئتين من الوثائق العليا: PsDocument لملفات PS و EPS،, و XpsDocument لملفات XPS. كلا الفئتين تعرضان to_pdf() و to_image() الطرق التي تعيد المصفوفات بايت، مما يجعلها سهلة لدمجها في معالجة الملفات بدون كتابة ملفات مؤقتة.
ولأن المكتبة لا تعتمد على Ghostscript أو Adobe Reader ، أو أي وقت تشغيل Office الأصلي ، فإنها تعمل على Windows و Linux و macOS بما في ذلك مشغلات CI وحاويات Docker. يمكن للمطورين الذين يحتاجون إلى واجهة برمجة التطبيقات التجارية الكاملة مع ميزات العرض المتقدمة الاستمرار في استخدام منتج Enterprise Aspose. الصفحة لـ Python جنباً إلى جنب مع هذه الأدوات العامة مفتوح المصدر.
ما هو مدرجة
تحويل PS و EPS إلى PDF
PsDocument يتعامل مع كل من PostScript (.ps) و PostScript المغطاة (.epsملفات) عبر نفس واجهة الطبقة. PsDocument.from_file() لتحميل المستند، ثم دعوة to_pdf() للحصول على النتيجة كصفحة بايت PDF.
from pathlib import Path
from aspose.page.ps.document import PsDocument
ps = PsDocument.from_file("input.ps")
pdf_bytes = ps.to_pdf()
Path("output.pdf").write_bytes(pdf_bytes)
المجلس الوزاري from_bytes() طريقة الطبقة تقبل بايتات خام، لذلك الوثائق التي تصل من الشبكة يمكن معالجة التدفقات أو تحميل الملفات دون الكتابة إلى القرص أولاً.
PS و EPS إلى صورة راستر
لتصوير وثيقة PS أو EPS إلى صورة PNG أو JPEG، تمر بـ ImageSaveOptions مثال إلى to_image(). ضعوا المكالمة format الممتلكات إلى "png" أو "jpeg" و المادة الثانية: dpi العقارات لتحكم بقراره الخارجي.
from aspose.page.ps.document import PsDocument
from aspose.page.ps.output import ImageSaveOptions
eps = PsDocument.from_file("input.eps")
opts = ImageSaveOptions(format="png", dpi=150)
png_bytes = eps.to_image(opts)
XPS إلى PDF و الصورة
XpsDocument يقوم بتحميل ملفات XPS ويكشف نفسها to_pdf() و to_image() واجهة كـ PsDocument.اتصل بي XpsDocument.from_file() لتحميل مستند XPS، ثم تحويل إلى شكل الناتج المطلوب.
from pathlib import Path
from aspose.page.xps.document import XpsDocument
from aspose.page.ps.output import ImageSaveOptions
xps = XpsDocument.from_file("input.xps")
pdf_bytes = xps.to_pdf()
Path("output.pdf").write_bytes(pdf_bytes)
png_bytes = xps.to_image(ImageSaveOptions(format="png", dpi=96))
معالجة الذاكرة
جميع طرق التحويل تعود bytes الملفات المؤقتة لا تطلب أبدا إلا إذا كان يكتبها التطبيق صراحة. from_bytes() المكونات على كلا الطرفين PsDocument و XpsDocument تقبل البايتات الخام كمدخل، لذا يمكن أن يبقى خط الأنابيب بأكمله في الذاكرة.
from aspose.page.ps.document import PsDocument
def convert_ps_in_memory(ps_bytes: bytes) -> bytes:
doc = PsDocument.from_bytes(ps_bytes)
return doc.to_pdf()
تكامل خادم MCP
وتشمل المكتبة خادم MCP اختراني يعرض وظائف التحويل كجهاز عن بعد. أدوات باستخدام FastMCP. سجل الخادم ps_to_pdf, ps_to_image, xps_to_pdf,، و xps_to_image كأدوات قابلة للنطق. McpInput يقبل مسار ملف أو بايتات مشفرة بـ base64؛; McpOutput يعيد بيس64 بايت أو يكتب إلى مسار.
FastMCP هي اعتماد اختياري وظيفة التحويل الأساسية تعمل بدونها. خادم MCP مفيد لجعل المكتبة قابلة للدعوة من أنابيب وكيل الذكاء الاصطناعي ، الخدمات الدقيقة ، والمحررين الذين يدعمون خوادم أدوات MPC .
بدء سريع
قم بتثبيت المكتبة باستخدام pip:
pip install aspose-page-foss>=0.1.0
يشمل المثال التالي حالة الاستخدام الأكثر شيوعًا تحويل ملف PS إلى PDF وحفظه على القرص:
from pathlib import Path
from aspose.page.ps.document import PsDocument
from aspose.page.ps.output import ImageSaveOptions
# Convert PS to PDF
ps = PsDocument.from_file("document.ps")
Path("document.pdf").write_bytes(ps.to_pdf())
# Convert EPS to PNG at 150 DPI
eps = PsDocument.from_file("illustration.eps")
opts = ImageSaveOptions(format="png", dpi=150)
Path("illustration.png").write_bytes(eps.to_image(opts))
# Convert XPS to PDF
from aspose.page.xps.document import XpsDocument
xps = XpsDocument.from_file("document.xps")
Path("document.pdf").write_bytes(xps.to_pdf())
تنسيقات مدعومة
Aspose.Page FOSS for Python reads PostScript (.ps), PostScript المغطاة (.eps), و مواصفات ورق XML (.xps) ، والتي تتضمن ملفات PDF (.pdf) والصور الرأسية (.png, .jpegجميع التحويلات تصدر فقط المكتبة لا تكتب PS، EPS أو XPS.
المصدر المفتوح و الترخيص
Aspose.Page FOSS for Python is released under the MIT license. The source code is hosted على GitHub في github.com/aspose-page-foss/Aspose.Page-FOSS-لـبايثون. يُسمح بالاستخدام التجاري دون قيود بموجب شروط MIT.
