The parameters in this rollout control the representation of the fluids in the viewport. All enabled values are drawn if the content is within the specified range.
UI Path: ||Select PhoenixFDSim|| > Attribute Editor > Preview rollout
Detail Reduction | detailReduction – Decreases the grid and particle detail in the preview. A value of 0 means no reduction. Increase this value if the interface starts to lag due to the simulation being very large. This parameter controls both the viewport preview and the GPU preview.
Auto Reduction | viewAutoReduction – Enables automatic adjustment of the Detail Reduction parameter to improve display performance. The preview detail will be reduced up to a point where the preview will display fast without blocking the interface. Note that the detail will only decrease automatically, but will not increase.
Only if Selected | onlyIfSelected – When enabled, the content in the viewports is only shown for the selected simulators.
Active View Only | activeViewOnly – When enabled, only the selected viewport shows the content of the simulator.
Show Box | showGrid – When enabled, displays the simulator's box in the viewport. The simulator box settings can be modified from the Grid rollout.
Graph Cells | showGridCells – When enabled and Show Box is enabled, displays a lattice with the cell sizes on the sides of the simulator's box.
Show Mesh | viewMesh – Turns the mesh preview on or off. This mode overrides the Voxel Preview mode. Note that if Render Mode is set to Ocean Mesh, the ocean will have lower detail in the preview than in the render in order to speed up the viewport display.
Depth Sorting | viewMeshAlphaSort – When enabled, turns on precise mesh drawing when using transparency.
Color | viewMeshColor – Specifies the color of the preview mesh.
Alpha | viewMeshAlphaSort – Specifies the alpha of the preview mesh, allowing transparent mesh preview.
The default preview mode that displays the individual content of each cell. All enabled channels are drawn if their content is between the corresponding thresholds.
Phoenix FD can only preview the channels present in the cache file for the current frame. To see the list of available channels and their ranges, go to the Cache File Content section of the Simulation roll-out.
Only the Overlap Of | andReduction – When enabled, all channels in a cell must meet the selected threshold conditions to visualize the cell.
Temperature | viewTemp, viewTempColor, viewTempColor2, viewTempThreshold, viewTempThreshold2 – Enables the representation of the temperature.
Smoke | viewSmoke, viewSmokeColor, viewSmokeColor2, viewSmokeThreshold, viewSmokeThreshold2 – Enables the representation of the smoke.
Fuel | viewFuel, viewFuelColor, viewFuelColor2, viewFuelThreshold, viewFuelThreshold2 – Enables the representation of the fuel.
Viscosity | viewVisc, viewViscColor1, viewViscColor2, viewViscThreshold1, viewViscThreshold2- Enables the representation of the viscosity.
Velocity | viewVel, viewVelColor, viewVelColor2, viewVelThreshold, viewVelThreshold2 – Enables the representation of the velocity.
Forces | viewForce, viewForceColor, viewForceColor2, viewForceThreshold, viewForceThreshold2 – Enables preview of how Phoenix forces and standard Maya fields will affect the simulation.
Add Selected Forces or Fields - When a native Maya or Phoenix FD force and a Phoenix FD Simulator are selected, the selected force will be added to the Forces preview of the simulator. This button is a shortcut for adding the selected force to the Force List phxforceprv_set1 which is automatically created with the Phoenix FD Simulator. You could do this manually by Middle-Mouse-Button drag&drop of the force into the Force List set in the Outliner.
RGB | viewUVW, viewUVWThreshold, viewUVWThreshold2 – Enables the representation of the RGB channel or the Wavelet channel, depending on which one is being used.
Auto Range | viewAutoRange – When enabled, automatically adjusts the preview ranges of visible channels for the current frame so that important data is always visible and the preview is always quick.
Note that the force preview is exclusive with all other voxel channel previews and will override other voxel channels. Unlike other voxel preview channels which use the size of the loaded cache, the Forces preview can also work without a loaded cache and will use the grid size of the Simulator.
Additionally, some Phoenix FD forces and standard Maya fields require the previous velocity at their acting position in the grid. This is not yet supported by the Forces preview. As a result, forces such as the Drag force are shown as if their velocity is always 0 and will not be visible. In addition, forces that act differently depending on the quantity of content in the grid (e.g. amount of liquid, smoke, or no content) are not yet supported by the preview.
The parameters here allow visualization of all particle groups generated by the simulator.
Particle Size | viewPartSize – Sets the size of the particles in the Viewport. Note that all particles are drawn with the same size.
Particle Systems | viewPrtSysNames – Displays a list of particle systems generated by the simulator. Selecting a particle system allows you to edit its preview settings.
Show Selected System | viewPrtSysShowUI – When enabled, the particle system will be visible in the simulator preview.
Preview Color | viewPrtSysColorUI – Specifies the default color of the particles. Moving particles are displayed as a blend between their default color and white, based on the selected Scale Color By channel. Note that if the particle system has an RGB channel exported, it will be used in place of the Preview Color.
Scale Color By | viewPrtSysColScaleChanUI – Specifies the particle channel used for adjusting the particle preview color.
- Speed – The faster the particles move, the whiter they will appear. The preview is only affected by the Scale Max option if the particle system has the Velocity channel export enabled.
- Size – The larger the particles are, the whiter they will appear. The preview is only affected by the Scale Max option if the particle system has the Size channel export enabled.
- Age – The older the particles are, the whiter they will appear. The preview is only affected by the Scale Max option if the particle system has the Age channel export enabled.
- Viscosity – The higher the viscosity the particles, the whiter they will appear. The preview is only affected by the Scale Max option if the particle system has the Viscosity channel export enabled.
Auto Scale | viewPrtSysAutoWSpeedUI – When enabled, automatically calculates the preview White Speed based on the Min/Max range of the selected Scale Color By channel, assuming the respective channel export has been enabled in the Output roll-out for the selected particle system.
Scale Max | viewPrtSysWSpeedUI – When Auto Scale is disabled, allows you to specify a constant value at which the particle preview color becomes pure white. Particles with a Scale Color By channel value higher than the specified Scale Max are also pure white.
The Slice preview displays only a single plane of voxels which can be convenient for debugging and fine-tuning a simulation.
Draw Just a Slice | viewSliceAxis – When enabled, only a voxel-thick cross-section of the grid becomes visible. This allows for a better view of occluded details and can help when previewing very rich data such as velocity fields.
Along X / Y / Z axis – Slices the grid along the specified axis.
Disabled – Turns the Draw Just a Slice feature off.
Slice Level | viewSliceLevel – Specifies the offset of the slice from the bottom center of the grid in voxels
GPU Shade Preview
The Phoenix GPU Preview shows the shading of the simulator using the current Volumetric Options. The preview works in real time and you should use it to quickly preview how changing volumetric options and curves affects the look of the simulation. Additionally, it can automatically save images during simulation, so you can easily preview it in motion. Note that the GPU preview is not a replacement for rendering though - in order to display quickly, it ignores Displacement, ignores any volumetric texture mapping of the Fire or Smoke, and all lights are treated as directional, so using dome lights, area lights or global illumination would produce different results than the preview. If you need to iterate on the final look of the simulation in complex lighting setups, V-Ray GPU IPR would allow you to get a much closer result to rendering.
Enable | gpuViewEnbl – Enables the GPU shading preview in the viewport. Note that geometries that intersect or exist inside the bounding box of the Simulator may appear behind the fluid or in front of it. Another limitation of the viewport preview is that it won't be visible if the camera goes inside the Simulator.
Required GPU memory – Shows the approximate texture RAM that will be used for the preview. Note that the GPU can allocate textures that exceed the available GPU memory but at the cost of speed. Also, there is no way to tell if the GPU can handle the texture without trying.
Diffuse Lighting | gpuViewLighting – When enabled, turns on the diffuse lighting. Without lighting, the smoke will not be visible and only fire will be rendered.
Add Selected Lights to GPU Preview – When a light and a PhoenixFDSimulator are selected, the selected light will be used for the GPU preview. This button is a shortcut for adding the selected light to the Lights phxlight_set# which is automatically created with the Phoenix FD Simulator. You could do this manually by Middle-Mouse-Button drag&drop of the light into the Lights set in the Outliner.
Lights | gpuViewLight – A set that specifies the exact lights used in the preview. If empty, the Maya viewport lights will be used, which can be controlled by the viewport's Lighting menu. You may need to select Use All Lights to enable the actual lighting. Note that V-Ray lights may not be used as Maya viewport lights and you should add them to the Lights set explicitly. If no lights are selected neither for the Maya viewport, nor added to the Lights set, Phoenix will use one default directional light.
Max Lights | gpuViewMaxLights – Sets the maximum number of lights used in the GPU preview. If there are more eligible lights depending on the conditions described in the Lights option, only the closest lights to the simulator will be used, and the directional lights will be always with lowest priority.
Ambient Lighting | gpuViewAmbient – When Diffuse Lighting is enabled, this specifies the color of the ambient light.
Background | gpuViewBackground – Specifies the background color when saving preview images in 24-bit format. This can be useful for programs that do not support premultiplied images.
Gamma | gpuViewGammaEnbl, gpuViewGamma – Specifies the gamma for the GPU preview. Affects the viewport preview only.
Save During Simulation | gpuViewSaveOnSim – When enabled, automatically saves the preview of each newly simulated frame.
Image Format | gpuImageFormat – Specifies the format of the saved preview images. If not explicitly specified, the output color depth is 32-bit, and the alpha channel is premultiplied. In Pdplayer, set the "Alpha Mode" to "Ignore Alpha" or "Premultiplied Alpha".
Save Path | gpuViewPath – Specifies the directory and the name template for the output preview image files. It uses the $(scene_dir_instance) macro by default, and there are also other available macros as listed below.
$(work_path) – $(data_dir)/$(scene)_Phoenix_frames/$(nodename)_####.aur
$(data_path) – $(data_dir)/$(scene)_Phoenix2_frames/$(nodename)_####.aur
$(scene_path) – $(dir)/$(scene)_Phoenix_frames/$(nodename)_####.aur
$(scene_dir) – $(dir)/$(scene)_Phoenix2_frames/$(nodename)_####.aur
$(implicit) – Same as $(data_path).
$(dir) – The scene directory.
$(data_dir) – The current workspace data directory. This can be overridden from the Phoenix FD Global Preferences' Default Cache Path option.
$(scene) – The scene file name.
$(nodename) – The name of the node.
$(fullname) – The full name of the node.
$(workspace) – The current workspace directory.
$env(<variable_name>) – An environment variable. See Using Environment Variables below.
#### is the frame number formatted with at least as many digits as the hash signs. If the frame digits are less than the hashes, the number is padded with zeroes to the left. As an example, the following table shows how different numbers of hash signs affect the formatting of different frame numbers.
Save Frame Preview | phxfdSaveFramePreviewSelectedSim – Saves an image preview for the current frame.
Save Animation Preview | phxfdSaveAnimPreviewSelectedSim – Save an image preview for the whole simulation range. Note that the preview in the viewport will be disabled for faster processing.