CreateEmptyPartition

指定のタイプ(オブジェクトまたはライト)の新しい空のパーティションを作成し、検査します。このコマンドは、シーン内のすべてを選択解除して Render メニューから[Pass - Partition] > [New]を選択することと同等の機能です。

注: 空のパーティションを作成したらそこに項目を追加することができますが、CreatePartition コマンドと SICreatePartition コマンドは両方の作業を同時に実行します。

パーティションはパスの一部で、グループと同様に振舞います。パーティションは、パス内でシーンエレメントを編成するために使用します。パーティションのタイプはオブジェクトおよびライトの 2 つです。レンダパスは、シーンの画像レイヤを作成します。作成したレイヤを他のパスと合成し、完全なイメージを作成できます。

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

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

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

スクリプト構文

パラメータ

パラメータ	タイプ	詳細
Target	文字列	パーティションを追加するパスデフォルト値：選択されているパス(現在のパス)
Name	文字列	新しいパーティションの名前デフォルト値：「Partition」
タイプ	siPartitionType	作成するパーティションのタイプデフォルト値： siObjectPartition
値	Group オブジェクトを含む XSICollection	新しいパーティションを戻します。

例

VBScript の例

'
'       This example demonstrates how to create an empty partition
'       and then add an object to it. It also shows how you can 
'       access partition information from a particular pass.
'
' Create a new scene 
NewScene , false
' Create a cone to add to one of the partitions
Set oCone = GetPrim( "Cone", "MeshSurface" )
' Create a standard (default) pass 
CreatePass , "PassMeBy", oPass
' Print partition info for default pass
getPartInfo oPass
' Now add an empty light partition to the pass and add the light to it
CreateEmptyPartition oPass, "Sweet_Sorrow", siLightPartition, oLightPart
AddToPartition oLightPart(0), "Light"
' Print new partition info 
getPartInfo oPass
function getPartInfo( in_pass )
        Application.LogMessage "Partitions for " & in_pass & ":"
        Application.LogMessage "--------------------------------"
        ' Create an XSICollection with the partition info
        set oParts = CreateObject( "XSI.Collection" )
        oParts.SetAsText in_pass & ".Partitions.*" 
        For Each p In oParts
                Application.LogMessage p
        Next
end function
' Output of the above script:
'INFO : "Partitions for Passes.PassMeBy:"
'INFO : "--------------------------------"
'INFO : "Passes.PassMeBy.Background_Objects_Partition"
'INFO : "Passes.PassMeBy.Background_Lights_Partition"
'
'INFO : "Partitions for Passes.PassMeBy:"
'INFO : "--------------------------------"
'INFO : "Passes.PassMeBy.Background_Objects_Partition"
'INFO : "Passes.PassMeBy.Background_Lights_Partition"
'INFO : "Passes.PassMeBy.Sweet_Sorrow"