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

Pliki na dysku

Folder projektu

Projekt to dowolny folder zawierający project.fdraw. Nic innego go nie oznacza, nic się nigdzie nie rejestruje, a przeniesienie folderu przenosi 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 to JSON: rozmiar płótna, warstwy jako osadzone PNG-i, głębia i przesunięcie Z na warstwę, cień ściany bocznej, punkt odniesienia, skala, osie lustrzane i kolory palety.

Kolory palety wędrują z projektem, nie odwołaniem do palety. Projekt musi otwierać się z właściwymi kolorami na maszynie, która nigdy nie widziała twojej biblioteki. Wszystko inne to tylko odwołania.

Każdy eksport jest pisany dwa razy — archiwum z czasem, które nigdy nie jest zastępowane, i kopia o stałej nazwie w latest/ dla ścieżki, którą twoja gra może hardcoded. Zobacz Eksportowanie.

Co eksport pisze

PrzyrostekCo to jest
.glbsiatkę, osadzony atlas PNG i hierarchię węzłów sprite → layer → island
.meshes.jsonplik towarzyszący: indeks → wyspa, plus punkt odniesienia, skala, kierunek warstw i granice
.bbmodelmodel jako projekt Blockbench — czworokąty, grupa na warstwę, tekstura w środku
.obj · .mtl · .atlas.pngmodel jako Wavefront OBJ, jego plik materiału i tekstura, na którą materiał wskazuje — trzy pliki, które działają tylko razem
.stlmodel jako jedna zamknięta bryła do druku, w skali milimetr na piksel
.pngrysunek, skomponowany płasko, w jego własnym rozmiarze pikseli
.vector.pnggrafika kreskowa, rasteryzowana
.view.pngwidok 3D, sam model, brak ziemi
.svggrafika kreskowa jako plik wektorowy

Cztery z nich to PNG-i tego samego projektu, rozróżniane wyłącznie przyrostkiem. To celowe i warto o tym wiedzieć, zanim napiszesz skrypt, który zbiera *.png.

Co jest w .glb

Standardowy binarny glTF, ładowalny przez cokolwiek, co czyta glTF 2.0.

  • Jedna siatka na wyspę — osobno połączony fragment rysunku — pogrupowany pod węzłem na warstwę.
  • Jeden materiał, jeden osadzony atlas PNG, z prośbą o próbkowanie NEAREST. Atlas nigdy nie jest wyższy niż szerszy, a gdy boki płótna są potęgą dwójki, boki atlasu też.
  • alphaMode: "BLEND" tylko gdy jakiś tekstel w atlasie jest półprzezroczysty; w innym przypadku klucz jest nieobecny i model zachowuje się jak nieprzezroczysty.
  • KHR_materials_unlit na materiale, gdy Materiał bez oświetlenia jest włączony — wymienione jako używane, nigdy jako wymagane, więc loader, który go nie zna, i tak otwiera plik.
  • Punkt odniesienia jest upiekany w geometrię, więc DrawModel(m, pos, …) nie potrzebuje przesunięcia.

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

Istnieje dlatego, że raylib’s Model nie ma nazw siatek, tylko tablica Meshes. Szukaj części po path zamiast po nagiej name: nazwy wysp są numerowane na warstwę, więc dwie warstwy mogą każda posiadać part_1.

orientation to back-to-front albo bottom-to-top — w którą stronę warstwy zostały wczytane do modelu. Geometria i granice są już obrócone, więc nic to nie zmienia dla gry; jest po to, by skrypt mógł odczytać, wzdłuż której osi biegnie stos warstw, bez mierzenia.

Twoje ustawienia i twoje biblioteki

PlatformaFolder ustawień
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

Wszystko jest pisane atomowo, więc przerwany zapis nie może zostawić obciętego pliku.

config.json przechowuje tylko to, co zmieniłeś. Twoja mapa klawiszy to lista odchyleń od wysłanej, co pozwala późniejszej wersji na przesunięcie domyślnej bez przesłonięcia twojego wyboru — i co sprawia, że skrót, który celowo wyczyściłeś, zostaje wyczyszczony.

Jest drugi folder w katalogu cache twojego systemu dla tego, co Flatty może przebudować samodzielnie: lista fontów na twojej maszynie i miniatury galerii mediów. Usunięcie go kosztuje nic poza sekundami, które zajmie ponowne wypełnienie.

Twoje projekty są gdzieś całkowicie indziej — gdziekolwiek je umieściłeś.

Pliki palet, które czyta i pisze

Czyta: .gpl (GIMP), .pal, .hex, .txt i .ase (Aseprite).

Pisze: .gpl, .pal, .hex, .txt.

Formaty obrazu

otwieraPNG, JPEG, GIF
biblioteka mediów przechowujetylko PNG
eksportyPNG

WebP i AVIF nie są oferowane, ponieważ Go nie ma dekodera dla żadnego z nich w swojej standardowej bibliotece.

Źródło ponad 40 megapikseli jest odrzucane, czytane z nagłówka pliku. Wszystko mniejsze otwiera się, a wynik jest ograniczony — 512 px na długiej krawędzi dla tekstury pędzla, własna długa krawędź płótna dla obrazu na niego trafiającego.