Parameter.Source

パラメータの DataSource（Shader や ActionSource など、パラメータの値から操作されるオブジェクト）を戻します。データソースが接続されていない場合は、Nothing が戻されます。パラメータが ActionSource および DataSource の両方を持つ場合、DataSource が戻されます。これは、アニメートされたパラメータがソースに接続されている場合に発生します。

注：データソースのすべてのタイプ（ActionSource、Constraint、FCurve、ImageClip、Operator、Shader、StaticSource）を取得できますが、設定できるのはデータソースのシェーダタイプだけです。Shader パラメータでは、ソースの他のシェーダへの設定がサポートされます。注：シェーダコンパウンドおよび複数出力シェーダは、出力 Parameter によって識別されるソースを必要とする複数の出力ポートを持ちます。この場合、GetSource によってパラメータが戻されます。また、Parameter.GetParent を呼び出すことにより接続されたシェーダにアクセスすることができます。

ヒント：VBScript では、Source プロパティに"Nothing"を割り当てて、DataSource を削除できます。JScript および Python の場合は、Parameter.Disconnect を呼び出すことで、同じ効果が得られます。

ProxyParameterの場合は、このプロパティからマスタパラメータのソースにアクセスできます。たとえば、パラメータに F カーブが存在し、そのパラメータに対応するプロキシパラメータが存在する場合は、どちらのパラメータオブジェクトのソースプロパティも同じF カーブオブジェクトを戻します。

1. VBScript の例

'

' This example illustrates how to add an FCurve to a parameter and access it afterwards

' using the Parameter.Source property.

'

NewScene , false

dim values

set oCube = Application.ActiveSceneRoot.AddGeometry( "Cube","MeshSurface" )

arrValues = Array( 0.00, 5.00, 1.00, 6.00, 2.00, 7.00, 3.00, 8.00, 4.00, 9.00, 5.00, 10.00 )

oCube.posx.AddFCurve2 arrValues 

set oSource = oCube.posx.Source

Application.LogMessage "The source is : " & TypeName( oSource )

' Remove the animation

set oCube.posx.Source = Nothing

set oSource = oCube.posx.Source

Application.LogMessage "The source is : " & TypeName( oSource )

' Expected result:

'INFO : The source is : FCurve

'INFO : The source is : Nothing

2. JScript の例

/*

	See Shader.GetShaderParameterTargets for an example demonstrating how to traverse 

	a shader tree from left to right using the Source property and right to left using the 

	GetShaderParameterTargets method. 

*/