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

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

SufixoO que é
.glba malha, um atlas PNG incorporado, e uma hierarquia de nós de sprite → camada → ilha
.meshes.jsono ficheiro acompanhante: índice → ilha, mais o ponto de apoio, a escala, o sentido das camadas e os limites
.bbmodelo modelo como um projeto Blockbench — quadrados, um grupo por camada, a textura dentro
.obj · .mtl · .atlas.pngo modelo como Wavefront OBJ, o seu ficheiro de material e a textura que o material nomeia — três ficheiros que só funcionam juntos
.stlo modelo como um sólido fechado para impressão, a um milímetro por pixel
.pngo desenho, composto em plano, no seu próprio tamanho de pixel
.vector.pnga arte de linhas, rasterizada
.view.pnga vista 3D, apenas o modelo, sem chão
.svga 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 NEAREST solicitada. 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_unlit no 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

PlataformaPasta 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

abrePNG, JPEG, GIF
a biblioteca de media guardaApenas PNG
exportaçõesPNG

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.