Bevezetés
Aspose.Page FOSS a(z) Python számára egy ingyenes, nyílt forráskódú könyvtár a PostScript (PS), az Encapsulated PostScript (EPS) és az XPS dokumentumok PDF-re és raszteres képekre konvertálásához Python alkalmazásokban. MIT licenc alatt kerül kiadásra, és PyPI elérhető mint aspose-page-foss.
A könyvtár két felső szintű dokumentumosztályt biztosít: PsDocument a PS és EPS fájlokhoz, valamint XpsDocument az XPS fájlokhoz. Mindkét osztály to_pdf() és to_image() metódusokat tesz elérhetővé, amelyek bájt tömböket adnak vissza, így egyszerűen integrálhatóak fájlfeldolgozó csővezetékekbe anélkül, hogy ideiglenes fájlokat kellene írni.
Mivel a könyvtár nem függ a Ghostscripttől, az Adobe Readertől vagy bármilyen natív Office futtatókörnyezettől, Windows, Linux és macOS rendszereken egyaránt fut, beleértve a CI futtatókat és Docker konténereket is. Azok a fejlesztők, akiknek szükségük van a teljes kereskedelmi API fejlett renderelési funkciókkal, továbbra is használhatják a vállalati Aspose.Page a Python termékhez együtt ezekkel a nyílt forráskódú segédprogramokkal.
Mi van benne
PS és EPS PDF konvertálása
PsDocument kezeli mind a PostScript (.ps), mind az Encapsulated PostScript (.eps) fájlokat ugyanazon osztályinterfész segítségével. Hívja meg a(z) PsDocument.from_file() metódust a dokumentum betöltéséhez, majd a(z) to_pdf() metódust a PDF bájt tömbként kapott eredmény lekéréséhez.
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)
A from_bytes() osztálymetódus nyers bájtokat fogad, így a hálózati adatfolyamokból vagy fájlfeltöltésekből érkező dokumentumok lemezre írás nélkül feldolgozhatók.
PS és EPS raszteres képre
PS vagy EPS dokumentum PNG vagy JPEG képre való rendereléséhez adjon egy ImageSaveOptions példányt a to_image() számára. Állítsa be a format tulajdonságot "png" vagy "jpeg" értékre, valamint a dpi tulajdonságot a kimeneti felbontás vezérléséhez.
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-re és képre
XpsDocument betölti az XPS fájlokat, és ugyanazt a to_pdf() és to_image() interfészt biztosítja, mint a PsDocument. Hívja meg a XpsDocument.from_file() függvényt egy XPS dokumentum betöltéséhez, majd konvertálja a kívánt kimeneti formátumba.
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))
Memóriában történő feldolgozás
Minden konverziós metódus bytes objektumot ad vissza. Ideiglenes fájlok soha nem szükségesek, kivéve ha az alkalmazás kifejezetten írja őket. A from_bytes() konstruktorok a PsDocument és a XpsDocument esetén is nyers bájtokat fogadnak bemenetként, így az egész csővezeték memóriában maradhat.
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 szerver integráció
A könyvtár tartalmaz egy opcionális MCP szervert, amely a konverziós funkciókat távoli eszközökként teszi elérhetővé a FastMCP segítségével. A szerver regisztrálja a ps_to_pdf, ps_to_image, xps_to_pdf és xps_to_image eszközöket hívhatóként. A McpInput fájlútvonalat vagy base64-kódolt bájtokat fogad; a McpOutput base64 bájtokat ad vissza vagy egy útvonalra ír.
FastMCP egy opcionális függőség — a fő konverziós funkció enélkül is működik. Az MCP szerver hasznos, hogy a könyvtár hívható legyen AI ügynök csővezetékekből, mikroszolgáltatásokból és olyan szerkesztőkből, amelyek támogatják az MCP eszközszervereket.
Gyors kezdés
Telepítsd a könyvtárat pip-pel:
git clone https://github.com/aspose-page-foss/Aspose.Page-FOSS-for-Python.git
cd Aspose.Page-FOSS-for-Python
pip install -e .A következő példa a leggyakoribb felhasználási esetet mutatja be — egy PS fájl PDF-re konvertálása és lemezre mentése:
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())
Támogatott formátumok
Aspose.Page FOSS a Python számára a PostScript (.ps), az Encapsulated PostScript (.eps) és a XML Paper Specification (.xps) fájlokat olvassa. Kimeneti formátumok a PDF (.pdf) és a raszteres képek (.png, .jpeg). Minden konverzió csak exportálásra szolgál — a könyvtár nem ír PS, EPS vagy XPS fájlokat.
Nyílt forráskód és licencelés
Aspose.Page FOSS for Python MIT licenc alatt került kiadásra. A forráskód GitHub a github.com/aspose-page-foss/Aspose.Page-FOSS-for-Python címen van tárolva. A kereskedelmi felhasználás korlátozás nélkül megengedett az MIT feltételek szerint.
