ArrayParameter.AddValue
v5.0
Adds a new parameter with a value to the array. This function ensures that all new array parameters are of the same type. Use this method to add lights and objects to shader parameters such as the camera-lens flare shader, which supports light and object lists.
oReturn = ArrayParameter.AddValue( ItemValue ); |
| Parameter | Type | Description |
|---|---|---|
| ItemValue | Variant | The value for the new parameter. If the array does not support this value. AddValue raises a "bad variable type" error. |
// 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
|