WS06-004 adds automated UV and texel-density quality checks in
@isis/3d-generation via src/processing/uv-texel-quality-validator.ts.
Implemented Checks#
UV coverage- Fails when coverage is below configurable minimum (
minUVCoverage).
- Fails when coverage is below configurable minimum (
UV overlap- Fails when overlap exceeds configurable maximum (
maxUVOverlapPercentage).
- Fails when overlap exceeds configurable maximum (
UV stretch- Warns when average stretch deviation or max stretch exceeds configured
bounds (
maxAverageStretchDeviation,maxStretch).
- Warns when average stretch deviation or max stretch exceeds configured
bounds (
Texel density- Computes per-triangle texel density using UV area, geometry area, and texture resolution.
- Warns on low/high average density and high variance across triangles.
- Supports optional target density with max allowed deviation.
API#
validateUVAndTexelDensity(mesh, options)- Input:
UnifiedMeshData - Output:
UVTexelValidationResultwith:uv: UV coverage/overlap/stretch metrics (reusinganalyzeUVQuality)texelDensity: deterministic density statisticsthresholds: applied configuration valuesissues: structured warnings/errors
- Input:
Default Thresholds#
minUVCoverage:0.65maxUVOverlapPercentage:0.02maxAverageStretchDeviation:0.35maxStretch:2.5textureWidth:2048textureHeight:2048minTexelDensity:256maxTexelDensity:4096maxTexelDensityCV:0.45maxTargetTexelDensityDeviation:0.3