Scripting: TogglePropVolume

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