v4.0
Removes a list of texture layers from a container (shader or material). If no container is provided, then it removes the layer(s) from all containers, effectively deleting them.
RemoveTextureLayers( [InputObjs], [Container] ); |
Parameter | Type | Description |
---|---|---|
InputObjs | String | List of layers which are to
be removed from a container.
Default Value: Current selection. |
Container | String or object | The container from which to remove the layers (if it currently contains them). If not specified, then the layers will be deleted from all containers in which they are found. |
' ' This example creates two shaders in a simple render tree, and applies ' texture layers to them. Then it removes some of the layers, illustrating ' the RemoveTextureLayers command. ' In particular, it builds the following stacks of layers. ' ' Phong Fractal ' A A ' B B ' C C ' option explicit dim oSph, oPhong, oFractal, oLyr(2) ' Build our shaders (a Phong and a Fractal), which will be the "texture ' layer containers" that will each be able to hold a stack of layers. NewScene , False set oSph = CreatePrim( "Sphere", "MeshSurface" ) set oPhong = SIApplyShader( "Phong", oSph ) set oFractal = BlendInPresetsInsp( "Fractal", , , True, siReplaceNoBlend, False, False, True ) ' Now create and add all the layers, as indicated above. ' Add 'A', 'B' and 'C' to both containers at the end. set oLyr(0) = AddTextureLayer( , oPhong & "," & oFractal, "A", True ) set oLyr(1) = AddTextureLayer( , oPhong & "," & oFractal, "B", True ) set oLyr(2) = AddTextureLayer( , oPhong & "," & oFractal, "C", True ) ' ' Now start removing. First we'll remove layer 'A' from just one ' of the containers. RemoveTextureLayers oLyr(0), oPhong(0) ' Now we'll remove layer 'B' from all containers which hold it. RemoveTextureLayers oLyr(1) PrintTextureLayersInContainer oPhong PrintTextureLayersInContainer oFractal sub PrintTextureLayersInContainer( in_cont ) dim oStack, oItem, oStr oStr = "Texture Layers in Container: " & in_cont & vbCrLf set oStack = EnumElements( in_cont & ".TextureLayers" ) for each oItem in oStack oStr = oStr & " " & oItem.name & vbCrLf next logmessage oStr end sub ' ' The output from the example should look something like this: ' 'INFO : Texture Layers in Container: sphere.Material.Phong ' C ' 'INFO : Texture Layers in Container: sphere.Material.Phong.Fractal ' A ' C ' |
AddTextureLayer MoveTextureLayers AddTextureLayerPorts Shader.RemoveTextureLayer Material.RemoveTextureLayer