CrowdScatter : ReferenceTarget
Crowd.scatter - superclass: ReferenceTarget; super-superclass:MAXWrapper - 51:0 - classID: #(2055548930, 169758462)
These properties correspond to the Scatter Objects dialog displayed by clicking the Scatter Objects icon in Crowd’s Setup rollout.
Clone Tab Properties
Object in the scene to be cloned.
The number of clones to be generated.
Specify how the object is cloned. It can be cloned as a copy, an instance, or a reference.
When true, all objects linked to the selected object are cloned as well, with the hierarchical structure retained intact for each clone.
Set true to clone an object when calling Scatter All. The object is cloned and then any specified transforms are applied to the clones.
Position Tab Properties
Choose position object before selecting the reference object. On Grid distributes the clones over the surface of a grid object. Inside Box and Inside Sphere distribute the clones within the volume of a primitive box or sphere object, respectively.
An object in the scene to be used as a reference object.
On Surface specifies a consistent distance above the surface using surface normals for distribution. Available only when. positionSpace is set to On Surface.
Specifies the X value for the center of the distribution in world coordinates.
Specifies the Y value for the center of the distribution in world coordinates.
Specifies the Z value for the center of the distribution in world coordinates.
Specifies the maximum distance from the center within which clones are to be positioned.
Specifies that clones are to be distributed on the world XY plane only, resulting in a disc-like array.
<crowd.scatter>.childBbox Boolean Default: True Alias: Include_childrens__bounding_boxes_in_spacing_calculations
When true, all of a hierarchical object's sub-objects are considered when determining spacing. When false, only the selected object is considered.
Specifies the minimum distance between cloned objects. The Spacing setting is multiplied by the size of the object's bounding sphere to determine how close objects can get. If Spacing is left at 1.0, the default, objects normally cannot be positioned within each others' bounding spheres. If Spacing is set to 2.0, objects are separated by a distance equal to or greater than the size of the bounding sphere.
Specifies a seed value for randomizing the clones' locations. If a scene has more than one crowd, each should use a different seed to avoid having identical configurations.
When true and crowds.genlocations is called, add 1 to the .positionSeed value, and redistributes the objects using the new random seed.
Rotation Tab Properties
If true, the forward axis is in the positive direction. If false the forward axis is in the negative direction.
Specifies which axis of the cloned objects points forward, for use with the Look At Target option.
If true the up axis is in the positive direction. If false the up axis is in the negative direction.
Axis of the cloned objects points upward; this axis is aligned with the world Z axis.
Determines the direction from which the clones look. By default, each clone looks from its own position (Self), so that when several clones are looking at a single target, each is oriented differently. To orient each clone so that it's parallel to an imaginary line between two objects (the "from" object and the "to" object), choose Selected Object and specify the object with the (None) button.
An object from which the clones are to look if lookFrom = 1.
1 - Look Toward Selected Object
Determines the direction toward which the scatter objects look. By default, each object retains its current orientation.
An object toward which the clones are to look.
Sets a maximum deviation angle in degrees for the clones' sideways orientation. If clones should look in an object's general direction but may look at a spot to either side of the target, use Sideways Deviation to set the maximum amount by which they can deviate from the calculated angle. The actual deviation amount for each clone is calculated at random, based on the Deviation settings and the Rand Seed setting. Range=0.0 to 180.0.
Sets a maximum deviation angle in degrees for the clones' up/down orientation. If clones should look in an object's general direction but may look at a spot above or below the target, use Up/Down Deviation to set the maximum amount by which they can deviate from the calculated angle. The actual deviation amount for each clone is calculated at random, based on the Deviation settings and the Rand Seed setting. Range=0.0 to 180.0.
Specifies a seed value for randomizing the clones' orientations, based on the Deviation settings. If a scene has more than one crowd, each should use a different seed to avoid having identical configurations.
When true and crowds. genrotations is called, add 1 to the .rotationSeed value, and redistributes the objects using the new random seed.
Scale Tab Properties
Contains options for scaling object clones. For each scaling axis you can specify alternative forward and up axes, plus a target object toward which the clones will point. In addition, you can specify a source object; when using both source and target objects, the clones are rotated so they're parallel to the line between the two.
Sets scaling on the X axis as a multiplier.
Sets the maximum factor for randomization of scaling. For each clone, Deviation is multiplied by a random number between 0.0 and 1.0, and then added to the Scale multiplier.
Lets you use the same scaling as on the Y axis, whether explicit or randomized. When you specify an axis, the parameters group for that axis becomes unavailable.
Lets you use the same scaling as on the Z axis, whether explicit or randomized. When you specify an axis, the parameters group for that axis becomes unavailable.
Sets scaling on the Y axis as a multiplier.
Sets the maximum factor for randomization of scaling. For each clone, Deviation is multiplied by a random number between 0.0 and 1.0, and then added to the Scale multiplier.
Lets you use the same scaling as on the X axis, whether explicit or randomized. When you specify an axis, the parameters group for that axis becomes unavailable
Lets you use the same scaling as on the Z axis, whether explicit or randomized. When you specify an axis, the parameters group for that axis becomes unavailable
Sets scaling on the Z axis as a multiplier.
Sets the maximum factor for randomization of scaling. For each clone, Deviation is multiplied by a random number between 0.0 and 1.0, and then added to the Scale multiplier.
Lets you use the same scaling as on the X axis, whether explicit or randomized. When you specify an axis, the parameters group for that axis becomes unavailable.
Lets you use the same scaling as on the Y axis, whether explicit or randomized. When you specify an axis, the parameters group for that axis becomes unavailable.
Specifies a seed value for randomizing the clones' scales, based on the Deviation settings.
When true and crowds. genscales is called, add 1 to the .scaleSeed value, and redistributes the objects using the new random seed.
All Ops Tab Properties
Set true to clone an object when calling Scatter All. The object is cloned, then any specified transforms are applied to the clones.
Turning on Clones makes the Select Objects to Transform button unavailable. The object to clone and cloning parameters must be specified on the with .ComputeClone.
When true and crowds.scatterall is called, the transforms are applied according to the settings in the Position panel.
When true and crowds.scatterall is called, the transforms are applied according to the settings in the Rotation panel.
When true and crowds.scatterall is called, the transforms are applied according to the settings in the Scale panel.
When true, .ComputePositions is true, and crowds.scatterall is called, add 1 to the .positionSeed value before redistributing the objects using the new random seed.
When true, .ComputeRotations is true, and crowds.scatterall is called, add 1 to the .rotationSeed value before redistributing the objects using the new random seed.
When true, .ComputeScales is true, and crowds.scatterall is called, add 1 to the .scaleSeed value before redistributing the objects using the new random seed.
Except where otherwise noted, this work is licensed under a Creative Commons Attribution-NonCommercial-ShareAlike 3.0 Unported License. Please see the Autodesk Creative Commons FAQ for more information.