SICreateLayerFromSelection

新規レイヤを作成して選択オブジェクトをそのレイヤに追加しますが、現在のレイヤにはしません。

注: このコマンドは、出力引数を使用します。 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 の例

'
' This example shows how to use the current selection
' to create a new layer and set that layer to current
'
NewScene , false
CreatePrim "Cylinder", "MeshSurface"
CreatePrim "Sphere", "MeshSurface"
ToggleSelection "cylinder", , True
' Now create the layer from the selection and make it current
SICreateLayerFromSelection , "LayerA", , oLayer
SetCurrentLayer oLayer

2. JScript の例

/*
        This example demonstrates how to create a new layer
        and set it to be the current layer
*/
// Setup
NewScene( null, false );
CreatePrim("Cylinder", "MeshSurface", null, null);
CreatePrim("Sphere", "MeshSurface", null, null);
ToggleSelection("cylinder", null, true);
// Get initial settings
checkCurrLayer();
// Make a new layer (it is *not* automatically set as current)
var oLayer = SICreateLayerFromSelection( null, "LayerA" )(0);
checkCurrLayer();
// Now explicitly set the new layer as current and check again
SetCurrentLayer( oLayer );
checkCurrLayer();
function checkCurrLayer()
{
        // What is the current layer?
        var oCurrLayer = GetCurrentLayer()(0);
        Application.LogMessage( "Current layer is....." + oCurrLayer );
}
// Expected result:
//INFO : Current layer is.....Layers.Layer_Default
//INFO : Current layer is.....Layers.Layer_Default
//INFO : Current layer is.....Layers.LayerA

3. Python の例

#
# This example demonstrates how to 
# create a layer from a group
#
app = Application
app.NewScene( "", 0 )
# Create two nulls 
app.GetPrim( "Null" )
app.GetPrim( "Null" )
# Add them to a new group
oGroup = app.CreateGroup( "NullsGroup", "null*" )
# Move the group to a new layer
ivtInfo = app.SICreateLayerFromSelection( "", "LayerNulls" )
oLayer = ivtInfo.Value( "Value" )
app.SetCurrentLayer( oLayer )