## 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