Java を使用したプレゼンテーションでのシェイプアニメーションの適用

このページの概要

Aspose.Slides for Java を使用して、シェイプアニメーション、タイミング、サウンド、アフターアニメーション動作、アニメーションテキストを追加、検査、カスタマイズする方法を学びます。

概要

エフェクト内の個別の動作やモーションパスセグメントの編集を行うには、カスタムアニメーションをご覧ください。

Aspose.Slides for Java はスライドアニメーションをスライドタイムライン上のエフェクトとして表現します。エフェクトには対象シェイプ、アニメーションのタイプとサブタイプ、トリガー、タイミング設定、サウンドやアフターアニメーション動作などのオプションプロパティがあります。

タイムラインには次の 2 種類のシーケンスがあります。

メインシーケンス はスライドが進行するにつれて再生されます。
インタラクティブシーケンス はトリガーシェイプがクリックされたときに開始します。

テキストボックス、画像、チャート、テーブル、その他のスライドオブジェクトはすべて IShape を実装しているため、ほとんどのスライドコンテンツに対して同じ ISequence.addEffect メソッドを使用します。利用可能なエフェクトは EffectType クラスに一覧されています。

シェイプアニメーションの追加

アニメーションを追加するには、スライドのメインシーケンスを取得し、対象シェイプ、エフェクトタイプ、サブタイプ、トリガーを指定して ISequence.addEffect を呼び出します。他のシェイプがクリックされたときに開始するエフェクトの場合、そのシェイプをトリガーとしたインタラクティブシーケンスを作成します。

次の例は両方のタイプのアニメーションを作成し、結果を shape-animations.pptx に保存します。

import com.aspose.slides.*;

public class AddShapeAnimations {
    public static void main(String[] args) {
        Presentation presentation = new Presentation();
        try {
            ISlide slide = presentation.getSlides().get_Item(0);

            IAutoShape targetShape = slide.getShapes().addAutoShape(ShapeType.RoundCornerRectangle, 120, 100, 320, 80);
            targetShape.addTextFrame("Click to animate this shape");

            ISequence mainSequence = slide.getTimeline().getMainSequence();
            IEffect entranceEffect = mainSequence.addEffect(targetShape, EffectType.Fade, EffectSubtype.None, EffectTriggerType.OnClick);
            entranceEffect.getTiming().setDuration(1.5f);

            IAutoShape triggerShape = slide.getShapes().addAutoShape(ShapeType.Bevel, 20, 20, 100, 40);
            triggerShape.addTextFrame("Move");

            ISequence interactiveSequence = slide.getTimeline().getInteractiveSequences().add(triggerShape);
            interactiveSequence.addEffect(targetShape, EffectType.PathFootball, EffectSubtype.None, EffectTriggerType.OnClick);

            presentation.save("shape-animations.pptx", SaveFormat.Pptx);
        } finally {
            presentation.dispose();
        }
    }
}

トリガーはエフェクトの開始タイミングを制御します。

EffectTriggerType.OnClick はメインシーケンスではクリックを待ち、インタラクティブシーケンスではトリガーシェイプのクリックを待ちます。
EffectTriggerType.WithPrevious は前のエフェクトと同時に開始します。
EffectTriggerType.AfterPrevious は前のエフェクトが終了したときに開始します。

画像、チャート、その他のシェイプタイプをアニメーション化するには、targetShape の代わりに対象オブジェクトを ISequence.addEffect に渡します。チャート固有のグループ化オプションについては、アニメーションチャートを参照してください。

シェイプアニメーションの取得

対象シェイプが分かっている場合は ISequence.getEffectsByShape を使用します。すべてのエフェクトを調べるには、メインシーケンスとすべてのインタラクティブシーケンスを列挙します。列挙によりインデックス 0 にエフェクトが存在すると仮定することを回避できます。

次の例はメインシーケンスとインタラクティブシーケンスのエフェクトを持つシェイプを作成し、対象シェイプのエフェクトを取得してスライド上のすべてのシーケンスを列挙します。

import com.aspose.slides.*;

public class ReadShapeAnimations {
    public static void main(String[] args) {
        Presentation presentation = new Presentation();
        try {
            ISlide slide = presentation.getSlides().get_Item(0);
            IAutoShape targetShape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 120, 100, 320, 80);
            targetShape.addTextFrame("Animated shape");

            ISequence mainSequence = slide.getTimeline().getMainSequence();
            mainSequence.addEffect(targetShape, EffectType.Fade, EffectSubtype.None, EffectTriggerType.OnClick);

            IAutoShape triggerShape = slide.getShapes().addAutoShape(ShapeType.Bevel, 20, 20, 100, 40);
            triggerShape.addTextFrame("Move");

            ISequence interactiveSequence = slide.getTimeline().getInteractiveSequences().add(triggerShape);
            interactiveSequence.addEffect(targetShape, EffectType.PathFootball, EffectSubtype.None, EffectTriggerType.OnClick);

            IEffect[] targetEffects = mainSequence.getEffectsByShape(targetShape);
            System.out.println("The main sequence contains " + targetEffects.length + " effect(s) for " + targetShape.getName() + ".");

            printSequence("Main sequence", mainSequence);

            int interactiveIndex = 1;
            for (ISequence sequence : slide.getTimeline().getInteractiveSequences()) {
                String triggerName = sequence.getTriggerShape() == null ? "unknown" : sequence.getTriggerShape().getName();
                String sequenceLabel = "Interactive sequence " + interactiveIndex + ", trigger: " + triggerName;
                printSequence(sequenceLabel, sequence);
                interactiveIndex++;
            }
        } finally {
            presentation.dispose();
        }
    }

    private static void printSequence(String label, ISequence sequence) {
        System.out.println("  " + label + ": " + sequence.getCount() + " effect(s)");

        for (IEffect effect : sequence) {
            String targetName = effect.getTargetShape() == null ? "unknown" : effect.getTargetShape().getName();
            String typeName = EffectType.getName(EffectType.class, effect.getType());
            String subtypeName = EffectSubtype.getName(EffectSubtype.class, effect.getSubtype());
            String triggerName = EffectTriggerType.getName(EffectTriggerType.class, effect.getTiming().getTriggerType());
            String effectDescription = typeName + " " + subtypeName + "; target: " + targetName + "; trigger: " + triggerName;
            System.out.println("    " + effectDescription);
        }
    }
}

特定のシェイプだけのエフェクトが必要な場合は、名前、プレースホルダータイプ、または他の安定したプロパティでシェイプを特定し、ISequence.getEffectsByShape を呼び出します。インデックス 0 の IShapeCollection.get_Item が常に目的のオブジェクトであると仮定しないでください。

継承プレースホルダーエフェクトの操作

通常スライド上のプレースホルダーは、レイアウトスライドやマスタースライド上の対応するプレースホルダーからアニメーション動作を継承できます。IShape.getBasePlaceholder は親プレースホルダーを返し、存在しない場合は null を返します。

以下の例のプレゼンテーションでは、フッターが通常スライドで Random Bars、レイアウトスライドで Split、マスタースライドで Fly In というエフェクトを持っています。

通常スライドのフッターアニメーション効果

レイアウトスライドのフッタープレースホルダーアニメーション効果

マスタースライドのフッタープレースホルダーアニメーション効果

次の例は新しいプレゼンテーションのプレースホルダー階層を使用します。マスタープレースホルダー、レイアウトプレースホルダー、通常スライド上の対応プレースホルダーにエフェクトを追加します。すべての IShape.getBasePlaceholder 呼び出しは、返されたシェイプが使用される前にチェックされます。

import com.aspose.slides.*;

public class InheritedPlaceholderAnimations {
    public static void main(String[] args) {
        Presentation presentation = new Presentation();
        try {
            ILayoutSlide layoutSlide = presentation.getLayoutSlides().getByType(SlideLayoutType.TitleAndObject);
            IShape layoutPlaceholder = findPlaceholderWithBase(layoutSlide);

            if (layoutPlaceholder == null) {
                throw new IllegalStateException("The layout slide does not contain a placeholder linked to its master slide.");
            }

            IShape masterPlaceholder = layoutPlaceholder.getBasePlaceholder();
            layoutSlide.getMasterSlide().getTimeline().getMainSequence().addEffect(masterPlaceholder, EffectType.Fly, EffectSubtype.Bottom, EffectTriggerType.OnClick);
            layoutSlide.getTimeline().getMainSequence().addEffect(layoutPlaceholder, EffectType.Split, EffectSubtype.VerticalIn, EffectTriggerType.OnClick);

            ISlide slide = presentation.getSlides().addEmptySlide(layoutSlide);
            IShape slidePlaceholder = findPlaceholderWithBase(slide, layoutPlaceholder);

            if (slidePlaceholder == null) {
                throw new IllegalStateException("The slide does not contain a placeholder linked to its layout slide.");
            }

            slide.getTimeline().getMainSequence().addEffect(slidePlaceholder, EffectType.RandomBars, EffectSubtype.Horizontal, EffectTriggerType.OnClick);
            printEffects("Normal slide", slide.getTimeline().getMainSequence().getEffectsByShape(slidePlaceholder));

            IShape baseLayoutPlaceholder = slidePlaceholder.getBasePlaceholder();
            if (baseLayoutPlaceholder != null) {
                printEffects("Layout slide", layoutSlide.getTimeline().getMainSequence().getEffectsByShape(baseLayoutPlaceholder));

                IShape baseMasterPlaceholder = baseLayoutPlaceholder.getBasePlaceholder();
                if (baseMasterPlaceholder != null) {
                    printEffects("Master slide", layoutSlide.getMasterSlide().getTimeline().getMainSequence().getEffectsByShape(baseMasterPlaceholder));
                }
            }

            presentation.save("placeholder-animations.pptx", SaveFormat.Pptx);
        } finally {
            presentation.dispose();
        }
    }

    private static IShape findPlaceholderWithBase(ILayoutSlide layoutSlide) {
        for (IShape shape : layoutSlide.getShapes()) {
            if (shape.getBasePlaceholder() != null) {
                return shape;
            }
        }

        return null;
    }

    private static IShape findPlaceholderWithBase(ISlide slide, IShape expectedBase) {
        for (IShape shape : slide.getShapes()) {
            if (shape.getBasePlaceholder() == expectedBase) {
                return shape;
            }
        }

        return null;
    }

    private static void printEffects(String source, IEffect[] effects) {
        System.out.println(source + ": " + effects.length + " effect(s)");

        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);
        }
    }
}

アニメーションタイミングの変更

PowerPoint の Timing ダイアログは ITiming のプロパティに対応しています。

アニメーション効果の PowerPoint タイミングダイアログ

Start は ITiming.getTriggerType にマッピングされます。
Duration は ITiming.getDuration にマッピングされ、秒単位です。
Delay は ITiming.getTriggerDelayTime にマッピングされ、秒単位です。
Repeat は ITiming.getRepeatCount 、ITiming.getRepeatUntilNextClick、または ITiming.getRepeatUntilEndSlide にマッピングされます。
Rewind when done playing は ITiming.getRewind にマッピングされます。

この独立した例はエフェクトを追加し、ISequence.addEffect が返すオブジェクトを介してタイミングを変更し、結果を保存します。返された IEffect 参照を保持することで不要なコレクションインデックス取得を回避します。

import com.aspose.slides.*;

public class ChangeAnimationTiming {
    public static void main(String[] args) {
        Presentation presentation = new Presentation();
        try {
            ISlide slide = presentation.getSlides().get_Item(0);
            IAutoShape shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 120, 100, 320, 80);
            shape.addTextFrame("Timed animation");

            IEffect effect = slide.getTimeline().getMainSequence().addEffect(shape, EffectType.Fade, EffectSubtype.None, EffectTriggerType.OnClick);
            effect.getTiming().setTriggerType(EffectTriggerType.OnClick);
            effect.getTiming().setDuration(2.0f);
            effect.getTiming().setTriggerDelayTime(0.5f);
            effect.getTiming().setRepeatUntilNextClick(false);
            effect.getTiming().setRepeatUntilEndSlide(false);
            effect.getTiming().setRepeatCount(2.0f);
            effect.getTiming().setRewind(true);

            presentation.save("shape-animation-timing.pptx", SaveFormat.Pptx);
        } finally {
            presentation.dispose();
        }
    }
}

繰り返しモードは一方のみ使用してください。繰り返し回数と「until」フラグを組み合わせると、ビューアーごとに混乱を招く結果になることがあります。繰り返しモードを変更する際は、ITiming.setRepeatUntilNextClick と ITiming.setRepeatUntilEndSlide を ITiming.setRepeatCount より先に呼び出してください。どちらかのフラグを設定するとアクティブな繰り返しモードも変更されます。

アニメーションサウンドの追加と抽出

アニメーションエフェクトは IEffect.getSound を使用して埋め込みオーディオを参照できます。IEffect.setStopPreviousSound は、以前のエフェクトで開始されたサウンドを停止するよう指示します。

エフェクトにサウンドを追加

次の例はローカルの音声ファイル animation-sound.wav が存在することを前提としています。2 つのエフェクトを作成し、最初のエフェクトにそのファイルをサウンドとして埋め込み、2 番目のエフェクトでサウンドを停止するよう設定します。ISequence.addEffect が返すオブジェクトを使用するため、シーケンスインデックスは不要です。

import com.aspose.slides.*;
import java.io.IOException;
import java.nio.file.Files;
import java.nio.file.Paths;

public class AddAnimationSound {
    public static void main(String[] args) throws IOException {
        Presentation presentation = new Presentation();
        try {
            ISlide slide = presentation.getSlides().get_Item(0);
            IAutoShape firstShape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 80, 100, 240, 80);
            IAutoShape secondShape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 400, 100, 240, 80);
            firstShape.addTextFrame("Starts sound");
            secondShape.addTextFrame("Stops sound");

            ISequence sequence = slide.getTimeline().getMainSequence();
            IEffect firstEffect = sequence.addEffect(firstShape, EffectType.Fade, EffectSubtype.None, EffectTriggerType.OnClick);
            IEffect secondEffect = sequence.addEffect(secondShape, EffectType.Fade, EffectSubtype.None, EffectTriggerType.OnClick);

            byte[] audioData = Files.readAllBytes(Paths.get("animation-sound.wav"));
            IAudio effectSound = presentation.getAudios().addAudio(audioData);
            firstEffect.setSound(effectSound);
            secondEffect.setStopPreviousSound(true);

            presentation.save("shape-animation-sound.pptx", SaveFormat.Pptx);
        } finally {
            presentation.dispose();
        }
    }
}

埋め込みエフェクトサウンドの抽出

次の例はローカルのプレゼンテーション presentation-with-animation-sounds.pptx が存在することを前提としています。メインシーケンスとインタラクティブシーケンスの両方を走査し、埋め込まれたすべてのエフェクトサウンドを extracted-animation-sounds ディレクトリに書き出します。拡張子は IAudio.getContentType が返すオーディオ MIME タイプから選択されます。

import com.aspose.slides.*;
import java.io.IOException;
import java.nio.file.Files;
import java.nio.file.Path;
import java.nio.file.Paths;
import java.util.Locale;

public class ExtractAnimationSounds {
    public static void main(String[] args) throws IOException {
        Path inputPath = Paths.get("presentation-with-animation-sounds.pptx");
        Path outputDirectory = Paths.get("extracted-animation-sounds");

        Files.createDirectories(outputDirectory);

        Presentation presentation = new Presentation(inputPath.toString());
        try {
            int soundIndex = 1;

            for (ISlide slide : presentation.getSlides()) {
                soundIndex = saveSounds(slide.getTimeline().getMainSequence(), outputDirectory, soundIndex);

                for (ISequence sequence : slide.getTimeline().getInteractiveSequences()) {
                    soundIndex = saveSounds(sequence, outputDirectory, soundIndex);
                }
            }

            System.out.println("Extracted " + (soundIndex - 1) + " sound file(s) to " + outputDirectory.toAbsolutePath() + ".");
        } finally {
            presentation.dispose();
        }
    }

    private static int saveSounds(ISequence sequence, Path outputDirectory, int soundIndex) throws IOException {
        for (IEffect effect : sequence) {
            if (effect.getSound() == null) {
                continue;
            }

            String extension = getAudioExtension(effect.getSound().getContentType());
            Path outputPath = outputDirectory.resolve("effect-sound-" + soundIndex + extension);
            Files.write(outputPath, effect.getSound().getBinaryData());
            soundIndex++;
        }

        return soundIndex;
    }

    private static String getAudioExtension(String contentType) {
        String normalizedType = contentType == null ? "" : contentType.toLowerCase(Locale.ROOT);

        if (normalizedType.equals("audio/mpeg")) {
            return ".mp3";
        }

        if (normalizedType.equals("audio/mp4")) {
            return ".m4a";
        }

        if (normalizedType.equals("audio/ogg")) {
            return ".ogg";
        }

        if (normalizedType.equals("audio/wav") || normalizedType.equals("audio/x-wav")) {
            return ".wav";
        }

        return ".bin";
    }
}

大容量のオーディオオブジェクトの場合は、IAudio.getStream を使用してストリームをファイルにコピーし、全体をバイト配列としてロードしないようにしてください。

アフターアニメーション動作の設定

After animation オプションはエフェクトが終了した後のシェイプの状態を制御します。

After アニメーション設定を示す PowerPoint 効果オプションダイアログ

AfterAnimationType クラスは、シェイプをそのまま残す、色を変更する、アニメーション後に非表示にする、または次のクリックで非表示にする、という動作をサポートします。タイプが AfterAnimationType.Color の場合は、IEffect.getAfterAnimationColor も設定してください。

この独立した例はエフェクトを作成し、取得したエフェクトオブジェクトを通じてアフターアニメーション動作を設定し、結果を保存します。

import com.aspose.slides.*;
import java.awt.Color;

public class SetAfterAnimationBehavior {
    public static void main(String[] args) {
        Presentation presentation = new Presentation();
        try {
            ISlide slide = presentation.getSlides().get_Item(0);
            IAutoShape shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 120, 100, 320, 80);
            shape.addTextFrame("Dim after animation");

            IEffect effect = slide.getTimeline().getMainSequence().addEffect(shape, EffectType.Fade, EffectSubtype.None, EffectTriggerType.OnClick);
            effect.setAfterAnimationType(AfterAnimationType.Color);
            effect.getAfterAnimationColor().setColor(Color.LIGHT_GRAY);

            presentation.save("shape-animation-after-effect.pptx", SaveFormat.Pptx);
        } finally {
            presentation.dispose();
        }
    }
}

AfterAnimationType.Color 以外のタイプに変更すると、アフターアニメーションの色設定はクリアされます。

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

テキストアニメーションには次の 2 つの関連コントロールがあります。

ITextAnimation.getBuildType は段落単位で表示するか、全体として表示するかを制御します。
IEffect.getAnimateTextType はテキストの表示方式（全体、一語単位、文字単位）を制御します。IEffect.getDelayBetweenTextParts は語または文字間の遅延を設定します。正の値はエフェクト期間のパーセンテージ、負の値は秒単位の遅延です。

次の独立した例はテキストボックス内の単語をアニメーション化します。BuildType.AsOneObject を使用すると段落単位の構築が無効化され、単語設定がテキストフレーム全体に適用されます。

import com.aspose.slides.*;

public class AnimateTextByWord {
    public static void main(String[] args) {
        Presentation presentation = new Presentation();
        try {
            ISlide slide = presentation.getSlides().get_Item(0);
            IAutoShape textBox = slide.getShapes().addAutoShape(ShapeType.Rectangle, 80, 80, 560, 100);
            textBox.addTextFrame("Aspose.Slides animates this sentence word by word.");

            IEffect effect = slide.getTimeline().getMainSequence().addEffect(textBox, EffectType.Fade, EffectSubtype.None, EffectTriggerType.OnClick);
            effect.getTextAnimation().setBuildType(BuildType.AsOneObject);
            effect.setAnimateTextType(AnimateTextType.ByWord);
            effect.setDelayBetweenTextParts(20.0f);

            presentation.save("animated-text.pptx", SaveFormat.Pptx);
        } finally {
            presentation.dispose();
        }
    }
}

テキストボックスを段落単位で構築したい場合は、BuildType.ByLevelParagraphs1（または他の段落レベル）を設定してください。単一の段落に独自のエフェクトを適用したい場合は、ISequence.addEffect のオーバーロードで IParagraph を受け取ります。段落レベルの例についてはアニメーションテキストを参照してください。

エクスポートと互換性に関する注意事項

PPT または PPTX で保存するとアニメーションモデルは保持されますが、最終的な再生はプレゼンテーションビューアーが制御します。
PDF および静的画像はアニメーションを再生しません。出力で動きを示す必要がある場合は、HTML5 エクスポート、アニメーション GIF、または動画変換を使用してください。
HTML5 では Html5Options.setAnimateShapes を有効にし、必要に応じて Html5Options.setAnimateTransitions も有効にしてください。
動画レンダリングは多くの一般的な入場、強調、退出、モーションパスエフェクトをサポートしますが、すべての PowerPoint エフェクトがサポートされているわけではありません。現在のサポートされているアニメーションとエフェクトを確認し、対象の Aspose.Slides バージョンで重要なプレゼンテーションをテストしてください。
高度なカスタムエフェクトや他のプレゼンテーション形式からインポートされたエフェクトはファイルに保持されることがありますが、PowerPoint、HTML5、または動画でのレンダリングが異なる場合があります。エフェクト名だけに依存せず、エクスポート結果を必ず検証してください。

FAQ

なぜ PowerPoint ではアニメーションが表示されるのに PDF では表示されないのですか？

PDF は静的フォーマットであるため、アニメーションやスライド遷移は再生されません。動きを保持する必要がある場合は、HTML5、アニメーション GIF、または動画にエクスポートしてください。

なぜ動画でエフェクトの再生が異なるのですか？

動画エクスポートはアニメーションをレンダリングして保存し、元の PowerPoint の動作をそのまま保持しません。一部の高度なエフェクトは未サポートか近似されます。サポートされているエフェクト表を確認し、実際のプレゼンテーションをテストしてから本番利用してください。

シェイプを前面または背面に移動するとアニメーション順序が変わりますか？

いいえ。シェイプの Z オーダーは重なりを制御し、シーケンスの順序とトリガーがアニメーションの再生順序を制御します。再生順序を変更したい場合はタイムラインを調整してください。

Java のプレゼンテーションからシェイプの実効プロパティを取得する Javaでプレゼンテーションシェイプのサムネイルを作成する

Java を使用したプレゼンテーションでのシェイプ アニメーションの適用

このページの概要

概要

シェイプ アニメーションの追加

シェイプ アニメーションの取得

継承プレースホルダー エフェクトの操作

アニメーション タイミングの変更

アニメーション サウンドの追加と抽出