Eve library

ISIS V2 UV and Texel Density Validators

Guide

Revision 1

On this page

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).
  • UV overlap
    • Fails when overlap exceeds configurable maximum (maxUVOverlapPercentage).
  • UV stretch
    • Warns when average stretch deviation or max stretch exceeds configured bounds (maxAverageStretchDeviation, maxStretch).
  • 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: UVTexelValidationResult with:
      • uv: UV coverage/overlap/stretch metrics (reusing analyzeUVQuality)
      • texelDensity: deterministic density statistics
      • thresholds: applied configuration values
      • issues: structured warnings/errors

Default Thresholds#

  • minUVCoverage: 0.65
  • maxUVOverlapPercentage: 0.02
  • maxAverageStretchDeviation: 0.35
  • maxStretch: 2.5
  • textureWidth: 2048
  • textureHeight: 2048
  • minTexelDensity: 256
  • maxTexelDensity: 4096
  • maxTexelDensityCV: 0.45
  • maxTargetTexelDensityDeviation: 0.3