Ficheiros no disco
Uma pasta de projeto
Um projeto é qualquer pasta contendo um project.fdraw. Nada mais marca um, nada se regista em lado nenhum, e mover a pasta move o projeto.
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 é JSON: o tamanho da tela, as camadas como PNGs incorporados, a profundidade por camada e desvio Z, a sombra da parede lateral, o ponto de apoio, a escala, os eixos de espelho, e as cores da paleta.
As cores da paleta viajam com o projeto, não uma referência a uma paleta. Um projeto tem de abrir com as suas cores certas numa máquina que nunca viu a tua biblioteca. Tudo mais apenas o referencia.
Cada exportação é escrita duas vezes — um arquivo com data e hora que nunca é substituído, e uma cópia de nome fixo em latest/ para um caminho que o teu jogo pode codificar. Vê Exportação.
O que uma exportação escreve
| Sufixo | O que é |
|---|---|
.glb | a malha, um atlas PNG incorporado, e uma hierarquia de nós de sprite → camada → ilha |
.meshes.json | o ficheiro acompanhante: índice → ilha, mais o ponto de apoio, a escala, o sentido das camadas e os limites |
.bbmodel | o modelo como um projeto Blockbench — quadrados, um grupo por camada, a textura dentro |
.obj · .mtl · .atlas.png | o modelo como Wavefront OBJ, o seu ficheiro de material e a textura que o material nomeia — três ficheiros que só funcionam juntos |
.stl | o modelo como um sólido fechado para impressão, a um milímetro por pixel |
.png | o desenho, composto em plano, no seu próprio tamanho de pixel |
.vector.png | a arte de linhas, rasterizada |
.view.png | a vista 3D, apenas o modelo, sem chão |
.svg | a arte de linhas como um ficheiro vetorial |
Quatro daqueles são PNGs do mesmo projeto, distinguidos apenas pelo sufixo. Isto é deliberado e vale a pena saber antes de escrever um script que globifica *.png.
O que está num .glb
glTF binário padrão, carregável por qualquer coisa que leia glTF 2.0.
- Uma malha por ilha — um pedaço de desenho separadamente conectado — agrupado sob um nó por camada.
- Um material, um atlas PNG incorporado, amostragem
NEARESTsolicitada. O atlas nunca é mais alto do que é largo, e é uma potência de dois quando a tela é uma. alphaMode: "BLEND"apenas quando algum texel no atlas é translúcido; caso contrário, a chave está ausente e o modelo comporta-se como um opaco.KHR_materials_unlitno material quando Material sem iluminação está ligado — listado como usado, nunca como necessário, por isso um carregador que não o conheça ainda abre o ficheiro.- O ponto de apoio está cozido na geometria, por isso
DrawModel(m, pos, …)não precisa de desvio.
O ficheiro acompanhante .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 o Model do raylib não tem nomes de malha, apenas um array Meshes. Procura as partes por path em vez de apenas por name: os nomes das ilhas são numerados por camada, por isso duas camadas podem cada uma ter um part_1.
orientation é de-trás-para-a-frente ou de-baixo-para-cima — qual era o sentido em que as camadas foram lidas no modelo. A geometria e os limites já estão virados, por isso não muda nada que um jogo tenha de fazer; está lá para que um script possa dizer qual é o eixo ao longo do qual a pilha de camadas corre sem medir.
As tuas definições e as tuas bibliotecas
| Plataforma | Pasta de definições |
|---|---|
| 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
Tudo é escrito atomicamente, por isso uma escrita interrompida não pode deixar um ficheiro truncado.
config.json guarda apenas o que mudaste. O teu mapa de teclas é uma lista de desvios do que foi enviado, que é o que deixa uma versão posterior mover um padrão sem sobrepor a tua escolha — e o que deixa um atalho que limpou-se de propósito ficar limpo.
Há uma segunda pasta, na pasta de cache do teu sistema, para o que Flatty consegue reconstruir por si: a lista de fontes da tua máquina e as miniaturas da galeria de media. Apagá-la não custa nada a não ser os segundos que leva a preencher de novo.
Os teus projetos estão noutro lugar completamente — onde quer que os coloques.
Ficheiros de paleta que lê e escreve
Lê: .gpl (GIMP), .pal, .hex, .txt, e .ase (Aseprite).
Escreve: .gpl, .pal, .hex, .txt.
Formatos de imagem
| abre | PNG, JPEG, GIF |
| a biblioteca de media guarda | Apenas PNG |
| exportações | PNG |
WebP e AVIF não são oferecidos, porque Go não tem descodificador para nenhum deles na sua biblioteca padrão.
Uma origem acima de 40 megapixéis é recusada, lida do cabeçalho do ficheiro. Qualquer coisa menor abre, e o resultado é limitado — 512 px no lado maior para uma textura de pincel, o lado maior próprio da tela para uma imagem que vai para cima.