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.