Mesh Validator
Validate 3D meshes in Tridi: missing rendered faces, non-manifold edges, UV overlaps and stretch, normals, skinning, morph targets, and transforms.
Applies to Tridi 1.6.0 release. Release notes
What Mesh Validator does
Mesh Validator scans the imported 3D scene for geometry and topology problems, invalid vertex attributes, UV layout issues, skinning and morph-target data, transforms, and scene placement. You can validate the entire scene or selected objects and their descendants.
It offers 41 checks in Transform & Placement, Geometry, Normals & Tangents, UV, Skinning, and Morph Targets. The separate Performance section shows scene statistics rather than generating issues. Validation examines Tridi's imported scene data; some checks, such as missing rendered faces, also require current renderer data.
Open and run validation
- Open a supported 3D model.
- Open Validation from the status bar, or press F5.
- Open the Validation Checks settings (gear icon) and choose Entire Scene or Selected Objects. Selected Objects requires at least one selected object and includes its descendants.
- Enable or disable individual checks. The panel scans automatically when a model is ready; there is no separate Run button.
- Review the Errors, Warnings, and Info counts, then expand a category and finding to see its affected object or mesh.
- Detach the panel for a movable window, or dock it back into the workspace.
Changing relevant scene or selection state marks an existing report as stale and triggers a new scan when validation can run. Changing a check invalidates the report and saves the check setting. A scan cannot run without a loaded model or, in Selected Objects mode, without a selection.
Available validation checks
Mesh Validator currently provides 41 checks. Default indicates whether the check is enabled in a new configuration. Severity is the level reported when that check finds a problem; an informational finding can describe intentional authoring choices.
| Check | Type | Severity | Default | What it detects | Short explanation |
|---|---|---|---|---|---|
| Scene not centered to world origin | Transform & Placement | Warning | On | The scene bounding box is horizontally offset from the world origin. | Entire Scene only. Checks the X/Z center of the complete scene bounds using a size-aware placement tolerance. |
| Scene floating above grid floor | Transform & Placement | Error | On | The lowest point of the scene is above the grid floor. | Entire Scene only. Flags a scene whose bounding-box minimum Y remains above the floor beyond the placement tolerance. |
| Scene below grid floor | Transform & Placement | Error | On | The scene extends below the grid floor. | Entire Scene only. Flags a scene whose bounding-box minimum Y is below the floor beyond the placement tolerance. |
| Scale not reset | Transform & Placement | Error | On | A renderable node does not use a reset scale of approximately (1, 1, 1). | Checks renderable nodes with geometry and ignores synthetic importer roots. |
| Negative scale | Transform & Placement | Error | On | A renderable node has a negative or mirrored scale. | Detects negative TRS scale components or a transform matrix with a negative determinant. |
| Non-uniform scale | Transform & Placement | Warning | On | A renderable node uses different scale magnitudes across its axes. | Flags transforms whose X, Y, and Z scale magnitudes are not approximately equal. |
| Sheared transform | Transform & Placement | Warning | On | A renderable node transform contains shear. | Detects matrix transforms whose normalized basis axes are not orthogonal, meaning the transform is not clean TRS. |
| Rotation not reset | Transform & Placement | Warning | Off | A renderable node rotation is not approximately identity. | Optional check for authored TRS rotations or clean matrix rotations that have not been reset. |
| Model dimension is 100 m or larger | Transform & Placement | Warning | On | At least one complete-scene dimension is 100 meters or larger. | Entire Scene only. Checks the maximum width, height, or depth of the scene bounds. |
| Invalid canonical scene | Geometry | Error | On | The loaded scene fails its core validation. | This is a global integrity check even when Selected Objects scope is active. |
| Empty mesh | Geometry | Error | On | An in-scope mesh contains no primitives. | Flags referenced meshes that have no renderable primitive data. |
| Empty primitive | Geometry | Error | On | A primitive has no positions or no triangle indices. | Detects primitives that do not contain the minimum geometry data needed for indexed triangles. |
| NaN / Inf position | Geometry | Error | On | A vertex position contains a non-finite component. | Finds position values containing NaN or infinity. |
| Attribute count mismatch | Geometry | Error | On | A non-empty vertex attribute stream has a different count from positions. | Checks normals, tangents, colors, UV0, UV1, joint indices, and joint weights against the primitive position count. |
| Invalid index | Geometry | Error | On | A triangle index is outside the vertex range, or the index count is not divisible by three. | Detects invalid indexed-triangle data. |
| Degenerate triangle | Geometry | Error | On | A triangle repeats a vertex or has near-zero area. | Finds collapsed or effectively zero-area triangles. |
| Missing faces | Geometry | Error | On | Source triangles are absent from the renderer's alpha-optimized index buffers. | Only runs this comparison when a matching runtime alpha-partition snapshot is available. It detects missing rendered triangles, not ordinary backface culling or intentionally transparent materials. |
| Loose vertex | Geometry | Warning | On | A render vertex is not referenced by any triangle. | Finds unused vertices in a primitive's indexed triangle data. |
| Boundaries | Geometry | Warning | On | An edge belongs to only one face. | Finds open boundary edges in canonical topology. |
| Multiple Faces | Geometry | Warning | On | An edge is shared by more than two faces. | Finds non-manifold edges with more than two adjacent faces. |
| Non Contiguous | Geometry | Warning | On | Two faces traverse a shared edge in the same direction. | Finds adjacent faces with inconsistent winding across their shared edge. |
| Missing normals | Normals & Tangents | Info | On | A primitive with positions has no authored normals. | Reports missing normal data without treating it as an error. |
| Invalid normals | Normals & Tangents | Error | On | A normal is non-finite or has zero length. | Detects normals that cannot provide a valid direction. |
| Non-normalized normals | Normals & Tangents | Warning | On | A normal is not approximately unit length. | Finds authored normals whose length differs from one beyond the validator tolerance. |
| Missing tangents | Normals & Tangents | Warning | On | A material uses tangent-space data but the primitive has no authored tangents. | Applies when normal, height, clearcoat-normal, or anisotropy texture data requires tangent-space information. |
| Invalid tangents | Normals & Tangents | Warning | On | A tangent is non-finite, zero-length, non-normalized, or has invalid handedness. | Checks the tangent direction and that its handedness component is approximately +1 or -1. |
| Missing UV | UV | Error | On | A material references UV0 or UV1 but that UV set is missing from the primitive. | Only reports a missing set when a texture binding actually requires it. |
| Invalid UV | UV | Error | On | A UV0 or UV1 coordinate contains NaN or infinity. | Detects non-finite UV coordinates in correctly sized UV streams. |
| UV outside 0-1 | UV | Info | On | A finite UV coordinate lies outside the 0-1 range. | Reports possible tiling coordinates as informational because values outside 0-1 can be intentional. |
| UV overlap | UV | Info | On | Two or more UV triangle interiors overlap. | Detects overlap in available UV0 and UV1 sets, including intentional stacked UVs. Shared boundaries alone do not count as interior overlap. |
| Zero-area UV face | UV | Error | On | A triangle with valid 3D area collapses to near-zero area in UV space. | Skips degenerate 3D faces so that the finding specifically points to collapsed UV mapping. |
| Flipped UV | UV | Warning | On | Connected faces within one UV island have inconsistent UV winding. | Flags faces that differ from the island's dominant orientation, not a fully mirrored island. |
| Concave UV island | UV | Warning | On | An island has substantial concavity in its UV boundary. | Flags an island when the missing area relative to its convex hull exceeds 25%. Concave layouts can be intentional. |
| Excessive UV stretch | UV | Warning | On | A UV-mapped triangle has a distortion anisotropy ratio above 5:1. | Highlights faces with strong directional UV stretching, using valid 3D and UV geometry. |
| Incomplete skin streams | Skinning | Error | On | Joint indices and weights are missing one another or do not match the vertex count. | Requires aligned joint-index and joint-weight streams for skinned vertices. |
| Invalid joint index | Skinning | Error | On | A positive-weight influence references a joint outside the mesh instance's skin palette. | Also reports skin streams that exist without a mesh instance to provide a valid skin palette. |
| Negative skin weight | Skinning | Error | On | A skin weight is negative or non-finite. | Finds invalid weight values before normalization is considered. |
| Non-normalized skin weights | Skinning | Warning | On | A vertex's skin-weight sum differs from one. | Checks the four stored influences against the validator's weight-sum tolerance. |
| Duplicate joint influence | Skinning | Warning | On | The same joint appears more than once with a positive weight on one vertex. | Finds redundant positive influences that reference the same joint. |
| Inconsistent morph target count | Morph Targets | Error | On | Primitive morph-target counts disagree within a mesh, or default morph weights do not match the expected count. | Checks that a mesh uses a consistent number of morph targets and matching default weights. |
| Invalid morph target stream | Morph Targets | Error | On | A morph delta stream has the wrong count or contains a non-finite delta. | Checks non-empty position, normal, and tangent morph-delta streams against the primitive vertex count. |
Inspect affected geometry
Expand a finding and use Affected when it is available to toggle a wireframe overlay around the implicated vertices, edges, or faces and frame them in the viewport. Most element-based checks show a sample of up to 128 affected elements, not necessarily every occurrence. The Missing faces check retains all identified missing triangle indices for its overlay.
Object-level findings can provide an object-focus action; scene placement findings use Frame Scene. Not every issue has addressable elements. Affected highlighting also requires a completed, current report and geometry that can be mapped to the visible model, so it may be unavailable for some imported or deformed meshes.
Interpreting findings
Validation is diagnostic: it reports potential problems but does not automatically repair meshes or UVs. UV overlap, UV outside 0-1, and even Concave UV island may reflect deliberate stacking, texture tiling, or UV packing. Inspect the affected area and the intended texturing workflow before changing an asset. Missing faces is a different check: it compares source triangles with the renderer's optimized triangle data when that snapshot is available.
Performance metrics
The Performance section reports objects, meshes, mesh instances, primitives, vertices, triangles, edges, materials, UV sets, skins, morph targets, and estimated draw calls for the active validation scope. These are scene statistics, not a frame-rate benchmark.