أدوات الاستخدام المشتركة للترجمة
أدوات الاستخدام المشتركة للترجمة
Aspose.Page FOSS for Python exposes a set of lower-level rendering utilities used داخلياً من قبل PsDocument و XpsDocument.يمكن استخدام هذه المكونات مباشرة أيضاً. عندما يكون هناك حاجة إلى التحكم الدقيق في الناتج.
RenderModelBuilder
RenderModelBuilder يبنين a RenderDocument تدريجياً، اتصلوا. begin_page() لبدء صفحة، إضافة أوامر الرسم، ثم الاتصال end_page().اتصل بي document() إلى استرداد المكملة RenderDocument.
from aspose.page.render.model import RenderModelBuilder
builder = RenderModelBuilder()
builder.begin_page(595, 842)
builder.end_page()
doc = builder.document()طرق الرسم المتاحة: add_path(), add_text(), add_image(), clip(), save_state(),، و restore_state().
PdfWriter
PdfWriter يسلسلها a RenderDocument إلى PDF 1.4 بايت. يتطلب ذلك a PdfMetadata مثال. انظر مخرج PDF لمزيد من التفاصيل.
RasterRenderer
RasterRenderer يجعل من RenderDocument إلى a RasterSurface RGBA في الذاكرة عازل البيكسل. RasterSurface يقدم get_pixel(), set_pixel(), width,، و height.
from aspose.page.render.model import RenderModelBuilder
from aspose.page.image.raster_renderer import RasterRenderer
builder = RenderModelBuilder()
builder.begin_page(400, 300)
builder.end_page()
doc = builder.document()
renderer = RasterRenderer()
surface = renderer.render(doc, page_index=0)
print(f"Pixels: {surface.width}x{surface.height}")نصائح وأفضل الممارسات
- استخدام
RenderModelBuilderعندما تحتاج إلى بناء وثيقة من الرسم البدائي. - استخدام
PdfWriterمع aRenderDocumentلتوليد PDF مخصص بدون ملف مصدر. RasterSurfaceالوصول إلى البكسل متاح عبر:get_pixel()وset_pixel().
إشارة API
| الفئة / الطريقة | وصف |
|---|---|
RenderModelBuilder.begin_page(width, height) | ابدأ صفحة جديدة |
RenderModelBuilder.end_page() | إنهاء الصفحة الحالية |
RenderModelBuilder.document() | استرداد مستند RenderDocument المكتمل |
PdfWriter.write(document) | تصفية مستند إلى بايتات PDF |
RasterRenderer.render(document, page_index) | إعادة صفحة إلى RasterSurface |
RasterSurface.width | عرض السطح بالبيكسلات |
RasterSurface.height | ارتفاع السطح في البكسلات |