isurf

 

 

This node creates iso-surface from input particles and supports four most popular particle meshing methods. ISurf can also transfer uvw data from particle onto the output mesh. As input it supports particles, particle groups, voxel grid and PhysX PBD liquid.

 

[Inputs]

 

#Particle Stream - This pin requires a particle stream to be connected. Connection is usually not required if any of the attributes is connected.

 

#Input (Grid) – Connect voxel grid to generate mesh based on smoke, fire or temperature.

 

#Input (PhysX) – Connect PhysX Simulation to generate mesh based on PBD Liquid particles.

 

Enabled - Enable or disable node evaluation.

 

ISurf Shape Group - ISurf node outputs a particle that will belong to this group. Particle will not be visible in the viewport and it will not affect the position of the shape.

 

Input Source – Choose between several input sources.

• Particle – Particles that are fed into the particle stream input will be used to generate isurf mesh.
• Particle Group - All particles from the Particle Group will be used.
• PBD Liquid – Generates mesh based on the connected PhysX and user defined PBD phases..
• Voxel Grid – Generates mesh based on connected Voxel Grid and user-defined meshing channel.

 

Meshing Mode - There are several methods to create iso surface and each method will be covered below. Zhu-Bridson will generate the smoothest surface, while Anisotropic is the best for meshing many water particles although it`s the slowest option.

 

Grid Spacing - Iso surface meshing is done on a regular grid where each grid cell calculates contribution for each particle. Smaller spacing will result in more detailed mesh but it`ll take considerable more memory and time to compute.

 

Input Particle Group – This option is visible only when input source is set to Particle Group and ISurf will use all particle from all particle groups that were selected by using the RegEx.

 

PBD Phases List – This option is visible only when input source is set to PBD Liquid. The ISurf node can be applied selectively to specific liquid phases. If no phase is specified, the force will affect all liquid phases by default.

 

 

Particles

This group of parameters ia visible only when particles are meshed.

 

Use Particle Radius – Enable this option to use per-particle radius values. If disabled, a single user-defined radius is applied to all particles.

 

Radius – The particle radius that will be used to generate the iso-surface. A larger radius, combined with a higher threshold, will create a smoother surface but will result in slower generation and less detail.

 

Radius Scale – Particle radius scaling factor.

 

 

Union of Spheres	Metaballs	Zhu-Bridson	Anisotropic

 

 

Union of Spheres

Treats each particle as perfect sphere. Resulting mesh won`t be thin and smooth as other modes.

 

Metaballs

This is a standard iso surface generation method.

 

Threshold - Iso surface threshold. Smaller threshold will produce more relaxed surface.

 

Zhu-Bridson

More advanced method than metaballs that tends to create a smoother surface.

 

Threshold - Iso surface threshold. Smaller threshold will produce more relaxed surface.

 

Anisotropic

The most advanced and the slowest method that allows particles to be stretched to create the smoothest surface of all available methods. This meshing mode is perfect for smooth liquids surface.

 

Threshold - Iso surface threshold. Smaller threshold will produce more relaxed surface.

 

Min. Neighbours - Particle will be stretched only if it has at least this many neighbours.

 

Lambda - Smaller value will result in surface with more disconnected areas.

 

Max Stretch - Maximum particle stretch amount.

 

 

Voxel Grid

This option lets you mesh Voxel Grid smoke, fire and temperature fields.

 

Use Grid Spacing - If this option is enabled, the ISurf grid spacing will match the Voxel Grid spacing

 

Spacing Scale - Use this option to create finer of coarser meshes by scaling the meshing grid spacing.

 

Channel - Channel you with to create mesh from.

 

Threshold – Voxel Grid voxels with channel values lower than threshold will be considered as empty.

 

 

Data Transfer

ISurf can retrieve velocities from any particle system and UVW data from NodeWorks particles, then bake them onto the resulting mesh. However, velocities are always generated as they are required for motion blur and filtering, while UVW is generated on demand.

 

Radius Scale – When transferring particle data to the mesh, this value will multiply the Radius value to transfer data across a broader range of voxels. In most cases, this value can remain at 1.0, but as soon as you use smoothing, you may need to increase it to obtain correct velocities or UVWs across the surface.

 

#Color – Connect color value to use when input mode is set to Particles.

 

Channel – Mapping channel that will hold colors.

 

#UVW 1 – Connect uvw value to use when input mode is set to Particles..

 

UVW 1 Map Channel – Mapping channel that will hold fist set of UVW data.

 

#UVW 2 – Connect uvw value to use when input mode is set to Particles..

 

UVW 2 Map Channel – Mapping channel that will hold second set of UVW data.

 

Material ID – ISurf shape material ID.

 

 

Filtering

Filtering options allow you to smooth the entire mesh or selectively target specific areas based on particle velocities using the Filtering Mask. Without the mask, the entire water surface would be smoothed, even in areas where detail is needed. Since the most detail is typically found in regions of high liquid velocity, applying a velocity-based filter mask helps retain detail in those areas.

 

 

Enabled – Check this option to enable smoothing.

 

Mode – Choose between three filtering options: Mean, Gaussian and Median. Each option will result in smoother surface but at the expense of details.

 

Kernel Radius – Higher values will result in a smoother surface. The mean filter is the slowest one, and high values can significantly impact meshing speed.

 

Use Mask – Enable the Mask option to vary the filter strength based on velocity, which will help to preserve detail in areas of high velocity.

 

Mask Alpha – Blend between smoothed and original values using this mask, which can be animated. This is useful for generating a completely smooth water surface before object impact or in similar situations. In regions where the mask or alpha value is zero, no smoothing will be applied.

 

Mask Min. Velocity – Minimum velocity value where mask strength will be the strongest.

 

Mask Max. Velocity – Maximum velocity value where mask strength will be the weakest

 

Mask Smooth Enable – Enable this option to apply smoothing to the mask itself. If there is an abrupt transition between the mask and the unsmoothed mesh, use this option to create a gradual transition.

 

Mask Mode – Enable this option to apply smoothing to the mask itself. If there is an abrupt transition between the mask and the unsmoothed mesh, use this option to create a gradual transition

 

Display Mask – Displays the smoothing mask directly on the mesh as a color gradient where red values represent the strongest mask value and blue is the weakest. Enabling this option will automatically enable NodeWorks Vertex Color display option.

 

Boundaries are used to mesh only a portion of particles or just to generate liquid surface.

 

 

Boundaries

Enabled – Check this option if you want to use Bounding Box helper.

 

Create Bounding Box – Click on this button to create Bounding Box helper object in the scene and add it to the ISurf.

 

Remove Boundaries – With this option enabled, ISurf will mesh only the water surface, which is useful when rendering pools or large bodies of water.

 

Flatten Surface – This option will create gradual transition from simulation to the fixed water level.

 

Water Level – Level of water body – this is the level along the positive Z axis.

 

Blend Distance % – Distance as percentage from the bounding box boundary.