<     > 

AddValue (ArrayParameter)

Introduced

5.0

Description

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.

Scripting Syntax

ArrayParameter.AddValue( ItemValue )

C# Syntax

Parameter ArrayParameter.AddValue( Object in_Value );

Parameters

Return Value

Parameter

Examples

JScript Example

// 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

See Also

Autodesk Softimage v7.5     <     >