gioser

tawasuyu/llimphi

Sovereign retained-mode GPU UI framework in Rust (wgpu+vello+taffy+parley), Elm loop, 40+ widgets.

Rust 229TOML 101Markdown 82Shell 24052 Definiciones

⎇ main shared/foreign-vox/LEEME.md Markdown · 24 líneas · 1.1 KB Historia crudo

chore: refresco desde el monorepo — 27 crates nuevos (anim, lottie, svg, mesh, image, layer, test, wire-view, widgets rag-sidebar/router/lazy-list/rive-button) y sync de los 95 existentes 93253cc22 · Sergio · 

1# foreign-vox
2
3*Read this in English: [README.md](README.md).*
4
5# foreign-vox — puente al formato **MagicaVoxel `.vox`**
6
7Lee y escribe modelos voxel en el formato de MagicaVoxel (estructura de
8*chunks* tipo-RIFF: `MAIN` → `SIZE`/`XYZI`/`RGBA`) y los expone como un
9`VoxModel` **neutral**: dimensiones + lista de voxels `(x,y,z,índice)` +
10una paleta de 256 colores RGBA indexada por el índice del voxel.
11
12Sin dependencias (sólo `std`): el formato son bytes planos *little-endian*.
13**No** conoce el motor — el conversor a `VoxelGrid` vive en `llimphi-voxel`
14(CLAUDE.md regla #4: lo ajeno entra por el puente, el núcleo trabaja nativo).
15
16Convención de color: el índice `i` de un voxel (1..255; `0` = vacío) indexa
17`VoxModel::palette``[i]`. Al leer el chunk `RGBA` (256 entradas crudas) se
18aplica el corrimiento documentado por MagicaVoxel (`palette[i] = crudo[i-1]`).
19Si el archivo no trae `RGBA`, se usa una paleta por defecto (rampa HSV) — los
20exportes reales de MagicaVoxel siempre incluyen `RGBA`, así que es un fallback.
21
22---
23
24Parte de **shared** — ver [shared](../LEEME.md).

LEEME.md

foreign-vox

Read this in English: 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.