Particle_Paint : Helper
| Value > MAXWrapper > Node > Helper > Particle_Paint |
The Particle_Paint helper enables you to paint particles with a specific pattern and timing onto the surface of one or more objects. You can access the Particle Paint helper by choosing Create panel > Helpers > Particle Flow > Particle Paint.
Particle seeds painted with the Particle Paint helper are not particles, but are seeds that can be turned into particles with the Birth_Paint or Placement_Paint operators in Particle Flow.
You can spray particle seeds with a freehand painting tool, or by using 3ds Max splines to define the pattern. Particle_Paint works in any orthogonal viewport such as a Front or Top view. It sprays perpendicular (into) the viewport and plants particle seeds on the surface of first object that it hits.
The Particle_Paint helper was first added to 3ds Max as part of the Creativity Extension to 3ds Max 2009 and became an integral part of 3ds Max 2010. It was previously available in the Particle Flow Tools Box #1.
Setup Rollout
Get/set the Brush Radius value.
Paint Flow Rate
Get/set the Stroke Limit value.
Get/set the Type drop-down list selection index.
Get/set the Seeds Per Second value used when .Rate_Type is set to 0 (Time).
Get/set the Paint Step value used when .Rate_Type is set to 1 (Length).
Get/set the Total Amount value used when .Rate_Type is set to 2 (Stroke).
Brush Adjustment
Get/set the state of the Radius checkbox.
Get/set the graph object controlling the Radius Graph.
Get/set the state of the Rate checkbox.
Get/set the graph object controlling the Rate Graph.
Get/set the Display Type drop-down list selection index.
Stroke Start
Get/set the Stroke Start Type radio button selection index.
Layout Rollout
Paint Objects:
Get/set the Paint At radio button selection.
0 - Paint on All Objects (default)
Get/set the array of nodes to paint on.
Get/set the state of the Animated Objects checkbox.
Get/set the state of the Include Children checkbox.
Mask Objects:
Get/set the state of the Use Mask Objects checkbox.
Get/set the Mask objects node array.
Get/set the state of the Include Children checkbox.
Particle Seed Location:
Get/set the selection index of the Location Type drop-down list.
0 - At Surface (default) - Particle seeds will reside on the surface of any objects on which they are painted.
1 - Above Surface -Particle seeds will be placed above the surface of any objects on which they are painted. The distance above the surface is set with the Distance parameter.
2 - Below Surface - Particle seeds will be placed below the surface of any objects on which they are painted. The distance below the surface is set with the Distance property.
3 - Above And Below Surface - Particle seeds will be placed both above and below the surface of any objects on which they are painted. The distance from the surface is set with the Distance property.
Get/set the distance above and/or below the surface the particle seeds are placed at.
Get/set the random variation of the Distance value as percentage.
Get/set the state of the Separation checkbox.
When set to true,Particle Paint attempts to separate particles by generating seeds repetitively until the desired separation is achieved. The Max Attempts parameter sets the number of times Particle Paint will generate seeds to attempt separation. If Distance is low and Separation is high, the desired separation might not be achieved even after many attempts. In this case, enable Stack Up For Separation.
Get/set the Separation Distance value.
Get/set the Max. Attempts value.
Get/set the state of the Stack Up For Separation checkbox.
When set to true, instead of using repetitive seed generation to attempt to separate particles, the separation conflict is resolved by moving the conflicting seed away in the direction of the surface's normal.
Orientation Rollout
Get/set the state of the Generate Rotation Comp. checkbox.
Get/set the selection index of the Priority Axis radio button.
When the X-Axis is selected as the Priority Axis, particles are first aligned by their local X axes in the manner specified in the drop down list, then the local Z axes are used.
If Z-Axis is selected, particles are aligned first by their local X axes, then their Z axes.
X-Axis:
Get/set the state of the Reverse checkbox when the X Axis is selected.
This has the effect of rotating particles by 180 degrees so they point in the opposite direction.
Get/set the selection index of the Orientation Type drop-down list used when the X Axis is selected as the Primary Axis.
0 - Random- Randomly orients the particles on the surface, according to the selected axis.
1 - Aligned To Surface Normal- Aligns particles to the surface normal of the object upon which they were painted. For example, if X is selected as the Priority Axis, the local X-axis for a particle is aligned with the surface normal. This option is suitable for placing instanced grass or hair objects on a surface.
2 - Align to World X/Y/Z-Axis- Aligns the particles along the World X/Y/Z-Axis.
3 - Look at Viewport- Forces all particles to align with the active viewport.
4 - Look at Particle Paint Icon- Forces all particles to face the Particle Paint Icon.
5 - Follow Stroke- Aligns particles along the spray path in the direction in which the stroke was drawn.
6 - Align to U/V/W Map Vector- Aligns particles along the U/V/W mapping direction on the surface of the painted object.
Z-Axis:
Get/set the state of the Reverse checkbox when the Z Axis is selected.
This has the effect of rotating particles by 180 degrees so they point in the opposite direction.
Get/set the selection index of the Orientation Type drop-down list used when the Z Axis is selected as the Primary Axis.
0 - Random- Randomly orients the particles on the surface, according to the selected axis.
1 - Aligned To Surface Normal- Aligns particles to the surface normal of the object upon which they were painted. For example, if X is selected as the Priority Axis, the local X-axis for a particle is aligned with the surface normal. This option is suitable for placing instanced grass or hair objects on a surface.
2 - Align to World X/Y/Z-Axis- Aligns the particles along the World X/Y/Z-Axis.
3 - Look at Viewport- Forces all particles to align with the active viewport.
4 - Look at Particle Paint Icon- Forces all particles to face the Particle Paint Icon.
5 - Follow Stroke- Aligns particles along the spray path in the direction in which the stroke was drawn.
6 - Align to U/V/W Map Vector- Aligns particles along the U/V/W mapping direction on the surface of the painted object.
Mapping Rollout
Causes each particle seed to acquire the sub-material index (Material ID) at the nearest point of the surface painted.
Creates mapping coordinates for each particle seed according to the Type selection. If you use this option, do not use a Mapping operator with the Birth Paint or Placement Paint operator as this will override the mapping generated by the Particle Paint helper.
Defines the mapping channels to which mapping values are assigned. You can choose more than one channel for assignment. Mapping channels are available for selection only if Generate Mapping Coords is turned on.
Get/set the selection index of the Mapping Type drop-down list.
0 - Stroke Dependent - Spreads mapping values from the Start Value to the End Value over the course of the stroke. The first particle in the stroke is given the Start Value, and the last particle of the stroke is given the End Value. All particles in between interpolate between the Start and End values. The same value is assigned to U, V, and W.
1 - Time Dependent - Assigns mapping values according to time. The first particle in the stroke is given the Start Value, and the timing of each successive particle (in relation to the first particle) receives an incremented value according to the Offset p/Secparameter and the number of seconds elapsed. For example, if Offset p/Sec is 0.25 (the default value), then a 4-second stroke covers the 0-1 range of UV mapping values.
2 - Index Dependent - Assigns mapping values incrementally regardless of the stroke time. The first particle in the stroke is given the Start Value, and each successive mapping value increments by the Offset p/Particle value. If Offset p/Particle is equal to 0.01 (the default value), and a stroke has 101 particles, then particles in the stroke receive the incremental mapping values 0.0, 0.01, 0.02, 0.03,..., 0.98, 0.99, 1.0.
3 - From Object Painted - Particle seeds taking their mapping from their placement on the painted object. A particle acquires the mapping values at the nearest point of the object’s surface. To acquire mapping values from several mapping channels of the object, use multiple selections of the buttons in the Assign To Mapping Channels group.
These mapping types work with numeric parameters to set mapping on particle seeds. For a planar map, for example, the lower left corner has UVW values of 0,0,0, while the upper right corner has UVW values of 1,1,0. These mapping types correlate these values to the stroke.
Get/set the Start Value used when .Mapping_Type is set to 0, 1 or 2.
Get/set the End Value used when .Mapping_Type is set to 0.
Get/set the Offset Value Per Second used when .Mapping_Type is set to 1.
Get/set the Offset Value Per Particle used when .Mapping_Type is set to 2.
Editing Rollout
Get/set the state of the Show Particle Timing checkbox.
Get/set the color of the Colorpicker.
Get/set the state of the Auto Sync Timing By Sel. checkbox.
Get/set the selection index of the Stop Type radio buttons.
Get/set the state of the Auto Adjust Global Timing checkbox.
See Also
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.