src/mesh/context.md

Mesh Module

Apply texture atlases to 3D meshes

Purpose

• Remap mesh UVs to atlas coordinates
• Transform meshes with new textures

Layout

mesh/
├── context.md   # This file
├── __init__.py  # API: apply_atlas()
└── uvmapper.py  # UV remapping logic

Scope

• In-scope: UV remapping, mesh transformation, vertex duplication
• Out-of-scope: Mesh loading, color extraction

Entrypoints

• apply_atlas(mesh, atlas, color_to_uv, mapper, face_colors) - Main application
• apply_atlas_to_mesh(mesh, atlas, color_to_uv, mapper, face_colors) - Detailed UV remapping with cached colors

Dependencies

• Internal: extraction.reader (for get_face_colors)
• External: NumPy, trimesh