After EffectsでPSDをコンポジションとして読み込むスクリプト｜既存素材を守る修正版

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

PSDをコンポジションとして読み込み、そのレイヤー素材を読み込んだコンポと同じプロジェクト階層へ移すスクリプトです。

旧コードのキャンセル後の処理継続と、同名の既存フォルダを削除する処理を修正しました。

掲載コードはローカルのAPI模擬テストで検証しました。

After EffectsでのPSD読み込み・表示・取り消しは未確認のため、実案件の前に練習用PSDと別名保存したプロジェクトで確認してください。

変更する範囲と読み込み形式

ImportAsType.COMPを指定し、PSDをコンポジションとして読み込みます。

レイヤーサイズを保持するCOMP_CROPPED_LAYERSとは異なります。

読み込み前の全アイテムIDと読み込み後のソースIDを比べ、今回追加された直接参照のFootageItemだけを移します。

既存素材・既存フォルダ・ディスク上のPSDは変更しません。

読み込み時に作られたフォルダは、空になっても残します。

「レイヤー」フォルダを作らない設定ではありません。

操作	対象	結果
ファイル選択をキャンセル	なし	読み込みも整理もしない
PSD読み込みに成功	新規素材のみ	読み込んだコンポと同じ階層へ移動
同名の既存フォルダがある	既存アイテム	削除・移動しない
途中で失敗	今回の読み込み・移動	一部が残る場合あり。取り消して確認

修正版スクリプト

次のコードをUTF-8のテキストとしてimport-psd.jsxに保存します。

/* Owned PSD import helper. Local API-double tests only; native AE validation pending. */
(function () {
    var project = app.project;
    if (!project) { alert("プロジェクトを開いてください。"); return; }
    var file = File.openDialog("レイヤーを持つPSDを1つ選択してください");
    if (!file) return;
    if (!file.exists || !/\.psd$/i.test(file.name)) {
        alert("存在する.psdファイルを選択してください。"); return;
    }
    var before = {}, options, imported, moved = 0;
    try {
        options = new ImportOptions(file);
        if (!options.canImportAs(ImportAsType.COMP)) {
            alert("このPSDをコンポジションとして読み込めません。標準の読み込みで確認してください。"); return;
        }
        options.importAs = ImportAsType.COMP;
        options.sequence = false;
        for (var i = 1; i <= project.numItems; i++) before["id_" + project.item(i).id] = true;
    } catch (error) { alert("読み込み前の確認に失敗しました。\n" + error.toString()); return; }
    app.beginUndoGroup("PSDをコンポジションとして読み込み");
    try {
        imported = project.importFile(options);
        if (!(imported instanceof CompItem) || before["id_" + imported.id]) {
            throw new Error("新規コンポジションを取得できませんでした。");
        }
        // Move only newly imported direct sources, identified by Item.id.
        // Retain importer-created folders; never remove a project item.
        var sources = [], seen = {};
        for (var n = 1; n <= imported.numLayers; n++) {
            var source = imported.layer(n).source;
            if (!(source instanceof FootageItem)) continue;
            var key = "id_" + source.id;
            if (before[key] || seen[key]) continue;
            seen[key] = true; sources.push(source);
        }
        for (var j = 0; j < sources.length; j++) {
            sources[j].parentFolder = imported.parentFolder;
            moved++;
        }
        alert("コンポジション「" + imported.name + "」を読み込み、新規素材" + moved + "個を同じ階層へ移しました。空のフォルダは残します。");
    } catch (error) {
        alert("処理が途中で止まりました。一部の読み込み・移動が残る場合があります。編集メニューで取り消して確認してください。\n" + error.toString());
    } finally { app.endUndoGroup(); }
}());