Go to: Synopsis. Return value. Flags. Python examples.

Synopsis

dynParticleCtx( string , [conserve=float], [cursorPlacement=boolean], [grid=boolean], [gridSpacing=float], [jitterRadius=float], [lowerLeftX=float], [lowerLeftY=float], [lowerLeftZ=float], [nucleus=boolean], [numJitters=int], [particleName=string], [sketch=boolean], [sketchInterval=int], [textPlacement=boolean], [upperRightX=float], [upperRightY=float], [upperZ=float])

Note: Strings representing object names and arguments must be separated by commas. This is not depicted in the synopsis.

dynParticleCtx is undoable, queryable, and editable.

The particle context command creates a particle context. The particle context provides an interactive means to create particle objects. The particle context command also provides an interactive means to set the option values, through the Tool Property Sheet, for the "particle" command that the context will issue.

Return value

None

In query mode, return type is based on queried flag.

Flags

conserve, cursorPlacement, grid, gridSpacing, jitterRadius, lowerLeftX, lowerLeftY, lowerLeftZ, nucleus, numJitters, particleName, sketch, sketchInterval, textPlacement, upperRightX, upperRightY, upperZ
Long name (short name) Argument types Properties
particleName(pn) string queryedit
Particle name.
nucleus(nc) boolean queryedit
If set true then an nParticle is generated with a nucleus node connection. Otherwise a standard particle is created.
conserve(c) float queryedit
Conservation of momentum control (between 0 and 1). For smaller values, the field will tend to erase any existing velocity the object has (in other words, will not conserve momentum from frame to frame). A value of 1 (the default) corresponds to the true physical law of conservation of momentum.
numJitters(nj) int queryedit
Number of jitters (instances) per particle.
jitterRadius(jr) float queryedit
Max radius from the center to place the particle instances.
sketch(sk) boolean queryedit
Create particles in sketch mode.
sketchInterval(ski) int queryedit
Interval between particles, when in sketch mode.
grid(gr) boolean queryedit
Create a particle grid.
gridSpacing(grs) float queryedit
Spacing between particles in the grid.
cursorPlacement(cp) boolean queryedit
Use the cursor to place the lower left and upper right of the grid.
textPlacement(tp) boolean queryedit
Use the textfields to specify the lower left and upper right of/ the grid.
lowerLeftX(llx) float queryedit
Lower left X position of the particle grid.
lowerLeftY(lly) float queryedit
Lower left Y position of the particle grid.
lowerLeftZ(llz) float queryedit
Lower left Z position of the particle grid.
upperRightX(urx) float queryedit
Upper right X position of the particle grid.
upperRightY(ury) float queryedit
Upper right Y position of the particle grid.
upperZ(urz) float queryedit
Upper right Z position of the particle grid.

Flag can appear in Create mode of command Flag can appear in Edit mode of command
Flag can appear in Query mode of command Flag can have multiple arguments, passed either as a tuple or a list.

Python examples

import maya.cmds as cmds

cmds.dynParticleCtx( 'dynParticleContext', e=True, nj=5, jr=1.5 )
# Set the option values for number of jitters to 5 and jitter
# radius to 1.5 in the particle context, which will result in
# creating 5 particles for each mouse click in the viewport,
# randomly placed, but all within 1.5 units of the mouse click.