nParticle node

Go to: Related nodes. Attributes.

The nParticle node applys dynamic motion to a deformable mesh.
 This can be used to simulate cloth behavior, as well as other
 deformable dynamic shapes, such as metal.

Node name	Parents	MFn type	Compatible function sets
nParticle	nBase	kNParticle	kBase kNamedObject kDependencyNode kDagNode kShape kParticle kNBase kNParticle

Related nodes

field, spring, nBase, nRigid

Attributes (87)

Attribute quick index omitted (too many attributes to show them all).

Long name (short name) Type Default Flags

numSubdivisions (nsub) integer 2

Number of subdivisions for each input/output mesh pairing.

scalingRelation (srl) enum 0

This defines the way dynamic attributes such as bend, stretch and tension are defined relative to object scale and cv density. If Link is specified then stretch and bend are fixed values applied at each link. Thus if a mesh has more cvs it will appear to be more stretchy and bendable, even thought the amount of stretch and bend is the same on a per link basis. With Object Space the mesh will bend and stretch the same amount regardless of the resolution of the mesh. Note that this can result in significantly greater compute times for the high resolution mesh, as the individual links need to be stiffer, which requires more calculation( on top of having more links to compute ). World Space is similar to ObjectSpace, except that the stiffness of the mesh is now fixed in worldspace. Thus scaling a mesh up will make it appear to be a larger sheet made of the same material, which appears proportionately less stiff. For example a small piece of paper may bend little under gravity, but a large sheet would flop.

inputAttract (iatt) float 0.0

Defines how attacted the cloth is to the current position of the input mesh.

inputAttractDamp (iadm) float 0.5

Defines how springy the effect of Input Mesh Attract is. At a value of zero input mesh attract will behave like a spring connection from the input mesh to the output dynamic mesh. The cloth will tend to wiggle about the input mesh position. As the Input Attract Damp is increased to 1 the cloth mesh will still move to the input mesh position but not have the momentum to travel past it, so will no longer occillate about the input position.

ignoreSolverGravity (igsg) bool 0

Turn off the effect of the gravity that is defined on the solver node.

ignoreSolverWind (igsw) bool 0

Turn off the effect of the wind that is defined on the solver node.

windSelfShadow (wssh) bool 0

Allow the object to shadow parts of itself from the wind.

drag (drg) float 0.01

Defines the drag affecting this nBase system

solverDisplay (svds) enum 0

Interactive display of internal solver info.

collideWidthScale (cwds) float 1.0

This defines the collision thickness relative to the radius value. If the collide width scale is 1.0 then the collision width will be the same as the radius. If it is 0.5 then the collision width will be half the radius value.

selfCollideWidthScale (scws) float 1.0

Allows the thickness of each input/output mesh to be scaled for self collision. This value is defined relative to the CollisionWidth, so if SelfCollideWidthScale is 1.0 then the width for self collision will be the same as the collision width. If it is 2.0 then it will be twice the collision width. It can often be useful to the make the self collision width greater than that for collision with other objects, especially when using vertex self collisions.

emissionOverlapPruning (eopr) float 0

This kills newly emitted particles before they appear in the simulation based on how they overlap with existing particles. This value scales the collision radius used to determine overlap. At a value of 1.0 it guarantees no self collisions with other particles on emission.

enableSPH (esph) bool 0

Use SPH to get liquidlike behavior

parallelSPH (psph) bool 0

Use parallel algorithm for SPH

recomputePairsSPH (rpsp) bool 0

Recompute Pairs in inner loop for SPH

incompressibility (incp) float 1.0

This determines now much particles will resist being compressed, if SPH is enabled

viscosity (visc) float 0.1

viscosity, if SPH is enabled

restDensity (rdns) float 2

the amount of overlap that particles attempt to achieve, with SPH enabled

radiusScaleSPH (rsph) float 1

how much to scale the radius for all of the above

threshold (thr) double 0.1

The threshold determines how smooth a blobby particle surface is. The threshold is the density beyond which is inside the surface. Each particle has a density of one in the center falling off to zero at the edge. The density of the particles sum where they overlap creating the overal density field. Note that at densities greater than 1.0 individual particles will disappear and only show up when overlapping other particles.

radius (ra) float 0.2

This determines the overall size of particles.

radiusScale (rdc) compound n/a

Radius Scale multiplies the radius value of the particles.

radiusScale_Position (rdcp) float 0.0

Position of ramp value on normalized 0-1 scale

radiusScale_FloatValue (rdcfv) float 0.0

Ramp value at the sibling position

radiusScale_Interp (rdci) enum 0

Ramp Interpolation controls the way the intermediate values are calculated. The values are:

None

Linear: The values are interpolated linearly in RGB color space.

Smooth: The values are interpolated along a bell curve, so that each color on the ramp dominates the region around it, then blends quickly to the next color.

Spline: The values are interpolated with a spline curve, taking neighboring indices into account for greater smoothness.

radiusScaleInput (rci) enum 0

This determines what attribute is used to index into the color ramp.

radiusScaleInputMax (rcix) float 1

This defines the range of the RadiusScale ramp. For the input "Age" this would be the maximum age in seconds mapped into the ramp. Any older particles would then get the value at the left side of the ramp. For the input particleID this would refer to the maximum particle ID value across the ramp, defined in hundreds of particles. Thus if one had 5000 particles one would need to set this to 50 in order for all particles to have a unique index into the ramp. Input values higher than the max value always clamp to the left side of the ramp.

radiusScaleRandomize (rsr) double 0.0

This is a random size multiplier of the the per particle radius scale values.

massScale (mssc) compound n/a

Mass Scale multiplies the mass value of the particles.

massScale_Position (msscp) float 0.0

Position of ramp value on normalized 0-1 scale

massScale_FloatValue (msscfv) float 0.0

Ramp value at the sibling position

massScale_Interp (mssci) enum 0

Ramp Interpolation controls the way the intermediate values are calculated. The values are:

None

Linear: The values are interpolated linearly in RGB color space.

Smooth: The values are interpolated along a bell curve, so that each color on the ramp dominates the region around it, then blends quickly to the next color.

Spline: The values are interpolated with a spline curve, taking neighboring indices into account for greater smoothness.

massScaleInput (msli) enum 0

This determines what attribute is used to index into the mass scale ramp.

massScaleInputMax (msix) float 1

This defines the range of the MassScale ramp. For the input "Age" this would be the maximum age in seconds mapped into the ramp. Any older particles would then get the value at the left side of the ramp. For the input particleID this would refer to the maximum particle ID value across the ramp, defined in hundreds of particles. Thus if one had 5000 particles one would need to set this to 50 in order for all particles to have a unique index into the ramp. Input values higher than the max value always clamp to the left side of the ramp.

massScaleRandomize (msr) double 0.0

This is a random size multiplier of the the per particle mass scale values.

pointFieldScale (pfsc) compound n/a

Point Field Scale multiplies the point field value of the particles.

pointFieldScale_Position (pfscp) float 0.0

Position of ramp value on normalized 0-1 scale

pointFieldScale_FloatValue (pfscfv) float 0.0

Ramp value at the sibling position

pointFieldScale_Interp (pfsci) enum 0

Ramp Interpolation controls the way the intermediate values are calculated. The values are:

None

Linear: The values are interpolated linearly in RGB color space.

Smooth: The values are interpolated along a bell curve, so that each color on the ramp dominates the region around it, then blends quickly to the next color.

Spline: The values are interpolated with a spline curve, taking neighboring indices into account for greater smoothness.

pointFieldScaleInput (psli) enum 0

This determines what attribute is used to index into the point field scale ramp.

pointFieldScaleInputMax (psix) float 1

This defines the range of the PointFieldScale ramp. For the input "Age" this would be the maximum age in seconds mapped into the ramp. Any older particles would then get the value at the left side of the ramp. For the input particleID this would refer to the maximum particle ID value across the ramp, defined in hundreds of particles. Thus if one had 5000 particles one would need to set this to 50 in order for all particles to have a unique index into the ramp. Input values higher than the max value always clamp to the left side of the ramp.

opacity (op) double 1

The shading opacity.

opacityScale (opc) compound n/a

Opacity Scale multiplies the opacity value of the particles.

opacityScale_Position (opcp) float 0.0

Position of ramp value on normalized 0-1 scale

opacityScale_FloatValue (opcfv) float 0.0

Ramp value at the sibling position

opacityScale_Interp (opci) enum 0

Ramp Interpolation controls the way the intermediate values are calculated. The values are:

None

Linear: The values are interpolated linearly in RGB color space.

Smooth: The values are interpolated along a bell curve, so that each color on the ramp dominates the region around it, then blends quickly to the next color.

Spline: The values are interpolated with a spline curve, taking neighboring indices into account for greater smoothness.

opacityScaleInput (oci) enum 0

This determines what attribute is used to index into the opacity ramp.

opacityScaleInputMax (osis) float 1

This defines the range of the OpacityScale ramp. For the input "Age" this would be the maximum age in seconds mapped into the ramp. Any older particles would then get the value at the left side of the ramp. For the input particleID this would refer to the maximum particle ID value across the ramp, defined in hundreds of particles. Thus if one had 5000 particles one would need to set this to 50 in order for all particles to have a unique index into the ramp. Input values higher than the max value always clamp to the left side of the ramp.

opacityScaleRandomize (osr) double 0.0

This is a random size multiplier of the the per particle opacity scale values.

colorRed (clr) double 0.0

The internal per object color.

colorGreen (clg) double 0.0

The internal per object color.

colorBlue (clb) double 0.0

The internal per object color.

color (cl) compound n/a

Color defines a range of color values used to render the particles.

color_Position (clp) float 0.0

Position of ramp value on normalized 0-1 scale

color_Color (clc) float3

Ramp color at the sibling position

color_ColorR (clcr) float 0.0

Ramp red channel value at the sibling position

color_ColorG (clcg) float 0.0

Ramp green channel value at the sibling position

color_ColorB (clcb) float 0.0

Ramp blue channel value at the sibling position

color_Interp (cli) enum 0

Ramp Interpolation controls the way the intermediate values are calculated. The values are:

None

Linear: The values are interpolated linearly in RGB color space.

Smooth: The values are interpolated along a bell curve, so that each color on the ramp dominates the region around it, then blends quickly to the next color.

Spline: The values are interpolated with a spline curve, taking neighboring indices into account for greater smoothness.

colorInput (coi) enum 0

This determines what attribute is used to index into the color ramp.

colorInputMax (cimx) float 1

This defines the range of the Color ramp. For the input "Age" this would be the maximum age in seconds mapped into the ramp. Any older particles would then get the value at the left side of the ramp. For the input particleID this would refer to the maximum particle ID value across the ramp, defined in hundreds of particles. Thus if one had 5000 particles one would need to set this to 50 in order for all particles to have a unique index into the ramp. Input values higher than the max value always clamp to the left side of the ramp.

colorRandomize (colr) double 0.0

This randomizes the input values for the color ramp for per particle color values. It requires that the colorInput be set to something other than Constant.

incandescence (inca) compound n/a

Incandescence defines a range of incandescence values used to render the particles.

incandescence_Position (incap) float 0.0

Position of ramp value on normalized 0-1 scale

incandescence_Color (incac) float3

Ramp color at the sibling position

incandescence_ColorR (incacr) float 0.0

Ramp red channel value at the sibling position

incandescence_ColorG (incacg) float 0.0

Ramp green channel value at the sibling position

incandescence_ColorB (incacb) float 0.0

Ramp blue channel value at the sibling position

incandescence_Interp (incai) enum 0

Ramp Interpolation controls the way the intermediate values are calculated. The values are:

None

Linear: The values are interpolated linearly in RGB color space.

Smooth: The values are interpolated along a bell curve, so that each color on the ramp dominates the region around it, then blends quickly to the next color.

Spline: The values are interpolated with a spline curve, taking neighboring indices into account for greater smoothness.

incandescenceInput (ini) enum 0