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
| Przyrostek | Co to jest |
|---|---|
.glb | siatkę, osadzony atlas PNG i hierarchię węzłów sprite → layer → island |
.meshes.json | plik towarzyszący: indeks → wyspa, plus punkt odniesienia, skala, kierunek warstw i granice |
.bbmodel | model jako projekt Blockbench — czworokąty, grupa na warstwę, tekstura w środku |
.obj · .mtl · .atlas.png | model jako Wavefront OBJ, jego plik materiału i tekstura, na którą materiał wskazuje — trzy pliki, które działają tylko razem |
.stl | model jako jedna zamknięta bryła do druku, w skali milimetr na piksel |
.png | rysunek, skomponowany płasko, w jego własnym rozmiarze pikseli |
.vector.png | grafika kreskowa, rasteryzowana |
.view.png | widok 3D, sam model, brak ziemi |
.svg | grafika 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_unlitna 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
| Platforma | Folder 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
| otwiera | PNG, JPEG, GIF |
| biblioteka mediów przechowuje | tylko PNG |
| eksporty | PNG |
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.