Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

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

SufijoQué es
.glbla malla, un atlas PNG incrustado y una jerarquía de nodos sprite → layer → island
.meshes.jsonel acompañante: índice → isla, más el punto de anclaje, la escala, hacia dónde van las capas y los límites
.bbmodelel modelo como un proyecto de Blockbench — cuadriláteros, un grupo por capa, la textura dentro
.obj · .mtl · .atlas.pngel modelo como OBJ de Wavefront, su archivo de material y la textura que nombra el material — tres archivos que solo funcionan juntos
.stlel modelo como un sólido cerrado para imprimir, a un milímetro por píxel
.pngla obra, compuesta plana, en su propio tamaño de píxel
.vector.pngel dibujo lineal, rasterizado
.view.pngla vista 3D, solo modelo, sin suelo
.svgel 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 NEAREST solicitado. 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_unlit en 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

PlataformaCarpeta 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

abrePNG, JPEG, GIF
la biblioteca de medios almacenaSolo PNG
exportaPNG

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.