v8.0 (2010)
Creates an empty Layer.
This command is similar to the SICreateLayer command except that it does not use output arguments
so it is safe to use with languages that don't support passing arguments by reference, such as JScript and Python.
oReturn = SICreateLayer2( [PresetObj], [Name], [LayerGroupName] ); |
Returns the Layer.
| Parameter | Type | Description | ||||
|---|---|---|---|---|---|---|
| PresetObj | String or a preset object (see SIGetPreset) |
Layer preset to use Default Value: "Default_New_Layer"
|
||||
| Name | String |
Name of the new layer Default Value: If not specified, the name will be automatically generated. |
||||
| LayerGroupName | String |
Name of the layer group that will contain the new layer Default Value: If not specified, the group containing the current layer will be used. |
#
# This example demonstrates how to use the SICreateLayer2 command
#
app = Application
app.NewScene(None, 0)
# Convenience function to
def checkCurrLayer() :
# What is the current layer?
rtn = app.GetCurrentLayer()
oCurrLayer = rtn.Value("Value")
app.LogMessage("Current layer is....." + oCurrLayer.FullName)
app.LogMessage("Current layer is in layer group....." + str(oCurrLayer.LayerGroupName.Value))
# Get initial settings
checkCurrLayer()
# Make a new layer
oNewLayer = app.SICreateLayer2(None, "LayerA")
checkCurrLayer()
# Now explicitly set the new layer as current and check again
app.SetCurrentLayer(oNewLayer)
checkCurrLayer()
# Make another new layer
oNewLayer = app.SICreateLayer2(None, "LayerB", "GroupB")
app.SetCurrentLayer(oNewLayer)
checkCurrLayer()
#OUTPUT OF ABOVE SCRIPT IS:
#INFO : "Current layer is.....Layers.Layer_Default"
#INFO : Current layer is in layer group.....Group_Default
#INFO : "Current layer is.....Layers.Layer_Default"
#INFO : Current layer is in layer group.....Group_Default
#INFO : "Current layer is.....Layers.LayerA"
#INFO : Current layer is in layer group.....Group_Default
#INFO : "Current layer is.....Layers.LayerB"
#INFO : Current layer is in layer group.....GroupB |