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

Aspose.Slides FOSS للـ Python

إنشاء وقراءة وتعديل عروض PowerPoint من Python — مجاني ومفتوح المصدر، لا يتطلب اعتمادًا على Office.

Aspose.Slides FOSS for Python Aspose.Slides FOSS
for Python

توثيق GitHub

مكتبة بايثون مفتوحة المصدر لعروض PowerPoint

Aspose.Slides FOSS for Python هي مكتبة بايثون خالصة مرخصة بموجب رخصة MIT للعمل مع ملفات PowerPoint .pptx. قم بتثبيتها بأمر pip واحد وابدأ فورًا في إنشاء وقراءة وتحرير العروض التقديمية دون الحاجة لتثبيت Microsoft Office أو أي بيئة تشغيل مملوكة.

تُظهر المكتبة واجهة برمجة تطبيقات Presentation مبنية حول Presentation، Slide، Shape، TextFrame، Paragraph، وPortion، وهو النموذج المفاهيمي الذي يستخدمه PowerPoint نفسه. أضف وأزل الشرائح، أدخل AutoShapes، الجداول، والموصلات، نسّق النص على مستوى الحرف باستخدام الغامق، المائل، حجم الخط واللون، طبّق تعبئات صلبة أو متدرجة، وأضف تأثيرات بصرية (ظل، توهج، تمويه، انعكاس).

نمط مدير السياق يضمن تنظيف الموارد بشكل موثوق: افتح دائمًا Presentation باستخدام with slides.Presentation(...) as prs:. الأجزاء غير المعروفة من XML التي تُواجه أثناء التحميل تُحفظ حرفيًا عند الحفظ، لذا فإن عملية التدوير لا تدمر المحتوى الذي لا تفهمه المكتبة بعد. تتطلب المكتبة Python 3.10 أو أحدث وتعتمد فقط على lxml، يتم تثبيتها تلقائيًا.

Presentation and Slide API

  • Create and open PPTX: Create new presentations or open existing .pptx files.
  • Add and remove slides: Programmatically manage the slide collection.
  • AutoShapes: Insert rectangles, ellipses, lines, and other AutoShape types.
  • Tables and Connectors: Add structured table shapes and connector lines between shapes.
  • Speaker notes: Read and write per-slide speaker notes.
  • Threaded comments: Access slide-level comment threads.

Where Aspose.Slides FOSS Can Be Used

  • Report generation: Build branded slide decks from data sources without Office.
  • Template automation: Fill PPTX templates with dynamic content in CI/CD pipelines.
  • Content migration: Read existing presentations and restructure or re-style slides.
  • Serverless backends: Process PPTX files inside Docker containers or Lambda functions.
  • Batch processing: Apply uniform formatting changes across large slide deck libraries.

Text Formatting and Visual Effects

  • Character-level formatting: Apply bold, italic, font size, and color to individual Portion objects.
  • Solid and gradient fills: Set shape fill to a solid color or multi-stop linear gradient.
  • Shadow and glow effects: Apply outer shadow, glow, blur, and reflection to any shape.
  • Paragraph alignment: Set left, center, right, or justify alignment per paragraph.
  • Round-trip safe: Unknown XML parts are preserved verbatim on re-save.

Developer Experience

Aspose.Slides FOSS installs with a single pip install aspose-slides-foss command. The only runtime dependency is lxml, installed automatically. There are no native extensions to compile.

The API mirrors PowerPoint’s own object model (Presentation, Slide, Shape, TextFrame, Paragraph, Portion), so anyone familiar with the PowerPoint object model can use the library immediately. It is MIT-licensed, open-source on GitHub, and requires Python 3.10 or later.

Create a Presentation and Add a Shape

Use the context manager (with slides.Presentation() as prs:) to ensure the PPTX is always closed and resources are freed. add_auto_shape() takes a ShapeType enum, then x/y position and width/height in points — the shape’s text_frame.text property sets the label in one line.

pip install aspose-slides-foss

import aspose.slides_foss as slides
from aspose.slides_foss.export import SaveFormat

with slides.Presentation() as prs:
    slide = prs.slides[0]

    # Add a rectangle AutoShape
    shape = slide.shapes.add_auto_shape(
        slides.ShapeType.RECTANGLE, 50, 50, 400, 150
    )
    shape.text_frame.text = "Hello, Aspose.Slides!"

    prs.save("output.pptx", SaveFormat.PPTX)

Format Text and Apply a Fill Effect

Text formatting works at the Portion level — the smallest unit of a run of characters. Open the saved file, navigate to the first portion of the first paragraph, and set font properties directly. Shape fill is independent: set fill_type to SOLID and assign a color to solid_fill_color.color.

import aspose.slides_foss as slides
from aspose.slides_foss import NullableBool, FillType
from aspose.slides_foss.drawing import Color
from aspose.slides_foss.export import SaveFormat

with slides.Presentation("output.pptx") as prs:
    shape = prs.slides[0].shapes[0]
    portion = shape.text_frame.paragraphs[0].portions[0]

    # Bold, 18pt, dark-blue text
    portion.portion_format.font_bold = NullableBool.TRUE
    portion.portion_format.font_height = 18
    portion.portion_format.fill_format.fill_type = FillType.SOLID
    portion.portion_format.fill_format.solid_fill_color.color = Color.dark_blue

    # Solid background fill on the shape
    shape.fill_format.fill_type = FillType.SOLID
    shape.fill_format.solid_fill_color.color = Color.alice_blue

    prs.save("formatted.pptx", SaveFormat.PPTX)

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

What is Aspose.Slides FOSS for Python?

It is a free, MIT-licensed pure-Python library for creating, reading, and editing PowerPoint .pptx presentations without requiring Microsoft Office.

Which file formats are supported?

PPTX is the supported read/write format. Export to PDF, HTML, SVG, or images is not available in this edition.

Does it require Microsoft Office or PowerPoint?

No. Aspose.Slides FOSS is a pure-Python library with no dependency on Microsoft Office, COM automation, or any proprietary runtime.

How do I install it?

Run pip install aspose-slides-foss. The only dependency is lxml, installed automatically. Python 3.10 or later is required.

Can I apply visual effects like shadow and glow?

Yes. The library supports outer shadow, glow, blur, and reflection effects on any shape object.

Is the context manager pattern recommended?

Yes. Always open a Presentation with with slides.Presentation(...) as prs: to ensure reliable resource cleanup.

Will round-tripping a PPTX destroy unknown content?

No. Unknown XML parts encountered during load are preserved verbatim on save, so content the library does not yet understand is never lost.

Where can I find the source code?

The library is MIT-licensed and hosted on GitHub. Bug reports and pull requests are welcome.

  

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

 العربية