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
grid (gr)		bool
	Create a particle grid.
gridSpacing (grs)		float
	Spacing between particles in the grid.
history (ch)		bool
image1 (i1)		unicode
image2 (i2)		unicode
image3 (i3)		unicode
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
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.