Spaces:
Sleeping
Sleeping
File size: 2,581 Bytes
346b70f |
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 |
# Project Structure
Mesh Palettizer - Web application for 3D model texture simplification
## Stack
- Runtime: Python 3.10+
- 3D Processing: Trimesh
- Image Processing: Pillow, NumPy, OpenCV
- ML/Clustering: Scikit-learn
- Spatial Indexing: SciPy
- Web Interface: Gradio
## Commands
- Web interface: `uv run python app.py`
- Install: `uv sync`
- Lint: `uv run ruff check .`
- Format: `uv run black src/`
## Layout
```
conversion/
├── CLAUDE.md # Global context (Tier 0)
├── app.py # Web interface with Gradio
├── README.md # Public documentation
├── pyproject.toml # Dependencies
├── context.md # Project context (Tier 2)
├── src/ # Core tool - reusable texture palettizer
│ ├── context.md # Module context (Tier 2)
│ ├── __init__.py # Main API: convert_meshes()
│ ├── preprocessing/ # Texture detail removal
│ │ ├── __init__.py
│ │ └── simplifier.py # Bilateral filter for artifact removal
│ ├── extraction/ # Color extraction from meshes
│ │ ├── __init__.py
│ │ ├── sampler.py # Face sampling with area weighting
│ │ └── reader.py # Texture/material color reading
│ ├── palette/ # Palette generation and mapping
│ │ ├── __init__.py
│ │ ├── quantizer.py # K-means clustering in LAB space
│ │ ├── mapper.py # Nearest color mapping via KD-tree
│ │ └── color_space.py # RGB/LAB conversion
│ ├── atlas/ # Texture atlas generation
│ │ ├── __init__.py
│ │ └── builder.py # Atlas construction with UV mapping
│ └── mesh/ # Mesh transformation
│ ├── __init__.py
│ └── uvmapper.py # UV remapping to atlas
└── layers/
└── structure.md # This file (Tier 1)
```
## Architecture
GLB processing with K-means color quantization and configurable palette sizes
- **Pattern**: Direct transformation pipeline
- **Flow**: Load meshes → Simplify textures → Sample colors → Quantize to palette → Create atlas → Apply → Export
- **Palette sizes**: Powers of 2 (8×8=64 colors, 16×16=256, 32×32=1024, etc.)
- **State**: None - pure transformation
- **Optimization**: Random sampling, vectorized operations, LAB color space
## Entry Points
`app.py` - Gradio web interface with configurable detail removal sensitivity
`src.convert_meshes()` - Core API with palette generation and detail control |