.NET のプレゼンテーションでシェイプアニメーションを適用する

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

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

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

PowerPoint は、entrance、exit、emphasis、およびmotion paths カテゴリにわたるアニメーションとアニメーション効果の多くのオプションとツールを提供します。

Aspose.Slides のアニメーション

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

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

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

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

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

// プレゼンテーションファイルを表すプレゼンテーションクラスのインスタンスを作成します。
using (Presentation pres = new Presentation())
{
    ISlide sld = pres.Slides[0];
    
    // テキスト付きの新しいAutoShapeを追加します
    IAutoShape autoShape = sld.Shapes.AddAutoShape(ShapeType.Rectangle, 20, 20, 150, 100);

    ITextFrame textFrame = autoShape.TextFrame;
    textFrame.Text = "First paragraph \nSecond paragraph \n Third paragraph";

    // スライドのメインシーケンスを取得します
    ISequence sequence = sld.Timeline.MainSequence;

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

    // シェイプテキストを第1レベル段落単位でアニメートします
    effect.TextAnimation.BuildType = BuildType.ByLevelParagraphs1;

    // PPTXファイルをディスクに保存します
    pres.Save(path + "AnimTextBox_out.pptx", SaveFormat.Pptx);
}

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

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

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

この C# コードは、Fly 効果を picture frame に適用する方法を示します：

// プレゼンテーションファイルを表すプレゼンテーションクラスのインスタンスを作成します。
using (Presentation pres = new Presentation())
{
    // プレゼンテーションの画像コレクションに追加する画像を読み込みます
    IImage image = Images.FromFile("aspose-logo.jpg");
    IPPImage ppImage = pres.Images.AddImage(image);
    image.Dispose();

    // スライドに画像フレームを追加します
    IPictureFrame picFrame = pres.Slides[0].Shapes.AddPictureFrame(ShapeType.Rectangle, 50, 50, 100, 100, ppImage);

    // スライドのメインシーケンスを取得します
    ISequence sequence = pres.Slides[0].Timeline.MainSequence;

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

    // PPTXファイルをディスクに保存します
    pres.Save("AnimImage_out.pptx", SaveFormat.Pptx);
}

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

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

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

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

    // 既存のシェイプに対してPathFootball効果を一から作成します。
    IAutoShape ashp = sld.Shapes.AddAutoShape(ShapeType.Rectangle, 150, 150, 250, 25);

    ashp.AddTextFrame("Animated TextBox");

    // PathFootBallアニメーション効果を追加します。
    pres.Slides[0].Timeline.MainSequence.AddEffect(ashp, EffectType.PathFootball,
                           EffectSubtype.None, EffectTriggerType.AfterPrevious);

    // いわゆる「ボタン」を作成します。
    IShape shapeTrigger = pres.Slides[0].Shapes.AddAutoShape(ShapeType.Bevel, 10, 10, 20, 20);

    // ボタン用の効果シーケンスを作成します。
    ISequence seqInter = pres.Slides[0].Timeline.InteractiveSequences.Add(shapeTrigger);

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

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

    PointF[] pts = new PointF[1];
    pts[0] = new PointF(0.076f, 0.59f);
    motionBvh.Path.Add(MotionCommandPathType.LineTo, pts, MotionPathPointsType.Auto, true);
    pts[0] = new PointF(-0.076f, -0.59f);
    motionBvh.Path.Add(MotionCommandPathType.LineTo, pts, MotionPathPointsType.Auto, false);
    motionBvh.Path.Add(MotionCommandPathType.End, null, MotionPathPointsType.Auto, false);

    // PPTXファイルをディスクに書き込みます
    pres.Save("AnimExample_out.pptx", SaveFormat.Pptx);
}

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

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

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

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

using (Presentation presentation = new Presentation("AnimExample_out.pptx"))
{
    ISlide firstSlide = presentation.Slides[0];

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

    // スライド上の最初のシェイプを取得します。
    IShape shape = firstSlide.Shapes[0];

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

    if (shapeEffects.Length > 0)
        Console.WriteLine($"The shape {shape.Name} has {shapeEffects.Length} animation effects.");
}

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

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

たとえば、sample.pptx という PowerPoint ファイルにフッター shape（テキスト「Made with Aspose.Slides」）が1つだけあり、Random Bars 効果がその shape に適用されているとします。

スライドシェイプアニメーション効果

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

レイアウトシェイプアニメーション効果

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

マスターシェイプアニメーション効果

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

using (Presentation presentation = new Presentation("sample.pptx"))
{
    ISlide slide = presentation.Slides[0];

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

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

    // マスタースライド上のプレースホルダーのアニメーション効果を取得します。
    IShape masterShape = layoutShape.GetBasePlaceholder();
    IEffect[] masterShapeEffects = slide.LayoutSlide.MasterSlide.Timeline.MainSequence.GetEffectsByShape(masterShape);

    Console.WriteLine("Main sequence of shape effects:");
    PrintEffects(masterShapeEffects);
    PrintEffects(layoutShapeEffects);
    PrintEffects(shapeEffects);
}

static void PrintEffects(IEnumerable<IEffect> effects)
{
    foreach (IEffect effect in effects)
    {
        Console.WriteLine($"{effect.Type} {effect.Subtype}");
    }
}

出力：

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

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

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

これは Microsoft PowerPoint のアニメーションタイミングパネルと拡張メニューです：

example1_image

以下は PowerPoint のタイミングと Effect.Timing プロパティの対応関係です：

PowerPoint のタイミング Start ドロップダウンは Effect.Timing.TriggerType プロパティに対応します。
PowerPoint のタイミング Duration は Effect.Timing.Duration プロパティに対応します。アニメーションの期間（秒）は、アニメーションが 1 サイクルを完了するのにかかる総時間です。
PowerPoint のタイミング Delay は Effect.Timing.TriggerDelayTime プロパティに対応します。
PowerPoint のタイミング Repeat ドロップダウンは次のプロパティに対応します：
- Effect.Timing.RepeatCount プロパティ（効果が繰り返される回数）
- Effect.Timing.RepeatUntilEndSlide フラグ（スライドの最後まで繰り返すか）
- Effect.Timing.RepeatUntilNextClick フラグ（次のクリックまで繰り返すか）
PowerPoint のタイミング Rewind when done playing チェックボックスは Effect.Timing.Rewind プロパティに対応します。

Effect のタイミングプロパティを変更する手順：

Apply するか、アニメーション効果を取得します。
必要な Effect.Timing プロパティに新しい値を設定します。
修正した PPTX ファイルを保存します。

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

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

    // メインシーケンスの最初の効果を取得します。
    IEffect effect = sequence[0];

    // 効果の TriggerType をクリックで開始するように変更します。
    effect.Timing.TriggerType = EffectTriggerType.OnClick;

    // 効果の Duration を変更します。
    effect.Timing.Duration = 3f;

    // 効果の TriggerDelayTime を変更します。
    effect.Timing.TriggerDelayTime = 0.5f;

    // 効果の Repeat 値が "none" の場合
    if (effect.Timing.RepeatCount == 1f)
    {
        // 効果の Repeat を "Until Next Click" に変更します。
        effect.Timing.RepeatUntilNextClick = true;
    }
    else
    {
        // 効果の Repeat を "Until End of Slide" に変更します。
        effect.Timing.RepeatUntilEndSlide = true;
    }

    // 効果の Rewind を有効にします。
        effect.Timing.Rewind = true;
    
    // PPTX ファイルをディスクに保存します。
    pres.Save("AnimExample_changed.pptx", SaveFormat.Pptx);
}

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

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

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

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

using (Presentation pres = new Presentation("AnimExample_out.pptx"))
{
	// プレゼンテーションのオーディオコレクションに音声を追加します
	IAudio effectSound = pres.Audios.AddAudio(File.ReadAllBytes("sampleaudio.wav"));

	ISlide firstSlide = pres.Slides[0];

	// スライドのメインシーケンスを取得します。
	ISequence sequence = firstSlide.Timeline.MainSequence;

	// メインシーケンスの最初の効果を取得します。
	IEffect firstEffect = sequence[0];

	// 効果に「サウンドなし」があるかチェックします
	if (!firstEffect.StopPreviousSound && firstEffect.Sound == null)
	{
		// 最初の効果にサウンドを追加します
		firstEffect.Sound = effectSound;
	}

	// スライドの最初のインタラクティブシーケンスを取得します。
	ISequence interactiveSequence = firstSlide.Timeline.InteractiveSequences[0];

	// 効果の「前のサウンドを停止」フラグを設定します
	interactiveSequence[0].StopPreviousSound = true;

	// PPTXファイルをディスクに書き込みます
	pres.Save("AnimExample_Sound_out.pptx", SaveFormat.Pptx);
}

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

Presentation クラスのインスタンスを作成します。
スライドのインデックスを使用して参照を取得します。
主なエフェクトシーケンスを取得します。
各アニメーション効果に埋め込まれた Sound を抽出します。

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

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

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

    foreach (IEffect effect in sequence)
    {
        if (effect.Sound == null)
            continue;

        // エフェクトのサウンドをバイト配列として抽出します
        byte[] audio = effect.Sound.BinaryData;
    }
}

アフターアニメーション

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

これは Microsoft PowerPoint のアニメーション効果パネルと拡張メニューです：

example1_image

PowerPoint の After animation ドロップダウンは次のプロパティに対応します：

IEffect.AfterAnimationType プロパティ（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 タイプに対応します。
IEffect.AfterAnimationColor プロパティは After animation のカラー形式を定義します。このプロパティは AfterAnimationType.Color タイプと連動して動作します。タイプを別のものに変更すると、After animation のカラーはクリアされます。

この C# コードは、After animation 効果を変更する方法を示します：

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

    // メインシーケンスの最初の効果を取得します
    IEffect firstEffect = firstSlide.Timeline.MainSequence[0];

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

    // アフターアニメーションの暗くする色を設定します
    firstEffect.AfterAnimationColor.Color = Color.AliceBlue;

    // PPTX ファイルをディスクに書き込みます
    pres.Save("AnimImage_AfterAnimation.pptx", SaveFormat.Pptx);
}

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

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

IEffect.AnimateTextType（効果の Animate text タイプ）形状のテキストは次のいずれかでアニメーション化できます：
- All at once（AnimateTextType.AllAtOnce）
- By word（AnimateTextType.ByWord）
- By letter（AnimateTextType.ByLetter）
IEffect.DelayBetweenTextParts は、アニメーション化されたテキスト部分（単語または文字）間の遅延を設定します。正の値は効果継続時間のパーセンテージを示し、負の値は秒単位の遅延を示します。

Effect の Animate text プロパティを変更する手順：

Apply するか、アニメーション効果を取得します。
IEffect.TextAnimation.BuildType プロパティを BuildType.AsOneObject の値に設定し、By Paragraphs アニメーションモードをオフにします。
新しい値を IEffect.AnimateTextType および IEffect.DelayBetweenTextParts に設定します。
修正した PPTX ファイルを保存します。

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

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

	// メインシーケンスの最初の効果を取得します
	IEffect firstEffect = firstSlide.Timeline.MainSequence[0];

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

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

	// 単語間の遅延をエフェクト期間の20%に設定します
	firstEffect.DelayBetweenTextParts = 20f;

	// PPTX ファイルをディスクに保存します
	pres.Save("AnimTextBox_AnimateText.pptx", SaveFormat.Pptx);
}

FAQ

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

HTML5 へのエクスポートを使用し、shape および transition アニメーションを有効にするオプションを設定します。プレーン HTML ではスライドアニメーションは再生されませんが、HTML5 では再生されます。

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

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

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

一般に、アニメーションはサポートされています、ただしまれに例外や特定の効果が異なる方法でレンダリングされることがあります。使用する効果とライブラリのバージョンでテストすることを推奨します。

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

.NET のプレゼンテーションでシェイプ アニメーションを適用する