Versions Compared

Key

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

...

The Particle Tuner uses custom logic to directly affect the particles of the Phoenix FD Simulator. It allows you to do very specific tweaks of the simulation which would otherwise be hard to achieve. It goes through all particles in the system from the Affect list changes the values only of those particles that pass the custom condition you created. Example Conditions and Actions would be: 

...

This will essentially force the fluid to start solidifying if it is emitted from a Source whose RGB is set to Red, and 5 seconds have passed since the fluid was emitted. Fluid which is colored differently will not be affected by the Action, even if it's age is greater than 5.

Unlike the Phoenix FD Mapper, the Particle Tuner can also delete particles from the simulation.

UI Text Box
sizemedium
typetip

The Particle Tuner is a powerful tool and it will not stop you from creating expressions such as "If the Age is higher than 0, delete the particle". This will kill all particles immediately after they are born which may cause confusion, so you must be careful.

Note that the Particle Tuner affects all Phoenix FD Simulators in the scene unless they explicitly exclude it.

...

When [ Edit Condition... ] – Opens the Edit Condition window. The Edit Condition window is used to construct a sequence of tests which are evaluated for every particle of the Phoenix FD SimulatorPhoenix Simulator, at each simulation Step. If the particle satisfies the condition, the selected Then actions are performed - Delete ParticleChange Particle Channel or Affect By Forces. Otherwise, the particle is ignored. By default, the condition is set to "Age > 1.000", therefore only those particles whose age is greater than one will be affected by the specified action. Time Scale different than 1 will affect the Particle Age used by the Particle Tuners. In order to get predictable results you will have to adjust the buildup time using this formula: Time Scale * Time in frames / Frames per second See the Particle Channel Ranges page for more information on the channel ranges.

...

UI Text Box
sizemedium
typeinfo

The Edit Condition window is at the core of the Phoenix FD 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 ParticleChange Particle Channel or Affect By Forcesactions 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.

...

Section

Value Expression Item


Anchor
valueExpression
valueExpression

UI Text Box
sizemedium
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 FD 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 Betweenval_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.

Channelval_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.

Textureval_typeval_tex – returns the specified texture's color intensity in the position of the current particle. The Phoenix FD 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.

...