AddObjectsToShader

Introduced

v1.0

Description

Adds a light list or object list to shaders.

Scripting Syntax

AddObjectsToShader( [InputObjs], [Target] );

Parameters

Parameter Type Description
InputObjs String List of objects to add to the shader.

Default Value: Current selection. If there is no current selection, the user is prompted to pick the objects.

Target String List of shader properties (lights, difflights, or objs).

Default Value: Current selection

Examples

VBScript Example

'

' This example creates a spotlight with a realistic light emission 

' by adding a spotlight to the scene, applying a volume shader to the 

' default pass, and then connecting it to the spotlight. 

'

NewScene , false

' Get a spot light

GetPrimLight "Spot", "Center_Stage", , , oSpotObj

' Apply a light shader and get an object pointer to it (the returned

' value is an XSICollection containing the shader as its only member)

Set oRetValue = SIApplyShader( "Fast_light_effects.Preset", oSpotObj )

Set oLightShader = oRetValue(0)

' Add a volume shader on the default pass and save its fullname

Set oDefPass = GetValue( "Passes.Default_Pass" )

sVolShader = SIApplyShaderToCnxPoint( "Fast_volume_effects.Preset", _

		oDefPass & ".VolumeShaderStack", , false )

sLightCnxPnt = sVolShader & ".Lights"

' Render a single frame of the default pass just to see the spotlight

' before connecting it to the volume shader

RenderPasses oDefPass, 1, 1

' Now add the Spot to the Volume shader light list

AddObjectsToShader oSpotObj, sLightCnxPnt

' Render a single frame of the default pass just to see the spotlight

' after connecting it to the volume shader

RenderPasses oDefPass, 1, 1

See Also

RemoveObjectsFromShader ApplyShader RemoveShaderFromCnxPoint RemoveAllShadersFromCnxPoint SIConnectShaderToCnxPoint