# foreign-vox

*Read this in English: [README.md](README.md).*

# foreign-vox — puente al formato **MagicaVoxel `.vox`**

Lee y escribe modelos voxel en el formato de MagicaVoxel (estructura de
*chunks* tipo-RIFF: `MAIN` → `SIZE`/`XYZI`/`RGBA`) y los expone como un
`VoxModel` **neutral**: dimensiones + lista de voxels `(x,y,z,índice)` +
una paleta de 256 colores RGBA indexada por el índice del voxel.

Sin dependencias (sólo `std`): el formato son bytes planos *little-endian*.
**No** conoce el motor — el conversor a `VoxelGrid` vive en `llimphi-voxel`
(CLAUDE.md regla #4: lo ajeno entra por el puente, el núcleo trabaja nativo).

Convención de color: el índice `i` de un voxel (1..255; `0` = vacío) indexa
`VoxModel::palette``[i]`. Al leer el chunk `RGBA` (256 entradas crudas) se
aplica el corrimiento documentado por MagicaVoxel (`palette[i] = crudo[i-1]`).
Si el archivo no trae `RGBA`, se usa una paleta por defecto (rampa HSV) — los
exportes reales de MagicaVoxel siempre incluyen `RGBA`, así que es un fallback.

---

Parte de **shared** — ver [shared](../LEEME.md).