glmCreatePopulationTool

The glmCreatePopulationTool command allows to create a Population Tool Locator:
int glmCreatePopulationTool [-shape string] [-center float float float] [-diagonal float float float] [-points float float float] [-forwards float float float] [-normals float float float] [-radius float] [-emitterParticleSystem string] [-mesh string] [-curve string]

Flags

Long name (short name) Argument types Properties Description
-shape (-s) string mandatory Shape type of the resulting locator. Valid values are point, quad, polygon, circle, triangle, multipoints, mesh, curve, scatter, sphere, mayaEmitter
-center (-c) float float float   Position of the center of the locator when shape is point, circle or sphere
-diagonal (-d) float float float multi use Two positions of the locator diagonal when shape is quad
-points (-p) float float float multi use Positions of the custom shape locator when shape is polygon, triangle or multipoints
-forwards (-f) float float float multi use Forward vectors of the slots when shape is multipoints
-normals (-n) float float float multi use Normal vectors of the slots when shape is multipoints
-radius (-r) float   Radius of the locator when shape is circle or sphere
-crowdEntityTypes (-cet) string multi use Name of all the Crowd Entity Types to assign to the slots
-mesh (-msh) string   Name of the Maya mesh to attach to when shape is mesh
-curve (-crv) string   Name of the Maya curve to attach to when shape is curve

Return Value

This command returns true if it succeeds in creating the locator:

MEL Examples

// create a grid population tool
glmCreatePopulationTool -shape point -center 0 0 0 -crowdEntityTypes "manTypeShape" -crowdEntityTypes "womanTypeShape" ;
// Result: 1 //

Python Examples

# Create a grid population tool
import maya.cmds as cmds
cmds.glmCreatePopulationTool(shape="point", center=[0, 0, 0], crowdEntityTypes=["manTypeShape", "womanTypeShape"])

# Result: True #