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


goal( selectionList , [goal=string], [index=boolean], [useTransformAsGoal=boolean], [weight=float])

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

goal is undoable, queryable, and NOT editable.

Specifies the given objects as being goals for the given particle object. If the goal objects are geometry, each particle in the particle object will each try to follow or match its position to that of a certain vertex/CV/lattice point of the goal. If the goal object is another particle object, each particle will try to follow a paricle of the goal. In any other case, all the particles will try to follow the current location of the goal object's transform. You can get this latter behavior for a geometry or particle object too by using -utr true.

The goal weight can be keyframed. It lives on the particle object to which the goal was added and is a multi-attribute.

Return value


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




goal, index, useTransformAsGoal, weight
Long name (short name) Argument types Properties
goal(g) string createquerymultiuse
This flag specifies string to be a goal of the particle object on the command line or the currently selected particle object. This flag can be used multiple times to specify multiple goals for a particle object. Query is for use by the attribute editor.
weight(w) float create
This specifies the goal weight as a value from 0 to 1. A value of 0 means that the goal's position will have no effect on the particle object, while a weight of 1 will make the particle object try to follow the goal object exactly. This flag can only be passed once and sets the weight for every goal passed with the -g/-goal flag.
index(i) boolean query
Returns array of multi-attribute indices for the goals. Intended for use by the Attribute Editor.
useTransformAsGoal(utr) boolean create
Use transform of specified object instead of the shape. Meaningful only for particle and geometry objects. Can only be passed once, applies to all objects passed with -g.

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.sphere( name='surface1')
cmds.particle( name='Particle')

cmds.goal( 'Particle', g='surface1', w=.75 )

# This command assigns surface1 as a goal of Particle with a goal
# weight of 0.75.

cmds.goal( 'Particle', g='surface1', w=.75, utr=1 )

# This command assigns the transform of surface1 as a goal of Particle
# with a goal weight of 0.75.

cmds.goal( 'Particle', g='camera1', w=.75 )

# This command assigns the transform of camera1 as a goal of Particle
# with a goal weight of 0.75.  The -utr flag is not relevant because
# only the transform can be used for any object other than geometry
# or particles.