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

  1. Open a supported 3D model.
  2. Open Validation from the status bar, or press F5.
  3. 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.
  4. Enable or disable individual checks. The panel scans automatically when a model is ready; there is no separate Run button.
  5. Review the Errors, Warnings, and Info counts, then expand a category and finding to see its affected object or mesh.
  6. 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 originTransform & PlacementWarningOnThe 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 floorTransform & PlacementErrorOnThe 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 floorTransform & PlacementErrorOnThe 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 resetTransform & PlacementErrorOnA renderable node does not use a reset scale of approximately (1, 1, 1).Checks renderable nodes with geometry and ignores synthetic importer roots.
Negative scaleTransform & PlacementErrorOnA renderable node has a negative or mirrored scale.Detects negative TRS scale components or a transform matrix with a negative determinant.
Non-uniform scaleTransform & PlacementWarningOnA renderable node uses different scale magnitudes across its axes.Flags transforms whose X, Y, and Z scale magnitudes are not approximately equal.
Sheared transformTransform & PlacementWarningOnA renderable node transform contains shear.Detects matrix transforms whose normalized basis axes are not orthogonal, meaning the transform is not clean TRS.
Rotation not resetTransform & PlacementWarningOffA 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 largerTransform & PlacementWarningOnAt 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 sceneGeometryErrorOnThe loaded scene fails its core validation.This is a global integrity check even when Selected Objects scope is active.
Empty meshGeometryErrorOnAn in-scope mesh contains no primitives.Flags referenced meshes that have no renderable primitive data.
Empty primitiveGeometryErrorOnA primitive has no positions or no triangle indices.Detects primitives that do not contain the minimum geometry data needed for indexed triangles.
NaN / Inf positionGeometryErrorOnA vertex position contains a non-finite component.Finds position values containing NaN or infinity.
Attribute count mismatchGeometryErrorOnA 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 indexGeometryErrorOnA triangle index is outside the vertex range, or the index count is not divisible by three.Detects invalid indexed-triangle data.
Degenerate triangleGeometryErrorOnA triangle repeats a vertex or has near-zero area.Finds collapsed or effectively zero-area triangles.
Missing facesGeometryErrorOnSource 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 vertexGeometryWarningOnA render vertex is not referenced by any triangle.Finds unused vertices in a primitive's indexed triangle data.
BoundariesGeometryWarningOnAn edge belongs to only one face.Finds open boundary edges in canonical topology.
Multiple FacesGeometryWarningOnAn edge is shared by more than two faces.Finds non-manifold edges with more than two adjacent faces.
Non ContiguousGeometryWarningOnTwo faces traverse a shared edge in the same direction.Finds adjacent faces with inconsistent winding across their shared edge.
Missing normalsNormals & TangentsInfoOnA primitive with positions has no authored normals.Reports missing normal data without treating it as an error.
Invalid normalsNormals & TangentsErrorOnA normal is non-finite or has zero length.Detects normals that cannot provide a valid direction.
Non-normalized normalsNormals & TangentsWarningOnA normal is not approximately unit length.Finds authored normals whose length differs from one beyond the validator tolerance.
Missing tangentsNormals & TangentsWarningOnA 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 tangentsNormals & TangentsWarningOnA 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 UVUVErrorOnA 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 UVUVErrorOnA UV0 or UV1 coordinate contains NaN or infinity.Detects non-finite UV coordinates in correctly sized UV streams.
UV outside 0-1UVInfoOnA finite UV coordinate lies outside the 0-1 range.Reports possible tiling coordinates as informational because values outside 0-1 can be intentional.
UV overlapUVInfoOnTwo 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 faceUVErrorOnA 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 UVUVWarningOnConnected 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 islandUVWarningOnAn 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 stretchUVWarningOnA 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 streamsSkinningErrorOnJoint 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 indexSkinningErrorOnA 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 weightSkinningErrorOnA skin weight is negative or non-finite.Finds invalid weight values before normalization is considered.
Non-normalized skin weightsSkinningWarningOnA vertex's skin-weight sum differs from one.Checks the four stored influences against the validator's weight-sum tolerance.
Duplicate joint influenceSkinningWarningOnThe 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 countMorph TargetsErrorOnPrimitive 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 streamMorph TargetsErrorOnA 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.