Texture Validation & Color Management

Texture Validation & Color Management

Module: Tech · Category: Workflow · Tool ID: TextureValidationColorMgmt

Three-tab texture validation tool. Texture Scanner scans all UTexture2D assets for sRGB, compression, dimensions, LOD group issues, and oversized warnings. Import Rules lets you author regex-to-setting rules for automated import enforcement. Batch Fix selects scanner results and applies fixes; exports CSV reports.

ℹ️ Absorbs the legacy PBRTextureValidator, NormalMapMixer, HeightmapToNormal, and TextureImportEnforcer standalone tools (AF-04).

---

When to use it

• Pre-shipping texture audit — confirming sRGB / compression / LOD group are correct project-wide
• Authoring import rules — automating “all _N textures should be Normal Map compression, sRGB off”
• Batch fixing texture settings discovered during scan

When not to use it

• Don’t use this for color grading — see LUT Color Grading Baker
• Don’t use this to bake — see Universal Bake Suite (Material Texture Baker)

---

Opening the tool

1. Open the EQLabs Hub and search for Texture Validation (or browse to Tech → Workflow)
2. Click the tool card
3. Use the tab bar: Scanner / Import Rules / Batch Fix

---

Tab 1 — Texture Scanner

Field	What it does	Default
Scan Path	Folder to scan	/Game
Scan Recursive	Toggle	true
Search	Filter results
Run Scan	Walks every UTexture2D
Copy Scan Results	Plain-text dump
Issues list	Per-row: asset name, issue type, details, severity, can-auto-fix flag

Issue types

Type	What it flags
sRGB	sRGB flag wrong for the texture’s role (e.g., Normal map with sRGB on)
Compression	Wrong compression for the texture’s role
NonPOT	Non-power-of-two dimensions (sometimes intentional)
LODGroup	Wrong LOD group
Oversized	Resolution exceeds expected limit

Summary

Total scanned / OK / Warning / Critical / per-issue counts.

Tab 2 — Import Rules

Author regex-to-setting rules.

Section	What it does
Pattern	Regex like .*_N$
Display Name	Friendly label like “Normal Maps”
Compression	Target compression
sRGB	Target sRGB flag
LOD Group	Target LOD group
Add Rule	Adds the rule
Remove Selected Rule	Deletes
Apply Rules	Applies rules to existing textures (V1: log-only)

Default rules

Out-of-the-box rules cover normal maps (_N$), masks (_M$), AO (_AO$), data textures, etc.

Tab 3 — Batch Fix

Section	What it does
Issues list (same as Scanner)	With selection checkboxes
Select All / Deselect All	Bulk toggle
Fix Selected	Applies fixes for every checked row
Export CSV	Saves scan results as CSV

---

Workflow

Audit + fix

1. Tab 1 — Set Scan Path, run scan
2. Tab 3 — Walk the issues, select what to fix, click Fix Selected

Author import rules

1. Tab 2 — Build rules matching your team conventions
2. Click Apply Rules to log what would change (V1 is log-only — actual auto-apply is on the import-side, configured manually)

---

Settings reference

Settings + import rules persist via [Project]/Saved/EQLabs/Settings/TextureValidationColorMgmt.json.

---

Output

• Texture asset edits — Fix Selected modifies texture settings; undoable
• CSV export — Batch Fix tab
• Clipboard — Copy Scan Results

---

Tips & gotchas

• sRGB matters for color correctness — wrong flag = wrong gamma = wrong shading
• Normal maps with sRGB on is the most common texture bug — surfaces it cleanly
• LOD group affects streaming budget — wrong LOD group can blow the streaming pool
• V1 of Import Rules is log-only — full auto-apply requires hooking the import pipeline (a future release)

---

Related tools

• Texture Channel Packer — for channel packing
• Smart Mask & Texture Processor — for normal-map blending and masks
• Project Doctor Suite — broader texture audit

---