## TogglePropVolume

### Introduced

v2.0

### Description

Disconnects (or reconnects) a proportional volume control to its geometry.
This command is typically used to re-position the volume deform when using a volume deform for sculpting. When a volume deform is disconnected it no longer affects the deformed geometry so it may be moved without affecting the current deformations.

### Scripting Syntax

    TogglePropVolume( InputObjs );

### Parameters

Parameter | Type | Description
--- | --- | ---
InputObjs | String | List of volume deform control objects Default Value: Current selection

### Examples

#### VBScript Example

    '

    ' Example using same volume deformer to apply two deforms to a grid

    '

    set grid = CreatePrim( "Grid", "MeshSurface" )

    set volume = GetPrimVolumeDeform

    ApplyPropVolumeOp , "" & grid & ";" & volume, , siPersistentOperation, , 0

    Translate , 0, 2, 0, siRelative, siView, siObj, siXYZ, , , , , , , , , , 0

    TogglePropVolume

    Scale , 0.5, 0.5, 0.5, siRelative, siLocal, siObj, siXYZ, , , , , , , , 0

    TogglePropVolume

    Translate , 0, -2, 0, siRelative, siView, siObj, siY, True, , , , , , , , , 0

### See Also

ApplyPropVolumeOp InspectPropVolume GetConnectedPropVolume