Често задавани въпроси

Как да инсталирам Aspose.Slides FOSS?

Инсталирайте от PyPI с помощта на pip. Необходим е Python 3.10 или по‑нова версия.

pip install aspose-slides-foss

Проверете инсталацията:

import aspose.slides_foss as slides
with slides.Presentation() as prs:
    print(f"Slides: {len(prs.slides)}")

Зависимостта lxml се инсталира автоматично. Не се изисква Microsoft Office или друг системен runtime.

Защо трябва да използвам `with slides.Presentation() as prs:`?

Класът Presentation управлява вътрешни файлови дескриптори и XML ресурси. Без контекстния мениджър тези ресурси не се освобождават, когато обектът Presentation излезе от обхвата, което може да доведе до изтичане на ресурси или заключване на файлове в Windows.

Винаги следвайте този модел:

with slides.Presentation("input.pptx") as prs:
    # work here
    prs.save("output.pptx", SaveFormat.PPTX)

В кои файлови формати мога да запазя?

Енумът SaveFormat определя константи за множество формати — PPTX, PDF, HTML, SVG, JPEG, PNG и други — за съвместимост на API с комерсиалното издание. По време на изпълнение в това FOSS издание, всички извиквания на save() игнорират аргумента за формат и винаги записват изход в PPTX. Предаване на SaveFormat.PDF се компилира и изпълнява без грешка, но създава файл .pptx, а не .pdf.

from aspose.slides_foss.export import SaveFormat
prs.save("output.pptx", SaveFormat.PPTX)

Експортирането в формати, различни от PPTX, не е функционално достъпно в това издание. Използвайте SaveFormat.PPTX за всички операции по запазване.

Мога ли да отворя `.ppt` (стар PowerPoint 97–2003) файлове?

Не. Само .pptx (Office Open XML) файловете се поддържат. Наследеният .ppt двоичен формат не се обработва от тази библиотека.

Как да достъпя слайдовете?

Слайдовете са списък с нулева индексация, достъпен чрез prs.slides:

first_slide = prs.slides[0]
slide_count = len(prs.slides)

Как да добавя втори слайд?

Използвайте prs.slides.add_empty_slide() с оформление:

with slides.Presentation() as prs:
    layout = prs.layout_slides[0]
    prs.slides.add_empty_slide(layout)
    slide2 = prs.slides[1]
    prs.save("two-slides.pptx", SaveFormat.PPTX)

Как да зададете цвета на фона на слайда?

Оцветяването на фона на слайда не е налично в това издание. Класът Slide не разкрива свойството background. Опитът за slide.background ще предизвика AttributeError. Тази функция не е реализирана в текущата версия.

Как да използвам `NullableBool`?

NullableBool е три‑стойностен изброим тип, използван за свойства на форматиране. Използвайте NullableBool.TRUE (а не Python‑овия True) за удебеляване, курсив и подобни свойства:

from aspose.slides_foss import NullableBool, TextUnderlineType
fmt.font_bold = NullableBool.TRUE
fmt.font_italic = NullableBool.FALSE
# font_underline is TextUnderlineType, not NullableBool:
fmt.font_underline = TextUnderlineType.NOT_DEFINED  # inherits from theme

Защо задаването на цвят на текста няма ефект?

Трябва също да зададете fill_type = FillType.SOLID преди да зададете цвета:

from aspose.slides_foss import FillType
from aspose.slides_foss.drawing import Color

fmt.fill_format.fill_type = FillType.SOLID
fmt.fill_format.solid_fill_color.color = Color.from_argb(255, 200, 0, 0)

Мога ли да използвам диаграми или SmartArt?

Не. Charts, SmartArt, OLE objects, animations, transitions, hyperlinks, VBA macros, и digital signatures не са реализирани в това издание и предизвикват NotImplementedError.

Поддържа ли библиотеката Python 3.9?

Не. Необходим е Python 3.10 или по-нова версия.

Тази библиотека е безопасна за многопоточност?

Всеки Presentation обект е независим. Създаването и използването на отделни Presentation екземпляри от различни нишки е безопасно, стига да не споделяте един единствен Presentation обект между нишките без външно заключване.

Как да вмъкна изображение?

Прочетете байтовете на изображението и ги добавете към prs.images, след което създайте PictureFrame:

with open("logo.png", "rb") as f:
    image_data = f.read()
image = prs.images.add_image(image_data)
slide.shapes.add_picture_frame(slides.ShapeType.RECTANGLE, 50, 50, 200, 150, image)

Често задавани въпроси