This page provides information on the Mapper component.
The Mapper uses textures to affect a channel in the simulation's grid. The chosen grid channel can either be directly set to the texture's values when the simulation starts, or it can gradually approach the texture's values over time. The Buildup Time specifies the time it takes for the channel to reach the full value specified in the texture under the influence of the Mapper.
The Mapper affects all Phoenix simulators in the scene unless they explicitly exclude it.
Active | active – Animatable checkbox that turns on and off the effect of the Mapper.
Initializer | init – The Mapper can work in two different modes. When this is checked, the Mapper just sets the initial conditions for the grid and stops affecting the simulation afterwards. Otherwise, while the simulation runs, it gradually or immediately keeps changing the value of the selected grid or particle Channel towards the value in the Map (similarly to a Source in Volume Brush mode).
Channel | channel – Specifies which channel is affected by this helper. It can be one of the following:
Disabled - Disables this node.
Temperature - Maps the voxels of the simulator for the Temperature channel to the texture values. Keep in mind that this channel should be mapped with a texture with a range that is typically [ 300, 2000 ] for Fire/Smoke simulations.
Smoke - Maps the voxels of the simulator for the Smoke channel to the texture values. This channel is typically in the range [ 0, 1 ].
Fuel - Maps the voxels of the simulator for the Fuel channel to the texture values. This channel is typically in the range [ 0, 1 ].
Velocity - Maps the voxels of the simulator for the Velocity channel to the texture values. This channel can take both positive and negative values, and its range is not limited. If your texture produces no result, try using an Output 3ds Max texture to boost the values. Velocity is typically in the range of [ 10, 1000 ].
RGB - Maps the voxels of the simulator for the RGB channel to the texture values. Essentially, this will transfer the texture color to the RGB channel.
Viscosity - Maps the voxels of the simulator for the Viscosity channel. This channel is typically in the range [ 0, 1 ].
Affected Particle Systems | affectpartsys - Allows the Mapper to separately affect the Liquid, Foam, Splash or Mist particles.
The Mapper can not create or delete particles - it can only change values in their channels, such as particle Velocity, RGB or Viscosity.
Map | map – Specifies the texture that will copy its values into the Simulator. It should be mapped into Object XYZ (using the Simulator box) or World XYZ. For channels that may require values higher than 1 (such as Velocity or Temperature), you can use a regular 3ds Max Output Map to expand the texture's values.
Mask | mask – A mask that specifies the region which will be affected by the Mapper. It allows you to limit the effect of the Mapper only to a certain volume in the Simulator. White values in the texture mean that the region is affected, and black values mean that the region is not affected. Gray values in between mean that the region is affected, but will take longer time to reach the values from the Map.
If the Buildup Time is 0, gray mask values will be treated as white, and the Mapper will act with full strength in such voxels. You could use a V-Ray DistanceTex as a Mask in order to confine the effect of the Mapper to a geometry volume, in order to make it easier to setup the effect visually.
Buildup Time | influence – When Initializer is disabled, this parameter specifies the time it takes (in seconds) for the channel to gradually reach the value specified in the Map. If Buildup Time is 0, the effect is instant and fluid is set to the values from the Map immediately.