Position_Object - superclass: helper super-superclass:node - classID: #(1962490647, 515064320)
By default, particles are born, or emitted, from the Particle Flow icon. The Position_Object operator lets you emit particles from any other object or objects in the scene instead. This topic uses the term emitter to refer to an object or objects used to emit particles with this operator.
Use the Position_Object settings to control the initial placement of particles on the emitter. You can set the emitter to emit particles from its surface, volume, edges, vertices, or pivot, or from a sub-object selection. You can also control particle emission with a material applied to the object.
When set to true, causes all particles to remain at their initial positions on the emitter. When set to false, each particle's birth position is determined by the emitter's current location.
When set to true, the software sets each particle's speed and direction of motion to those of the emitter at the time of birth. When set to false, the emitter movement doesn't affect that of the particles. Used only when Lock_On_Emitter is set to false.
Determines, as a percentage, the extent to which particles inherit the emitter's motion. Available only when Inherit_Emitter_Movement is on.
Determines, as a percentage, the extent to which inherited emitter motion can vary per particle. To determine the final multiplier for each particle, the Variation value is multiplied by a random number between -1.0 and 1.0, and then added to the Multiplier value.
Specifies the list of emitter nodes to be used. When the list is empty, the world origin (0.0,0.0,0.0) will be used as the emitter source.
When set to true, allows particles to follow the surface of an object whose form is animated by morphing or with modifiers.
When set to true, the operator acquires animation of the emitter shape on a tick basis (every 1/4800th of a second) rather than a frame basis. This provides greater precision in allowing the particle positions to follow animation of the emitter object's form.
Controls the state of the Location drop-down list. It lets you specify where on each emitter the particles appear. This choice applies to all emitter objects.
0: Pivot - Emits particles from the original position of the emitter object's pivot. Moving the pivot does not affect this option.
1: Vertices - Emits particles from randomly selected vertices of the emitter objects.
2: Edges - Emits particles from random points along the edge sub-objects of the emitter objects.
3: Surface - Emits particles from random points on the surface of the icon.
4: Volume - Emits particles from random points within the volume of the icon.
5: Selected Vertices - Emits particles from the current vertex sub-object selection.
6: Selected Edges - Emits particles from the current edge sub-object selection.
7: Selected Faces - Emits particles from the current face or polygon sub-object selection.
Lets you specify a range of distances from the object surface for particle placement.
Use_Surface_Offset is not used when Location is set to 0 : Pivot or 1 : Volume. Use the Surface_Offset_Minimum and Surface_Offset_Maximum parameters to set the range.
Negative values offset the particles below the surface.
When Use_Surface_Offset is set to true, let you specify the range of offset distances from the object surface.
When set to true, enables the usage of the Density_Type option.
Varies emission over the emitter surface based on properties of the material applied to the emitter. For example, if the object is assigned a black-and-white checkered diffuse map and you choose the Grayscale option, particles are emitted only from the white checks.
Possible values are:
0: Grayscale - The software internally converts the material-based coloring (diffuse) to grayscale, and then emits more particles in lighter areas and fewer in darker areas.
1: Opacity - Particles are more likely to appear on opaque areas than on transparent areas.
2: Grayscale & Opacity - Combines the two: More particles appear on light, opaque areas than on dark, transparent areas.
3: Red/Green/Blue - Considers only the specified color channel. The higher its value at any given pixel, the more likely particles are to appear there.
When set to true, uses a sub-material from the Multi/Sub-Object material assigned to the emitter to define density values.
Specifies the material ID of the sub-material to be used for particle emission.
When set to true, the software attempts to keep the particles apart by the amount specified in Distance. The likelihood of successfully separating particles depends on the number of particles, the specified distance, and the .Maximum_Number_of_Attempts value.
Specifies the distance, in system units, by which the software should try to keep the particles separate.
Limits emission to a specific number of points on the specified Location type. Emission points are still randomized. Change the Random_Seed value to alter these.
Sets the number of emission points. Available only when .Distinct_Points_Only is set to true.
When set to true, if the software cannot place a particle according to the current option, it deletes the particle. When set to false, particle placement is undefined; that is, it depends on other variables.
Specifies the randomization value.
When .Apart_Placement is set to true, this specifies the maximum number of times Particle Flow will try to set particle positions that maintain the requested distance. If unsuccessful within this number of attempts, particles might be closer together than the requested distance. Also affects placement with .Density_By_Emitter_Material when .Density_Type is set to either of the Grayscale options.
Particle Flow Classes