Javaでカスタムアニメーションビヘイビアを作成および変更する

このページの概要

Aspose.Slides for Java を使用して、PowerPoint プレゼンテーション内のカスタムアニメーションビヘイビアと編集可能なモーションパスを作成、検査、変更します。

概要

カスタムアニメーションビヘイビアを使用すると、色の変更、形状の回転、編集可能なモーションパスの追従など、アニメーション効果内の個々の操作を制御できます。このガイドでは、ビヘイビアの作成と組み合わせ、タイミングの構成、既存のアニメーションの検査と変更、そしてプロパティがプレゼンテーションの保存と再オープン後も保持されることを確認する方法を示します。

事前定義された効果やクリックトリガーについては、Shape Animation を参照してください。

アニメーションモデルの理解

アニメーションは Timeline → Sequence → Effect → Behaviors の階層で構成されます。

getTimeline メソッドはスライドのタイムラインを返し、メインシーケンスとインタラクティブシーケンスを含みます。
ISequence は効果を保持し、異なる形状を対象にできる場合があります。
IEffect は対象形状、プリセット、サブタイプ、効果のタイミングを識別します。
IEffect.getBehaviors が返すコレクションには、色の変更、移動、回転、プロパティ設定など、効果を実装する操作が含まれます。

個々のビヘイビアの作成

ISequence.addEffect を呼び出して効果を作成し、getBehaviors コレクションにアクセスします。プリセットはこのコレクションを自動的に構成できます。プリセットを拡張する際はその操作を保持し、意図的に置き換える場合は clear を使用します。

IBehaviorFactory は以下に示す 8 種類のビヘイビアを生成します。モーションは Build a Motion Path で扱います。各スニペットにはインポートが含まれます。実行文はメソッド内に配置してください。後の編集例では使用する出力ファイルを示します。

回転

createRotationEffect で回転効果を作成します。getBy は相対角度（度）を指定し、getFrom と getTo は開始点と終了点を指定します。

この例は Spin 効果で開始し、プリセットの操作を 1 つの回転ビヘイビアに置き換え、継続時間を 2 秒に設定します。90 度の相対角度は形状の開始向きからの 1/4 回転を表すため、明示的な開始角度は不要です。

import com.aspose.slides.*;

Presentation presentation = new Presentation();
try {
    ISlide slide = presentation.getSlides().get_Item(0);

    IAutoShape shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 100, 100, 160, 80);

    IEffect effect = slide.getTimeline().getMainSequence().addEffect(shape, EffectType.Spin, EffectSubtype.None, EffectTriggerType.OnClick);
    effect.getBehaviors().clear();

    IBehaviorFactory factory = new BehaviorFactory();
    IRotationEffect rotation = factory.createRotationEffect();
    rotation.setBy(90f);
    rotation.getTiming().setDuration(2f);

    effect.getBehaviors().add(rotation);

    presentation.save("rotation.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

rotation.pptx には 1 つの形状と 1 つの回転ビヘイビアが含まれます。以下のコレクション、タイミング、回転編集例はこのファイルを使用します。

拡大縮小

createScaleEffect を X/Y パーセンテージで使用します。getFrom と getTo は開始サイズと終了サイズを示し、getBy は相対変化を示します。ここで 100 は元のサイズです。

例では両方の次元を 100% から 125% に 2 秒かけて拡大します。水平・垂直のパーセンテージを同等にすると形状の比率が保たれ、異なるパーセンテージにすると一方の次元が伸びます。

import com.aspose.slides.*;
import java.awt.geom.Point2D;

Presentation presentation = new Presentation();
try {
    ISlide slide = presentation.getSlides().get_Item(0);

    IAutoShape shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 100, 100, 160, 80);

    IEffect effect = slide.getTimeline().getMainSequence().addEffect(shape, EffectType.GrowShrink, EffectSubtype.None, EffectTriggerType.OnClick);
    effect.getBehaviors().clear();

    IBehaviorFactory factory = new BehaviorFactory();
    IScaleEffect scale = factory.createScaleEffect();
    scale.setFrom(new Point2D.Float(100, 100));
    scale.setTo(new Point2D.Float(125, 125));
    scale.getTiming().setDuration(2f);

    effect.getBehaviors().add(scale);

    presentation.save("scale.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

カラー

createColorEffect で塗りつぶしを青からオレンジに変更します。getFrom と getTo は色を示し、getBy はカラーオフセットです。IBehavior.getProperties はアニメーション対象の属性を特定します。

形状の実体塗りは青で初期化され、アニメーションの開始色と一致します。塗りつぶしカラー属性を選択することで、どの部分を変更すべきかビヘイビアに指示します。保存された効果は 2 秒でオレンジに遷移することを記述しています。

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

Presentation presentation = new Presentation();
try {
    ISlide slide = presentation.getSlides().get_Item(0);

    IAutoShape shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 100, 100, 160, 80);
    shape.getFillFormat().setFillType(FillType.Solid);
    shape.getFillFormat().getSolidFillColor().setColor(Color.BLUE);

    IEffect effect = slide.getTimeline().getMainSequence().addEffect(shape, EffectType.ChangeFillColor, EffectSubtype.None, EffectTriggerType.OnClick);
    effect.getBehaviors().clear();

    IBehaviorFactory factory = new BehaviorFactory();
    IColorEffect color = factory.createColorEffect();
    color.getProperties().add(BehaviorProperty.getFillColor().getValue());
    color.getFrom().setColor(Color.BLUE);
    Color orange = new Color(255, 165, 0);
    color.getTo().setColor(orange);
    color.getTiming().setDuration(2f);

    effect.getBehaviors().add(color);

    presentation.save("color.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

フィルタ

createFilterEffect でワイプを選択します。getType、getSubtype、getReveal がそれぞれフィルタ、方向、表示/非表示を指定します。

この例は右方向サブタイプで形状を表示する 2 秒のワイプを構成します。フィルタ設定は効果内のビヘイビアに属するため、プリセットの元の操作を削除した後に設定します。

import com.aspose.slides.*;

Presentation presentation = new Presentation();
try {
    ISlide slide = presentation.getSlides().get_Item(0);

    IAutoShape shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 100, 100, 160, 80);

    IEffect effect = slide.getTimeline().getMainSequence().addEffect(shape, EffectType.Wipe, EffectSubtype.None, EffectTriggerType.OnClick);
    effect.getBehaviors().clear();

    IBehaviorFactory factory = new BehaviorFactory();
    IFilterEffect filter = factory.createFilterEffect();
    filter.setType(FilterEffectType.Wipe);
    filter.setSubtype(FilterEffectSubtype.Right);
    filter.setReveal(FilterEffectRevealType.In);
    filter.getTiming().setDuration(2f);

    effect.getBehaviors().add(filter);

    presentation.save("filter.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

プロパティ

createPropertyEffect で不透明度をアニメーション化します。getFrom・getTo・getBy は文字列で、getValueType と getCalcMode によって解釈されます。3 つすべてを無差別に設定せず、エンドポイントまたは相対オフセットのいずれかを選択してください。

ここでは属性として不透明度を選び、数値文字列で 25% から 100% への変化を表します。線形補間により段階的に変化します。他の属性に適用する場合は、その属性に適した値タイプとエンドポイント値を選びます。

import com.aspose.slides.*;

Presentation presentation = new Presentation();
try {
    ISlide slide = presentation.getSlides().get_Item(0);

    IAutoShape shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 100, 100, 160, 80);

    IEffect effect = slide.getTimeline().getMainSequence().addEffect(shape, EffectType.Fade, EffectSubtype.None, EffectTriggerType.OnClick);
    effect.getBehaviors().clear();

    IBehaviorFactory factory = new BehaviorFactory();
    IPropertyEffect property = factory.createPropertyEffect();
    property.getProperties().add(BehaviorProperty.getStyleOpacity().getValue());
    property.setValueType(PropertyValueType.Number);
    property.setCalcMode(PropertyCalcModeType.Linear);
    property.setFrom("0.25");
    property.setTo("1");
    property.getTiming().setDuration(2f);

    effect.getBehaviors().add(property);

    presentation.save("property.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

設定

createSetEffect を使用して、getTo により可視性を割り当てます。セットビヘイビアはエンドポイント間を補間しません。

例では可視性属性を選択し、ビヘイビア実行時に文字列 visible を設定します。最小構成のプレゼンテーションでは矩形は既に表示されているため、単独では視覚的変化が顕著でないことがあります。これは、形状の表示/非表示を制御する他の効果と組み合わせて使用するのに有用です。

import com.aspose.slides.*;

Presentation presentation = new Presentation();
try {
    ISlide slide = presentation.getSlides().get_Item(0);

    IAutoShape shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 100, 100, 160, 80);

    IEffect effect = slide.getTimeline().getMainSequence().addEffect(shape, EffectType.Appear, EffectSubtype.None, EffectTriggerType.OnClick);
    effect.getBehaviors().clear();

    IBehaviorFactory factory = new BehaviorFactory();
    ISetEffect set = factory.createSetEffect();
    set.getProperties().add(BehaviorProperty.getStyleVisibility().getValue());
    set.setTo("visible");

    effect.getBehaviors().add(set);

    presentation.save("set.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

コマンド

createCommandEffect を使用し、getType・getCommandString・getShapeTarget を構成します。作業ディレクトリに sample.wav という WAV 録音ファイルを配置してください。この例では addAudioFrameEmbedded で埋め込み、再生コマンドをオーディオフレームに付加します。

オーディオフレームは効果の対象でもあり、コマンドの対象でもあります。これにより再生要求が埋め込み録音に結び付けられ、単なるコマンド文字列だけではどのメディアオブジェクトを制御すべきか特定できません。効果はスライドショー中のクリックで開始するよう構成されています。

import com.aspose.slides.*;
import java.io.FileInputStream;
import java.io.IOException;

Presentation presentation = new Presentation();
try {
    ISlide slide = presentation.getSlides().get_Item(0);

    try (FileInputStream audioStream = new FileInputStream("sample.wav")) {
        IAudioFrame audioFrame = slide.getShapes().addAudioFrameEmbedded(100, 100, 40, 40, audioStream);

        IEffect effect = slide.getTimeline().getMainSequence().addEffect(audioFrame, EffectType.MediaPlay, EffectSubtype.None, EffectTriggerType.OnClick);
        effect.getBehaviors().clear();

        IBehaviorFactory factory = new BehaviorFactory();
        ICommandEffect command = factory.createCommandEffect();
        command.setType(CommandEffectType.Call);
        command.setCommandString("play");
        command.setShapeTarget(audioFrame);

        effect.getBehaviors().add(command);

        presentation.save("command.pptx", SaveFormat.Pptx);
    } catch (IOException exception) {
        System.out.println("Unable to read sample.wav: " + exception.getMessage());
    }
} finally {
    presentation.dispose();
}

保存により command.pptx にコマンドが格納されますが、録音は再生されません。再生にはコマンドとメディア対象をサポートするスライドショープレイヤーが必要です。

ビヘイビアコレクションの管理

IBehaviorCollection は add、insert、remove、removeAt をサポートします。この例では rotation.pptx を開き、拡大縮小を追加し、回転の前に移動させ、回転を削除します。同一オブジェクトの削除と再挿入によりコピーを作成せずに位置が変更されます。

編集シーケンスはコレクションを「回転→拡大縮小」から「拡大縮小→回転」へ、さらに「拡大縮小」のみへと変化させます。インデックスは現在のコレクションを基にするため、再配置後の回転の新しいインデックスが使用されます。最終的な列挙で保存されるビヘイビアが確認できます。

import com.aspose.slides.*;
import java.awt.geom.Point2D;

Presentation presentation = new Presentation("rotation.pptx");
try {
    IEffect effect = presentation.getSlides().get_Item(0).getTimeline().getMainSequence().get_Item(0);
    IBehaviorCollection behaviors = effect.getBehaviors();

    IBehaviorFactory factory = new BehaviorFactory();
    IScaleEffect scale = factory.createScaleEffect();
    scale.setTo(new Point2D.Float(125, 125));
    scale.getTiming().setDuration(2f);

    behaviors.add(scale);

    behaviors.remove(scale);
    behaviors.insert(0, scale);
    behaviors.removeAt(1);

    for (IBehavior behavior : behaviors)
        System.out.println(behavior.getClass().getSimpleName());

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

出力は ScaleEffect のみで、拡大縮小だけが残ります。コレクションの順序自体はビヘイビアを連続再生させるスケジューリングを意味しません。すべての操作を置き換える場合にのみコレクションをクリアしてください。

ビヘイビアタイミングの構成

IBehavior.getTiming は ITiming を露出し、IEffect.getTiming とは独立しています。効果タイミングは囲む効果全体のスケジュールを決定し、ビヘイビアタイミングはその内部の操作を記述します。

継続時間、遅延、繰り返し、加速の設定

rotation.pptx を開き、継続時間 (getDuration) とトリガー遅延 (getTriggerDelayTime) を秒単位で設定し、setRepeatCount で繰り返し回数を構成します。getAccelerate と getDecelerate は継続時間の割合で、合計は最大 1 としてください。

入力ファイルは回転例で作成したものです。最初のビヘイビアが回転であることが分かっています。この例ではそのビヘイビアのタイミングのみを変更し、90 度の角度はそのまま保持します。角度とタイミングを別々に管理することで、アニメーション全体を再構築せずにペース調整が容易になります。

import com.aspose.slides.*;

Presentation presentation = new Presentation("rotation.pptx");
try {
    IEffect effect = presentation.getSlides().get_Item(0).getTimeline().getMainSequence().get_Item(0);

    IRotationEffect rotation = (IRotationEffect)effect.getBehaviors().get_Item(0);
    rotation.getTiming().setDuration(2f);
    rotation.getTiming().setTriggerDelayTime(0.5f);
    rotation.getTiming().setRepeatCount(3f);
    rotation.getTiming().setAccelerate(0.2f);
    rotation.getTiming().setDecelerate(0.2f);

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

このビヘイビアは 2 秒の継続時間、0.5 秒の遅延、繰り返し回数 3 を使用し、継続時間の最初と最後の 20% が加速と減速に使われます。

他の繰り返しポリシーとしては getRepeatDuration、getRepeatUntilEndSlide、getRepeatUntilNextClick があり、すべて同時に有効にするのではなく 1 つを選択してください。getAutoReverse は前進後にアニメーションを逆再生します。加速と減速は連続的な変化に適用され、離散的な代入やコマンドには適用されません。

モーションパスの作成

createMotionEffect でモーションを作成します。getFrom・getTo・getBy はパーセンテージベースの座標またはオフセットを示します。編集可能な経路を作成するには MotionPath を生成し、IMotionEffect.setPath で割り当てます。IMotionPath はパスコマンドを保持します。

MotionCommandPathType が操作を選択します。

コマンド	ポイント数	意味
MoveTo	1	開始位置を設定
LineTo	1	直線セグメントを終点まで移動
CurveTo	3	2 つの制御点と終点で定義される三次ベジエ曲線に従う
CloseLoop	0	開始位置に戻る
End	0	パスを終了

MotionPathPointsType はポイントの編集特性（コーナーまたはスムーズ）を示し、コマンドタイプの代替ではありません。下の曲線例では曲線ポイントタイプ、直線セグメントではコーナーポイントタイプを使用します。

パス座標はスライド寸法に正規化されます。X 変位 0.25 はスライド幅の 1/4 を表し、0.25 ポイントではありません。Y は下方向が正です。絶対コマンドはパス座標系で位置を指定し、相対コマンドは現在位置からのオフセットを指定します。これは getOrigin （パスの基準フレーム選択）や getPathEditMode（形状移動時のパスの動作制御）とは別です。

直線パスの作成

開始点、1 本の直線セグメント、終了コマンドを持つモーションビヘイビアを作成します。IMotionPath.add はコマンドタイプ、ポイント配列、ポイントタイプ、相対座標フラグを受け取ります。

開始コマンドは (0, 0) を設定し、直線は (0.25, 0) で終了します。これによりスライド幅の 1/4 の水平変位が得られます。終了コマンドは座標ポイントを持ちません。パスを割り当てた後、モーションビヘイビアを効果に追加すると、そのルートが矩形に接続されます。

import com.aspose.slides.*;
import java.awt.geom.Point2D;

Presentation presentation = new Presentation();
try {
    ISlide slide = presentation.getSlides().get_Item(0);

    IAutoShape shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 100, 100, 160, 80);

    IEffect effect = slide.getTimeline().getMainSequence().addEffect(shape, EffectType.PathRight, EffectSubtype.None, EffectTriggerType.OnClick);
    effect.getBehaviors().clear();

    IBehaviorFactory factory = new BehaviorFactory();
    IMotionEffect motion = factory.createMotionEffect();
    motion.setOrigin(MotionOriginType.Layout);
    motion.getTiming().setDuration(2f);

    IMotionPath path = new MotionPath();
    path.add(MotionCommandPathType.MoveTo, new Point2D.Float[] { new Point2D.Float(0, 0) }, MotionPathPointsType.Auto, false);
    path.add(MotionCommandPathType.LineTo, new Point2D.Float[] { new Point2D.Float(0.25f, 0) }, MotionPathPointsType.Corner, false);
    path.add(MotionCommandPathType.End, new Point2D.Float[0], MotionPathPointsType.None, false);

    motion.setPath(path);
    effect.getBehaviors().add(motion);

    presentation.save("motion.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

motion.pptx には 3 つのパスコマンドを持つ 1 つのモーションビヘイビアが含まれます。以下のファイル編集例はこの構造を前提としています。

絶対座標と相対座標の比較

この 2 つのパスオブジェクトは同一ルートを表します。絶対コマンドは (0.3, 0.1) に終了し、相対コマンドは現在位置に (0.1, 0.1) を加えて (0.2, 0) に到達します。

両方のパスは同じ位置で開始します。相対線の場合は X と Y のオフセットを現在位置に加えて終点を求め、絶対線の場合は終点を直接読み取ります。座標変換せずにフラグだけ切り替えると別のルートになります。

import com.aspose.slides.*;
import java.awt.geom.Point2D;

MotionPath absolutePath = new MotionPath();
absolutePath.add(MotionCommandPathType.MoveTo, new Point2D.Float[] { new Point2D.Float(0.2f, 0) }, MotionPathPointsType.Auto, false);
absolutePath.add(MotionCommandPathType.LineTo, new Point2D.Float[] { new Point2D.Float(0.3f, 0.1f) }, MotionPathPointsType.Corner, false);

MotionPath relativePath = new MotionPath();
relativePath.add(MotionCommandPathType.MoveTo, new Point2D.Float[] { new Point2D.Float(0.2f, 0) }, MotionPathPointsType.Auto, false);
relativePath.add(MotionCommandPathType.LineTo, new Point2D.Float[] { new Point2D.Float(0.1f, 0.1f) }, MotionPathPointsType.Corner, true);

いずれかのパスをモーションビヘイビアに割り当ててプレゼンテーションで使用できます。最後の Boolean 引数はそのコマンドに相対座標を使用するかどうかを選択します。

直線を曲線に置換

motion.pptx を開き、直線コマンドを三次曲線に置換します。まず 2 つの制御点を、続いて終点を指定します。

開始位置は前のコマンドで供給されます。最初の 2 点が曲線を形作り、3 番目が終点です。3 点が連続した終点という意味ではありません。コマンドタイプ、ポイント編集タイプ、ポイント配列を同時に更新すると、新しいジオメトリに合わせてセグメントが一貫します。

import com.aspose.slides.*;
import java.awt.geom.Point2D;

Presentation presentation = new Presentation("motion.pptx");
try {
    IEffect effect = presentation.getSlides().get_Item(0).getTimeline().getMainSequence().get_Item(0);
    IMotionEffect motion = (IMotionEffect)effect.getBehaviors().get_Item(0);

    IMotionPath path = motion.getPath();
    path.get_Item(1).setCommandType(MotionCommandPathType.CurveTo);
    path.get_Item(1).setPointsType(MotionPathPointsType.CurveSmooth);
    path.get_Item(1).setPoints(new Point2D.Float[] { new Point2D.Float(0.1f, 0), new Point2D.Float(0.2f, 0.1f), new Point2D.Float(0.3f, 0.1f) });

    presentation.save("curve.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

curve.pptx のパスは依然として 3 コマンドですが、真ん中のコマンドが曲線になっています。

保存されたパスの検査と編集

各 IMotionCmdPath は getPoints・getCommandType・getPointsType・isRelative を公開します。以下の例は motion.pptx の既知の 3 コマンドパスを使用します。任意の入力に対しては、編集前に対象効果を特定し、コマンドタイプとポイント数をインデックスで確認してください。

コマンドと座標の読み取り

パスを変更せずに読み取ります。終了コマンドとクローズループコマンドはポイントを必要としないため、null のポイント配列を許容します。

出力は各数値コマンドタイプと相対座標フラグをペアで示し、その後にポイントを列挙します。これにより、パスを変更する前にエンドポイントとオフセットを区別できます。曲線は 3 点を、直線は 1 点だけを一覧表示します。

import com.aspose.slides.*;
import java.awt.geom.Point2D;

Presentation presentation = new Presentation("motion.pptx");
try {
    IEffect effect = presentation.getSlides().get_Item(0).getTimeline().getMainSequence().get_Item(0);
    IMotionEffect motion = (IMotionEffect)effect.getBehaviors().get_Item(0);

    IMotionPath path = motion.getPath();
    for (IMotionCmdPath segment : path)
    {
        System.out.println(segment.getCommandType() + ", relative: " + segment.isRelative());
        if (segment.getPoints() != null)
            for (Point2D.Float point : segment.getPoints())
                System.out.println("X=" + point.x + ", Y=" + point.y);
    }
} finally {
    presentation.dispose();
}

このリストには開始点、(0.25, 0) に終了する絶対直線、そして終了コマンドが含まれます。

エンドポイントの変更

motion.pptx を開き、直線のポイント配列を置換してエンドポイントを移動させます。

入力ファイルではインデックス 0 が開始コマンド、インデックス 1 が直線です。直線の単一ポイントを置換すると、コマンドタイプ、タイミング、コレクション内位置は変わらず、目的地だけが変更されます。コマンドが絶対座標を使用しているため、新しいペアは位置を示します。

import com.aspose.slides.*;
import java.awt.geom.Point2D;

Presentation presentation = new Presentation("motion.pptx");
try {
    IEffect effect = presentation.getSlides().get_Item(0).getTimeline().getMainSequence().get_Item(0);

    IMotionEffect motion = (IMotionEffect)effect.getBehaviors().get_Item(0);
    motion.getPath().get_Item(1).setPoints(new Point2D.Float[] { new Point2D.Float(0.4f, 0.1f) });

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

motion-endpoint.pptx の直線は (0.4, 0.1) に終了し、元ファイルは変更されていません。

セグメントの置換

insert と removeAt を使用して motion.pptx の直線を置換します。挿入により古い直線はインデックス 2 にシフトします。

この手法は既存座標を編集するのではなく、コマンドオブジェクト自体を置換することを示します。挿入後、コレクションは一時的に開始コマンド、新しい直線、古い直線、終了コマンドの順に含まれます。インデックス 2 を削除すると古い直線が除去され、新しいルートが残ります。

import com.aspose.slides.*;
import java.awt.geom.Point2D;

Presentation presentation = new Presentation("motion.pptx");
try {
    IEffect effect = presentation.getSlides().get_Item(0).getTimeline().getMainSequence().get_Item(0);
    IMotionEffect motion = (IMotionEffect)effect.getBehaviors().get_Item(0);

    IMotionPath path = motion.getPath();
    path.insert(1, MotionCommandPathType.LineTo, new Point2D.Float[] { new Point2D.Float(0.2f, 0.1f) }, MotionPathPointsType.Corner, false);
    path.removeAt(2);

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

保存されたパスは依然として 3 コマンドで、新しい直線は (0.2, 0.1) に終了し、終了コマンドが最後にあります。

既存ビヘイビアの変更と検証

ビヘイビアのインデックスが不明な場合はタイプで選択します。この例では rotation.pptx を開き、IRotationEffect を検索し、角度を変更し、再オープン後に保存値を確認します。

タイプチェックにより回転でないビヘイビアはループでスキップされます。2 回目のロードは保存されたファイルを別のプレゼンテーションオブジェクトに読み込み、比較はメモリ上の値ではなく永続化データを対象とします。この例は既知の効果がメインシーケンスの最初にあることを前提としています。任意のプレゼンテーションで正しい効果を見つけるには、タイプでビヘイビアを選択するだけでは不十分です。

import com.aspose.slides.*;

Presentation presentation = new Presentation("rotation.pptx");
try {
    IEffect effect = presentation.getSlides().get_Item(0).getTimeline().getMainSequence().get_Item(0);

    for (IBehavior behavior : effect.getBehaviors())
    {
        if (behavior instanceof IRotationEffect) {
            IRotationEffect rotation = (IRotationEffect) behavior;
            rotation.setBy(180f);
        }
    }

    presentation.save("rotation-edited.pptx", SaveFormat.Pptx);

    Presentation reopened = new Presentation("rotation-edited.pptx");
    try {
        IEffect savedEffect = reopened.getSlides().get_Item(0).getTimeline().getMainSequence().get_Item(0);

        for (IBehavior behavior : savedEffect.getBehaviors())
        {
            if (behavior instanceof IRotationEffect) {
                IRotationEffect rotation = (IRotationEffect) behavior;
                System.out.println("Rotation preserved: " + (Math.abs(rotation.getBy() - 180f) < 0.001f));
            }
        }
    } finally {
        reopened.dispose();
    }
} finally {
    presentation.dispose();
}

出力は Rotation preserved: true です。その他のビヘイビアでも同様のタイプチェックパターンを適用してください。完全な保存確認には対象形状、効果、ビヘイビアタイプと順序、タイミング、パスコマンドを比較し、浮動小数点値には数値許容差を使用します。アニメーション構成が不明なプレゼンテーションについては、Read Shape Animations を参照し、メインとインタラクティブシーケンスの走査方法を確認してください。

ビヘイビアの順序、プリセット、再生

IBehaviorCollection の順序は効果操作の保存順序であり、各ビヘイビアが自動的に前のビヘイビアを待つプレイリストではありません。スケジューリングはタイミングと囲む効果が決定します。ビヘイビアは重複して再生でき、同一プロパティへの操作は getAdditive や getAccumulate を通じて相互作用します。「移動 → 回転」のように順序だけでスケジューリングしようとせず、Shape Animation で説明したように明示的なタイミングまたは別々の効果を使用してください。

効果の getType と getSubtype はプリセットを記述しますが、編集されたビヘイビアツリーの完全な説明ではありません。ビヘイビアをカスタマイズする前にプリセットとサブタイプを選択してください。プリセットを変更するとコレクションが再構築され、カスタム操作が失われる可能性があります。たとえば、カスタマイズした Spin 効果を Fade に変更すると、回転ビヘイビアがセットやフィルタビヘイビアに置き換わります。プリセットやサブタイプを変更した後はコレクションを再度検査してください。プリセットのビヘイビアをクリアすると、プリセットが必要とする可視化や初期化操作も失われることがあります。例では可視形状を使用し、ビヘイビアを置換しているため、すべてのプリセット実装を再構築してはいません。

フォーマット互換性

保存されたビヘイビアツリーがすべてのビューアやエクスポートレンダラで同一の再生を保証するわけではありません。保存データとレンダリング結果を別々に確認してください。

フォーマットまたは出力	確認項目
PPTX	例の主要フォーマットとして使用。再オープンして編集可能なビヘイビアツリーを確認し、目的の PowerPoint バージョンで再生をチェック
PPT	レガシーのバイナリ表現は PPTX と異なる可能性あり。別途保存‑再オープンサイクルと再生をテストし、PPTX の成功だけですべての組み合わせがサポートされると推測しない
PDF、PNG、JPEG などの静的スライド画像	静的なスライド表現であり、再生可能なビヘイビアタイムラインや最終アニメーションフレームは保証されない
HTML5	エクスポートオプションでシェイプアニメーションを有効にするとサポートされるアニメーションを再生可能。ブラウザでカスタム組み合わせをテスト
Animated GIF	レンダリングされたフレームを保存するが、編集可能なビヘイビアやクリックトリガーは含まれない。実際のモーションを確認
Video	アニメーションフレームをレンダリングし動画としてエンコード。サポートはレンダラの supported animations and effects に限定され、コマンドやインタラクティブイベントは編集可能なタイムラインに変換されない

FAQ

効果にビヘイビアが何も追加していないのに含まれているのはなぜですか？

事前定義された効果を作成すると、その基礎となる操作が生成されることがあります。ビヘイビアを拡張するか置換するかを判断する前に、まずそれらを検査してください。

ビヘイビアを先頭に移動すれば最初に再生されますか？

必ずしもそうではありません。コレクション順序はタイミングの代替にはなりません。遅延、継続時間、同一プロパティへの操作間の相互作用を確認してください。

終了コマンドにポイントがないのはなぜですか？

終了コマンドはパスの終端を示すだけで、座標は不要です。ファイルから読み取ったパスを検査する際は、ポイント配列が null である可能性を考慮してください。

往復保存だけで再生が確認できるのですか？

いいえ。再オープンはプロパティが保持されたことを確認しますが、スライドショープレイヤーやアニメーションエクスポートで実際の視覚的動作を別途テストする必要があります。

JavaでPowerPointプレゼンテーションにアニメーションを追加して強化する Java を使用したプレゼンテーションで 3D 効果を作成する

Javaでカスタム アニメーション ビヘイビアを作成および変更する