Versions Compared

Key

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

...

Always – Cache files are always read by the preview.
Disable During Sim
 – Cache files are read only when the simulation is stopped. This would speed up the simulation and is good for overnight simulations where you don't need to watch the simulation constantly.
Don't Preview Caches
 – Cache files are never read for the preview. They will only be read during rendering, or in case any of the Phoenix tools requires them - e.g. the Particle Shader, the Grid Texture, etc. 

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. Note that this parameter does not affect the Mesh preview.

...

Graph Cells | showGridCells – Shows a lattice with the cell sizes on the sides of the Simulator's box or the Slice Preview.

 


Mesh Preview

...

Section

...

Column
width

...

40%

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.

...

Column
width60%

Image Added

...



Anchor
GPUPreview
GPUPreview
GPU Shade Preview

...

UI Text Box
typenote

Note that the GPU Shade Preview is not a replacement for rendering. In order to display in real time, the preview ignores Displacement, as well as any volumetric texture mapping of the Fire or Smoke. There are also some limitations as to how it displays volumes when geometries intersect the sim, or are inside the grid.

Finally, all lights are treated as directional, so using dome lights, area lights or global illumination would produce different render results than the GPU Preview. If you need to iterate on the final look of the simulation with complex lighting setups, you should use V-Ray GPU IPR, or another interactive rendering solution.

...

Section
Column

...

width

...

40%

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

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.

Add Selected Lights to GPU Preview – When a light and a Simulator 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 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 – Specifies the color of the ambient light.

Gamma gpuViewGammaEnbl, gpuViewGamma – Specifies the gamma for the GPU preview. Affects the viewport preview only.

Save Images During Simulation | gpuViewSaveOnSim – When enabled, automatically saves the preview of each newly simulated frame.

Save Alpha | gpuAlphaEnabled – Allows saving an alpha channel if the image format is PNG or TIFF. This option is ignored for BMP and JPG. If you are using 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. The supported formats are PNG, JPG, BMP and TIFF.

UI Expand
titleClick Here to expand additional $(VARIABLE) information

$(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 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.

Align
aligncenter
 

Result
Frame Number#######
11010001
1010100010
1000100010001000

Save Frame Preview | phxfdSaveFramePreviewSelectedSim – Saves an image preview for the current frame. If you have many instances of the same Simulator, you could also merge their GPU Previews in the same image using this example MEL command:

phxfdSaveFramePreview (`ls -ap PhoenixFDSimulator1`,1, "",{});

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. If you have many instances of the same Simulator, you could also merge their GPU Previews in the same image sequence using this example MEL command:

phxfdSaveAnimPreview(`ls -ap PhoenixFDSimulator1`, 1, 5, 1, "",{});

...

Column
width60%

Image Added


Particle Preview

...

UI Text Box
typeinfo

The parameters here control the visualization of Particle Types generated by the Simulator. Phoenix can only preview the Particle Types present in the cache file for the current frame.

UI Text Box
typenote

You can specify a Particle Channel to use as a basis for adjusting the particle preview color, using the Scale Color By option. For example, you could set the Scale Color By option to the Speed particle channel, so that the faster the particles move, the whiter they appear in the preview.

You can find more info on Particle Channels from the Particle Channel Ranges page.

Section

...

Column

...

width

...

40%

Show prv_particles – Enables the preview of particles. The controls below affect the visualization of the currently selected particle group.

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. You can choose the Particle System to edit from the particle Systems menu.

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.

  • No Scaling – All particles will be the same color - the one specified by 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 Scale Max based on the Min/Max range of the selected Scale Color By particle channel, assuming the respective channel export has been enabled in the Output rollout 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. You can also find more info about the usual particle channel maximum values on the Particle Channel Ranges page.

...

Column
width60%

Image Added

...


Voxel Preview

...

UI Text Box
typeinfo

The Voxel Preview displays the Grid Channel content of each cell. Phoenix can only preview the channels present in the cache file for the current frame. All enabled channels are drawn if their content is between the corresponding thresholds.

To see the list of available channels and their ranges for an input sim cache, go to the Cache File Content section of the Simulation rollout. You can also find more info on the Grid Channel Ranges page.

...

Section
Column
width40%

Only the Overlap Of: andReduction – When enabled, all of the enabled channels below 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.

As Fire | viewTempNatural – When the temperature is in Kelvins, e.g. when coming from a Phoenix simulation, the voxel colors come from a physically correct black body radiation model. In this mode the custom color for the temperature are disabled. Check the Grid Channel Ranges for more info.

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.

Velocity Streamlines | viewVelStreamlines, viewVelStreamlinesThreshold, viewVelStreamlinesThreshold2, viewVelStreamlinesColor, viewVelStreamlinesColor2 – Traces the velocity field of the cache files to generate a streamline preview.

As Rainbow viewVelStreamlinesColorCurve – Represents the Velocity Streamlines in rainbow colors, where red is the fastest, green is medium speed and blue is the slowest.

Streamlines Length | viewVelStreamlinesMaxIterations – Signifies the maximum length of each streamline in the preview. Adjusting the value will provide you with a guide/preview of the velocity field's motion. The Streamline's length is measured in voxels and at the lowest setting, the Streamlines will be no larger than a voxel.

UI Text Box
typeinfo

The Velocity Preview is inactive when the Forces Preview is enabled, and vice versa. Similarly, the Velocity Streamlines Preview is inactive when the Force Streamlines Preview is enabled, or the other way around.

Forces | viewForce, viewForceColor, viewForceColor2, viewForceThreshold, viewForceThreshold2 – Enables preview of how Phoenix forces and standard Maya fields will affect the simulation. This preview can be shown even without any loaded simulation.

Add Selected Forces or Fields - When a native Maya or Phoenix force and a Phoenix 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 Simulator. You could do this manually by Middle-Mouse-Button drag&drop of the force into the Force List set in the Outliner.

Force Streamlines | viewForceStreamlines, viewForceStreamlinesThreshold, viewForceStreamlinesThreshold2, viewForceStreamlinesColor, viewForceStreamlinesColor2 – Enables a streamline preview of how Phoenix forces or standard Maya fields will affect the simulation. This preview can be shown even without any loaded simulation.

As Rainbow | viewForceStreamlinesColorCurve – Represents the Force Streamlines in rainbow colors, where red is the fastest, green is medium speed and blue is the slowest.

Lines Length | viewForceStreamlinesMaxIterations – Signifies the maximum length of each streamline in the preview. Adjusting the value will provide you with a guide/preview of the force field's motion. The Streamline's length is measured in voxels and at the lowest setting, the Streamlines will be no larger than a voxel.

UI Text Box
typenote

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 forces and standard Maya fields such as the Drag force are not supported yet, 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.

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.

Column
width60%

Image RemovedImage Added

 


Bake Streamlines

...

Section
Column
width40%

Bake Streamlines to Curves  Button for converting the currently shown Streamline preview (either Velocity Streamlines or Force Streamlines) into native Maya curves. The baked curves can be rendered like any regular Maya curve by using the V-Ray Renderable Curves node.

Auto Bake | autoBakeStreamlineCurvesOnPreviewChange – Enables automatic Streamlines to Curves baking on any change in the Streamlines Preview. While the Auto Bake option is enabled you don't have to press the Bake Streamlines button in order for scene changes to be applied to the curves and changing the timeline frame will update the baked curves.

Column
width

...

60%

Image Modified

...



Slice Preview

...

UI Text Box
typeinfo

The Slice preview displays only a single slice of voxels which can be convenient for debugging and fine-tuning a simulation.

...

Section
Column
width40%

Draw a Slice | viewSliceAxis – When enabled, only a voxel-thick cross-section of the grid is visible. This works for voxels, particles, and velocity streamlines, but not for the GPU Preview or the Mesh Preview. It allows for a better view of occluded details and can help when previewing very rich data such as velocity fields, or in order to see underwater cavities.

Along Axis X, Y, Z – 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.

Slice Width | viewSliceWidth – Specifies the width of the slice in voxels.

Column
width60%

Image Added