pymel.core.effects.fluidVoxelInfo

static effects.fluidVoxelInfo(*args, **kwargs)

Provides basic information about the mapping of a fluid voxel grid into world- or object space of the fluid. Use this command to determine the center point of a voxel, or to find the voxel containing a given point, among other things.

Flags:
Long name (short name) Argument Types Properties
checkBounds (cb) bool ../../../_images/create.gif
 
If this flag is on, and the voxel index of a point that is out of bounds is requested, then we return nothing.
inBounds (ib) int, int, int ../../../_images/create.gif
 

Are the three ints representing the x, y, z indices of a voxel within the bounds of the fluid’s voxel grid? True if yes, false if not. (For 2D fluids, pass in z=0 for the third argument. See examples.)

objectSpace (os) bool ../../../_images/create.gif
 
Whether the queried value should be returned in object space (TRUE), or world space (FALSE, the default).
radius (r) float ../../../_images/create.gif
 

Modifier for the -voxel flag. Returns a list of index triples identifying voxels that fall within the given radius of the point specified by the -voxel flag. Flag can have multiple arguments, passed either as a tuple or a list.

voxel (v) float, float, float ../../../_images/create.gif
 

Returns array of three ints representing the x, y, z indices of the voxel within which the given point position is contained. If the checkBounds flag is on, and the point is out of bounds, we return nothing. Otherwise, even if the point is out of bounds, index values are returned. When combined with the -radius flag, returns an array of index triples representing a list of voxels within a given radius of the given point position.

voxelCenter (vc) bool ../../../_images/create.gif
 

The center position of the specified voxels. Returns an array of floats (three for each of the indices in the query). (Valid only with the -xIndex, -yIndex, and -zIndex flags.)

xIndex (xi) int ../../../_images/create.gif
 
Only return values for cells with this X index
yIndex (yi) int ../../../_images/create.gif
 
Only return values for cells with this Y index
zIndex (zi) int ../../../_images/create.gif
 
Only return values for cells with this Z index

Derived from mel command maya.cmds.fluidVoxelInfo

Example:

import pymel.core as pm

# fluid3D is a 10x10x5 three-dimensional fluid.
# fluid2D is a 9x9 two-dimensional fluid.
#
# Are the given indices within the bounds of the fluids?
#
pm.fluidVoxelInfo( 'fluid2D', inBounds=( 9, 9, 0) )
# Result: false
pm.fluidVoxelInfo( 'fluid2D', inBounds=( 8, 8, 0) )
# Result: true
pm.fluidVoxelInfo( 'fluid3D', inBounds=( 2, 3, 4 ) )
# Result: true
pm.fluidVoxelInfo( 'fluid3D', inBounds=( 12, 9, 2) )
# Result: false

Previous topic

pymel.core.effects.fluidEmitter

Next topic

pymel.core.effects.getDefaultBrush

Core

Core Modules

Other Modules

This Page