Aspose.Slides FOSS for Java の開始方法

aspose-slides-foss for Java は、無料で MIT ライセンスのライブラリで、PowerPoint .pptx ファイルの作成と編集が可能です — Microsoft Office は不要で、Maven Central で入手可能です。

ステップバイステップガイド

ステップ 1: Maven 依存関係を追加

依存関係を pom.xml に追加してください（Java 21 以降が必要です）：

<dependency>
    <groupId>org.aspose.slides.foss</groupId>
    <artifactId>aspose-slides-foss</artifactId>
    <version>1.0.0</version>
</dependency>

パッケージが正しく解決されることを、プロジェクトをビルドして確認してください：

mvn dependency:resolve

ステップ 2: 必要なクラスをインポート

プレゼンテーションの読み込みと保存に必要なクラスをインポートします:

import org.aspose.slides.foss.Presentation;
import org.aspose.slides.foss.ISlide;
import org.aspose.slides.foss.IAutoShape;
import org.aspose.slides.foss.ITextFrame;
import org.aspose.slides.foss.ShapeType;
import org.aspose.slides.foss.FillType;

ステップ 3: プレゼンテーションを作成

引数なしで Presentation を構築し、空白のスライドを1枚作成します。常に try-with-resources を使用して内部リソースが解放されるようにしてください：

import org.aspose.slides.foss.Presentation;

try (Presentation prs = new Presentation()) {
    System.out.println("Slides: " + prs.getSlides().size());
    prs.save("new_presentation.pptx");
}

ステップ 4: テキスト付きシェイプを追加

slide.getShapes().addAutoShape() を使用して矩形を挿入し、次に addTextFrame() を呼び出してテキストコンテンツを追加します:

import org.aspose.slides.foss.Presentation;
import org.aspose.slides.foss.ISlide;
import org.aspose.slides.foss.IAutoShape;
import org.aspose.slides.foss.ITextFrame;
import org.aspose.slides.foss.IPortionFormat;
import org.aspose.slides.foss.ShapeType;
import org.aspose.slides.foss.NullableBool;

try (Presentation prs = new Presentation()) {
    ISlide slide = prs.getSlides().get(0);
    IAutoShape shape = slide.getShapes().addAutoShape(
        ShapeType.RECTANGLE, 50, 50, 400, 150
    );
    ITextFrame tf = shape.addTextFrame("Hello from Aspose.Slides FOSS!");
    IPortionFormat fmt = tf.getParagraphs().get(0).getPortions().get(0).getPortionFormat();
    fmt.setFontHeight(24);
    fmt.setFontBold(NullableBool.TRUE);
    prs.save("with_shape.pptx");
}

ステップ5: 塗りつぶしを適用して保存

保存する前にシェイプに単色の塗りつぶし色を設定する：

import org.aspose.slides.foss.Presentation;
import org.aspose.slides.foss.IAutoShape;
import org.aspose.slides.foss.ShapeType;
import org.aspose.slides.foss.FillType;
import org.aspose.slides.foss.drawing.Color;

try (Presentation prs = new Presentation()) {
    IAutoShape shape = prs.getSlides().get(0).getShapes().addAutoShape(
        ShapeType.RECTANGLE, 100, 100, 400, 200
    );
    shape.getFillFormat().setFillType(FillType.SOLID);
    shape.getFillFormat().getSolidFillColor().setColor(new Color(70, 130, 180));
    shape.addTextFrame("Styled shape");
    prs.save("styled.pptx");
}

一般的な問題と修正

ClassNotFoundException for org.aspose.slides.foss.Presentation Maven の依存関係が解決されていません。mvn dependency:resolve を実行し、
アーティファクトが Maven Central に存在することを確認してください。pom.xml のバージョンを確認してください。

UnsupportedOperationException 特定のメソッドを呼び出すとき 一部の機能（チャート、アニメーション、PDF エクスポート）は、UnsupportedOperationException をスローしますこのリリースで。API リファレンスの既知の制限セクションを確認してから高度な機能を使用してください。

シェイプの座標がずれているようです
座標と寸法は EMU（English Metric Units）で表されています。
1 ポイントは約
12700 EMU。
デフォルトのスライドは 9144000 × 6858000 EMU です。

既存の PPTX を読み込む際にファイルが見つかりません
絶対パスを指定するか、作業ディレクトリが正しく設定されていることを確認してください：

import java.nio.file.Paths;
String path = Paths.get("presentations", "existing.pptx").toAbsolutePath().toString();
try (Presentation prs = new Presentation(path)) { ... }

よくある質問

aspose-slides-fossはMicrosoft Officeを必要としますか？

いいえ。このライブラリは、Microsoft Office、COM オートメーション、または Windows API に依存せず、純粋な Java でネイティブに .pptx ファイルを作成および読み取ります。

サポートされている Java バージョンはどれですか？

Java 21 以降。ライブラリは Windows、macOS、Linux、Docker コンテナ上で動作します。

このライブラリは商用利用に無料ですか？

はい。MIT ライセンスの下でリリースされています。使用、変更、再配布は、あらゆる目的で、
商用アプリケーションを含む目的で行うことができます。

既存のPPTXファイルを読み込むことはできますか？

はい。Presentation コンストラクタにファイルパスを渡してください：

try (Presentation prs = new Presentation("existing.pptx")) {
    System.out.println("Loaded " + prs.getSlides().size() + " slides");
    prs.save("copy.pptx");
}

プレゼンテーションを明示的に閉じる必要がありますか？

はい。Presentation は AutoCloseable を実装します。クリーンアップを保証するために、常に try-with-resources（try (Presentation prs = new Presentation()) { ... }）を使用してください。