ویژگیها و قابلیتها
ویژگیها و قابلیتها
Aspose.Slides FOSS for Python provides a broad set of capabilities for working with PowerPoint .pptx فایلها را بهصورت برنامهنویسی. این صفحه تمام حوزههای ویژگی پشتیبانیشده را همراه با مثالهای کد نماینده فهرست میکند.
ورودی/خروجی ارائه
یک مورد موجود را باز کنید .pptx فایل یا یک مورد جدید ایجاد کنید، سپس به فرمت PPTX ذخیره کنید.
import aspose.slides_foss as slides
from aspose.slides_foss.export import SaveFormat
# Open an existing presentation
with slides.Presentation("input.pptx") as prs:
print(f"Slide count: {len(prs.slides)}")
prs.save("output.pptx", SaveFormat.PPTX)
# Create a new presentation (starts with one blank slide)
with slides.Presentation() as prs:
prs.save("new.pptx", SaveFormat.PPTX)توجه: PPTX تنها فرمت ذخیرهسازی پشتیبانیشده است. خروجی به PDF، HTML، SVG یا تصاویر در دسترس نیست.
قسمتهای XML ناشناخته در فایل منبع بهصورت دقیق هنگام ذخیره حفظ میشوند، بنابراین باز کردن و ذخیره مجدد یک .pptx هرگز محتوایی را که کتابخانه هنوز درک نمیکند حذف نخواهد کرد.
مدیریت اسلایدها
افزودن، حذف، تکثیر و تغییر ترتیب اسلایدها.
import aspose.slides_foss as slides
from aspose.slides_foss.export import SaveFormat
with slides.Presentation() as prs:
# Access the first slide
slide = prs.slides[0]
# Add an additional blank slide at the end
prs.slides.add_empty_slide(prs.layout_slides[0])
print(f"Total slides: {len(prs.slides)}")
prs.save("multi-slide.pptx", SaveFormat.PPTX)اشکال
افزودن AutoShapes، PictureFrames، جدولها و Connectors به یک اسلاید.
AutoShapes
import aspose.slides_foss as slides
from aspose.slides_foss import ShapeType
from aspose.slides_foss.export import SaveFormat
with slides.Presentation() as prs:
slide = prs.slides[0]
# Add a rectangle at (x=50, y=50) with width=300, height=100
shape = slide.shapes.add_auto_shape(ShapeType.RECTANGLE, 50, 50, 300, 100)
shape.add_text_frame("Aspose.Slides FOSS")
prs.save("shapes.pptx", SaveFormat.PPTX)جدولها
import aspose.slides_foss as slides
from aspose.slides_foss.export import SaveFormat
with slides.Presentation() as prs:
slide = prs.slides[0]
# Column widths and row heights in points
col_widths = [120.0, 120.0, 120.0]
row_heights = [40.0, 40.0, 40.0]
table = slide.shapes.add_table(50, 50, col_widths, row_heights)
table.rows[0][0].text_frame.text = "Product"
table.rows[0][1].text_frame.text = "Quantity"
table.rows[0][2].text_frame.text = "Price"
prs.save("table.pptx", SaveFormat.PPTX)اتصالات
import aspose.slides_foss as slides
from aspose.slides_foss import ShapeType
from aspose.slides_foss.export import SaveFormat
with slides.Presentation() as prs:
slide = prs.slides[0]
box1 = slide.shapes.add_auto_shape(ShapeType.RECTANGLE, 50, 100, 150, 60)
box2 = slide.shapes.add_auto_shape(ShapeType.RECTANGLE, 350, 100, 150, 60)
conn = slide.shapes.add_connector(ShapeType.BENT_CONNECTOR3, 0, 0, 10, 10)
conn.start_shape_connected_to = box1
conn.start_shape_connection_site_index = 3 # right side
conn.end_shape_connected_to = box2
conn.end_shape_connection_site_index = 1 # left side
prs.save("connector.pptx", SaveFormat.PPTX)قالببندی متن
متن را در سطح پاراگراف و کاراکتر با استفاده از فرمتبندی کنید PortionFormat.
import aspose.slides_foss as slides
from aspose.slides_foss import ShapeType, NullableBool, FillType
from aspose.slides_foss.drawing import Color
from aspose.slides_foss.export import SaveFormat
with slides.Presentation() as prs:
slide = prs.slides[0]
shape = slide.shapes.add_auto_shape(ShapeType.RECTANGLE, 50, 50, 500, 150)
tf = shape.add_text_frame("Bold blue heading")
fmt = tf.paragraphs[0].portions[0].portion_format
fmt.font_height = 28
fmt.font_bold = NullableBool.TRUE
fmt.fill_format.fill_type = FillType.SOLID
fmt.fill_format.solid_fill_color.color = Color.from_argb(255, 0, 70, 127)
prs.save("text.pptx", SaveFormat.PPTX)NullableBool.TRUE بهطور صریح ویژگی را تنظیم میکند؛; NullableBool.NOT_DEFINED از اسلاید مستر ارث میبرد.
انواع پر
پر کردن اشکال با پرکنندههای ثابت، گرادیان، الگو یا تصویر.
import aspose.slides_foss as slides
from aspose.slides_foss import ShapeType, FillType
from aspose.slides_foss.drawing import Color
from aspose.slides_foss.export import SaveFormat
with slides.Presentation() as prs:
slide = prs.slides[0]
shape = slide.shapes.add_auto_shape(ShapeType.RECTANGLE, 50, 50, 300, 150)
# Solid fill
shape.fill_format.fill_type = FillType.SOLID
shape.fill_format.solid_fill_color.color = Color.from_argb(255, 30, 120, 200)
prs.save("fill.pptx", SaveFormat.PPTX)افکتهای بصری
اعمال سایه خارجی، درخشندگی، لبه نرم، تاری، بازتاب و سایه داخلی بر روی اشکال.
ویژگیهای اثر از طریق shape.effect_format. تنظیم outer_shadow_effect, glow_effect, soft_edge_effect, blur_effect, reflection_effect,، یا inner_shadow_effect برای پیکربندی هر کدام بهصورت مستقل.
3D Formatting
اعمال برجستگی 3D، دوربین، رِیگ نور، ماده و عمق برآمدگی از طریق shape.three_d_format. این کنترل عمق بصری و مدل نورپردازی برای رندر شکلها در نمایشگرهای PPTX که از افکتهای 3D پشتیبانی میکنند، انجام میدهد.
یادداشتهای سخنران
پیوست یادداشتها به هر اسلاید با استفاده از notes_slide_manager.
import aspose.slides_foss as slides
from aspose.slides_foss.export import SaveFormat
with slides.Presentation() as prs:
notes = prs.slides[0].notes_slide_manager.add_notes_slide()
notes.notes_text_frame.text = "Key talking point: emphasize the ROI benefit."
prs.save("notes.pptx", SaveFormat.PPTX)نظرات
نظرات زنجیرهای با اطلاعات نویسنده و موقعیت اسلاید اضافه کنید.
import aspose.slides_foss as slides
from aspose.slides_foss.drawing import PointF
from aspose.slides_foss.export import SaveFormat
from datetime import datetime
with slides.Presentation() as prs:
author = prs.comment_authors.add_author("Jane Smith", "JS")
slide = prs.slides[0]
author.comments.add_comment(
"Please verify this data before the presentation.",
slide,
PointF(2.0, 2.0),
datetime.now()
)
prs.save("comments.pptx", SaveFormat.PPTX)تصاویر جاسازیشده
درج یک تصویر از مسیر فایل در ارائه و افزودن آن به اسلاید به عنوان یک PictureFrame.
import aspose.slides_foss as slides
from aspose.slides_foss.export import SaveFormat
with slides.Presentation() as prs:
with open("logo.png", "rb") as f:
image_data = f.read()
image = prs.images.add_image(image_data)
slide = prs.slides[0]
slide.shapes.add_picture_frame(
slides.ShapeType.RECTANGLE, 50, 50, 200, 150, image
)
prs.save("with-image.pptx", SaveFormat.PPTX)ویژگیهای سند
خواندن و نوشتن ویژگیهای اصلی، برنامه و سفارشی سند.
import aspose.slides_foss as slides
from aspose.slides_foss.export import SaveFormat
with slides.Presentation() as prs:
props = prs.document_properties
# Core properties
props.title = "Q1 Results"
props.author = "Finance Team"
props.subject = "Quarterly Review"
props.keywords = "Q1, finance, results"
# Custom property
props.set_custom_property_value("ReviewedBy", "Legal Team")
prs.save("deck.pptx", SaveFormat.PPTX)محدودیتهای شناختهشده
مناطق زیر را برمیانگیزد NotImplementedError و در این نسخه در دسترس نیستند:
| منطقه | وضعیت |
|---|---|
| نمودارها | پیادهسازی نشده |
| SmartArt | پیادهسازی نشده |
| انیمیشنها و انتقالها | پیادهسازی نشده |
| صادرات PDF / HTML / SVG / تصویر | پیادهسازی نشده (فقط PPTX) |
| ماکروهای VBA | پیادهسازی نشده |
| امضاهای دیجیتال | پیادهسازی نشده |
| پیوندها و تنظیمات عمل | پیادهسازی نشده |
| اشیاء OLE | پیادهسازی نشده |
| متن ریاضی | پیادهسازی نشده |
همچنین ببینید
- شروع کار: نصب و اولین اسکریپت
- مرجع API: مرجع کلاس و متد
- راهنماهای گامبهگام: مقالات هدفمند