After Effects│エクスプレッションをスクリプト化する方法

2016年1月6日2026年10月16日

回転の式を選択したプロパティだけに設定する練習

2026年10月3日確認：ここでの対象は、式のない数値1つのプロパティです。

別名保存した練習コンポジションにソリッドを2枚置き、それぞれの回転を20度と30度にします。

回転のプロパティ名を2つとも選択し、下のコードをset-expression.jsxとしてUTF-8で保存して「ファイル」→「スクリプト」→「スクリプトファイルを実行」から実行します。

設定する式はvalue + 10;で、元の値に10を加える例です。

期待する表示値は30度と40度で、未選択の位置や不透明度には式を付けません。

プロパティグループは対象から外し、既存の式があるプロパティ・ベクトル・ロックされたレイヤーが混ざると、書き込みを始める前に止めます。

既存の式は無効になっていても上書きしません。

式が評価エラーになると停止しますが、先に設定したプロパティは残る場合があります。

Ctrl+Z／Command+Zまたは元の練習コピーで、回転20度・30度と式なしの状態へ戻るか確認してください。

Windowsの実機で確かめた結果（2026年10月15日）

2026年10月15日に、Windows 11 Pro（10.0.26200）のAfter Effects 26.5.0（Build 89、日本語表示）で、この練習を確かめました。

640×360・30fps・3秒の練習用コンポジションに、160×50pxの赤と青の平面を置き、赤の回転を20度、青の回転を30度にしました。

どちらもキーフレームと式はなく、選んだのは2つの回転だけです。

赤と青の2枚の平面の回転を20度と30度にし、2つの回転だけを選んだAfter Effectsのタイムライン — 2026-10-15撮影。Adobe After Effects 26.5.0 (Build 89)、Windows 11 Pro (10.0.26200)。640×360・30fpsの練習用コンポジションで、赤の平面（左）の回転を20度、青の平面（右）の回転を30度にし、2つの回転だけを選んだ実機画面（ウィンドウのタイトルバーのみ切り取り）。

下のコードを書き換えずに実行すると、赤は20度から30度、青は30度から40度になり、2つの回転にvalue + 10;の式が付きました。

元の値は20度と30度のまま残り、選んでいない位置と不透明度には式が付きませんでした。

実行直後の画面は、コードの下に載せています。

続けて「編集」メニューの「Set selected scalar expressionsの取り消し」を1回選ぶと、回転は20度と30度に戻り、式もなくなりました。

取り消したあとに書き出した画像は、実行前に書き出した画像と全画素で一致しました。

練習用のプロジェクトとレイヤーの準備、回転の選択、コードの実行、数値の読み取りはスクリプトで行いました。

そのため、「ファイル」→「スクリプト」→「スクリプトファイルを実行」のメニューから実行する操作は、確認に含めていません。

画面で行ったのは、プロパティの展開、式の表示、「編集」メニューからの取り消しです。

Ctrl+Z／Command+Zのキー操作そのもの、Mac、ほかのバージョン、回転以外のプロパティ、キーフレームがあるプロパティは試していません。

式が評価エラーになったときや、途中で止まったあとの戻し方も、確かめていません。

入力・条件	操作・結果	確認する点
回転2つ	value + 10;	20→30、30→40
位置・既存の式・ロック	事前確認で停止	書き込み前に止める
エラー後	Undo／元コピー	途中までの変更も確認

仕様の照合には、コミュニティで保守されているProperty API参照を参照しました。

よく使うエクスプレッションをワンクリックで適用できるようにスクリプト化しました。

毎回コードを調べたり打ち直したりする手間を省けます。

記述を思い出す時間が減り、作業を効率化できます。

エクスプレッションをスクリプト化する方法

(function () {
    var EXPRESSION = "value + 10;";
    var comp = app.project && app.project.activeItem;
    if (!(comp instanceof CompItem)) { alert("Open a composition."); return; }
    var selected = comp.selectedProperties, targets = [], i;
    for (i = 0; i < selected.length; i++) {
        var prop = selected[i];
        if (prop.propertyType !== PropertyType.PROPERTY || !prop.canSetExpression) { continue; }
        var owner = prop.propertyGroup(prop.propertyDepth);
        if (owner.locked || prop.expression !== "" || prop.propertyValueType !== PropertyValueType.OneD) {
            alert("Select unlocked scalar properties with no existing expression."); return;
        }
        targets.push(prop);
    }
    if (!targets.length || targets.length > 20) { alert("Select 1 to 20 scalar properties."); return; }
    app.beginUndoGroup("Set selected scalar expressions");
    try {
        for (i = 0; i < targets.length; i++) {
            targets[i].expression = EXPRESSION;
            if (targets[i].expressionError) { throw new Error(targets[i].expressionError); }
        }
    } catch (error) {
        alert("Stopped: " + error.toString() + "\nUndo or reopen your practice copy.");
    } finally { app.endUndoGroup(); }
})();