Layer Space Transforms のメソッド

Layer Space Transforms のメソッドは、レイヤーの空間からワールドの空間にトランスフォームするなど、ある空間の値を別の空間の値にトランスフォームする場合に使用します。from メソッドは、レイヤー空間を、指定した空間（コンポジションまたはワールド）に値をトランスフォームします。to メソッドは、指定した空間（コンポジションまたはワールド）からレイヤー空間に値をトランスフォームします。どちらのトランスフォームメソッドでも、トランスフォームが計算される時間を取得する引数を使用できます。ただし、ほとんどの場合は、現在の時間（初期設定）を使用します。

Vec トランスフォームメソッドは、2 つの位置の値の違いなどの方向ベクトルをトランスフォームする場合に使用します。位置などのポイントをトランスフォームする場合は、通常の（Vec ではない）トランスフォームメソッドを使用します。2D レイヤーでは、コンポジション空間とワールド空間は同じです。しかし、3D レイヤーでは、コンポジション空間はアクティブカメラに依存し、ワールド空間はカメラから独立しています。

toComp(point, t=time)

返されるタイプ：配列 [2 または 3]。

引数のタイプ：point は配列 [2 または 3] で、t は Number です。

レイヤー空間からコンポジション空間へポイントをトランスフォームします。

fromComp(point, t=time)

返されるタイプ：配列 [2 または 3]。

引数のタイプ：point は配列 [2 または 3] で、t は Number です。

コンポジション空間からレイヤー空間へポイントをトランスフォームします。3D レイヤーでの変換結果のポイントは、レイヤー空間にある場合でもゼロ以外の値になる可能性があります。例えば、「fromComp(thisComp.layer(2).position)」のように記述できます。

toWorld(point, t=time)

返されるタイプ：配列 [2 または 3]。

引数のタイプ：point は配列 [2 または 3] で、t は Number です。

レイヤー空間からビューに依存しないワールド空間へポイントをトランスフォームします。例えば、次のように指定します。

  toWorld.effect("Bulge")("Bulge Center")

fromWorld(point, t=time)

返されるタイプ：配列 [2 または 3]。

引数のタイプ：point は配列 [2 または 3] で、t は Number です。

ワールド空間からレイヤー空間へポイントをトランスフォームします。例えば、「fromWorld(thisComp.layer(2).position)」のように記述できます。

このメソッドの使用例については、例：2 つのレイヤー間のバルジを作成するを参照してください。

toCompVec(vec, t=time)

返されるタイプ：配列 [2 または 3]。

引数のタイプ：vec は配列 [2 または 3] で、t は Number です。

レイヤー空間からコンポジション空間へベクトルをトランスフォームします。例えば、「toCompVec([1,0])」のように記述できます。

fromCompVec(vec, t=time)

返されるタイプ：配列 [2 または 3]。

引数のタイプ：vec は配列 [2 または 3] で、t は Number です。

コンポジション空間からレイヤー空間へベクトルをトランスフォームします。例えば、2D レイヤーの場合、次のように指定します。

  dir=sub(position, thisComp.layer(2).position); 
  fromCompVec(dir)

toWorldVec(vec, t=time)

返されるタイプ：配列 [2 または 3]。

引数のタイプ：vec は配列 [2 または 3] で、t は Number です。

レイヤー空間からワールド空間へベクトルをトランスフォームします。例えば、次のように指定します。

  p1 = effect("Eye Bulge 1")("Bulge Center");  
  p2 = effect("Eye Bulge 2")("Bulge Center");   
  toWorld(sub(p1, p2))

fromWorldVec(vec, t=time)

返されるタイプ：配列 [2 または 3]。

引数のタイプ：vec は配列 [2 または 3] で、t は Number です。

ワールド空間からレイヤー空間へベクトルをトランスフォームします。例えば、「fromWorld(thisComp.layer(2).position)」のように記述できます。

fromCompToSurface(point, t=time)

返されるタイプ：配列 [2]。

引数のタイプ：point は配列 [2 または 3] で、t は Number です。

コンポジション空間上のポイントをレイヤーの表面上のポイント（Z 値ゼロ）へ、アクティブカメラから写したときに見える位置に投影します。このメソッドは、エフェクトコントロールポイントを設定するときに便利です。この要素は 3D レイヤーにのみ使用します。