precompose()

記述

app.project.item(index).layers.precompose(layerIndicies, name, moveAllAttributes)

概要

新規にCompItem objectを作成し、指定されたレイヤーをそのレイヤーコレクションに移動します。これは特定のレイヤーをこのコレクションから削除して、新しいCompItemをこのコレクションに追加します。

引数

layerIndices

name

moveAllAttributes

コレクションされるレイヤーのインデックス位置。整数の配列。

新しいCompItem objectの名称。

オプション。trueの場合(デフォルト)、すべてのアトリビュートが新しいコンポジション内に保持されます。これはAfter EffectsのGUIでプリコンポーズする際にプリコンポーズダイアログの「すべての属性を新規コンポジションに移動」オプションを選択するのに相当します。この値は layerIndicesの配列が1つだけの場合にfalseに設定することができます。これはプロコンポースダイアログで「すべての属性を〜に残す」に相当します。(ノートの図参照)

戻り値

CompItem object

ノート

サンプル

app.project.item(1).layers.precompose([1,3,4], "newComp", true)