Java を使用してプレゼンテーションにシェイプ アニメーション を適用する

アニメーションは、テキスト、画像、図形、またはチャートに適用できる視覚効果です。プレゼンテーションやその構成要素に命を吹き込みます。

プレゼンテーションでアニメーションを使用する理由

アニメーションを使用すると

• 情報の流れを制御する
• 重要なポイントを強調する
• 聴衆の関心や参加意欲を高める
• コンテンツを読みやすく、理解しやすく、処理しやすくする
• プレゼンテーションの重要な部分に読者や視聴者の注意を引く

PowerPoint には、開始、終了、強調、およびモーション パスのカテゴリーにわたる、アニメーションやアニメーション効果のための多くのオプションとツールが用意されています。

Aspose.Slides のアニメーション

• Aspose.Slides は、Aspose.Slides.Animation 名前空間下でアニメーションを操作するために必要なクラスと型を提供します。
• Aspose.Slides は、EffectType 列挙体で 150 以上のアニメーション効果を提供します。これらの効果は、基本的に PowerPoint で使用されるものと同じ（または同等）です。

テキスト ボックスへのアニメーションの適用

Aspose.Slides for Java を使用すると、図形内のテキストにアニメーションを適用できます。

1. Presentation クラスのインスタンスを作成します。
2. インデックスを使用してスライド参照を取得します。
3. rectangle の IAutoShape を追加します。
4. IAutoShape.TextFrame にテキストを追加します。
5. メイン シーケンスのエフェクトを取得します。
6. IAutoShape にアニメーション効果を追加します。
7. TextAnimation.BuildType プロパティを BuildType 列挙体の値に設定します。
8. プレゼンテーションを PPTX ファイルとしてディスクに書き込みます。

この Java コードは、AutoShape に Fade 効果を適用し、テキスト アニメーションを By 1st Level Paragraphs の値に設定する方法を示します：

// プレゼンテーション ファイルを表すプレゼンテーション クラスのインスタンスを作成します。
Presentation pres = new Presentation();
try {
    ISlide sld = pres.getSlides().get_Item(0);

    // テキスト付きの新しい AutoShape を追加します
    IAutoShape autoShape = sld.getShapes().addAutoShape(ShapeType.Rectangle, 20, 20, 150, 100);

    ITextFrame textFrame = autoShape.getTextFrame();
    textFrame.setText("First paragraph \nSecond paragraph \n Third paragraph");

    // スライドのメインシークエンスを取得します。
    ISequence sequence = sld.getTimeline().getMainSequence();

    // シェイプに Fade アニメーション効果を追加します
    IEffect effect = sequence.addEffect(autoShape, EffectType.Fade, EffectSubtype.None, EffectTriggerType.OnClick);

    // シェイプのテキストを第1レベル段落でアニメーション化します
    effect.getTextAnimation().setBuildType(BuildType.ByLevelParagraphs1);

    // PPTX ファイルをディスクに保存します
    pres.save(path + "AnimText_out.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

テキストへのアニメーションに加えて、単一のParagraphにもアニメーションを適用できます。 Animated Text を参照してください。

PictureFrame へのアニメーションの適用

1. Presentation クラスのインスタンスを作成します。
2. インデックスを使用してスライド参照を取得します。
3. スライド上に PictureFrame を追加または取得します。
4. メイン シーケンスのエフェクトを取得します。
5. PictureFrame にアニメーション効果を追加します。
6. プレゼンテーションを PPTX ファイルとしてディスクに書き込みます。

この Java コードは、PictureFrame に Fly 効果を適用する方法を示します：

// プレゼンテーション ファイルを表すプレゼンテーションクラスのインスタンスを作成します。
Presentation pres = new Presentation();
try {
    // プレゼンテーションの画像コレクションに追加する画像を読み込みます
    IPPImage picture;
    IImage image = Images.fromFile("aspose-logo.jpg");
    try {
        picture = pres.getImages().addImage(image);
    } finally {
        if (image != null) image.dispose();
    }

    // スライドに画像フレームを追加します
    IPictureFrame picFrame = pres.getSlides().get_Item(0).getShapes().addPictureFrame(ShapeType.Rectangle, 50, 50, 100, 100, picture);

    // スライドのメインシーケンスを取得します。
    ISequence sequence = pres.getSlides().get_Item(0).getTimeline().getMainSequence();

    // 画像フレームに左から飛ぶアニメーション効果を追加します
    IEffect effect = sequence.addEffect(picFrame, EffectType.Fly, EffectSubtype.Left, EffectTriggerType.OnClick);

    // PPTX ファイルをディスクに保存します
    pres.save(path + "AnimImage_out.pptx", SaveFormat.Pptx);
} catch(IOException e) {
} finally {
    if (pres != null) pres.dispose();
}

Shape へのアニメーションの適用

1. Presentation クラスのインスタンスを作成します。
2. インデックスを使用してスライド参照を取得します。
3. rectangle の IAutoShape を追加します。
4. Bevel の IAutoShape を追加します（このオブジェクトがクリックされるとアニメーションが再生されます）。
5. ベベル形状のエフェクト シーケンスを作成します。
6. カスタム UserPath を作成します。
7. UserPath への移動コマンドを追加します。
8. プレゼンテーションを PPTX ファイルとしてディスクに書き込みます。

この Java コードは、Shape に PathFootball（パスフットボール）効果を適用する方法を示します：

// PPTX ファイルを表す Presentation クラスのインスタンスを作成します。
Presentation pres = new Presentation();
try {
    ISlide sld = pres.getSlides().get_Item(0);

    // 既存のシェイプに対して PathFootball 効果を新規作成します。
    IAutoShape ashp = sld.getShapes().addAutoShape(ShapeType.Rectangle, 150, 150, 250, 25);
    ashp.addTextFrame("Animated TextBox");

    // PathFootBall アニメーション効果を追加します
    pres.getSlides().get_Item(0).getTimeline().getMainSequence().addEffect(ashp, EffectType.PathFootball,
            EffectSubtype.None, EffectTriggerType.AfterPrevious);

    // いわゆる「ボタン」を作成します。
    IShape shapeTrigger = pres.getSlides().get_Item(0).getShapes().addAutoShape(ShapeType.Bevel, 10, 10, 20, 20);

    // このボタン用のエフェクトシーケンスを作成します。
    ISequence seqInter = pres.getSlides().get_Item(0).getTimeline().getInteractiveSequences().add(shapeTrigger);

     // カスタムユーザーパスを作成します。このオブジェクトはボタンがクリックされた後にのみ移動します。
    IEffect fxUserPath = seqInter.addEffect(ashp, EffectType.PathUser, EffectSubtype.None, EffectTriggerType.OnClick);

     // 作成したパスが空なので、移動コマンドを追加します。
    IMotionEffect motionBvh = ((IMotionEffect)fxUserPath.getBehaviors().get_Item(0));

    Point2D.Float[] pts = new Point2D.Float[1];
    pts[0] = new Point2D.Float(0.076f, 0.59f);
    motionBvh.getPath().add(MotionCommandPathType.LineTo, pts, MotionPathPointsType.Auto, true);
    pts[0] = new Point2D.Float(-0.076f, -0.59f);
    motionBvh.getPath().add(MotionCommandPathType.LineTo, pts, MotionPathPointsType.Auto, false);
    motionBvh.getPath().add(MotionCommandPathType.End, null, MotionPathPointsType.Auto, false);

     // PPTX ファイルをディスクに書き込みます
    pres.save("AnimExample_out.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

Shape に適用されたアニメーション効果の取得

以下の例は、ISequence インターフェイスの getEffectsByShape メソッドを使用して、Shape に適用されたすべてのアニメーション効果を取得する方法を示します。

例 1: 通常スライド上の Shape に適用されたアニメーション効果の取得

以前、PowerPoint プレゼンテーションの図形にアニメーション効果を追加する方法を学びました。以下のサンプルコードは、プレゼンテーション AnimExample_out.pptx の最初のノーマル スライドの最初の図形に適用された効果を取得する方法を示します。

Presentation presentation = new Presentation("AnimExample_out.pptx");
try {
    ISlide firstSlide = presentation.getSlides().get_Item(0);

    // スライドのメイン アニメーション シーケンスを取得します。
    ISequence sequence = firstSlide.getTimeline().getMainSequence();

    // 最初のスライド上の最初のシェイプを取得します。
    IShape shape = firstSlide.getShapes().get_Item(0);

    // シェイプに適用されたアニメーション効果を取得します。
    IEffect[] shapeEffects = sequence.getEffectsByShape(shape);

    if (shapeEffects.length > 0)
        System.out.println("The shape " + shape.getName() + " has " + shapeEffects.length + " animation effects.");
} finally {
    if (presentation != null) presentation.dispose();
}

例 2: プレースホルダーから継承されたものを含むすべてのアニメーション効果の取得

ノーマル スライド上の図形に、レイアウト スライドやマスタ スライド上のプレースホルダーがあり、これらのプレースホルダーにアニメーション効果が追加されている場合、スライドショー中に図形のすべての効果が再生されます。プレースホルダーから継承されたものも含まれます。

たとえば、sample.pptx という PowerPoint プレゼンテーション ファイルがあり、1 枚のスライドにフッター形状だけが含まれ、テキストは “Made with Aspose.Slides” で、Random Bars 効果がその形状に適用されているとします。

また、レイアウト スライドのフッタープレースホルダーに Split 効果が適用されているとします。

さらに、マスタ スライドのフッタープレースホルダーに Fly In 効果が適用されているとします。

以下のサンプルコードは、IShape インターフェイスの getBasePlaceholder メソッドを使用して形状プレースホルダーにアクセスし、レイアウト スライドやマスタ スライドにあるプレースホルダーから継承されたものを含む、フッター形状に適用されたアニメーション効果を取得する方法を示します。

Presentation presentation = new Presentation("sample.pptx");

ISlide slide = presentation.getSlides().get_Item(0);

// 通常スライド上のシェイプのアニメーション効果を取得します。
IShape shape = slide.getShapes().get_Item(0);
IEffect[] shapeEffects = slide.getTimeline().getMainSequence().getEffectsByShape(shape);

// レイアウトスライド上のプレースホルダーのアニメーション効果を取得します。
IShape layoutShape = shape.getBasePlaceholder();
IEffect[] layoutShapeEffects = slide.getLayoutSlide().getTimeline().getMainSequence().getEffectsByShape(layoutShape);

// マスタースライド上のプレースホルダーのアニメーション効果を取得します。
IShape masterShape = layoutShape.getBasePlaceholder();
IEffect[] masterShapeEffects = slide.getLayoutSlide().getMasterSlide().getTimeline().getMainSequence().getEffectsByShape(masterShape);

System.out.println("Main sequence of shape effects:");
printEffects(masterShapeEffects);
printEffects(layoutShapeEffects);
printEffects(shapeEffects);

presentation.dispose();

static void printEffects(IEffect[] effects)
{
    for (IEffect effect : effects)
    {
        String typeName = EffectType.getName(EffectType.class, effect.getType());
        String subtypeName = EffectSubtype.getName(EffectSubtype.class, effect.getSubtype());

        System.out.println(typeName + " " + subtypeName);
    }
}

Output:

Main sequence of shape effects:
Fly Bottom
Split VerticalIn
RandomBars Horizontal

アニメーション効果のタイミング プロパティの変更

Aspose.Slides for Java は、アニメーション効果のタイミング プロパティを変更できます。

これは Microsoft PowerPoint のアニメーション タイミング ペインです：

PowerPoint のタイミングと Effect.Timing プロパティの対応は次のとおりです：

• PowerPoint のタイミング Start のドロップダウン リストは、Effect.Timing.TriggerType プロパティに対応します。
• PowerPoint のタイミング Duration は、Effect.Timing.Duration プロパティに対応します。効果期間（秒）は、アニメーションが 1 サイクルを完了するのにかかる総時間です。
• PowerPoint のタイミング Delay は、Effect.Timing.TriggerDelayTime プロパティに対応します。

Effect のタイミング プロパティを変更する手順は次のとおりです：

1. Apply またはアニメーション効果を取得します。
2. 必要な Effect.Timing プロパティに新しい値を設定します。
3. 変更した PPTX ファイルを保存します。

この Java コードは操作を示します：

// プレゼンテーションファイルを表すプレゼンテーションクラスのインスタンスを作成します。
Presentation pres = new Presentation("AnimExample_out.pptx");
try {
    // スライドのメインシーケンスを取得します。
    ISequence sequence = pres.getSlides().get_Item(0).getTimeline().getMainSequence();

    // メインシーケンスの最初のエフェクトを取得します。
    IEffect effect = sequence.get_Item(0);

    // エフェクトの TriggerType をクリック時開始に変更します
    effect.getTiming().setTriggerType(EffectTriggerType.OnClick);

    // エフェクトの Duration を変更します
    effect.getTiming().setDuration(3f);

    // エフェクトの TriggerDelayTime を変更します
    effect.getTiming().setTriggerDelayTime(0.5f);

    // PPTX ファイルをディスクに保存します
    pres.save("AnimExample_changed.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

アニメーション効果のサウンド

Aspose.Slides は、アニメーション効果のサウンドを操作するために次のプロパティを提供します：

• setSound(IAudio value)
• setStopPreviousSound(boolean value)

アニメーション効果のサウンドを追加

この Java コードは、アニメーション効果のサウンドを追加し、次の効果が開始するときに停止させる方法を示します：

Presentation pres = new Presentation("AnimExample_out.pptx");
try {
    // プレゼンテーションのオーディオコレクションに音声を追加します
    IAudio effectSound = pres.getAudios().addAudio(Files.readAllBytes(Paths.get("sampleaudio.wav")));

    ISlide firstSlide = pres.getSlides().get_Item(0);

    // スライドのメインシーケンスを取得します
    ISequence sequence = firstSlide.getTimeline().getMainSequence();

    // メインシーケンスの最初のエフェクトを取得します
    IEffect firstEffect = sequence.get_Item(0);

    // エフェクトに「サウンドなし」かどうかをチェックします
    if (!firstEffect.getStopPreviousSound() && firstEffect.getSound() == null)
    {
        // 最初のエフェクトにサウンドを追加します
        firstEffect.setSound(effectSound);
    }

    // スライドの最初のインタラクティブシーケンスを取得します
    ISequence interactiveSequence = firstSlide.getTimeline().getInteractiveSequences().get_Item(0);

    // エフェクトの「前のサウンドを停止」フラグを設定します
    interactiveSequence.get_Item(0).setStopPreviousSound(true);

    // PPTX ファイルをディスクに保存します
    pres.save("AnimExample_Sound_out.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

アニメーション効果のサウンドを抽出

1. Presentation クラスのインスタンスを作成します。
2. インデックスを使用してスライドの参照を取得します。
3. メイン シーケンスのエフェクトを取得します。
4. 各アニメーション効果に埋め込まれた setSound(IAudio value) を抽出します。

この Java コードは、アニメーション効果に埋め込まれたサウンドを抽出する方法を示します：

// プレゼンテーション ファイルを表すプレゼンテーション クラスのインスタンスを作成します。
Presentation presentation = new Presentation("EffectSound.pptx");
try {
    ISlide slide = presentation.getSlides().get_Item(0);

    // スライドのメイン シーケンスを取得します。
    ISequence sequence = slide.getTimeline().getMainSequence();

    for (IEffect effect : sequence)
    {
        if (effect.getSound() == null)
            continue;

        // エフェクトのサウンドをバイト配列で抽出します。
        byte[] audio = effect.getSound().getBinaryData();
    }
} finally {
    if (presentation != null) presentation.dispose();
}

アフター アニメーション

Aspose.Slides for Java は、アニメーション効果の After animation プロパティを変更できます。

これは Microsoft PowerPoint のアニメーション効果ペインおよび拡張メニューです：

PowerPoint の Effect After animation ドロップダウン リストは、以下のプロパティに対応します：

• setAfterAnimationType(int value) プロパティは、After animation のタイプを示します：
  • PowerPoint の More Colors は、AfterAnimationType.Color タイプに対応します。
  • PowerPoint の Don’t Dim は、AfterAnimationType.DoNotDim タイプ（デフォルトのアフター アニメーション タイプ）に対応します。
  • PowerPoint の Hide After Animation は、AfterAnimationType.HideAfterAnimation タイプに対応します。
  • PowerPoint の Hide on Next Mouse Click は、AfterAnimationType.HideOnNextMouseClick タイプに対応します。
• setAfterAnimationColor(IColorFormat value) プロパティは、アフター アニメーションのカラー形式を定義します。このプロパティは AfterAnimationType.Color タイプと連携して機能します。別のタイプに変更すると、アフター アニメーションのカラーはクリアされます。

この Java コードは、アフター アニメーション効果を変更する方法を示します：

// プレゼンテーション ファイルを表すプレゼンテーション クラスのインスタンスを作成します
Presentation pres = new Presentation("AnimImage_out.pptx");
try {
    ISlide firstSlide = pres.getSlides().get_Item(0);

    // メインシーケンスの最初のエフェクトを取得します
    IEffect firstEffect = firstSlide.getTimeline().getMainSequence().get_Item(0);

    // アフター アニメーションのタイプをカラーに変更します
    firstEffect.setAfterAnimationType(AfterAnimationType.Color);

    // アフター アニメーションの暗転カラーを設定します
    firstEffect.getAfterAnimationColor().setColor(Color.BLUE);

    // PPTX ファイルをディスクに書き込みます
    pres.save("AnimImage_AfterAnimation.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

テキストのアニメーション

Aspose.Slides は、アニメーション効果の Animate text ブロックを操作するために次のプロパティを提供します：

• setAnimateTextType(int value) は、効果のアニメート テキスト タイプを示します。シェイプのテキストは次のようにアニメーション化できます：
  • 全体同時 ([AnimateTextType.AllAtOnce] タイプ)
  • 単語単位 ([AnimateTextType.ByWord] タイプ)
  • 文字単位 ([AnimateTextType.ByLetter] タイプ)
• setDelayBetweenTextParts(float value) は、アニメーション化されたテキスト部分（単語または文字）間の遅延を設定します。正の値は効果期間のパーセンテージを、負の値は秒単位の遅延を指定します。

Effect の Animate text プロパティを変更する手順は次のとおりです：

1. Apply またはアニメーション効果を取得します。
2. setBuildType(int value) プロパティを [BuildType.AsOneObject] の値に設定し、By Paragraphs アニメーションモードをオフにします。
3. setAnimateTextType(int value) と setDelayBetweenTextParts(float value) プロパティに新しい値を設定します。
4. 変更した PPTX ファイルを保存します。

この Java コードは操作を示します：

// プレゼンテーション ファイルを表すプレゼンテーション クラスのインスタンスを作成します。
Presentation pres = new Presentation("AnimTextBox_out.pptx");
try {
    ISlide firstSlide = pres.getSlides().get_Item(0);

    // メインシーケンスの最初のエフェクトを取得します
    IEffect firstEffect = firstSlide.getTimeline().getMainSequence().get_Item(0);

    // エフェクトのテキスト アニメーション タイプを「As One Object」に変更します
    firstEffect.getTextAnimation().setBuildType(BuildType.AsOneObject);

    // エフェクトのアニメート テキスト タイプを「By word」に変更します
    firstEffect.setAnimateTextType(AnimateTextType.ByWord);

    // 語間の遅延を効果期間の 20% に設定します
    firstEffect.setDelayBetweenTextParts(20f);

    // PPTX ファイルをディスクに書き込みます
    pres.save("AnimTextBox_AnimateText.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

FAQ

プレゼンテーションを Web に公開する際にアニメーションを保持するにはどうすればよいですか？

Export to HTML5 を使用し、shape と transition アニメーションを有効にするオプションを設定します。プレーンな HTML ではスライド アニメーションは再生されませんが、HTML5 では再生されます。

図形の Z 順序（レイヤー順序）を変更するとアニメーションにどのような影響がありますか？

アニメーションと描画順序は独立しています。効果は表示/非表示のタイミングとタイプを制御し、z-order は何が何を覆うかを決定します。見た目の結果は両者の組み合わせで決まります。（これは一般的な PowerPoint の動作で、Aspose.Slides のエフェクトとシェイプのモデルも同様のロジックに従います。）

特定の効果をビデオに変換する際に制限はありますか？

一般的に、animations are supported ですが、稀なケースや特定の効果は異なる形でレンダリングされることがあります。使用する効果とライブラリのバージョンでテストすることを推奨します。