AddToPartition

Description

Adds one or more objects to a partition and remove them from the current partition.

Scripting Syntax

AddToPartition( Target, InputObjs )

Parameters

Parameter

Type

Description

Target

String

Partition to add the objects to.

InputObjs

String

List of objects to add to the partition.

Examples

VBScript Example

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

See Also

CreateEmptyPartition

MoveToPartition

RemoveFromPartition

CreatePassWithPartition



Autodesk Softimage v7.5