ArrayParameter.AddValue

導入

v5.0

詳細

新しいパラメータに配列の値を追加します。この関数を使用すると、新しい配列パラメータの型がすべて同じになります。このメソッドを使用し、ライトリストやオブジェクトリストをサポートするカメラレンズ、フレアシェーダなどのシェーダパラメータにライトとオブジェクトを追加します。

スクリプト 構文

oReturn = ArrayParameter.AddValue( ItemValue );

戻り値

Parameter

パラメータ

パラメータ タイプ 詳細
ItemValue Variant 新しいパラメータの値です。配列でこの値がサポートされていない場合、AddValue は「無効な変数タイプ」エラーを表示します。

JScript の例

// This example shows how to use AddValue to
// set up a lens flare on a camera.
// Create a camera and apply a shader to the lens
var root = Application.ActiveProject.ActiveScene.Root;
// Create a point light
var light = root.AddLight( "Point", true, "PointLight" );
// Set up a camera with a lens flare
var camera = root.AddCamera( "Camera", "Camera" );
translate( camera, 4, 6, 4);
var flare = camera.parameters("lensshader").connectfromprogid("Softimage.FLARES.LEN");
flare.parameters("lights").AddValue(light);
// find all shaders applied to camera
var shaders = camera.FindShaders(siShaderFilter);
var eShaders = new Enumerator(shaders)
logmessage( "Number of shaders attached to camera: ");
for ( ; !eShaders.atEnd(); eShaders.moveNext() )
{
        var shader = eShaders.item();
        logmessage( "camera shader: " + shader.progid );
}
//INFO : Number of shaders attached to camera: 
//INFO : camera shader: Softimage.FLARES.LEN.1

関連項目

ArrayParameter.Remove ArrayParameter.Move