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

Dateien auf der Platte

Ein Projektordner

Ein Projekt ist jeder Ordner, der eine project.fdraw enthält. Nichts anderes kennzeichnet einen, nichts registriert ihn irgendwo, und das Verschieben des Ordners verschiebt das Projekt.

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 ist JSON: die Leinwandgröße, die Ebenen als eingebettete PNGs, die Pro-Ebenen-Tiefe und Z-Versatz, der Seitenwand-Schatten, der Drehpunkt, die Skalierung, die Spiegelachsen und die Farben der Palette.

Die Farben der Palette reisen mit dem Projekt, nicht eine Referenz zu einer Palette. Ein Projekt muss sich mit seinen richtigen Farben auf einem Computer öffnen, der deine Bibliothek nie gesehen hat. Alles andere, das es nur referenziert.

Jeder Export wird zweimal geschrieben — ein zeitgestempeltes Archiv, das nie ersetzt wird, und eine kopierte Kopie mit festem Namen in latest/ für einen Pfad, den dein Spiel hartcodieren kann. Siehe Exportieren.

Was ein Export schreibt

SuffixWas es ist
.glbdas Gitter, ein eingebetteter PNG-Atlas und eine Knotenhierarchie von sprite → layer → island
.meshes.jsondie Begleitdatei: index → island, plus der Bezugspunkt, die Skalierung, in welche Richtung die Ebenen laufen, und die Grenzen
.bbmodeldas Modell als Blockbench-Projekt — Vierecke, eine Gruppe pro Ebene, die Textur innen
.obj · .mtl · .atlas.pngdas Modell als Wavefront OBJ, seine Materialsdatei und die Textur, die das Material nennt — drei Dateien, die nur zusammenarbeiten
.stldas Modell als ein geschlossener Körper zum Drucken, bei einem Millimeter pro Pixel
.pngdie Grafik, flach composited, in ihrer eigenen Pixelgröße
.vector.pngdie Strichzeichnung, gerastert
.view.pngdie 3D-Ansicht, nur Modell, kein Boden
.svgdie Strichzeichnung als Vektordatei

Vier davon sind PNGs des gleichen Projekts, nur nach Suffix unterschieden. Das ist absichtlich und es lohnt sich, zu wissen, bevor du ein Skript schreibst, das *.png globt.

Was ist in einer .glb

Standard-Binär glTF, ladbar von allem, das glTF 2.0 liest.

  • Ein Gitter pro Insel — ein separat verbundenes Grafikstück — gruppiert unter einem Knoten pro Ebene.
  • Ein Material, ein eingebetteter PNG-Atlas, NEAREST-Abtastung angefordert. Der Atlas ist nie höher als er breit ist, und eine Potenz von zwei, wenn die Leinwand eine ist.
  • alphaMode: "BLEND" nur, wenn ein Texel im Atlas durchscheinend ist; sonst fehlt der Schlüssel und das Modell verhält sich wie ein undurchsichtiges.
  • KHR_materials_unlit auf dem Material wenn Unbeleuchtetes Material an ist — aufgelistet als verwendet, nie als erforderlich, darum öffnet ein Lader, der es nicht kennt, die Datei immer noch.
  • Der Drehpunkt ist in der Geometrie eingebacken, also braucht DrawModel(m, pos, …) keinen Versatz.

Die .meshes.json-Begleitdatei

{
  "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": [] } }
  ]
}

Es existiert, weil raylibis Model keine Mesh-Namen hat, nur ein Meshes-Array. Suche Teile nach path statt nach bloßem name: Inselnamen werden pro Ebene nummeriert, also können zwei Ebenen jeweils eine part_1 halten.

orientation ist back-to-front oder bottom-to-top — in welcher Richtung die Ebenen in das Modell gelesen wurden. Die Geometrie und die Grenzen sind bereits gedreht, darum ändert es nichts, das ein Spiel tun muss; es ist dort, damit ein Skript sagen kann, welche Achse der Ebenenstapel entlang läuft, ohne zu messen.

Deine Einstellungen und deine Bibliotheken

PlattformEinstellungsordner
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

Alles wird atomar geschrieben, also kann ein unterbrochenes Schreiben keine abgeschnittene Datei hinterlassen.

config.json speichert nur, was du geändert hast. Deine Tastaturbelegung ist eine Liste von Abweichungen von der gelieferten, was eine spätere Version erlaubt, einen Standard zu verschieben, ohne deine Wahl zu überschreiben — und was einen Shortcut, den du absichtlich gelöscht hast, gelöscht hält.

Es gibt einen zweiten Ordner in deinem System-Cache-Verzeichnis für das, was Flatty selbst wieder aufbauen kann: die Liste der Schriften auf deinem Computer und die Miniaturen der Mediengalerie. Das Löschen kostet nichts als die Sekunden, die es braucht, um es wieder zu füllen.

Deine Projekte sind ganz woanders — überall, wo du sie hinlegst.

Palettendateien, die es liest und schreibt

Liest: .gpl (GIMP), .pal, .hex, .txt und .ase (Aseprite).

Schreibt: .gpl, .pal, .hex, .txt.

Bildformate

öffnetPNG, JPEG, GIF
die Medienbibliothek speichertnur PNG
exportiertPNG

WebP und AVIF werden nicht angeboten, da Go keinen Decoder für beide in seiner Standardbibliothek hat.

Eine Quelle über 40 Megapixel wird abgelehnt, gelesen aus dem Dateikopf. Alles Kleinere öffnet sich, und das Ergebnis wird stattdessen begrenzt — 512 px auf der langen Kante für eine Bürstentextur, die eigene lange Kante der Leinwand für ein Bild, das darauf geht.