src/context.md

# Mesh Palettizer Core

Core library for 3D model texture palette optimization

## Purpose

- Extract colors from mesh textures and materials
- Generate optimized palettes via perceptual clustering
- Build color palettes and remap mesh UVs
- Support multi-mesh scenes with shared textures

## Layout

```
src/
├── context.md       # This file
├── __init__.py      # Main API: convert_meshes()
├── preprocessing/   # Texture detail removal
├── extraction/      # Color extraction from meshes
├── palette/         # Palette generation and mapping
├── atlas/           # Palette texture creation
└── mesh/            # UV remapping
```

## Scope

- In-scope: Mesh processing, color quantization, UV mapping
- Out-of-scope: File I/O, API calls, web interface

## Entrypoints

- `convert_meshes(mesh_list, atlas_size, face_sampling_ratio, simplify_details, detail_sensitivity, scene_metadata)` - Main API
- Returns: `ConversionResult` with processed meshes, palette, and scene metadata

## Dependencies

- Internal: All submodules
- External: numpy, trimesh, PIL, scikit-learn, scipy