Bifröst MeshProps attributes

The Bifröst meshProps attributes control the voxelization and properties of the mesh objects that share this property.

Container Attributes

Enable

Enables evaluation of the entire container node.

Evaluation Type

Controls how the node is evaluated. Normally, this should not be changed.

Simulation: The node gets evaluated based on the previous frame.
Property: The node is used only to set values used by other nodes.
Mesh Property: The node is used to set values on polygon mesh objects, such as emitters, colliders, and other meshes used in a simulation.
Per Frame: The node is evaluated every frame, but does not depend on the previous frame. This mode can be used for animation or reading cache files.

Properties

Enable: Enables the evaluation of the node.

Conversion

Mode

Controls how the object is voxelized:

Solid creates a solid volume including the mesh interior. The mesh should be both manifold and watertight.
Shell create a thin shell around the mesh surface. In this mode, Thickness should typically be 1.0 or more.
Solid (Robust) is an alternative to Solid that usually gives better results for volumes with fine detail, openings leading to cavities, or non-watertight surfaces. However, it does not handle fluids inside completely enclosed regions.

Coarsen Interior

Saves memory by performing additional coarsening of the voxels inside the volume when Mode is Solid (Robust), especially with self-intersecting meshes.

Offset Surface Distance

The distance in voxel widths used to close (dilate and then erode) the solid voxels when Mode is Solid (Robust). The internal minimum is 1.0 so only values greater than that have an effect. High values can create artifacts.

Thickness Units

Whether Thickness is in Voxels or World Space units. When set to Voxels, the effective thickness depends on the Master Voxel Size of the simulation.

Thickness

The amount to thicken the mesh. For solid shapes that are already quite thick, you can use 0.0 for a precise boundary or even negative values to shrink along the surface normals. For thinner volumes and shells, you should use larger values to prevent holes.

Note that thickness will round off sharp corners.

Voxel Scale

Scaling factor for the Master Voxel Size used to initially voxelize meshes that share this property. See Control the voxel resolution of a Bifröst simulation.

Velocity Scale

Controls the proportion of velocity from an animated mesh's transformation and deformation that is considered by the simulation in each of the world X, Y, and Z axes.

For a mesh used as a motion field, these are scaling factors for the base velocity used by Inherit Velocity when the Geometry option is enabled. You can further adjust the effect by modifying Inherit Velocity.
For a mesh used as a kill field, the velocity is not used and this option has no effect on the simulation.

Additional Velocity controls

These attributes work together to apply an optional, extra velocity that is considered by the simulation, and which is independent of the guide mesh's actual animation.

For a mesh used as a motion field, this extra velocity is included in the base velocity used by Inherit Velocity when the Geometry option is enabled.
For a mesh used as a kill field, the velocity is not used and this option has no effect on the simulation.

Enable Additional Velocity: Adds extra velocity to any existing velocity.
Additional Velocity Mult: A multiplier that scales Additional Velocity uniformly in all axes.
Additional Velocity: The base velocity to add in world coordinates.

Boundary Controls

Limits the effect of the associated mesh objects to their intersection with an implicit shape. See Limit the volume of a mesh's effect using boundary controls.

Enable Boundary: Activates the boundary controls.
Boundary Shape: Selects the shape of the boundary volume.
Invert: Restricts the effect of the mesh to the exterior instead of the interior of the boundary volume.

Adaptivity

Refine Nearby Fluids: Prevents the fluid resolution from being coarsened in regions that are close to the mesh when spatial adaptivity is enabled on the liquid properties node.