Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Section
Column
width35%
UI Text Box
typeinfo

The Edit Condition window is at the core of the Phoenix Particle Tuner. It consists of a Conditions Tree on the left and a Parameters panel for the individual elements in the tree on the right. The Delete Particle, Change Particle Channel or Affect By Forces actions will only be executed for the particles of the Simulator which satisfy the conditions tree.

The Conditions Tree is made up of the following expression types: Logic, Compare, Math, Value.

Folding (collapsing) of a tree item in the view to the left will show you a simplified view of the expression. For example, collapsing the tree in the image below will change its text to "Age > 1.000", meaning the Particle Tuner will affect only particles whose Age channel is higher than 1 second. You can also read a simplified view of the entire condition expression in the text box below the Edit Condition... button.

Column
width5%
 
Column
width60%

Image RemovedImage Added

 

 

Section

Value Expression Item


Anchor
valueExpression
valueExpression

Section
Column
width35%
UI Text Box
typeinfo

The Value Expression Item is the lowest level operator. It expects no sub-expressions but can be converted to a Math Expression Item by selecting it with the right mouse button in the Conditions Tree.

The Value Expression Item returns a raw number which can be either the value of a Particle Channel or a Texture for a given particle of the Phoenix Simulator, a manually-specified number in a certain range or the distance between a given particle and an object in the scene.

Number val_typeval_number – returns the specified value.

Random Between val_type, val_rand_min, val_rand_max – returns a random number in the selected range. Note: a different value is generated for each particle of the Simulator. The value also changes for every frame.

Channel val_type, val_chan_part – returns the value of the specified Simulator Particle Channel for the current particle. You must have this particle channel enabled in the Output rollout of your Simulator. The Channel can be one of:[ Size ], [ Age ], [ Viscosity ], [ RGB Red ], [ RGB Green ], [ RGB Blue ], [ Velocity X ], [ Velocity Y ], [ Velocity Z ], [ Speed ]. You can find out more about the usual particle channel ranges in Phoenix here.

Distance Toval_typeval_dist_node – returns the distance from the current particle to the surface of the specified object. Will be positive if the particle is outside the object volume, and will be negative if the particle is inside the object volume. The distance is in simulation grid voxels. Note: currently you can only pick polygon meshes - measuring distance from the current particle to a nearest particle from a particle system is currently not supported.

Texture val_typeval_tex – returns the specified texture's color intensity in the position of the current particle. The Phoenix Simulator has no Explicit UV coordinates therefore the texture's Mapping should be set to Planar from Object or World XYZ for this to work. For more information on texture mapping in Phoenix, please check the Texture mapping, moving textures with fire/smoke/liquid, and TexUVW page.

Column
width5%

 

Column
width60%

Image RemovedImage Added

 

 

Section

Compare Expression Item


Anchor
compareExpression
compareExpression

Section
Column
width35%
UI Text Box
typeinfo

The Compare Expression Item evaluates to true if the specified condition is valid based on the provided sub-expressions. Otherwise, it evaluates to false.

To create a Compare Expression in the Conditions Tree, right-mouse-button click either on a Logic or a Compare expression and select "Replace with: New Comparison".

Compare Type  | comp_type – Sets the comparison type to perform:

When set to "Is Greater Than", the Compare expression for a given particle will be true when the first Math/Value expression item should return a value larger than the second.

When set to "Is Less Than", the Compare expression for a given particle will be true when the first Math/Value expression item should return a value smaller than the second.

When set to "Is Equal To", the Compare expression for a given particle will be true when both Math/Value expression items evaluate to the same number.

Column
width5%

 

Column
width60%

Image RemovedImage Added

 

 

Section

Math Expression Item


Anchor
mathExpression
mathExpression

Section
Column
width35%
UI Text Box
typeinfo

The Math Expression Item returns a number calculated according to the specified Math Type and the provided sub-expressions.

To create a Math Expression Item in the Conditions Tree, right-mouse-button click either on a Math or a Value expression Item and select one of the "Replace with: (this) ..." options which contains a "+" , "-", "*" or "/" symbol.

Math Typemath_type – Sets the mathematical operation type to perform:

When set to "Plus", the Math expression returns the sum of the two Math/Value expressions below it.

When set to "Minus", the Math expression returns the difference of the two Math/Value expressions below it.

When set to "Multiplied by", the Math expression returns the product of the two Math/Value expressions below it.

When set to "Divided by", the Math expression returns the quotient of the two Math/Value expressions below it.

Column
width5%

 

Column
width60%

Image RemovedImage Added

 

 

Section

Logic Expression Item


Anchor
logicExpression
logicExpression

Section
Column
width35%
UI Text Box
typeinfo

The Logic Expression Item is a top level operator which returns a value of either True or False, depending on the specified Logic Type and the provided sub-expressions.

To create a Logic Expression in the Conditions Tree, right-mouse-button click either on a Logic or a Compare expression and select one of: "Replace with: (this) AND ... " or "Replace with: (this) OR ...".

Logic Type logic_type – Sets the type of logic to use: 

When set to "And", both Compare expressions below should evaluate to true for a given particle for the Logic Expression to be true. 

When set to "Or", at least one of the two Compare expressions below should evaluate to true for a given particle for the Logic Expression to be true.

Column
width5%

 

Column
width60%

Image RemovedImage Added