<     > 

RemoveAllShadersFromCnxPoint

Introduced

1.0

Description

Disconnects all shaders from the specified shader's connection points, without the need to know information about the connected shaders or if shaders are indeed connected.

The second argument allows the user to specify in detail what types of shader connections should be disconnected.

Note: Shaders that are not used anymore once disconnected are automatically deleted.

Scripting Syntax

RemoveAllShadersFromCnxPoint( [InputObjs], [Type] )

Parameters

Examples

VBScript Example

'
' This example demonstrates how to disconnect shaders on a scene object. It
' also shows how you can find out whether the object's material is connected
' to a shader or a texture.
'

OpenScene InstallationPath( siFactoryPath ) _
   & "\Data\XSI_SAMPLES\Scenes\Rendertree_Displacement_Cell.scn", False

' Select the grid and get a pointer to it
SelectObj "grid"
Set oGrid = Selection(0)

' Output at this point (before removing the shaders):
'INFO : "Found a shader on Surface"
'INFO : "Found a texture on Displacement"
'INFO : "Found a shader on Shadow"
'INFO : "Found a shader on Photon"
displayDetails oGrid

' Disconnect the shaders, if any, connected to the grid material Volume,
' Displacement and Photon connection points. (Note that specifying the 
' Volume parameter is redundant in this case since it is not connected)
Set oCnxPoints = CreateObject( "XSI.Collection" )
oCnxPoints.Add oGrid.Material.Parameters( "volume" )
oCnxPoints.Add oGrid.Material.Parameters( "displacement" )
oCnxPoints.Add oGrid.Material.Parameters( "photon" )
rem RemoveAllShadersFromCnxPoint oCnxPoints, siShaderCnxPointAll

' Output at this point (notice that we only disconnected the shaders on the
' Displacement and Photon points so we still have shaders on Surface and
' Shadow):
'INFO : "Found a shader on Surface"
'INFO : "Found a shader on Shadow"
displayDetails oGrid



function displayDetails( in_obj )
   Application.LogMessage "--------------------------------------------"

   ' Look for each parameter that is connected to a shader and print its name
   For Each p In in_obj.Material.Parameters
       If TypeName( p.Source ) = "Shader" Then
          Application.LogMessage "Found a shader on " & p.Name
       ElseIf TypeName( p.Source ) = "Texture" Then
          Application.LogMessage "Found a texture on " & p.Name
       End If
   Next
end function

See Also

Autodesk Softimage v7.5     <     >