CHAPTER 14

3D Visualization

Geometry, domain and surface display tab with camera and scene controls.

14.1 3D View Tab

The tab 3D Visualization uses the Helix/WPF engine to render geometries, domain and surfaces in high interactive quality. It is mainly used in pre-processing - during execution, the 3D particles tab displays the simulation state.

14.2 Camera controls

To the right of 3D View, a control column adjusts the camera and scene:

BUTTON FUNCTION
3D Standard isometric view
XY / XZ / YZ Orthogonal views aligned with coordinate planes
Reset Reposition the camera to view the whole scene
Edges STL Show/hide STL mesh triangulation (checks density and normal)
Settings Opens the scene settings panel

Use orthogonal views to check alignment, scale and direction of normal in planes. Reset is useful when the camera becomes “lost” when exploring complex geometries.

14.3 Scene Settings

The display configuration panel allows you to adjust: background color (gradient, solid, dark/light); surface opacity (useful to see particles inside closed geometries); saved cameras (storage positions/reuse orientations); movement style (orbit, pan, smoothed zoom); time text (physical time overlay during animation); and playback speed and recording parameters.

Scene lighting

Lighting has its own section under Camera and movement, and it is what separates a readable scene from a flat one. The key light is positioned in spherical coordinates rather than by an XYZ vector:

FIELD DEFAULT WHAT IT DOES
Light azimuth (°) 35 Horizontal angle; positive = light coming from the right
Light elevation (°) 30 Vertical angle; positive = light coming from above
Ambient light (0–1) 0.45 Uniform base illumination that fills the shadows
Key light (0–1) 1.0 Key light intensity — this is what creates the gradient
Fill light (0–1) 0.5 Fill opposite the key, softening the dark side
Key light follows the camera on With this on, azimuth and elevation are relative to the camera; off, they are absolute in the Z-up world
Azimuth and elevation at 0 flatten the scene — With the light following the camera and both angles at zero, the key is aligned with the view: a pure headlight that lights everything head-on and produces no gradient at all. The result looks “dark” even at maximum intensity — what is missing is not light but shading. Moving the key off-axis (the default 35° / 30°) restores volume to geometries and particles, which is why ambient light can sit at 0.45 without darkening the scene. If you push ambient towards 1.0 chasing clarity, you get the opposite: the uniform base washes out the gradient and flattens everything again.
Starting point — Keep the defaults (azimuth 35°, elevation 30°, ambient 0.45, key 1.0, fill 0.5). To emphasise relief on a geometry, raise the elevation and lower the ambient; to check particle colour without shadow interference, raise the ambient temporarily.

14.4 STL edges

The button STL edges allows viewing the triangulation of the mesh. Use to check the mesh density (dense enough to capture curvature?), visual quality (very elongated or degenerate triangles?) and openings or non-manifold mesh regions (visible boundary edges indicate an open STL).

14.5 Ruler and Clip

3D ruler: click the 📏 icon in the viewport toolbar, select two points and read the distance overlaid on the scene. This is a viewing tool; it does not change geometry or the solver.

Visual clip: in Scene Settings, enable the clipping plane, choose particles, STL/surfaces or both, and enter a point and plane normal. Use the clip to inspect silo or bed interiors; it does not remove particles or change contacts. Disable clipping to restore the full view.

14.6 Orthographic and perspective projection

In 3D Visualization, P and O switch between perspective and orthographic projection. The switch preserves framing and orientation. Dragging follows the face axis while accounting for camera and zoom; Esc cancels. Field of view is kept consistent between the WPF window and SharpDX renderer.