pymel.core.context.dynParticleCtx¶
- dynParticleCtx(*args, **kwargs)¶
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 particlecommand that the context will issue. In query mode, return type is based on queried flag.
Flags:
Long Name / Short Name Argument Types Properties conserve / c float 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. cursorPlacement / cp bool Use the cursor to place the lower left and upper right of the grid. exists / ex bool Returns true or false depending upon whether the specified object exists. Other flags are ignored. grid / gr bool Create a particle grid. gridSpacing / grs float Spacing between particles in the grid. history / ch bool If this is a tool command, turn the construction history on for the tool in question. image1 / i1 unicode First of three possible icons representing the tool associated with the context. image2 / i2 unicode Second of three possible icons representing the tool associated with the context. image3 / i3 unicode Third of three possible icons representing the tool associated with the context. jitterRadius / jr float Max radius from the center to place the particle instances. lowerLeftX / llx float Lower left X position of the particle grid. lowerLeftY / lly float Lower left Y position of the particle grid. lowerLeftZ / llz float Lower left Z position of the particle grid. name / n unicode If this is a tool command, name the tool appropriately. nucleus / nc bool If set true then an nParticle is generated with a nucleus node connection. Otherwise a standard particle is created. numJitters / nj int Number of jitters (instances) per particle. particleName / pn unicode Particle name. sketch / sk bool Create particles in sketch mode. sketchInterval / ski int Interval between particles, when in sketch mode. textPlacement / tp bool Use the textfields to specify the lower left and upper right of/ the grid. upperRightX / urx float Upper right X position of the particle grid. upperRightY / ury float Upper right Y position of the particle grid. upperZ / urz float Upper right Z position of the particle grid. Flag can have multiple arguments, passed either as a tuple or a list. Derived from mel command maya.cmds.dynParticleCtx
Example:
import pymel.core as pm pm.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.