# ISIS V2 UV and Texel Density Validators

`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`
