UnnestShaders

Introduced

7.0

Description

Unnests shaders from a shader container (compound or material).

Scripting Syntax

UnnestShaders( InputObjs, ShaderContainer )

Parameters

Parameter

Type

Description

InputObjs

String

Shaders to unnested.

Default Value: If not specified, the user is prompted to make a selection.

ShaderContainer

String

The container to unnest the shaders from.

Default Value: ""

Examples

Python Example

#
# This example demonstrates how to use the UnnestShaders command.
#
null = None
true = 1
false = 0
app = Application
app.NewScene(null, false)
app.CreatePrim("Sphere", "MeshSurface", null, null)

# Create a Shader Compound Containing Phong
app.CreateShaderCompound("Sources.Materials.DefaultLib.Scene_Material.Phong", null)

# Create 2 shaders under the material
app.CreateShaderFromPreset("Shaders\\Texture\\Cell.Preset", "Sources.Materials.DefaultLib.Scene_Material", null)
app.CreateShaderFromPreset("Shaders\\Texture\\Checkerboard.Preset", "Sources.Materials.DefaultLib.Scene_Material", null)

# Nest both shaders under the shader compound
shadersToNest = "Sources.Materials.DefaultLib.Scene_Material.Cell,Sources.Materials.DefaultLib.Scene_Material.CheckerBoard"
app.NestShaders( shadersToNest, "Sources.Materials.DefaultLib.Scene_Material.ShaderCompound" )

# Unnest one shader from the shader compound. A this point the shader does not 
# have a parent, you should always renest it under a container.
shadersToUnnest = "Sources.Materials.DefaultLib.Scene_Material.ShaderCompound.Cell"
app.UnnestShaders( shadersToUnnest , "Sources.Materials.DefaultLib.Scene_Material" )

# Renesting under the material.
app.NestShaders( shadersToUnnest , "Sources.Materials.DefaultLib.Scene_Material" )

See Also

CreateShaderFromPreset

CreateShaderFromCLSID

CreateShaderFromProgID

CreateShaderCompound

NestShaders

AddShaderCompoundPort

RemoveShaderCompoundPort

MoveShaderCompoundPort

RenameShaderCompoundPort

ExportShaderCompound

ImportShaderCompound

ExplodeShaderCompound

SetShaderCompoundProperties

GetShaderCompoundProperties

 

 



Autodesk Softimage v7.5