Archivos en disco
Una carpeta de proyecto
Un proyecto es cualquier carpeta que contenga un project.fdraw. Nada más lo marca, nada lo registra en ningún lugar, y mover la carpeta mueve el proyecto.
fluffy cloud/
project.fdraw the drawing
exports/
2026-08-21_144312_fluffy_cloud.glb an archive, never overwritten
2026-08-21_144312_fluffy_cloud.meshes.json
2026-08-21_150102_fluffy_cloud.svg
latest/
fluffy_cloud.glb the copy your game loads
fluffy_cloud.meshes.json
project.fdraw es JSON: el tamaño del lienzo, las capas como PNGs incrustados, la profundidad por capa y desplazamiento Z, la sombra de pared lateral, el punto de anclaje, la escala, los ejes de espejo, y los colores de la paleta.
Los colores de la paleta viajan con el proyecto, no una referencia a una paleta. Un proyecto tiene que abrirse con sus colores correctos en una máquina que nunca ha visto tu biblioteca. Todo lo demás solo lo referencia.
Cada exportación se escribe dos veces — un archivo con marca de tiempo que nunca se reemplaza, y una copia con nombre fijo en latest/ para una ruta que tu juego puede codificar. Ver Exportar.
Lo que una exportación escribe
| Sufijo | Qué es |
|---|---|
.glb | la malla, un atlas PNG incrustado y una jerarquía de nodos sprite → layer → island |
.meshes.json | el acompañante: índice → isla, más el punto de anclaje, la escala, hacia dónde van las capas y los límites |
.bbmodel | el modelo como un proyecto de Blockbench — cuadriláteros, un grupo por capa, la textura dentro |
.obj · .mtl · .atlas.png | el modelo como OBJ de Wavefront, su archivo de material y la textura que nombra el material — tres archivos que solo funcionan juntos |
.stl | el modelo como un sólido cerrado para imprimir, a un milímetro por píxel |
.png | la obra, compuesta plana, en su propio tamaño de píxel |
.vector.png | el dibujo lineal, rasterizado |
.view.png | la vista 3D, solo modelo, sin suelo |
.svg | el dibujo lineal como archivo vectorial |
Cuatro de esos son PNGs del mismo proyecto, diferenciados solo por sufijo. Es deliberado y vale la pena saber antes de escribir un script que busque *.png.
Lo que hay en un .glb
glTF binario estándar, cargable por cualquier cosa que lea glTF 2.0.
- Una malla por isla — un trozo de obra separadamente conectado — agrupado bajo un nodo por capa.
- Un material, un atlas PNG incrustado, muestreo
NEARESTsolicitado. El atlas nunca es más alto de lo ancho, y una potencia de dos cuando el lienzo lo es. alphaMode: "BLEND"solo cuando algún texel en el atlas es translúcido; en caso contrario, la clave está ausente y el modelo se comporta como uno opaco.KHR_materials_unliten el material cuando Material sin iluminación está activado — indicado como usado, nunca como obligatorio, así que un cargador que no lo conoce aún puede abrir el archivo.- El punto de anclaje está horneado en la geometría, así que
DrawModel(m, pos, …)no necesita desplazamiento.
El acompañante .meshes.json
{
"generator": "Flatty",
"model": "fluffy_cloud.glb",
"canvas": { "w": 32, "h": 32 },
"pixelsPerUnit": 16,
"pivot": "bottom-center",
"orientation": "back-to-front",
"bounds": { "min": [-1, 0, -0.25], "max": [1, 2, 0.25] },
"meshes": [
{ "index": 0, "name": "part_1", "layer": "face", "path": "face/part_1",
"layerIndex": 0, "cells": 210, "bounds": { "min": [], "max": [] } }
]
}
Existe porque Model de raylib no tiene nombres de malla, solo un array Meshes. Busca las partes por path en lugar de por name simple: los nombres de isla están numerados por capa, así que dos capas pueden cada una tener un part_1.
orientation es back-to-front o bottom-to-top — de qué forma se leyeron las capas en el modelo. La geometría y los límites ya están girados, así que no cambia nada que un juego tenga que hacer; está ahí para que un script pueda decir en qué eje corre la pila de capas sin medir.
Tus ajustes y tus bibliotecas
| Plataforma | Carpeta de ajustes |
|---|---|
| Linux | ~/.config/flatty/ |
| macOS | ~/Library/Application Support/flatty/ |
| Windows | %AppData%\flatty\ |
flatty/
config.json recent projects, workspaces, preferences, your keymap
palettes/ one .json per palette
media/ one .png per picture, plus a .meta.json beside it
themes/ one .json per theme you made or imported
layouts/ one .json per saved layout
Todo se escribe atómicamente, así que una escritura interrumpida no puede dejar un archivo truncado.
config.json solo almacena lo que cambiaste. Tu mapa de teclas es una lista de desviaciones del enviado, lo que permite que una versión posterior mueva un valor predeterminado sin anular tu elección — y lo que hace que un atajo que borraste a propósito se mantenga borrado.
Hay una segunda carpeta, en el directorio de caché de tu sistema, para lo que Flatty puede reconstruir por sí mismo: la lista de fuentes en tu máquina, y las miniaturas de la galería de medios. Eliminarla no cuesta nada excepto los segundos que tarda en rellenarse de nuevo.
Tus proyectos están en otro lugar completamente — donde sea que los pongas.
Archivos de paleta que lee y escribe
Lee: .gpl (GIMP), .pal, .hex, .txt y .ase (Aseprite).
Escribe: .gpl, .pal, .hex, .txt.
Formatos de imagen
| abre | PNG, JPEG, GIF |
| la biblioteca de medios almacena | Solo PNG |
| exporta | PNG |
WebP y AVIF no se ofrecen, porque Go no tiene decodificador para ninguno en su biblioteca estándar.
Una fuente de más de 40 megapíxeles se rechaza, leída del encabezado del archivo. Cualquier cosa más pequeña se abre, y el resultado se tapa en su lugar — 512 px en el borde largo para una textura de pincel, el borde largo del lienzo para una imagen que va a él.