コンポの幅・高さに追従する矩形シェイプを作ります。
黒い背景を表示する設定と、下のレイヤーへエフェクトを適用する調整レイヤー設定を分けます。
最終調査日:2026年10月3日。
構文と参照順序はローカルで検査しています。
AE本体の作成・サイズ追従・調整効果・取り消しは未確認です。
黒背景と調整レイヤーを選ぶ
| 目的 | コードの設定 | 結果の確認 |
|---|---|---|
| 黒背景 | makeAdjustment = false | 通常レイヤーとして黒を塗り、最下段へ配置 |
| 調整レイヤー | makeAdjustment = true | 上段へ配置し、後から必要なエフェクトを追加 |
調整レイヤーの黒い塗りだけで、不透明な黒背景が表示されるとは考えません。
黒背景を作りたい場合はfalseのまま使います。
コードを使わず作る場合は、レイヤーを選択しない状態で長方形ツールをダブルクリックします。
選択した素材にマスクを作る操作と区別し、作成後のシェイプ設定を確認します。
コンポサイズへ追従するコード
練習プロジェクトを保存してコンポを開き、次のコードをCompShape.jsxとして保存します。
「ファイル→スクリプト→スクリプトファイルを実行」からそのファイルを選びます。
// 原記事 @author suimin の処理を、対象判定とmatchName参照で改訂。
(function () {
var comp = app.project.activeItem;
var makeAdjustment = false; // 黒背景=false、調整レイヤー=true
if (!(comp instanceof CompItem)) { alert("コンポを開いてください。"); return; }
app.beginUndoGroup("コンポサイズのシェイプを作成");
try {
var shape = comp.layers.addShape();
shape.name = makeAdjustment ? "コンポ調整" : "コンポ黒背景";
shape.label = 0;
shape.adjustmentLayer = makeAdjustment;
shape.property("ADBE Transform Group").property("ADBE Position").expression =
"[thisComp.width / 2, thisComp.height / 2]";
var root = shape.property("ADBE Root Vectors Group");
var rectangle = root.addProperty("ADBE Vector Shape - Rect");
rectangle.property("ADBE Vector Rect Size").expression = "[thisComp.width, thisComp.height]";
// addProperty後は同じグループ内の古い参照を使い回さない。
var fill = shape.property("ADBE Root Vectors Group").addProperty("ADBE Vector Graphic - Fill");
fill.property("ADBE Vector Fill Color").setValue([0, 0, 0, 1]);
fill.property("ADBE Vector Fill Opacity").setValue(100);
if (!makeAdjustment) { shape.moveToEnd(); }
} catch (error) {
alert(error.toString() + "\n編集→取り消しで今回作成分を戻してください。");
} finally { app.endUndoGroup(); }
}());
原記事のsuimin氏による処理を基に、CompItem判定とプロパティのmatchName参照を加えています。
矩形サイズを番号2で決め打ちせず、ADBE Vector Rect Sizeで参照します。
塗りを追加するときはプロパティグループを参照し直します。
indexed groupへの追加で古いプロパティ参照が無効になるため、追加前のrectangleを後から使い回しません。
| 入力 | 計算上の設定 | 確認する点 |
|---|---|---|
| 960×540のコンポ | サイズ960×540/位置480,270 | 黒背景は最下段 |
| 1280×720へ設定変更 | サイズ1280×720/位置640,360 | 式が有効なままか確認 |
| フッテージやフォルダーを開く | 作成せずメッセージ | コンポを開いて実行 |
背景が見えない・ずれる場合
黒背景が見えない場合は、makeAdjustmentがfalseか、レイヤーの映像スイッチがONかを確認します。
前面の不透明な素材が覆っている場合は、背景が隠れるのが通常の結果です。
サイズが合わない場合は、矩形サイズとレイヤー位置の式、スケール100%、回転0、親なしを確認します。
別の親や変形を加えた状態では、コンポ枠との一致を別途確認します。
戻すときは実行直後に「編集→取り消し」で作成分を戻します。
途中で例外が出た場合も再実行を重ねず取り消し、保存した練習コピーへ戻します。
仕様の参照:矩形と塗りのmatchName、addPropertyの参照更新、Adobeのスクリプト実行方法。
コンポ枠を切り替える練習は画面サイズとON/OFF式、コンポを増やす作業はコンポの複製を参照します。
関連記事と旧配布資料
関連記事は目的に応じて使い分けます。
旧配布コードと、このページの改訂コードは同じものではありません。





