feat: complete phase 3 implementation for terrain atlas and terrain blend

[ViTeXFTW]

Summary

This PR adds comprehensive support for terrain atlasing and blend pattern generation, enabling procedural texture atlas creation and proper UV coordinate handling for terrain tiles and cliff faces.

Key Changes

New Terrain Atlas System (terrain_atlas.hpp/cpp)

• Tile index decoding: Functions to extract tile index (top 14 bits) and quadrant (bottom 2 bits) from encoded tile indices
• UV computation: Calculate normalized UV coordinates for individual quadrants within tiles
• Tile UV table generation: Build UV lookup tables from texture class definitions with proper atlas layout
• Procedural atlas generation: Create procedural terrain atlases with distinct colors per tile for testing/fallback

New Blend Pattern System (terrain_blend.hpp/cpp)

• 12 blend directions: Support for horizontal, vertical, diagonal, and long diagonal blends with inverted variants
• Pattern generation: Create 64x64 alpha blend patterns with smooth gradients for each direction
• Blend info parsing: Convert map blend tile info to blend directions with proper inversion/flip handling
• Blend detection: Check if a cell contains blend data

Terrain Mesh Enhancements

• Atlas coordinate support: Added atlasCoord field to TerrainVertex for proper texture mapping
• Blend data integration: New generateChunkFromBlendData() function to generate terrain chunks with blend tile and cliff data
• Cliff face handling: Proper UV mapping for cliff faces using per-corner UV coordinates from cliff info
• Mesh generation from blend data: generateTerrainMeshFromBlendData() to create complete terrain meshes with blend support

Terrain Renderable Updates

• Blend data loading: New loadWithBlendData() method to load terrain with blend tile information
• Atlas pipeline initialization: initPipelineWithAtlas() to set up rendering with texture atlases
• Atlas texture management: Track and manage atlas texture binding

Shader Updates

• Vertex shader: Added inAtlasCoord input and fragAtlasCoord output for atlas-based texturing
• Fragment shader: Use atlas coordinates for texture sampling when available

Test Coverage

• 227 tests for terrain atlas: Comprehensive testing of tile decoding, UV computation, and procedural atlas generation
• 211 tests for blend patterns: Validation of blend pattern generation, direction mapping, and complementary patterns
• Pipeline tests: Updated to reflect new vertex stride (40 bytes) and attribute count (4)

Implementation Details

• Tile indices use bit-packing: bits 2-15 for tile index, bits 0-1 for quadrant
• Blend patterns use normalized coordinates (0-1) mapped to 64x64 grids with smooth gradients
• Procedural atlas uses deterministic color generation based on tile index for debugging
• Cliff faces support per-corner UV coordinates for complex geometry
• All UV coordinates are normalized to [0, 1] range for proper atlas sampling

https://claude.ai/code/session_01ADLdYWAcHMTCEJ3z9nDGjv

[ViTeXFTW]

@greptileai

[ViTeXFTW]

@greptileai

[greptile-apps]

Greptile Summary

This PR implements comprehensive terrain atlasing and blend pattern generation support for the C&C Generals Zero Hour map renderer, enabling proper texture atlas creation and UV coordinate handling for terrain tiles and cliff faces.

Key Accomplishments

• Terrain Atlas System: Implemented tile index decoding (14-bit tile + 2-bit quadrant), UV computation for atlas mapping, and procedural atlas generation with deterministic color patterns
• Blend Pattern System: Created 12 blend directions (horizontal, vertical, diagonal variants) with smooth 64x64 alpha gradients for terrain texture transitions
• Mesh Generation: Extended TerrainVertex with atlasCoord field and added blend-data mesh generation with per-corner cliff UV support
• Shader Integration: Updated terrain vertex/fragment shaders to use atlas coordinates for proper texture sampling
• Comprehensive Testing: Added 438 tests (227 for atlas, 211 for blend patterns) achieving thorough coverage of the new functionality

Code Quality

The implementation follows the project's coding standards with proper RAII patterns, const correctness, and TDD approach. The bit-packing logic correctly extracts tile indices (bits 2-15) and quadrants (bits 0-1) as specified in the format documentation. UV coordinate calculations properly normalize to [0, 1] range for atlas sampling.

Confidence Score: 5/5

• This PR is safe to merge with minimal risk
• All changes are well-structured implementations of documented terrain rendering features with comprehensive test coverage (438 tests), proper error handling, bounds checking, and adherence to project coding standards
• No files require special attention

Important Files Changed

Filename	Overview
src/render/terrain/terrain_atlas.cpp	Implemented bit-packing logic for tile indices and UV table generation with proper atlas layout
src/render/terrain/terrain_blend.cpp	Implemented smooth gradient generation for all blend directions with proper inversion handling
src/render/terrain/terrain_mesh.cpp	Implemented cliff face UV mapping and blend data integration for terrain mesh generation
src/render/terrain/terrain_renderable.cpp	Implemented blend data loading and atlas texture management with proper descriptor updates
shaders/terrain.vert	Added inAtlasCoord input and fragAtlasCoord output for atlas texture sampling
shaders/terrain.frag	Updated to use fragAtlasCoord for texture sampling when atlas is enabled
src/lib/gfx/pipeline.hpp	Updated terrain pipeline preset with 40-byte vertex stride and 4 attributes for atlas support
tests/terrain/test_terrain_atlas.cpp	Added 227 comprehensive tests covering tile decoding, UV computation, and atlas generation
tests/terrain/test_terrain_blend.cpp	Added 211 tests validating blend pattern generation and direction mapping logic

_{Last reviewed commit: ba2c57e}