<     > 

CreatePartition

Description

Creates a new object or light partition and adds the specified objects.

Note: This command uses output arguments. C# and some scripting languages (such as JScript, PerlScript and Python) don't support arguments passed by reference so you need to use the best workaround for your situation:

For scripting languages this command returns an ISIVTCollection which you can use to get the output arguments.

For C# you can use the XSIApplication.ExecuteCommand method to call this command. ExecuteCommand packs the output arguments into a C# System.Object containing an Array of the output arguments (see Calling Commands from C#).

Scripting Syntax

CreatePartition( [Target], [Name], [InputObjs], [Value] )

Parameters

Examples

VBScript Example

'
'  This example demonstrates how to create a partition with
'  an object in 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 light partition to the pass with a light in it
CreatePartition oPass, "Sweet_Sorrow", "Light", oLightPart

' 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"

See Also

Autodesk Softimage v7.5     <     >