CreateLayer

新しいレイヤを作成し、選択対象を追加します。

注: このコマンドは、出力引数を使用します。 C# および一部のスクリプト言語(JScript、PerlScript、Python など)は、リファレンスによって渡される引数をサポートしていません。このため、状況に応じた適切な回避策を実行する必要があります。

スクリプト言語の場合、このコマンドは出力引数を取得するために使用できる ISIVTCollection を戻します。

C# の場合は、XSIApplication.ExecuteCommand メソッドを使用してこのコマンドを呼び出すことができます。 ExecuteCommand は、出力引数を C# の System.Object (出力引数の配列を含む)にパック化します(詳細については、「C# からのコマンドの呼び出し」を参照)。

スクリプト構文

パラメータ

タイプ

詳細

PresetObj

文字列またはプリセットオブジェクト(SIGetPreset から取得されたオブジェクトなど)

使用するレイヤのプリセット

デフォルト値： "Default_New_Layer"

指定可能な値:	説明:
Default_New_Layer	デフォルトの新しいレイヤ

Name

文字列

新しいレイヤの名前

InputObjs

文字列

レイヤに移動するオブジェクトのリスト

デフォルト値：選択されたオブジェクト

値

レイヤ

新しいレイヤを戻します。

例

1. VBScript の例

CreateLayer , "LayerA",,oLayer
SetCurrentLayer oLayer

2. VBScript の例

' Get initial settings
checkCurrLayer
' Make a new layer (it is *not* automatically set as current)
SICreateLayer , "LayerA",oLayer
checkCurrLayer
' Now explicitly set the new layer as current and check again
SetCurrentLayer oLayer
checkCurrLayer
' Make another new layer (it *is* automatically set as current)
CreateLayer , "LayerB",,oLayer
SetCurrentLayer oLayer
checkCurrLayer
function checkCurrLayer()
        ' What is the current layer?
        GetCurrentLayer oCurrLayer
        LogMessage "Current layer is....." & oCurrLayer
end function
'OUTPUT OF ABOVE SCRIPT IS:
'INFO : "Current layer is.....Layers.Layer_Default"
'INFO : "Current layer is.....Layers.Layer_Default"
'INFO : "Current layer is.....Layers.LayerA"
'INFO : "Current layer is.....Layers.LayerB"

3. VBScript の例

Dim oLayer, oGroup
' Create two nulls 
GetPrim "Null"
GetPrim "Null"
' Add them to a new group
Set oGroup = CreateGroup( "NullsGroup", "null*" )
' Move the group to a new layer and make it the current layer
CreateLayer , "LayerNulls", oGroup, oLayer 
SetCurrentLayer oLayer