src/extraction/context.md

# Color Extraction Module

Extract colors from 3D mesh materials and textures

## Purpose

- Sample colors from mesh faces
- Read from textures via UV coordinates
- Apply area-weighted sampling

## Layout

```
extraction/
├── context.md    # This file
├── __init__.py   # API: extract_colors()
├── sampler.py    # Random sampling strategies
└── reader.py     # Read colors from materials
```

## Scope

- In-scope: Color extraction, texture sampling, UV mapping
- Out-of-scope: Color quantization, atlas generation

## Entrypoints

- `extract_colors(mesh, sample_rate, simplify_details, detail_sensitivity)` - Main extraction function
- `get_face_colors(mesh, simplify_details, detail_sensitivity)` - Read colors from mesh
- `sample_colors(colors, sample_rate, areas)` - Sample with weighting

## Dependencies

- Internal: preprocessing.simplify_texture
- External: NumPy, trimesh, OpenCV