よくある質問

Aspose.Slides FOSS をインストールするにはどうすればよいですか？

pip を使用して PyPI からインストールします。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 やその他のシステムランタイムは必要ありません。

なぜ`with slides.Presentation() as prs:`を使用しなければならないのですか？

Presentation クラスは内部のファイルハンドルと XML リソースを管理します。コンテキストマネージャがない場合、Presentation オブジェクトがスコープを抜けたときにそれらのリソースが解放されず、Windows でリソースリークやファイルロックが発生する可能性があります。

常にこのパターンに従ってください：

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

どのファイル形式に保存できますか？

PPTX のみサポートされています:

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

このエディションでは、PDF、HTML、SVG、または画像形式（PNG、JPEG）へのエクスポートは利用できません。

`.ppt` (古い PowerPoint 97–2003) ファイルを開くことはできますか？

いいえ。.pptx（Office Open XML）ファイルのみがサポートされています。レガシー.pptバイナリ形式はこのライブラリでは処理されません。

スライドにアクセスするにはどうすればよいですか？

スライドは、prs.slides を介してアクセスできるゼロベースのリストです：

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

2枚目のスライドを追加するにはどうすればよいですか？

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)

よくある質問