CreateLayer

CreateLayer

詳細

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

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

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

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

スクリプト構文

CreateLayer( [PresetObj], [Name], [InputObjs], [Value] );

パラメータ

パラメータ タイプ 説明
PresetObj 文字列またはプリセット オブジェクト(SIGetPreset から取得されたオブジェクトなど) 使用するレイヤのプリセット

デフォルト値: "Default_New_Layer"

指定可能な値:

説明:

Default_New_Layer デフォルトの新しいレイヤ
Name 文字列 新しいレイヤの名前
InputObjs 文字列 レイヤに移動するオブジェクトのリスト

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

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

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

関連項目

SICreateLayer SICreateLayer2 SICreateLayerFromSelection SICreateLayerFromSelection2