1. محصولات
  2.   Aspose.Page
  3.   Aspose.Page FOSS for Python

Aspose.Page FOSS for Python

کتابخانهٔ رایگان و تحت مجوز MIT Python برای استخراج اسناد PS، EPS و XPS به‌صورت PDF و تصاویر رستر. نیازی به Office نیست.

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

مستندات GitHub

کتابخانه پایتون منبع باز برای PS، EPS و XPS Conversion

Aspose.Page FOSS برای Python یک کتابخانهٔ رایگان و متن‌باز برای تبدیل اسناد PostScript (PS)، Encapsulated PostScript (EPS) و XPS در برنامه‌های Python است. آن را با یک فرمان pip install aspose-page-foss نصب کنید و شروع به استخراج اسناد به PDF و تصاویر رستر کنید بدون هیچ زمان‌اجرایی یا وابستگی سیستمی مالکیتی.

کتابخانه یک API تمیز ارائه می‌دهد که بر پایهٔ PsDocument و XpsDocument ساخته شده است. یک سند را با from_file() یا from_bytes() بارگذاری کنید، سپس to_pdf() را فراخوانی کنید تا یک جریان بایت PDF دریافت کنید، یا با یک نمونهٔ ImageSaveOptions to_image() کنید تا به PNG یا JPEG با DPI مشخص رندر شود. یک سرور MCP اختیاری ps_to_pdf، ps_to_image، xps_to_pdf و xps_to_image را به عنوان ابزارهای تبدیل از راه دور با استفاده از FastMCP ارائه می‌دهد.

از آنجا که این کتابخانه هیچ وابستگی‌ای به کتابخانه‌های بومی Office یا Ghostscript ندارد، به‌صورت یکسان بر روی Windows، Linux و macOS اجرا می‌شود، از جمله رانرهای CI و کانتینرهای Docker. پایه کد تحت مجوز MIT است و در GitHub میزبانی می‌شود. توسعه‌دهندگانی که به API تجاری کامل نیاز دارند می‌توانند از Aspose.Page برای Python همراه با این منابع متن‌باز استفاده کنند. برای محصول سازمانی، به Aspose.Page for Python — Enterprise Product مراجعه کنید.

تبدیل اسناد PS و EPS

  • PS به PDF: PsDocument.from_file() را فراخوانی کنید سپس to_pdf() برای استخراج سند به‌صورت آرایه بایت PDF.
  • EPS به PDF: PsDocument.from_file() هر دو پسوند فایل .ps و .eps را می‌پذیرد.
  • PS/EPS به تصویر: یک ImageSaveOptions(format="png", dpi=150) را به to_image() برای خروجی PNG یا JPEG پاس دهید.
  • پردازش در حافظه: تمام تبدیل‌ها bytes را برمی‌گردانند — نیازی به فایل‌های موقت نیست.
  • از بایت‌ها: برای پردازش داده‌های PS/EPS از یک جریان شبکه یا بارگذاری، از PsDocument.from_bytes() استفاده کنید.

جایی که از تبدیل PS/EPS استفاده می شود.

  • نابرها اسناد: گزارش های PostScript قدیمی را برای آرشیو یا توزیع به PDF صادر کنید.
  • ** جریان های کاری چاپ:** تبدیل PS output از درایورهای چاپ به PDF یا پیش نمایش تصویر.
  • ** پردازش دارایی EPS:** تصاویر E PS را به PNG برای استفاده در وب یا اسناد، رستر کنید.
  • ** اتوماسیون دسته:** پرونده های PS / EPS را در کار CI یا cron بدون GUI پردازش کنید.

تبدیل اسناد XPS

  • XPS to PDF: برای استخراج فایل XPS به صورت آرایه بایت PDF، ابتدا XpsDocument.from_file() و سپس to_pdf() را فراخوانی کنید.
  • XPS to image: برای رندر کردن صفحات XPS به PNG یا JPEG، to_image() را با ImageSaveOptions صدا بزنید.
  • From bytes: برای داده‌های XPS در حافظه که از بارگذاری‌ها یا جریان‌ها می‌آیند، از XpsDocument.from_bytes() استفاده کنید.
  • Page access: برای کار با صفحات جداگانه، از add_page()، get_page() و remove_page() بهره ببرید.
  • XPS package reading: برای بررسی بخش‌های خام بسته XPS، از XpsPackage.from_file() استفاده کنید.

جایی که از تبدیل XPS استفاده می شود

  • کف چاپ ویندوز: فایل های کفی XPS را از زیر سیستم چاپ Windows به PDF یا تصویر صادر کنید.
  • ** آرشیو اسناد:** تبدیل فایل های XPS به PDF قابل خواندن جهانی برای ذخیره طولانی مدت.
  • ** تولید پیش نمایش:** صفحات XPS را به PNG برای سیستم های مدیریت سند تبدیل کنید.
  • ** استفاده از سیستم عامل های متقابل:** پردازش فایل XPS در سرورهای لینوکس و macOS که بیننده بومی در دسترس نیستند.

سرور MCP برای تبدیل از راه دور

  • تعرض ابزار: create_server() را ثبت می کند ps_to_pdf، ps_to_image, xps_to_pdf و xps_to_image به عنوان ابزارهای MCP از طریق FastMCP.
  • ** متاداتا EPS:** ابزار eps_metadata از فایل های Eps، فیلدهای مربع محدود کننده و سرگوشی DSC را استخراج می کند.
  • ** انواع ورودی / خروجی:** McpInput یک مسیر فایل یا بایت کد base64 را می پذیرد؛ McpOutput بايت های base 64 را بازمی گرداند یا به یک Path می نویسد.
  • ** گزینه های تبدیل:** McpConversionOptions کنترل فرمت خروجی و DPI برای تبدیل تصاویر.
  • ** وابستگی اختیاری:** FastMCP فقط برای میزبانی سرور MCP مورد نیاز است؛ تبدیل هسته بدون آن کار می کند.

موارد استفاده از MCP

  • نابرها عامل AI: تبدیل اسناد را به عنوان ابزاری که توسط Claude یا سایر عوامل سازگار با MCP قابل فراخوانی است، نشان دهید.
  • ** خدمات کوچک:** یک سرویس تبدیل سبک را اجرا کنید که 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 از هر { PLACHAULDER 8 ] تولید شود.
  • PdfMetadata: title، creator ، producer،creation_date و trapped را در فایل PDF خروجی تنظیم کنید.
  • RasterRenderer: یک RenderDocument را به یکRasterSurface ارائه دهید؛ با encode_png() یا encode_bmp() رمزگذاری کنید.
  • کودینگ یونیکوډ: لایه خروجی PDF متن چند اسکریپت یونیکد را شامل CJK و سیریل می کند.

موارد استفاده از سطح پایین ارائه

  • ** تولید PDF سفارشی:** صفحات با مسیرهای مترا، متن و تصاویر بدون یک فایل PS / XPS واسطه ایجاد کنید.
  • ** تست پیکسل کامل:** برای نمایش اسناد و مقایسه پکسل در آزمایشات خودکار از RasterRenderer استفاده کنید.
  • ** ادغام فونت:** برای ارائه صحیح، از فونتهای TrueType با استفاده از FontResolver و build_embedded_font() ادراج کنید.
  • ** مدیریت رنگ:** اعمال Paint اشیاء با فضای رنگی مبتنی بر DeviceRGB یا CIE به مسیرها و متن.

تبدیل PS به PDF

برای دسترسی به فایل PostScript PsDocument.from_file() را فراخوانید و برای صادر کردن آن به عنوان یک جریان بایت PDF to_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

برای دسترسی به سند XPS XpsDocument.from_file() را فراخوانید و برای صادر کردن آن به عنوان یک جریان بایت PDF to_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 برای پایتون تحت مجوز MIT منتشر شده است، که اجازه استفاده در برنامه های تجاری و خصوصی را می دهد.

آیا وابستگی های بومی وجود دارد؟

نه، این کتابخانه به هیچ گونه Ghostscript ، Adobe Reader یا هر زمان اجرا بومی وابسته نیست. در ویندوز، لینوکس و macOS کار می کند.

کتابخانه از چه فرمت های ورودی پشتیبانی می کند؟

کتابخانه فایل های PostScript (.ps) ، Encapsulated Post Script (.eps), و XPS (.xps). را می خواند.

کتابخانه چه فرمت های خروجی تولید می کند؟

کتابخانه از طریق to_pdf() به PDF و با استفاده از ImageSaveOptions از طريق to_image() به PNG یا JPEG تصاویر راستر صادر می کند.

می تونم فایل ها رو بدون دیسک I/O در حافظه پردازش کنم؟

بله. با استفاده از from_bytes() برای بارگیری بایت خام و بایت های بازگردانده شده ازto_pdf() یا to_image() به طور مستقیم بدون نوشتن فایل ها.

  

منابع پشتیبانی و آموزش

 فارسی