SetReference2

Introduced

v9.0 (2011)

Description

Sets reference parameter value for a shader parameter.

Scripting Syntax

SetReference2( Target, Value, [Time] );

Parameters

Parameter Type Description
Target String The parameter to set.
Value String The parameter representing the reference value.
Time Integer Frame at which to set the values.

Default Value: Current frame.

Examples

VBScript Example

' 

' This example demonstrates how to set a start and end point for a 

' lightning bolt effect using the SetReference2 command

'

NewScene , False

' Create a sphere for the lightning volume shader -- make it transparent

CreatePrim "Sphere", "MeshSurface"

Scale , 1.78336557059961, 1.78336557059961, 1.78336557059961, siRelative, siGlobal, siObj, siXYZ, , , , , , , , 0

ApplyShader , , , , siLetLocalMaterialsOverlap

SetValue "sphere.Material.Phong.transparency.green", 1

SetValue "sphere.Material.Phong.transparency.blue", 1

SetValue "sphere.Material.Phong.transparency.red", 1

' Create two nulls to act as endpoints for the lightning bolt

GetPrim "Null", "StartNull"

Translate , -4, 2.98511157062997, -0.298511157062997, siAbsolute, siView, siObj, siXYZ, True, , , , , , , , , 0

GetPrim "Null", "EndNull"

Translate , 2, 3.98014876083996, -0.398014876083996, siAbsolute, siView, siObj, siXYZ, True, , , , , , , , , 0

' Apply the lightning shader

SelectObj "sphere", , True

SIApplyShaderToCnxPoint "Volume\Volume_lightning.Preset", "Sources.Materials.DefaultLib.Material.volume"

' Set the start and endpoints of the lightning bolt

SIAddArrayElement "Sources.Materials.DefaultLib.Material.Volume_lightning.startpoint"

SetReference2 "Sources.Materials.DefaultLib.Material.Volume_lightning.startpoint.Item", "StartNull"

SIAddArrayElement "Sources.Materials.DefaultLib.Material.Volume_lightning.endpoint"

SetReference2 "Sources.Materials.DefaultLib.Material.Volume_lightning.endpoint.Item", "EndNull"

' Draw a render region to see the lightning bolt

See Also

SetReference