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