introductionstart-running-itstart-first-modelguide-workspaceguide-arrangingguide-drawingguide-stampsguide-colourguide-layersguide-3d-viewguide-vectorguide-recordingguide-picturesguide-librariesguide-projectsguide-exportingguide-appearancereference-panesreference-toolsreference-keyboardreference-filesreference-command-line

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

What Flatty is

Flatty turns pixel art into 3D models you can drop straight into a game.

You paint a flat grid, exactly as you would in any pixel editor. Flatty pushes that drawing out into the third dimension — giving it thickness, colouring its sides, welding it into a mesh — and writes a .glb file that rl.LoadModel takes as-is.

The drawing on the left is the only thing you edit. The model on the right is a consequence of it, rebuilt as you paint. It is wearing one of the four ways Flatty can shade a model; the export always carries your own colours.

The one idea

The picture is the shape. There is no separate modelling step and nothing to sculpt. A pixel you paint becomes solid; a pixel you leave transparent is not part of the model at all — not a hollow, not a hidden face, simply absent. Erase a pixel and the shape loses that column of material the moment you let go.

That is why the tool is worth using. A sprite and its model can never disagree, because there is only one of them.

flowchart LR
    A[You paint<br/>a 2D grid] --> B[Each opaque pixel<br/>becomes a column]
    B --> C[Columns weld into<br/>one mesh]
    C --> D[".glb your game loads"]
    style A fill:#66d9ef,stroke:#66d9ef,color:#1a1a1a
    style D fill:#a6e22e,stroke:#a6e22e,color:#1a1a1a

Who it is for

People making 2.5D games — platformers, brawlers, top-down adventures — who want the look of pixel art with real geometry: characters that catch a light, props that cast shadows, a world you can move a camera through.

If you have drawn a sprite before, you already know how to use most of this.

Five things come out of one drawing

The model is the reason the app exists, but it is not the only thing you can ask for. From the same artwork, on their own buttons:

You getWhich is
a .glbthe extruded model, plus a sidecar naming its parts
a .pngthe artwork, flat, at its own pixel size
an .svgthe model traced as line art — six ways of drawing it, from clean outlines to halftone dots
a second .pngthat same line art, rasterised
a third .pngthe 3D view itself, framed and with nothing behind it

The line art is the one nobody expects. Line art is its chapter, and it is worth a look even if you only came for the model.

What you should know before starting

It is not a voxel editor. You cannot carve out an interior, and you cannot give one part of a shape a different thickness from the pixel beside it. Depth is a property of a layer, not of a pixel. That restriction is the whole point: it is what keeps the drawing the single source of truth, and what makes the result reliably cheap to render.

Layers are how shapes gain structure. Give a nose more depth than a face, put one layer in front of another, and you have relief without ever leaving the 2D grid. Layers and depth is the chapter that unlocks the tool.

Nothing is saved automatically. A project is a folder you choose; until you save, your work is only in memory. Projects explains the whole arrangement, which is deliberately simple: no catalogue of your projects, no database, no hidden root folder. Move a folder and it is still a project.

Your materials are the other way round. Palettes and pictures belong to you rather than to any one drawing, so they are kept once, in your libraries, and every project can reach them.

How to read this book

If you want toStart at
get something working in ten minutesYour first model
understand the editor properlyThe workspace, then read forward
look one thing upthe Reference section
get a model into your gameExporting to your game

This book is everything you need. It is the complete manual: what each part of the program is, how to drive it, and what comes out the other end. There is nothing you have to know that is written down somewhere else.

Flatty is free, and the newest version is always at flatty.higreg.pl.

Running it

Flatty is at flatty.higreg.pl, and that is always where the newest version is. It is free — no key, no account, nothing to sign up for.

There is no installer, nothing to register, and no runtime to fetch alongside it. The whole program is one executable, and even the font it draws with is baked inside. Unpack it wherever you keep your tools and run it.

flatty_1.0.0_linux_amd64.tar.gz
├── flatty                  the program
├── LICENSE                 what you may do with it
└── THIRD-PARTY-NOTICES.md  the open-source components it is built on

Take the build that matches your machine. On the download page they are named flatty_<version>_<system>_<chip> — windows_amd64, linux_amd64, darwin_arm64 for an Apple Silicon Mac, darwin_amd64 for an Intel one.

Windows

Right-click the .zip and choose Extract All. Run flatty.exe from the folder it produces.

Windows may show a blue “Windows protected your PC” box the first time. That is SmartScreen reacting to a program it has not seen many people run yet, not to anything it found in the file. Click More info, then Run anyway.

Do not run Flatty from inside the .zip — Windows opens it in a temporary folder, and anything you save from there disappears.

macOS

Take the arm64 archive for an Apple Silicon Mac (M1 and later) and the amd64 one for an Intel Mac. The Apple menu → About This Mac tells you which chip you have — and, on the same panel, which version of macOS you are running. You will need that second number in a moment.

There is no disk image and no Flatty icon to drag into Applications, and that is deliberate rather than unfinished. Apple only lets an application open without a warning if its author pays for a developer account and submits each build for scanning. Flatty is free and does not, so a bundle would have been refused by your Mac just as firmly as the bare program is — while looking as though it should work. You are given the program itself instead, and told honestly how to let it run.

It takes about a minute, once.

The short way, on any version of macOS

Open Terminal and run these, one line at a time:

cd ~/Downloads
tar xzf flatty_*_darwin_arm64.tar.gz
xattr -d com.apple.quarantine flatty
./flatty

The xattr line removes the flag macOS puts on anything a browser downloaded. It may answer No such xattr — that only means the flag was not there, and you can carry on to the next line.

Flatty is now unlocked for good. Later on you can run it by double-clicking it in Finder like anything else.

The Finder way, if you would rather not use Terminal

Double-click the .tar.gz to unpack it, then double-click flatty. It will be refused the first time. What you do next depends on your version of macOS, and this is where most people get stuck.

On macOS 14 and earlier — Monterey, Ventura, Sonoma:

Control-click (or right-click) flatty, choose Open, and confirm with Open again in the box that follows. That is all, permanently.

On macOS 15 and later — Sequoia, Tahoe:

Apple removed that shortcut, so Control-click no longer offers Open at all. Instead:

  1. Double-click flatty and let it be refused. Close the message.
  2. Open System Settings → Privacy & Security and scroll down to Security.
  3. Next to the line mentioning flatty, click Open Anyway and confirm.

Do that part promptly. The Open Anyway button only appears for about an hour after a refused launch, and if you come back later it simply will not be there. Double-click flatty again to bring it back, then go straight to Settings.

A Terminal window opens next to Flatty

That is expected and it is not an error. Flatty is a plain program rather than a Mac application bundle, so Finder runs it through Terminal and that window stays open for as long as Flatty does. Closing it quits Flatty, so leave it be and put it behind the main window.

Linux

tar xzf flatty_*_linux_amd64.tar.gz
chmod +x flatty
./flatty

The chmod is usually unnecessary — the archive carries the executable bit — but it costs nothing and it is the fix if you get Permission denied.

Or take the AppImage

There is a second Linux download, ending in .AppImage. It is the same program in the format Linux uses for “one file you can just run”: no archive to unpack, and your desktop picks up its name and icon.

chmod +x flatty_*_linux_amd64.AppImage
./flatty_*_linux_amd64.AppImage

Here the chmod is not optional — a download arrives without the executable bit, and without it nothing happens when you click.

It needs a reasonably current system: Ubuntu 22.04, Debian 12, Fedora 36 or newer, or anything of about that vintage. On something older, take the .tar.gz instead. Neither version can do anything the other cannot; pick whichever suits how you like to keep programs.

If you want it in your applications menu rather than in a folder, a tool like Gear Lever or AppImageLauncher will file it away for you. Nothing obliges you to — it runs perfectly well from wherever it sits.

Either way

You need a graphics driver and a desktop session, which any normal Linux install has. On a bare server there is nothing to draw into and the program will not start.

Check it works

flatty -demo cloud

That opens the editor with a small piece of artwork already loaded, so you can see a model before you have drawn anything.

Press Ctrl+Q to leave — Esc deliberately does not quit.

Where Flatty keeps things

Two places, and nothing else:

WhatWhere
your workfolders you choose — see Projects
your settings and recent-project listone config file

Your palettes, brush textures, themes and saved layouts live beside that file, a folder apiece — see Your libraries.

PlatformConfig file
Linux~/.config/flatty/config.json
macOS~/Library/Application Support/flatty/config.json
Windows%AppData%\flatty\config.json

There is a second folder for things Flatty can rebuild by itself — the list of fonts on your machine, and the thumbnails in the media gallery. It lives in your system’s cache directory, and deleting it costs you nothing but the few seconds it takes to fill in again.

Nothing is written anywhere else, nothing is installed system-wide, and removing Flatty is a matter of deleting the executable. Your projects are ordinary folders and are not touched by that.

What you may do with it

The full terms are in the LICENSE file beside the program. The short version:

Everything you make with Flatty is entirely yours. Your drawings, your exported models, and anything you build from them. No royalty, no revenue share, no attribution and no permission needed — however successful the work becomes. Sell it, licence it, open-source it, put it in a game with a million players. That clause outlives the rest of the agreement: even if your licence ended tomorrow, what you already made stays yours.

You may use Flatty for any purpose, personal or commercial, including paid client work, and install it on as many machines as you like. There is no limit on how many people at an organisation may use it.

Please do not redistribute the program itself — do not resell it, bundle it into another product, or publish copies of it. It is free, but it is not open source, and the download page is where it should come from.

It comes with no warranty — so keep backups of your work, as you would with any tool that writes files.

THIRD-PARTY-NOTICES.md, also in the archive, lists the open-source components inside Flatty and their licences.

Next: Your first model.

Your first model

Ten minutes, start to finish: draw something, give it thickness, and get a .glb your game can load.

1. Start a project

Flatty opens on a chooser. It lists the projects you have opened before — so on a genuinely first run it is empty, where the one below has been used once already.

Press New project. The file browser opens, and it wants one thing: the folder your project will live in.

Browse to wherever you keep your work, then type a name in the row under the listing — fluffy cloud will do — and press Create. That makes a folder of that name inside the one you are standing in, which is the whole of what a project is.

The line at the bottom spells out exactly what is about to be written, so there is never any guessing:

-> /home/you/sprites/fluffy cloud/project.fdraw

The folder is the project. There is no library and no database: a project is any folder containing a project.fdraw file, and it can be anywhere. Move it, copy it, put it on a memory stick — it is still a project. The name in the Project pane is yours to change whenever you like.

2. Draw something

You are looking at the canvas, large and top left, with the tools, the colours and the layer list in a strip beneath it. Down the right are the two views of what you are making: the model above, its line art below. Paint on the canvas with the left mouse button.

Draw a solid blob — a cloud, a face, a shield, whatever. Keep it simple and keep it touching the bottom of the canvas if it is a character; that is where the model’s pivot goes, so a character drawn at the bottom edge stands on the ground in your game.

A few things to try straight away:

Do thisGet this
[ and ]smaller and larger brush
Ctrl+dragpaint with the second colour
Shift+dragerase back to transparent
Alt+clicktake a colour off the canvas
G, then clickflood-fill a region
Ushapes — a line, a box, an ellipse, a polygon
S, or the right button on the canvasthe Swiss Army Knife — colours, tools and layers under the cursor
Ctrl+Zundo
Ctrl+Pask for anything by name — every pane and every command

That last one is worth trying early. Most of what Flatty can do lives in a pane you have not put on screen yet, and the command palette is how you find one without having learnt where it is.

Watch the right-hand pane while you work. The model is rebuilt as you draw — you are never waiting for a preview.

3. Give it depth

The model is currently a flat slab. Change that in the Outliner.

Click the title tab of any pane — the little filled label at its top left, reading 2D Canvas with a chevron after it — and choose Outliner. Above the layer list is a card for whichever layer you are on, and its first slider is Depth. Drag it and watch the shape push out.

The slider under it is the other half of what turns a stack of layers into relief. Z offset moves this layer’s slab forwards or backwards through the volume, so a nose can sit in front of a face rather than inside it.

Two more numbers worth a moment, both in the Project pane:

  • Side walls → Shade darkens the colour of the extruded sides relative to the front face. Lower is darker. This is what stops a model looking like a sticker.
  • World placement → Px / unit sets the scale: at 16, a 64-pixel sprite is 4 world units across.

4. Look at it properly

In the 3D pane, drag with the left button to orbit, use the wheel to move closer, and middle-drag to pan. The chip in the corner labelled Free orbit switches to a fixed angle — front, back, left, right, top or isometric — which is the honest way to check a silhouette.

The third chip along that line is how the model is shaded. Flatty is your colours exactly as you painted them, and it is what you should come back to before deciding a shade is wrong; the three beside it are stylised ways of seeing the same model, and the pictures in this book use one of them.

Whichever you pick, the export is unaffected — see The 3D view.

5. Save and export

Ctrl+S saves the project. Ctrl+E exports the model. Everything that comes out of a drawing has a button of its own in the Export pane, which the setup key at the bottom right of the window will pop out for you.

Your project folder now looks like this:

fluffy cloud/
  project.fdraw                              the drawing — this is your work
  exports/
    2026-08-21_144312_fluffy_cloud.glb       an archive, never overwritten
    2026-08-21_144312_fluffy_cloud.meshes.json
    latest/
      fluffy_cloud.glb                       the one your game loads
      fluffy_cloud.meshes.json

Every export is written twice. Once with a timestamp that is never replaced, so a week of work is still there to go back to. And once into latest/ under a fixed name, because the path in your game’s code cannot change every time you press export.

6. Load it in your game

m := rl.LoadModel("sprites/fluffy cloud/exports/latest/fluffy_cloud.glb")

// The one line you have to add: the file asks for nearest-neighbour filtering,
// but raylib's glTF loader does not apply that request, so your pixels come out
// blurred unless you say it again here.
for _, mat := range m.GetMaterials() {
    if tex := mat.GetMap(rl.MapAlbedo).Texture; tex.ID != 0 {
        rl.SetTextureFilter(tex, rl.FilterPoint)
    }
}

rl.DrawModel(m, playerPos, 1, rl.White)  // the pivot is baked in — no offset needed

That is the whole integration. No conversion step, no import settings, no material to rebuild.

Where to go next

  • Layers and depth — the chapter that makes shapes stop looking like slabs
  • Line art — the same model traced as an SVG, six different ways. Nobody expects this one
  • Colour — the two colours, the wheel, palettes and transparency
  • Exporting to your game — pivots, scale, Blender, and what is actually in the file

The workspace

Flatty has no fixed window layout. The screen is divided into panes, and every pane can show any view — the canvas, the 3D model, the palette, the project, the tools. You arrange them to suit the job.

A pane’s title is a menu

Everything else here depends on knowing this. The chevron on the tab is what says so — for a long time nothing on screen did, and it was the one thing about Flatty you had to be told.

Click a pane’s title tab and you get a list of everything that pane can become. The tab is the filled label in its top-left corner: a small icon, the name, and a chevron after it.

The list comes in four families, in this order. Artwork is the four views that show you the drawing, Layers the one that describes the stack rather than drawing it, Painting what you make marks with, and Setup everything about the app rather than about the picture.

ViewIconWhat it is for
2D Canvasa grid with one cell painteddrawing
3D Viewa solid boxlooking at the model
Vectora path with a node at each endthe model as line art, and the SVG it writes
Layer Deckthree stacked cardslayers as cards in 3D space
Outlinera bar with two branches under itthe layer list, and the depth of the one you are on
Toolsa brushthe seven tools and their settings
Palettefour squarescolours
Mediaa pictureeverything you have imported
Glyphsa letter in a grid cellevery character in a font on your machine, for the stamp
Projecta folderthe name, the folder, the canvas, the scale
Exportan arrow leaving a boxeverything that comes out of a drawing
Layoutsa window outlinenamed arrangements of panes
Appearancea disc with one half filledthe theme: how the interface itself is drawn
Shadersa lampthe numbers inside the app’s own shaders
Settingsthree slidersthe app’s own preferences
Keystwo keycapsevery shortcut, and where to change them
Creditsa heartwhat you are running, and who made what is inside it

The menu repeats those icons beside the names, and the icons are the part that does not change with the interface language. In a workspace of six panes it is usually faster to find the one you want by its shape than by reading four titles.

A pane folded to a vertical rail keeps its icon at the top of the strip, above the title turned on its side. That is where the shape earns its keep: a sideways word is slow to read.

That menu, the command palette below and the setup key at the bottom right are the three ways to reach a view. Most of the seventeen are not on screen when the app opens, and none of the three is a shortcut you have to have learnt first.

Asking for something by name

Ctrl+P, from anywhere. A large field over a list of everything the app can be asked to do, and you narrow it by typing.

Everything else in Flatty is reached by aim — a key you have memorised, or a pane you have to go and find. This is the one place you can reach something by its name, which is worth most on the day you know what you want and not where it lives.

Three groups, in the order you meet them. Workspaces is one row per workspace you have, plus next, previous and close; the app is quitting. In between, panes is the four things you can do with any of the seventeen views:

CommandDoes
Focus the … panegoes to the one you already have, in whichever workspace it is in
Split to the … panedivides the pane you are in and puts that view in the new half
Open the … pane in a new workspacea workspace of its own holding it, and takes you there
Pop out the … panea large panel over your work — see Arranging it

Focus and Split are deliberately not the same command. One goes to the pane you have; the other makes another one here, beside what you are working on.

Where a command has a key of its own the row shows it, and it shows your key — rebind Ctrl+3 and that row says so the next time you open the palette.

A command that cannot run right now is still listed, dimmed, with the reason on the right — there is only one workspace, you are looking at it. Dropping it would give you the shorter list and the worse one: a command you cannot see is a command you cannot learn.

Typing matches letters in order but not necessarily together, so fo3 finds Focus the 3D View pane and the letters you typed are picked out in the row. Accents fold, so the search works the same in every language the app speaks: in Polish zolc matches zażółć, and in German grosse matches Größe — which is how people type both when the letter is not under their fingers. Up and Down move, Enter runs, Esc closes.

One thing to know: the palette will not open while you are typing in a field somewhere else — a name box, a filter, a search. The field has the keyboard, and Ctrl+P belongs to whatever it means there. Click away first.

The buttons in a header

They are Flatty’s own, not your window manager’s. Left to right:

ButtonDoes
?what this pane is for, and its shortcuts
fold the blockfolds the whole column or row this pane sits in
split left | rightdivides the pane vertically, new half beside it
split top / bottomdivides it horizontally, new half below
collapsefolds the pane to a strip
closeremoves the pane, its neighbour takes the room

The split icons show the pane being divided with the new half tinted, so you can see where you will end up before clicking. Hover any of them for a tooltip.

Each carries its own colour without being hovered: yellow for the question mark, green for the two splits, blue for collapse and the block fold, red for close. Across a wide window you pick one by colour rather than by comparing small shapes. They brighten under the cursor.

The fold the block button, drawn with a doubled chevron, only appears on a pane that belongs to a column or a row of panels; there is nothing for it to do otherwise. When it is missing the space goes back to the title rather than being left as a gap, and the question mark shifts along to keep the row of keys unbroken.

Drag the gutters between panes to resize.

The question mark

Every pane explains itself. The ? at the head of the group opens a card for that pane: a short description of what it is for, then its own keys and mouse gestures, drawn on keycaps.

There is no manual to hunt through and nothing global to open — the help is asked for from the thing it describes, so what you get back is about the pane you were already looking at and nothing else.

The status bar has one too, near the right-hand end. That one covers what belongs to no pane in particular: the header buttons above, the workspace squares, and the keys that work everywhere.

Escape closes a card, and so does clicking anywhere outside it.

A card shows the keys you are actually using. Rebind something in the Keys pane and every card that mentions it says so straight away — the cards are a readout of your own settings rather than a printed list that can drift away from them.

When a pane runs short of room

Make a pane small enough and its contents will not fit. Nothing is dropped: the pane scrolls, and a slim bar appears down its right edge.

A pane never hides a control to save space. If you cannot see something, it is below the fold, not missing. A pane that quietly shed its last two buttons would look exactly like a program without them.

Three ways to move it:

the wheel, or two fingersanywhere over the pane
dragging the barit thickens as your pointer reaches it, and the whole strip is a target — you do not have to hit the thin line
clicking the empty trackjumps to that point, and you can carry on dragging from there

Some panes hold a list that scrolls inside itself — the layouts in the Layouts pane, your palette library, the media grid. Scroll one of those to its end and the pane behind it takes over, so a single gesture carries you from the bottom of the list to the bottom of the pane without moving the pointer off.

The 3D pane is the one exception to “nothing is dropped”, and it has to be: it is a heads-up display over somebody’s model with nowhere to scroll to. Squeeze it narrow and the row along its bottom loses whatever will not fit, the hint first and the camera readout next. Widen it and everything comes back.

The Swiss Army Knife

Press S. A titled bench of cards opens centred on the cursor, holding most of what you would otherwise go and find a pane for. Press S again and it is gone. Over the 2D canvas the right mouse button opens it too, which is the shorter reach when your hand is already drawing.

Three columns, six cards:

CardGives you
Palettethe swatch grid, and the two colours you are holding
Palettesyour other palettes, to switch between — see below
Toolsall seven, and which one is in hand
Mixingthe blend modes
Layerswhich layer the next stroke lands on
Symmetrythe mirror axes — click to step through off, one, two, all four

It is not a smaller workspace and is not meant to become one. Nothing in it can delete, rename or reorder anything, on purpose: a panel you open by accident must not be able to lose work.

It appears instantly and nothing animates — there is no gesture to hold and nothing to wait for. Pick as much as you like before closing it. Choosing a colour does not put the knife away, so a colour and then a tool, or two colours in a row, is one press of S rather than two.

Esc closes it, and so does clicking anywhere outside it — and that click still does whatever it would normally have done, rather than being spent on dismissing the knife.

It opens down and to the right of the pointer, or back across it near the edge of the screen, so it is always fully visible.

Switching palettes from the knife

The Palettes card carries your palettes, so you can change between them without leaving the canvas. The ten you start with are already in it, so it works on the first day rather than after you have found a setting.

What it will not do is carry everything. A library of thirty poured into it would be a wall of unlabelled colour with no way to tell one from another, so anything you add later — installed, imported or made yourself — stays out until you say otherwise. In the Palette pane’s Manage tab, select a palette and turn on Show in the Swiss Army Knife, or take one of the ten back out.

Along the bottom of the window: the workspace squares at the left, then whatever the app has to tell you, and three controls at the right.

ControlOpens
the flagthe language picker
?the app’s own help card
the setup keythe setup panel

A fourth group can be asked for: record, pause and stop, turned on by Keys in the footer in the Recorder pane. They lead the row, ahead of the flag, so the three above never move when they appear. See Recording.

Only three otherwise, and it was eight not long ago. What no single one of their reasons accounted for was what eight small glyphs look like together. The flag and the question mark stay because they have to be readable without opening anything — a flag reads without knowing the language it is written in — and the flag leads because it is the control somebody who cannot read the interface has to find.

The setup panel

Ctrl+,, or the setup key. It is both the way to the panes you visit rarely and a shortcut back to the arrangements you use.

PartHolds
the tilesSettings, Layouts, Project, Export, Appearance, Keys, Shaders and Credits
the layouts cardthe four you applied most recently, newest first, each drawn as the arrangement it holds rather than as its name

A tile pops its pane out; it never inserts one. Nothing you have arranged moves, nothing is split and no workspace is added. The gear that used to sit here did insert, splitting whichever pane you were in to do it — which is a way to lose an arrangement you built on purpose.

Picking a layout here does exactly what Apply in the Layouts pane does: it replaces every workspace with the ones that layout holds. On a fresh install nothing has been applied yet, so the card offers the layout the window came from.

Leaving

Escape never quits. Escape is what dismisses a popup, and a missed popup should not end your session.

Leaving is Ctrl+Q, and it asks.

With unsaved changes you get Save and quit, Quit without saving and Cancel. With nothing pending you get a don’t ask again option — which deliberately only appears when there is nothing to lose. It means “stop asking me the pointless question”, not “agree in advance to discard work you have not seen”.

A failed save cancels the quit rather than pressing on. And a project that has no folder yet cannot be written by pressing a button, so Save and quit opens the New Project panel and stops there, waiting for you to say where it goes.

Arranging it

Panes are cheap. Move them, fold them, throw a second arrangement into a workspace of its own, and when you have something worth keeping, give it a name.

Nothing on this page needs saving. Which workspaces exist, what is in each of them, what is folded and where you dragged the dividers all come back the next time you open the app.

Several workspaces

One arrangement is rarely right for everything. Painting wants the canvas large; checking the model wants the 3D view large; building a palette wants neither. Rearranging the window every time you change job is the tax this removes.

The row of numbered squares at the bottom left is your workspaces. Each one is a complete arrangement of panes, and one is on screen at a time.

Do thisAnd
click a squarethat workspace comes up
Ctrl+1…9the same, without leaving the keyboard
click the +a new, empty workspace, and you are in it
right-click a squarerename it, duplicate it, or close it

Give them names — right-click, Rename… — and the name appears when you hover the square. The square keeps its number on its face whatever you call it, because a number is what Ctrl+3 means and a word wide enough to read would make the row something you have to scan rather than aim at.

There is room for twelve. Past that the + stays where it is and stops responding, rather than disappearing and shifting everything under your cursor.

Closing the last workspace is refused: it would leave you looking at nothing at all.

An empty workspace

A new workspace starts empty, and you can empty an existing one by closing or dragging away its last pane.

It is not a broken state and there is nothing to repair. A workspace is for something, and being asked what beats being handed a canvas you then have to change. Two ways out, both on the screen:

  • Pick a view opens the same menu a pane’s title does. Whatever you choose fills the whole workspace, and you split from there.
  • Drag a pane into it from another workspace, and that pane becomes the whole of it.

Moving a pane

Between a pane’s name and its buttons is a field of small dots. That is a grip: hold it and drag, and the pane comes with you.

Where you let go decides what happens.

Let goAnd you get
over another pane’s edgethat pane splits, and the one you dragged takes the side you were nearest
over another pane’s middlethe two swap places
over the window’s own edgea full-height column, or a full-width row, across everything
over a workspace squarethe pane moves to that workspace, beside whatever you were last working in there
over the +a new workspace, holding just that pane
over an empty workspacethe pane becomes the whole of it

You do not have to aim in the dark. While you drag, an accent rectangle shows the exact space the pane is about to take, and the other three edges of whatever you are over show as faint stubs. Every choice is visible before you commit, and the rectangle slides between them as you move.

Over a workspace square the rectangle collapses onto the square itself — the one thing on screen standing for a layout you cannot see.

Hold a pane over a workspace square for a moment and that workspace opens with the pane still in your hand. You can then drop it against a real pane or a real edge, exactly as you would at home. Moving to a different square starts the wait again, so crossing the row on your way to the + does not flip you through every workspace on the way.

Changed your mind mid-drag? Esc or the right mouse button calls it off. So does letting go over the pane you are carrying.

A moved pane arrives exactly as it left — the same view, the same camera angle, the same scroll position — and that holds across workspaces as much as within one. Folded panes can be dragged too, either by the bar or by the short run of dots at the top of a folded rail.

The split buttons and the grip do different jobs. Splitting adds a pane; dragging moves one you already have. If the panel you want is on screen but in the wrong place, the grip is the shorter route every time.

A workspace’s last pane can be dragged out like any other. The workspace it leaves simply goes empty, waiting for whatever you put in it next.

Folding

The chevron collapses a pane to a strip and hands the room to its neighbour. It is not closing — the pane keeps its kind, its state and its share of the split, so clicking again restores exactly what was there. That is the point: the alternative is closing a panel and rebuilding it later.

Which way it folds depends on where the room can go, and the chevron points that way:

  • Stacked top and bottom, a pane folds to a title bar and its neighbour gets the height.
  • Side by side, it folds to a narrow vertical rail with the title turned on its side — a horizontal bar cannot give a neighbour any width.
  • Fold every panel in a column and the whole column becomes one rail of tabs, handing the width to whatever sits beside it.

A folded pane keeps the same buttons in the same places, so a quick open-and-shut never lands on the wrong one.

Double-clicking the grip folds a pane too, and unfolds it again. It works from either side: on an open pane’s bar it folds, and on a folded one — the bar, or the short run of dots at the top of a rail — it opens back up. Hover the dots and the tooltip says which way the next double click will go.

The last pane still open in a workspace will not fold, by either route. Folding it would leave you looking at a workspace of rails with nothing in any of them, and no strip wide enough to offer the chevron back. Closing it is a different matter — that leaves an empty workspace, which has a way out on the screen.

A gutter with a folded pane on either side does nothing when you drag it. There is only one size a strip can be, and the ratio it is holding is the one the pane comes back to.

Popping a pane out

Sometimes you want a pane large, once, and you do not want to give it a home. The Keys list to check one thing. The Appearance pane to try a colour. The 3D view big enough to actually look at.

Two ways in: Pop out the … pane in the command palette, and — for the eight in the Setup family — a tile in the setup panel.

Nothing about your arrangement changes. No pane is moved, nothing is split, no workspace is added, and nothing is saved. The workspace is dimmed behind the panel and is exactly as you left it when the panel goes.

That is the whole difference between this and the other three pane commands. Two of those rearrange something and one adds a workspace, and all three are things you then have to undo by hand. A pop-out you dismiss.

Esc closes it, and so does clicking outside it. Any view can be popped out, and it is a real pane while it is up: its own keys work, its menus open over it, and it scrolls if what it holds does not fit. Each opens at a size that suits what it holds — the 3D view and the canvas take most of the screen, a settings panel takes a column — and every one of them grows taller on a taller monitor, because escaping a pane’s scrollbar is half of why you popped it out.

Esc takes one thing off at a time, innermost first. Over a popped-out 2D canvas with a block of pixels in flight, the first press calls the block off and the panel stays — that canvas is not covering your artwork, it is your artwork. A second press closes it. Over a pane that shows nothing of the drawing, the first press closes the panel, because there is nothing else in front of it to mean.

Saved layouts

Keeping is different from saving. Your workspaces come back on their own; a layout is an arrangement you have given a name, so you can come back to it after rearranging everything, and hand it to somebody else.

Open the Layouts pane from the setup panel’s Layouts tile, or point any pane’s title at it.

It answers three questions, top to bottom:

SectionSays
Currentwhich layout the window came from, and whether it still matches. Save as new keeps what is on screen; Revert throws away the changes since
Built inthe four the app ships with — Focus 11, which is what a fresh install opens on, then Simple, Claudy and Rico — with how many panes each holds
My layoutsthe ones you have saved, and the folder they are written to

Four buttons act on whichever row you have picked: Apply (become that layout, every workspace), Copy, Update (overwrite it with what is on screen) and Delete, which asks twice.

The six cannot be lost. They are not files on your disk, so nothing you do can edit or delete one. Update and Delete stay visible on a built-in but do nothing, and say why. Copy it and the copy is yours. That is what makes “put it back the way it was” always available — and it means improving one in a later version improves it for you too.

“Rico — modified” in orange means the workspaces have drifted from the layout you applied: a divider dragged, a pane closed, a workspace renamed. Switching between workspaces is not a change, and neither is a divider moved by half a percent, which is just a number being written to disk and read back. Update keeps the drift, Revert undoes it, and either way nothing is lost by ignoring the marker — the arrangement itself is saved continuously regardless.

Apply replaces every workspace, not just the one on screen, and that reach is the reason it is a deliberate act on something with a name rather than a menu item you brush past.

Your own layouts are one file each in ~/.config/flatty/layouts/, and the pane names the folder. Copying one out to send to somebody is a file manager away, and one dropped in appears the next time the app starts.

What a layout stores

The shape: which views, split which way, at what ratios, plus which panes are folded and each 3D pane’s fixed angle. The angle is there because choosing “Isometric” from the preset chip is a decision, not somewhere a camera happened to drift.

Deliberately not stored is anything you arrive at rather than choose: a free orbit’s angle, the canvas zoom and pan, scroll positions. Coming back to a workspace should put the panels back, not resurrect exactly where a view was pointing three sessions ago.

Drawing

The canvas is a pixel grid. The left mouse button paints, and everything else is a variation on that.

The seven tools

The Tools pane is a rail of tools down the left and the selected one’s settings on the right. They are split that way because the two halves are consulted at different rates: which tool is in hand is glanced at constantly, where its settings need room for real controls and are adjusted far less often.

ToolKeyWhat it does
BrushBdrag to lay colour down
BucketGclick to flood a region with one colour
Texture brushNdrag to work a texture into pixels already there
Glyph stampTclick to press a character from any font into the canvas
FlextrudeFpaint over the drawing, then raise what you painted into a slab of its own
ShapesUdrag out a line, a rectangle or an ellipse, or click out a polygon
GeneratorKclick to grow one item — a blade of grass, a rock — and drag to sow a handful

This page covers the brush, the bucket and the shape tool, and everything they share: mixing, selection, symmetry and undo. The three that stamp something into the canvas have a page of their own, and Flextrude belongs with layers and depth, because what it makes is a layer.

Three modifiers mean the same thing to every tool that lays colour down, and the tool panel spells them out at its foot under INPUT BINDINGS:

left buttonthe primary colour
Ctrl + leftthe secondary colour
Shift + lefterase to transparent

The texture brush is the exception — it lays down the texture’s own colours rather than the palette’s, so neither modifier means anything to it.

The brush

Size is [ and ], or the slider, or holding Ctrl and turning the wheel. The panel shows the exact footprint, so you can see the shape you are about to stamp.

Shape is Square (the whole footprint, edge to edge) or Circle (the disc inside it). Below 4 pixels a circle has no room to be one, so it draws square.

Mixing

Under MIXING the brush stops laying colour down and starts working on the colour already there. It is one card, and every tool that has it has the same one — so none of them can drift into disagreeing about what “multiply” means.

ModeNormal, Multiply, Screen, Darken, Lighten, Overlay, Hard light, Soft light — how a stroke combines with what is underneath
Intensityhow much of that combination to apply. 0 leaves the artwork alone, 1 applies the mode in full
Build upoff, each pixel is mixed once per stroke; on, lingering keeps deepening it, like an airbrush
Speedhow much each pass adds while Build up is on

Any mode but Normal recolours existing pixels only. A mode that mixes has nothing to mix with where there is no pixel, so it leaves empty space alone. The panel says so in orange rather than leaving you to discover it as “the brush stopped working”.

Normal ignores Intensity, and the slider goes grey to say so. Normal replaces the colour outright; a half-strength replacement would be a transparency rather than a mix, and transparency here is a hole in the model rather than thinner paint. Pick any other mode and the slider — and Build up with it — comes back to life. Neither control disappears when it cannot be used: a setting that vanished would look like one this tool does not have.

With Build up off, a stroke comes out the same however fast you drew it. Each pixel takes the mix once, so scrubbing back and forth over one spot does nothing after the first pass. Let go and stroke again to apply it a second time. That is what makes a mixing brush something you can aim; turn Build up on when you want the opposite, and dwelling in one place to darken it is the whole technique.

Speed is the rate that build-up adds at. Left is a slow wash you can stop anywhere; right is full strength on the first few pixels of movement. It starts a quarter of the way up.

The bucket

Click to flood. Four settings, each with a reason:

Tolerance is the largest per-channel difference a colour may have from the one you clicked and still be taken. The default is zero — an exact match — because flat colour with hard edges is the medium. Raise it for the antialiased edges that arrive with an imported PNG.

Only what it touches, turned off, replaces every matching colour on the layer at once. That is how one colour gets swapped out everywhere.

A selection confines it, exactly as it confines a paste. A marked-out region is you saying “this part and no other”.

Shift+bucket floods a hole rather than a colour — how a shape gets hollowed out in one click.

The fill is four-connected: two areas touching only at a corner are separate regions. That matches how the extruder finds islands, so a fill can never jump a diagonal hairline that the model treats as a wall.

Brush size and mirror symmetry are both ignored by the bucket. A fill is defined by the region it finds, not by a footprint.

The shape tool

U, and then four shapes to choose between:

ShapeGesture
Linedrag from one end to the other
Rectangledrag out a box
Ellipsedrag out the box it fits inside
Polygonclick each corner; click the first one again to close it

The polygon is the one that is not a single press. Corners accumulate as you click, Backspace takes the last one back, Enter closes the shape where it stands, and Esc throws the whole thing away.

Under the shapes are three ways to fill one:

Outlinethe boundary only, in the first colour
Filledthe whole shape, in the first colour
Filled + outlinefirst colour inside, second on the edge

That last one is why the shape tool holds both colours at once, and it is the common case for pixel art: a shape and its darker rim in one gesture. A line has no inside, so with a line in hand all three read the same and the card says so.

Keep it regular locks a rectangle to a square, an ellipse to a circle, and a line to the horizontal, the vertical or the diagonal.

The edge is the brush footprint the boundary is drawn with — the same Size and Shape controls the brush has, so a rectangle can have a four-pixel border. A Filled shape has no edge to thicken, and the card says so rather than leaving the slider live and answering to nothing.

Selection

DoGet
drag with the marqueea rectangular selection
the free-select toola freehand region; the loop closes itself when you let go
Ctrl+Athe whole of the layer’s contents
Ctrl+C / Ctrl+Xcopy / cut
Ctrl+Vpaste
Ctrl+Shift+Vpaste onto a new layer
Delempty what is selected

Both selection tools live in SELECT, at the left of the bar along the foot of the canvas, and while a selection is live every tool respects it. That is the point of making one.

The bar along the foot

Everything the canvas offers is in one band below the artwork, in groups with a word over each: SELECT, INSERT, CANVAS, LAYER, VIEW. Reading left to right is roughly the order of work — mark something out, bring something in, change the surface, change the layer, change the view — and the size and zoom sit at the far right.

Nothing is above the drawing and nothing is drawn on it, which is the point: the canvas is the whole of the pane except that band. Make the pane narrower and the bar wraps onto a second line rather than dropping anything.

INSERT’s two keys each have a small chevron on the end. The key itself does the ordinary thing — paste, or place a picture — and the chevron opens the other place it could land, which is a new layer of its own.

Take hold of what you selected

A finished selection is a selection. The pixels stay where they are; the marquee is a marked-out region, something to copy, to cut, to confine a fill to, or to pick up when you are ready.

Picking it up is Float — the first key on the little bar that appears beside whatever you have selected, or simply a press inside the box, which is the gesture most people try first. The block is then in flight: something you can drag, turn, scale and nudge, with grips around it and an arm above it.

This changed. Finishing a selection used to pick it up for you, with a switch to turn that off. Both are gone, and the reason is that it changed two things at once and said neither: what you had marked out, and what was in your hand. Now the marquee waits, and taking hold of it is a thing you do.

The bar that follows your selection

The moment anything is selected, seven keys appear beside it:

Floattake the pixels off the layer, into your hand
Copyinto the copy buffer
Cutinto the copy buffer, and off the layer
Turn left, Turn righta quarter turn each way
Dropland what is in your hand where it is
Clearput a float back, or take the marquee away

They sit above the selection when there is room and below it when there is not, they never cover the arm you turn it by, and they get out of the way while you are dragging. All seven are always there — the ones that do not apply are dim rather than missing, so the key you were reaching for never moves to somewhere else between one press and the next.

Picking pixels up changes nothing. The block in flight is a pending edit, not a hole: the pixels are still on their layer, the 3D view and the layer deck still show a whole drawing, and letting go costs you nothing. Only dropping it writes anything, and the move — pixels out of the old place, into the new one — is a single step of undo.

A cut is the one that does change the drawing straight away: the pixels leave the layer, land in the buffer, and the selection goes with them. One Ctrl+Z puts them back.

Cut works with something already in your hand, and it takes the thing you are holding. A floated block goes into the buffer as you see it — turned, resized, whatever you have done to it — and the place it was picked up from is emptied, which is the same region a cut of that selection would have taken. A paste in flight erases nothing when you cut it: those pixels were never on this layer, so there is no gap to leave behind.

A cut also puts the selection tool down, whichever of the two you were using. It is the end of the episode, the same way dropping a float is, so the next click on the artwork paints instead of starting another marquee.

Moving what is in flight

A paste, a placed picture and a floated selection all arrive in flight, and all of them are handled the same way.

DoGet
drag itmove it
drag a gripresize it — eight of them, corners and sides
drag the arm above itturn it to any angle; hold Shift for 15° steps
the two quarter-turn keysexactly 90°, left or right
arrow keysnudge a pixel, or eight with Shift
Enter, or a click off itdrop it where it is
Esccall it off — the pixels go back where they came from
Delempty the region instead of moving it

Turn it and turn it back and nothing has happened to your artwork. The angle and the size are kept beside the block rather than applied to it, and they are worked into the pixels once, when you drop. Fiddling with the arm for a minute costs the drawing nothing; a paint program that resampled on every frame of the drag would leave pixel art chewed and no way back but undo.

The quarter turns are the exception worth knowing: 90° is the only rotation that costs a pixel-art image nothing at all, and it is why they have keys of their own rather than being an angle you aim for.

A quarter-turned block also stays on the pixel grid. It lands exactly under the outline you are dragging, so you can push it flush against an edge of the canvas or line it up with artwork already there. Any other angle has to be resampled onto whole pixels however carefully you place it, so its edges land where the rounding puts them.

How it lands

The overwrite switch, behind the cog in CANVAS, decides what a drop does to what is already underneath it.

offonly the block’s own pixels land; empty space in it leaves what is under it alone
onthe whole region it covers is erased first, empty space included

It stays live while something is in flight, so you can change your mind about how a paste lands right up to the moment it does. On a turned or scaled block it erases the shape you can see, not the box around it.

Running off the edge

A block dropped partly outside the canvas is clipped: the part hanging over the edge is not written. If none of it lands at all, the status line says so.

Unless auto-grow is on, in which case the canvas is enlarged to hold it, up to 256×256. The switch is in the Canvas card of the Project pane, and it is the same one that lets a brush stroke run off the edge — placing something does not get a setting of its own. It is worth knowing that this is easy to trigger by turning: a quarter turn makes a wide block a tall one about its own middle, so a selection well inside the canvas can come out of the turn hanging off the bottom of it.

Only what would actually be painted counts. A turned block’s corners are empty and an overwrite’s gaps only erase, and neither is a reason to make the canvas bigger.

Growing upwards or leftwards moves the whole drawing, so the view pans to keep it still — and it moves the export pivot with it. That is why auto-grow is off unless you ask for it, and why a set of frames that has to line up wants a canvas sized once instead.

Clearing a layer

The clear key in LAYER takes everything off the current layer. The layers under it are untouched, and a selection makes no difference to it — it is the whole layer or nothing, which is what separates it from Del.

The two keys beside it belong to the same group and are about looking rather than drawing: solo shows this layer on its own, and the opacity key fades it so you can trace what is behind it. Neither changes the model. See Layers and depth.

Symmetry

There are four mirror axes, all behind one key in CANVAS — the one wearing a small picture of the axes themselves, which is lit for whichever are on: | vertical, - horizontal, and \ and / for the two diagonals. Click it and they appear in a panel over the canvas. Switch on any combination and every stroke is mirrored across all of them as you draw, which is how a face or a symmetrical prop gets made in a fraction of the passes. With all four on, one press of the brush lands in eight places — that is every reflection a square has, and no combination of these axes can produce more.

M steps through the useful settings without leaving the keyboard: off, one axis, two, all four, off again. Off clears them in one click.

The axes do not have to sit in the middle. The chevrons in that panel move one a cell at a time, so you can mirror around the centre line of a face that is not in the centre of the canvas; the centre key beside them puts them back.

Diagonals need a canvas whose sides differ by an even number. A diagonal reflection swaps the two distances, so it only lands on whole cells when both axes agree in parity — on any square canvas it always does. Where it cannot, the two keys are refused rather than dropped, and say so when you hover them. The alternative was a mirror half a pixel out, which puts a visible seam down the middle of a drawing.

The bucket ignores symmetry, and so does the glyph stamp — a mirrored letter would read backwards. The generator mirrors, but grows a fresh item at each reflection rather than copying one, because grass that mirrors exactly reads as obviously duplicated.

Undo

Ctrl+Z and Ctrl+Shift+Z.

One stroke is one step, from the button going down to it coming up — not one step per pixel. One bucket click is one step. A click that changes nothing records nothing, so undo never spends a press on a stroke that did not do anything.

The Project pane shows how much undo history is being held, and roughly how many more strokes there is room for at this canvas size.

Moving around the canvas

DoGet
middle-drag, or Space+dragpan
wheel, or two fingerszoom, anchored on the cursor
Shift+wheelpan — the trackpad gesture
two fingers sidewayspan left and right
Ctrl+wheelresize whatever mark you are holding

That last one is one gesture for three different settings: the brush’s footprint, the glyph stamp’s ink height and the generator’s item height. Whichever tool is in hand, the wheel sizes its mark.

If zoom or pan goes the wrong way for your trackpad, reverse it in Settings. Which way is “right” depends on your OS’s natural-scrolling setting, which the app has no way to read.

Canvas size

The Project pane has the canvas size: presets from 16 to 256, width and height sliders, a ratio lock, and a 3×3 anchor pad that says where the existing artwork sits when the canvas grows or shrinks. Nothing happens until you press Apply, and Revert puts the sliders back to the size you actually have.

Auto-grow when drawing off the edge does what it says — the canvas expands to meet a stroke that runs past its border, up to 256×256.

Stamps and growers

Three tools put something into the canvas rather than dragging colour across it: the texture brush works a picture into pixels that already exist, the glyph stamp presses a character from any font on your machine, and the generator grows an item — a blade of grass, a rock, a mushroom — from a handful of colours and a seed.

They sit together because they share the same shape: you choose a source, you choose a size, and then a click puts one down.

The texture brush

N. It works a texture into pixels that already exist — grain on wood, noise on stone, dirt on metal.

A stamp can recolour a pixel that is already there and can do nothing else. This brush never creates one. That is what separates it from the two below, which both make new silhouette, and it is why it is the tool you reach for when a shape is finished and wants surface.

Its settings are the texture strip, Size, Shape, Scale — how far the pattern is magnified before it is sampled, in whole steps, so its grain can be coarser than one canvas pixel — and the same mixing card the brush has.

One difference from the brush: here Intensity stays live in every mode, Normal included. The texture brush lays a picture over pixels that are already there, so how much of it shows through means something even when the mode is a straight replacement.

The strip in the card is the textures you have reached for lately, not the whole library — paint with one and it leads the row next time. Add… brings a picture in, cropping and sizing it on the way; Manage… opens the Media pane, where everything you have imported can be tagged, searched and filtered. Right-click a thumbnail to take it off the strip.

Textures are capped at 512 pixels on their long edge on the way in — see Bringing in a picture.

The glyph stamp

T. Pick a font from anywhere on your machine, pick a character, and click to press it into the canvas as pixels.

It becomes artwork immediately — there is no text layer and nothing to re-edit afterwards, which is also why a drawing made this way opens the same on a machine that has never had the font.

Size is the height of the letter’s own ink, in canvas pixels — not a typographic point size. Ask for 32 and you get 32 pixels of visible letter, up to the canvas’s own height. [ and ] move it, and so does Ctrl+wheel. Fit to canvas grows the letter until it fills the canvas without spilling over an edge; a wide letter gives up some height to keep its width inside.

Weight thickens or thins the letterform, in five steps: from only the pixels the letter fills completely, through thinner than the font draws it and as the font draws it, out to every pixel it touches at all. It is the control that makes small letters legible — most fonts need thickening below about twelve pixels.

Weight is a threshold, and that is correctness rather than taste. A letter rendered with soft edges would put half-transparent pixels into your artwork, and a single translucent texel puts the whole exported model onto glTF’s blending path — which costs every model the sorting artifacts of a transparent surface. Cutting the coverage keeps the artwork one-bit, and turns the constraint into the control pixel-art letterforms actually want.

Browse glyphs… opens the Glyphs pane: the whole font, in a grid. Nine categories narrow it — All, A–Z, 0–9, Punctuation, Arrows, Maths, Blocks, Shapes, Pictures — and a field at the top reaches anything they do not offer: type a codepoint like U+2603, or paste the character itself, and press Enter to put it in the stamp’s hand.

Blocks is worth knowing about — alongside box-drawing it holds all 256 braille patterns, which are the best source of dither texture at this scale.

The pane’s own toolbar picks the font, filters the list by name, and has a Rescan for a font installed since the app last read the list. The list is otherwise ready the moment you open it: it is read once and kept, so the several seconds it takes on a cold machine is paid once rather than every launch.

My glyphs

The characters you stamp stay on a shelf in the tool panel, so using one again never means opening the browser. Each keeps the font it came from, and clicking one brings that font back with it — a star picked from a symbol face is still that star a week later, not whatever the font you have open now happens to carry at the same codepoint.

The list holds still. New entries are appended and nothing already there moves, there is no cap, and the strip wraps rather than scrolling. It used to be a list of recents and behaved like one — using an entry hoisted it to the front and shunted the rest along, so a set of favourites rearranged itself every time it was used. Remove, in the card’s heading, takes the glyph in hand off the shelf and leaves it in your hand.

Switching fonts leaves you with nothing selected. The same codepoint is a different drawing in a different font, so carrying your choice across would not be keeping it.

Two limits. Colour emoji fonts cannot be stamped — they hold pictures rather than outlines, so there is nothing to scale — and are left out of the font list entirely; monochrome emoji faces work normally. And the stamp ignores mirror symmetry, because a mirrored letter would read backwards.

The generator

K. Click to grow one item; drag to sow a handful along the path.

This is the tool that decides what the mark is. Your hand says where and how big; the grower says the rest, from a seed. Six of them ship:

GrowerGrows
Grass bladea single blade, leaning and curling
Toon grassa clump — tufts, blade characters, seedheads
Rocka stone silhouette
Toon rocka boulder with cracks, character and moss
Toon mushrooma cap with gills, a lip, a ring and a stalk
Celestial bodya planet, with craters, rivers, oceans and air

Pick one from the grid of keys at the top of the card. Under it is the nursery — a preview of the exact item currently in hand, at the size it will be stamped.

ControlDoes
Keep the same itemoff, every stamp is a fresh roll of the dice; on, the item in the nursery is the one you get, again and again
Re-rollone new item now
Heighthow tall the item stands, in canvas pixels. [ and ], or Ctrl+wheel

Below those, the controls belong to whichever grower you picked, in groups — Shape, Growth, Detail, Toon, Sky and Sowing, according to what that grower actually has. A blade of grass has Lean, Curl and Sway where a planet has Surface and Sky; the card only ever shows the ones that mean something.

Sowing is shared by all six: Spacing is how far apart items land along a drag, and Scatter is how far each may stray from the line you drew. A drag with scatter at zero is a hedge; wound up, it is a meadow.

The colour shelf

The Colours card is the palette the item grows from, bottom of the item first. It starts empty, and an empty shelf means the colour in hand is used — which is the sensible default, and the reason the tool works before you have touched it.

Add the colour in hand puts your current colour on the shelf; Custom… opens the wheel for one that is not in your hand. Two or three colours is what a grass blade wants: a dark base, a lighter body, a pale tip.

The shelf belongs to the grower, not to the project. Your greens are still on the grass when you open a new drawing tomorrow — what a project records is the artwork, and by then the colours are in the artwork.

The generator is the one mark that refuses to grow the canvas. A sow stamps along a path, and a canvas that grew mid-drag would shift every position the walk has not reached yet. Draw inside the edges, or resize the canvas first.

It mirrors, unlike the glyph stamp — but it grows a fresh item at each reflection rather than copying one. Grass that mirrors exactly reads as obviously duplicated, which is the opposite of what symmetry is for here.

Colour

Two colours, always

You hold two colours ready rather than one, because that is how pixel art is actually drawn: a fill and its outline, a light and its shade, swapped between hundreds of times a sitting.

The colours you paint with are yours, not the palette’s. A palette is a saved set — somewhere to keep colours you want back — and nothing about it limits what you can paint with. Pick any colour you like from the wheel, take one off the canvas with the eyedropper, or type a hex code: none of that has to be in a palette first, and none of it changes one.

Switching palettes leaves the colours in your hands exactly where they were.

SlotPainted byMarked in the grid with
primaryleft buttona full ring
secondaryCtrl + lefta wedge in the swatch’s corner

One rule, everywhere: Ctrl means the other colour. Ctrl+click a swatch to set the secondary, Ctrl+drag to paint with it, Ctrl+Alt+click to eyedropper into it.

X swaps the pair, as does the <> button between the two rows.

Those three modifiers are what the app ships with rather than what it is stuck with: the second colour, the eyedropper and erasing are all listed in the Keys pane, and changing one there changes it everywhere at once — including the hints the interface draws for it.

A swatch in the grid lights up when it happens to hold the colour you are on. If two swatches are the same colour, both light up — they are the same colour.

Shift beats Ctrl. Erasing is the destructive one, so if both are held by accident, the reading that destroys least is the one taken.

The colour is settled when the button goes down and held for the whole drag. Letting go of a modifier mid-stroke does not change what the rest of it lays down.

The colour wheel

Click either colour chip in the Palette pane’s Pick tab and the wheel opens next to it: hue round the disc, saturation from the middle outwards, and the two bars below for how light and how solid.

ControlDoes
the dischue and saturation together, in one movement
Lightblack through to the full colour
Alphahow solid — all the way down is the eraser
the hex fieldtype #RRGGBB or #RRGGBBAA when you already know the colour

The two small squares beside the hex field are the colour you opened on and the colour you have now, so you can judge a change against where it started.

It paints as you drag. The colour goes into your hand on every frame the wheel is open, so you are choosing against your actual artwork rather than against a preview. Cancel, Esc or a click outside puts back what you started with.

It opens beside the chip you clicked rather than in the middle of the screen, and it does not dim the workspace behind it — you are meant to be able to see what you are choosing for.

Picking colours off the canvas

DoGet
S, or the right button over the canvasthe Swiss Army Knife, with the swatches in it
Alt+clickeyedropper into the primary
Ctrl+Alt+clickeyedropper into the secondary

Hold Alt and the cursor turns into an eye. That is the whole announcement: the square that normally shows where your brush will land goes faint, shrinks to the single pixel it is about to sample, and an eye appears in it. Add Ctrl and a wedge appears in the corner — the same wedge the grid uses for the second colour — so you can see which slot the pick is aimed at before you commit to it.

At low zoom the eye sits beside the cursor rather than on it. The pixel you are aiming at is one or two pixels wide there, and a glyph sitting on top of it would cover the very thing you are trying to look at.

It samples the topmost visible pixel that has something in it, so what you get is what you see. Alt-clicking empty space does nothing — a misclick off the artwork must not silently hand you the eraser.

Picking a colour changes nothing but the colour in your hand. Your palette is not added to, not reordered and not saved over. If you want the colour you just picked to stay, put it in a palette yourself with the + in the Manage tab’s colour editor.

To reach the eraser, click the eraser swatch under the two colours, or hold Shift while you draw.

Your palette library

You can keep as many palettes as you like. Each is a small readable file in ~/.config/flatty/palettes/, so they follow you across every project with no import step and you can copy one out and mail it without exporting anything. See Your libraries for how they are found, tagged and filtered — the Manage tab carries the same filter bar the Media pane does.

Flatty comes with 87 palettes, and a fresh library is given ten of them — enough to paint anything, few enough to read down. They are ordinary palettes from the moment they arrive: rename one, edit it, export it, delete it. The rest are one click away, in the palette browser below.

In the Manage tabWhat it does
Newa palette from scratch: black and white, ready to edit
Import…read a .gpl, .pal, .hex, .txt or Adobe .ase file into your library
Copyduplicate the selected one, so the original stays as it was
Install…browse the palettes that come with Flatty and keep the ones you want
Usepaint with this palette from now on. It reads In use when you already are
Export…write it back out as .gpl, .pal, .hex or .txt
Restoreput a palette that came with Flatty back the way it shipped, on a second click. It reads Update when a newer version has arrived with a new release, and is greyed out for a palette you made yourself — there is nothing to go back to
Deleteremove it, on a second click
Tag… / Untag…file it, so the filter above finds it again — see Your libraries

Each palette carries a Name, an About and an Author, editable in place. These are not decoration — the file formats palettes travel in already carry them, and dropping them on import is what turns a library into a list of filenames.

Under those is Show in the Swiss Army Knife, which puts this palette in the knife’s Palettes card so you can change to it without leaving the canvas. The ten you start with are already in it, so the knife works on the first day; anything you add later is off until you say so — see switching palettes from the knife.

The palettes that come with Flatty

Install… in the Manage tab opens the shelf. Eighty-seven palettes, filed under six headings — celestial, figures, machines, painters, places and techniques — with the ones you already have marked.

Each card shows the palette’s name, what it is filed under, how many colours it holds, and all of them, laid out at the width its author chose. That width matters more than it sounds: these palettes are arranged as ramps — a dark step to a light one — and shown at the right width each row is a ramp. Hover a card for a sentence about what the palette is for.

Narrowing it down:

  • The All / Not installed / Installed switch. Not installed is the useful one once you have been through a few.
  • The category chips. Click one to see only that heading, click it again to come back.
  • The search field, which matches on the name as you type.

Press Install and the palette joins your library. Nothing else changes — the colours in your hand stay exactly as they were, so you can browse mid-drawing without losing your place. A palette you already have reads Installed and cannot be pressed; one you have edited offers Restore; and one we have shipped a newer version of offers Update.

Escape closes the browser, and so does a click outside it.

They are yours once they are here

An installed palette is not on loan. Rename it, rearrange it, throw half the colours away — it is a file in your folder like any other, and Flatty will not change it under you.

What it does remember is where it came from, and that is what Restore is for: however far you have taken a palette, the original is still in the program and one press brings it back. It is also how a new release reaches you — if a palette you have is improved in a later version, its button says Update rather than Restore, and the choice stays yours.

Editing colours

Select a swatch and the editor below gives you a hex field, R/G/B/A sliders, and < > + − to arrange, add and remove. The + adds a copy of the selected colour, so building a ramp is add-and-nudge. A palette will not go below one colour — delete the palette instead.

Order is meaningful — a ramp read out of order is not a ramp — so rearranging counts as an edit.

Which swatch you are editing is a separate thing from which colour you are painting with. Picking a colour off a ramp does not move the editor, and editing a ramp does not change your brush. The one exception is when they are the same colour: then the change follows into your hand, as you would expect.

Transparency, and the two kinds of it

This distinction matters more here than in a normal pixel editor, because transparency decides whether geometry exists.

Fully transparent is absence. A transparent pixel is not part of the model at all — not a hollow, not a hidden face, simply not there. The eraser is simply a fully transparent colour in your hand; nothing is added to your palette when you reach for it, and your palette keeps the colours its author chose.

Partial alpha is a real colour. The hex field takes #RRGGBBAA and the A slider adjusts it. A texel with partial alpha is still solid geometry wearing a translucent texture — glass, water and smoke are authored that way.

What the export does about it. glTF’s default alphaMode is OPAQUE, under which renderers are told to ignore the alpha channel and draw every texel solid. So Flatty declares it: if any texel in the atlas is translucent, the material is written as alphaMode: "BLEND". Only if — blanket blending would cost every model the sorting artifacts of a transparent surface, including the majority that have nothing translucent in them.

The cost is inherent to the effect rather than to this app. Correct blending needs back-to-front sorting, and most renderers do that per object — so a translucent model can show its own far faces through its near ones, in the wrong order.

A palette that does contain a fully transparent swatch — some imported ones do — keeps it, and picking it is the same as reaching for the eraser, because it is the same thing.

Side-wall colour

The sides of the extrusion are not painted by you. They are derived from the front face: the Project pane’s Side walls → Shade slider multiplies the front pixel’s colour, so a lower value gives darker sides.

That is what stops a model reading as a sticker, and it costs nothing to maintain — repaint the front and the sides follow.

Where derived is not what you want, rim paint in a 3D pane is the override: click a side wall and it takes the colour in your hand. See The 3D view.

Layers and depth

This is the chapter that makes shapes stop looking like slabs.

Depth belongs to a layer, not a pixel

You cannot give one pixel a different thickness from the pixel beside it. What you can do is put them on different layers and give each layer its own depth.

A face, a nose, a pair of eyes: three layers, three depths, and you have relief without ever leaving the 2D grid.

Every layer carries two numbers, both at the top of the Outliner:

What it means
Depthhow thick the layer’s slab is
Z offsetwhere that slab’s centre sits along the depth axis

Both are whole pixel counts and their sliders snap to whole steps, mid-drag included.

Any slider can be typed into — click the number and enter a value. And Shift slows a drag to a quarter rate, which is what makes a 129-step range usable in a panel a hundred pixels wide.

The Outliner

The layer list, and the layer you are on. Add, remove, rename, toggle visibility, solo a layer to work on it alone, and move one forward or back with ^ and v. The readout at the head of its list says how many layers there are and how many separate islands of artwork they add up to.

Layer order decides which layer wins where two slabs contest the same depth, and the 2D blend order. It is not the same thing as where a layer sits in space — that is Z offset.

Hiding a layer, and soloing one

Each row carries a tick and a solo dot, and they are two different questions. The tick is is this layer part of the drawing; the dot is am I looking at this one on its own for a minute.

Untick a layer and it leaves the drawing — the whole of it. The canvas, the deck, the 3D view, the line art, a recording and every file you export are built from the layers that are ticked, so putting one away and pressing Export gives you a model without it.

Reaches
the tickeverything: the 2D canvas, the layer deck, the 3D view, the line art, recordings, and every file that comes out
the solo doteverything you look at, and the pictures taken of it — but never the .glb, the .bbmodel, the .obj or the .stl

Solo stops short of a model file because it is not saved with the project. It is a lens you flick on and off a dozen times an hour, so a file built through it would come out differently tomorrow from the same drawing, and nothing in the drawing would say why. Hiding is saved: put a layer away, close the project, and it is still away when you open it next year — which is exactly why it can be trusted to travel into an export.

Hiding a layer is not an edit. Put one away to see what is behind it, make a stroke, then press Ctrl+Z, and it is the stroke that goes. Undo steps back through the drawing you made, never through the way you happened to be looking at it.

Seeing through a layer

Opacity fades a layer on the canvas, and it is how you draw one shape over another: turn the layer in front down to a third and trace the thing behind it.

It lives on the bar along the foot of the 2D canvas, in the LAYER group — the key beside solo and clear. Click it and a small panel with one slider opens above it. The key stays lit for as long as the layer you are on is faded, so a layer you turned right down last week cannot quietly stay that way.

It reaches the canvas and nothing else. Not the 3D view, not the deck, not the line art, not a model file — a layer faded to a whisper is still a solid block in the model, at every value including nothing at all. The one picture that follows it is the artwork PNG, and only because that file is the canvas written out.

It used to be a slider in the Outliner, sitting between Depth and Z offset — which are geometry — so it read as a third piece of geometry, and people reasonably expected a faded layer to come out faint. It never did. Moving it to the surface it actually affects was the fix; there was nothing to be gained from a note underneath explaining that two neighbouring sliders meant something else.

It no longer dims cards in the layer deck either. The deck has its own way of getting the sheets in front of you out of the way, and the two were fighting: a faded layer came out fainter than the card standing in front of it, so the one you had asked to look at was the hardest to see.

^ and v move a layer through the model

They step the active layer one place through the front-to-back order, and what that costs depends on what it is stepping past:

The layer it passes isAnd ^
at a different depthtrades places with it along the depth axis — the layer genuinely moves in space
in the same planeswaps their places in the list, which is what decides who wins a contested range

Step a layer one way and then the other and it is exactly where it started. The two layers exchange their positions rather than being recomputed, so nothing drifts however long you spend nudging a stack into order. What that gives up is the span the pair covered: two slabs of different thicknesses cannot both keep their thickness and still fill the same run, so the gap between them is kept and the outer edge moves. With equal depths — which is every layer in a fresh document — nothing moves but the two layers.

A thin slab that was buried inside a thicker one is lifted clear rather than swapped, because trading centres would leave it swallowed exactly as it was.

The status bar says already at the front or already at the back rather than doing nothing quietly.

Pack the layers back to back

Pack layers, the last key on the Outliner’s toolbar, gives every layer a Z offset so the slabs touch, centred on zero. It is the fastest way from “four layers all at zero” to something with front-to-back structure, and it is refused with a reason when there is only one layer and therefore no gaps to close.

Hidden layers take part, and that is not an oversight. Packing decides where each slab sits, which is a question a layer still has an answer to while it is put away — skip it and you leave a gap with nothing in it, waiting to be wrong the moment you tick the layer back on.

Several layers at once

Layers have a selection of their own, and the active layer is always part of it.

DoGet
Ctrl+click a rowadd that layer to the selection, or take it out
Shift+click a roweverything from the active layer up to that one
the select-all key in the Outlinerevery layer; click it again for just the active one

With two or more selected, Squash flattens them into one. Where two of them have a pixel in the same cell the one further forward in the model wins — the same rule the 2D canvas blends by, so squashing cannot change the picture. The result keeps the lowest layer’s name and depth.

It flattens the layers you can see, and leaves the rest alone. A layer you have unticked takes no part and survives untouched, so squashing three layers with one hidden leaves you two rather than one. Both halves matter: flattening a layer you had put away would bring back artwork you had put away, and leaving it out of the flatten while still removing it would be worse than either — that is artwork destroyed rather than resurrected.

Two things deliberately do not count. A faded layer lands at full strength, because opacity is a way of looking at the drawing and baking it into pixels makes that permanent. And soloing changes nothing, because it is a lens you toggle constantly, and losing a layer over how you happened to be looking at the stack would be a loss with no gesture behind it.

Squash is refused rather than hidden, and says which of the two it is: fewer than two layers picked, or fewer than two of the picked ones showing.

Delete, with the Outliner focused, removes the layers you have selected.

Flextrude

F. Paint over the drawing to mark cells out, then raise what you painted into a slab of its own, in front of everything.

It is the odd one out among the tools — it lays no colour down at all, and it reads the whole stack rather than the layer you are on. What it makes is not a mark but a layer, which is why it lives on this page.

The wash you paint is not a selection: nothing lifts, nothing moves, and the cells stay exactly where they are until you ask for the raise.

ControlDoes
Size / Shapethe brush you mark with, the same pair the brush itself has
Depthhow far the painted pixels are raised, in canvas pixels
Instant punchon, a stroke raises itself the moment you let go; off, paint as much as you like and then press Raise
Raiselift the painted cells into a slab of their own
Clearunpaint every cell, leaving the drawing exactly as it is

Only cells the canvas actually draws can be marked, and the refusal is in the brush rather than in the button — so the wash you can see is exactly what Raise will act on.

Raise repeatedly and the new slabs abut rather than drifting: each one is placed against the back of the last, on whole pixels.

The layer deck

The deck shows your layers as cards floating in 3D, sorted by their actual position. It is the view where “which layer is in front of which” stops being an abstraction.

Order in the deck is position; order in the Outliner is priority. Keeping those apart is what makes the deck honest:

What it isWhere you change itWhat it affects
Z offsetwhere the layer sits in the volumethe deck’s Move mode, the Outliner’s slider, or ^ / v past a layer at another depththe geometry
Layer orderwhich layer wins^ / v past a layer in the same planewho owns a contested range, and 2D blend order

The Outliner’s two arrows reach both, which is the point of them: they mean “move this forward” and let the document work out whether that is a matter of space or of priority.

Cards are sorted by actual z, and ties break by layer order — the mesher’s own rule, so the fan is never a fiction.

Three modes

The deck has modes rather than modifiers, because the left button has four plausible meanings here.

ModeLeft buttonShift+leftRight button
Lookdrag orbits · click selects——
Paintpaint the active carderaseorbit
Movedrag a card along z—orbit

In Paint mode the active card owns the pointer wherever it lies under it, so you can aim at the layer at the back of a stack through the artwork of a nearer one. Switching layers lives in Look mode. Flextrude is the one tool the deck refuses — what it makes is a new layer, and a deck of cards is not where you ask for one.

Seeing the card you picked

Cards you are not working on are drawn faint, and a card standing between you and the one you picked is fainter still. Choose the layer at the back of the deck and the sheets in front of it step aside far enough that you can read it — no need to solo, which used to be the only way through.

They do not vanish, and that is on purpose: their silhouettes are most of the reason to use this pane at all. Orbit round to the other side of the deck and the roles swap, because which cards are in the way depends on where you are standing.

Push the camera in and cards dissolve as you reach them, one plane at a time, until the layer you are painting is the only thing left. Close up a half-visible neighbour is the worst of both — too faint to be context, still enough to tint the pixel you are judging.

True Z, spread and labels

True Z shows the cards at their real spacing. Turn it off and the spread slider opens the gaps so every card is visible and clickable — the same order, pulled apart. It is a zoom along z, not a re-sort.

Layers that share a plane fan apart by a hairline, so a tie is visible rather than one card hiding another. When there are ties, a Pack layers key appears on the deck’s own bar and says how many layers share an offset — the same key the Outliner has, offered where you noticed the problem.

Labels puts each card’s name beside it, and Frame points the camera back at the whole deck.

Which way the layers run

Every project reads its layers one of two ways, and the choice is a switch in two places: Layers bottom to top on the Project pane’s World placement card, and the stepped-block key along the bottom of the 3D view. They are the same setting; use whichever pane is open.

The canvas isA layer’s Z offset moves itThe model
off — back to frontthe front viewtowards youstands up, extruded out of the page
on — bottom to topthe top view, a planupwardlies on the ground, a stack of slices

Nothing about the drawing changes, and neither does the order the layers sit in. What changes is which view of the model your canvas turns out to be. Back to front, the layer that reaches furthest forward is the one nearest you; bottom to top, that same layer is the highest slice. Draw a pyramid as concentric squares on layers at rising offsets and turn it on. Draw terrain as contours.

The 3D view is the only place the difference can be seen, which is why the key lives there: the canvas looks identical either way, and that is the point of the feature rather than a limitation of it.

Bottom-centre is the one pivot the switch moves. It is a promise about the world — the model’s base lands where you place it — so bottom to top it rests the lowest slice on the ground instead of the bottom edge of the canvas. Center and Top left describe the canvas and mean the same cell whichever way the model is built. See Exporting.

The setting is saved with the project and travels into every export, and one Ctrl+Z takes it back.

What the mesher does with all this

Worth knowing, because it explains why some things are impossible and others are free.

Layers are never meshed separately. For each column of the canvas, the slab of every layer taking part is collected and resolved into one list of non-overlapping spans, with upper layers winning any contested range. Front and back caps come from the ends of each run; side walls are the parts of a span the neighbouring column does not cover.

This means coincident and buried faces cannot be generated, because nothing ever emits them. Two layers whose planes touch exactly will not z-fight.

Faces then merge greedily into the largest rectangles they can. A solid 8×8 block is six quads. A 32×32 cloud is about 130.

One consequence to know about: the side colour is per column, shared by all four of that column’s walls. Rim-painting the top wall of a pixel also paints its side walls. On a straight run you never notice, because the other walls face away. On a staircase, where one pixel shows two walls at once, you do. It is a deliberate trade — one click colours a whole step instead of four.

The 3D view

The 3D pane shows the model your drawing makes, rebuilt as you paint. You are never waiting for a preview and there is no button to press to update it.

A note about the pictures in this book. They mostly show the model as Lam::pula on a Delicate ground, because it photographs well. A fresh install opens on Flatty over that same Delicate grid — your own colours, on a floor that holds still — and every other look is one click away on the chips along the bottom of the pane. This section shows each of them on its own.

Moving the camera

DoGet
left-dragorbit
wheeldolly in and out
middle-dragpan
Shift+wheelpan
Space+dragpan

The angle you settle on is the one the Recorder starts a turntable from, so this is where a recording gets framed.

Nothing stops you going under the ground. Orbit down past the horizon and the grid stays where it is, seen from below, drawn over the model instead of behind it — which is what you want when you are checking the underside of something.

The readout along the bottom tells you where you are. Three faint marks, each with its number: a swung arrow for the turn left and right, the same arrow on its side for the tilt up and down, and a measuring mark for how far away you are. Hover one and it tells you which is which.

Everything the pane offers sits on that one line — the camera preset, the ground, how the model is shaded, then five square keys for the orb, Recenter, Rim paint, which way the layers run, and the camera, then the readout and the reminder about panning. Squeeze the pane narrow and the line drops whatever no longer fits, the hint first and the readout next. Widen it and it comes back; nothing is lost, it is only out of room.

Fixed angles

The first chip in the corner reads Free orbit by default. Click it and you can lock the camera to a preset:

Front · Back · Left · Right · Top · Isometric

Use these to check a silhouette. A free orbit drifts, and a shape that looks right from a slightly-off angle can be wrong from straight on.

A fixed angle is a decision, so it is one of the few pieces of camera state that a saved layout remembers. Where a free orbit happens to be pointing is not.

Recenter — the key with the corner brackets closing on a dot — puts the camera back on the model and frames it. It is the one you want after resizing the canvas or moving a layer a long way.

The last of the four keys is a camera: it writes a picture of this view, the model alone with no ground under it. It is the same thing the Export pane’s 3D view card does, on the pane you lined the shot up in. See Exporting.

The ground

The second chip along chooses what the pane draws under the model. There are six, and the same choice applies to every 3D pane you have open — it describes how you like to see your work rather than what one pane is for, so two views of the same model never disagree about it.

GroundWhat you get
No gridthe model, floating, and nothing else
Delicatea soft, still grid — quiet enough to look at artwork over. The default
Retro-futurean animated grid with a neon glow, drifting slowly away from you
Retro surfacethe same grid on a solid floor cut into facets — a low-poly landscape rather than lines on nothing
Mistdrifting banks of fog around the model’s feet
Smokea churning column of volumetric smoke rising around it

Retro surface is the one to raise the Wave on. On the grid styles the swell is only drawn into the lines; here the floor genuinely has a shape. Hills stand between you and the model, the horizon stops being a straight line, and the facets catch the light at different angles as they roll past.

The last two are not grids at all, and they are in the same list for a good reason: they answer the same question — what is under the model — so making them a second setting would let the two fight over the scene.

Every one of them is tuned in the Shaders pane — its colour, its brightness, how fast it drifts, how much it undulates. The chip picks the style; the Shaders pane is where its numbers live. The Settings pane carries the same style chooser, for the times you are already there.

Nothing dials down to invisible. No grid already does that, and a grid you cannot quite see is indistinguishable from one that is broken.

How the model is shaded

The chip after the ground is a different question: not what is under the model, but how the model itself is drawn. Like the ground, it applies to every 3D pane at once. The layer deck does not offer it — a deck of cards is not the extruded model.

ModeWhat you get
Flattyyour colours, exactly as you painted them, with no lighting at all. The default, and what an export contains
Marshmallowpastel and soft-lit, with the hard edges of the extrusion rounded off
Golden Claudeevery pixel a small brick of lit glass, the artwork read as brightness rather than colour
Lam::pulathe model as one piece of tinted glass, lit from behind by coloured lamps

Flatty is the one to trust. Nothing whatever is done to the colours — no shader of ours even runs — which is why it is what you open in and what you should come back to before deciding a shade is wrong.

None of the other three changes your model or your export. They are ways of seeing your work, not ways of altering it, and switching between them costs nothing and loses nothing.

Marshmallow

It softens the colours towards pastel, lights the model as though the light were passing through it rather than bouncing off, and glows a little at the edges, so a stack of square-cornered slabs reads as something soft.

Golden Claude

The opposite decision. Where Marshmallow hides that the model is a heap of boxes, this makes the boxes the subject: every pixel becomes a small brick, cut like glass and lit from inside, and the lattice you can see is the real one your drawing describes.

Your colours do not survive it, and that is the mode rather than a limitation — the artwork is read as brightness, and all the colour comes from the light. A pale pixel is a bright brick.

Lam::pula

Glass again, but the whole model as one piece of it rather than a heap. Your own colours stay, with their vibrance raised, and the model is made translucent and lit by coloured lamps that shine through it from behind. The bricks are still there — they are what catches a ray at a corner.

Tuning a shader

The Shaders pane opens up the numbers inside the app’s own shaders, where they have been lifted out.

At the top is which shader you are editing, grouped by what it is for:

GroupHolds
3D modelLam::pula, Golden Claude, Marshmallow
Scenethe Delicate grid, Retro-future, Retro surface, Mist and Volumetric smoke
Interfacethe lit panels behind the workspace chips, and every repeating surface — the checkerboard, the pixel grid, the pane grips

Below that, that shader’s controls, in groups of their own. For Lam::pula they are Material, Lamps, Orbit, Light, Reflection and Sparks; for Retro-future the glow colour, the brightness, the drift and the wave.

Everything is live: drag a slider and the 3D panes change under you.

Reset to defaults puts every value back to what the shader ships with, and you can reach for it freely — only the values you have actually moved are remembered, so a shader you have never touched is not pinned to the numbers this version of the app happened to have.

A shader whose values are still compiled in says so, plainly, rather than offering an empty pane.

The orientation orb

The first of the five square keys shows and hides a small ball in the pane’s top right corner. It tells you which way you are facing.

On itWhat it shows
three coloured armsthe axes — pink for X, green for Y, cyan for Z. Only the positive end of each carries a dot, so you can tell which way round you are
a dimmed armthat axis pointing away from you, on the far side of the ball
a ringthe ground plane. It opens into a wide ellipse as you climb above the model, and closes to a straight line when you are level with it

The ring is the part worth watching. Long before you have read an arm, its shape has told you how high up you are — and it flattens as you approach eye level, which is exactly when a silhouette is worth checking.

It sits in a fixed corner rather than out in the scene, and that is the whole improvement over the coloured lines it replaced. Those lived at the model’s origin, so they were covered by the model, grew and shrank as you zoomed, and slid off the edge as soon as you panned. A model built away from the origin left them somewhere off in the distance answering a question nobody had asked.

Unlike the ground and the shading, this one is per pane. One view can keep its bearings while another gives you a clean look at the model.

Rim paint

Rim paint is the third of the five keys — a small extruded box with its side walls filled in, which is exactly what it colours. While it is on, the left button paints side-wall colours instead of orbiting; orbiting moves to the right button, and the line beside the key spells that out on little keycaps for as long as the mode is on.

DoGet
left-click a wallpaint it the primary colour
Ctrl+clickpaint it the secondary
Shift+clickback to the derived shade

Side walls are normally derived from the front face by the Project pane’s Shade slider. Rim paint is the override for the places where derived is not what you want — the lit top edge of a platform, a worn metal rim.

A rim colour never outlives its pixel. Erase the pixel and the override goes with it, so a colour cannot come back to haunt a cell you paint into months later.

And remember that the side colour is per column, shared by all four walls of that column. Painting the top wall of a pixel also paints its sides. See Layers and depth.

Turning the model on its side

The fourth key — a stepped block — reads the layers bottom to top: each layer becomes a slice stacked upward, and the canvas becomes a plan of them seen from above. Lit, the model lies on the ground; unlit, it stands up out of the page as it always has. The Project pane’s World placement card has the same switch, and this one is here because the 3D view is the only place the difference shows.

It changes the project, not the view — the export follows it, and so does undo — and it is the last thing a narrow pane keeps before the camera key, since the Project pane offers it too. Everything about what it does to your layers is in Layers and depth.

Reading the status bar

Two readouts can be switched on in Settings, under Debug, and both draw on the status bar:

2 islands · 132 quads · 264 tris        62 fps

Islands are separately connected pieces of artwork. Quads are the merged rectangles the mesher produced — this is the number to watch if you care about draw cost, and it is usually far smaller than you would guess, because a solid region merges into a handful of large faces.

The frame rate is an average over the last thirty frames drawn. The app rests between them when nothing is changing, so this is not the display’s rate and a low number on a still screen is the app saving your battery rather than struggling.

Line art

The same model, traced as line art and written as an .svg. It is a real vector file — paths and fills, no pixels — so it scales to a poster, opens in Inkscape or Illustrator, and goes on a page beside your artwork.

Point any pane’s title at Vector and it draws whatever your 3D view is looking at. Orbit the model and the line art follows.

The preview and the file are the same drawing. There is no separate “export settings” screen and nothing to reconcile: what the pane shows is what Export line art writes, so you tune it by looking at it. What you change is remembered, so the pane opens where you left it.

Six ways to draw it

The select at the top of the pane picks the algorithm, and they are genuinely different drawings rather than filters over one.

Outline

Flat shapes with a line where the surface turns. The plain one, and the one to start from.

Cells

Every painted pixel as its own square. Far more detail — and a much larger file, because a face that Outline draws as one shape is here as many shapes as it has pixels.

Hatched

Ruled shading, denser where a face turns away from the light. Angle, Spacing and Contrast are its three controls; the pictures in this book use 45°, a spacing of about a third of a cell, and the contrast well up.

Newsprint

Halftone dots on one screen — the newspaper press. Screen is how far apart the dots sit, Angle which way the rows run, and Gain fattens or thins the mid-tones while leaving white paper white and solid ink solid.

Ink Wash

Softened contours and pooling washes, loaded out of the box: Softness and Bleed open part-way up, because a renderer called Ink Wash that showed you the outline drawing would read as a setting that had not taken.

Turn all three down to zero and it is the Outline drawing, exactly — that is what the brush at no pressure is. Wobble starts at zero, being the one of the three that is a hand rather than a medium: it takes the ruler off the line, and Bleed lets the colour run past it.

Screentone

Flat fills with tone dots in the shade — the manga page. Tone is the threshold at which a face starts to take dots, and it defaults just above the front faces, so the artwork’s own faces stay flat and the walls turned away get the tone.

Treatment: what colour it comes out

Three, and they are about the whole drawing rather than about one renderer:

TreatmentGives you
Artwork coloursyour palette, as painted
Two-toneone solid colour for everything, on paper of your choosing
Line artno fills at all — the lines and nothing else

Solid colour is what Two-tone fills with, and Paper is what sits behind the whole page. Leave Paper fully transparent and the SVG has no background, which is what you want if it is going into a layout.

Both stay on the card when the treatment they belong to is not chosen, drawn inert. A control that vanishes says nothing about itself; one that appears from nowhere is a control you did not know you had.

The line

ControlDoes
Line colourincluding its alpha — a line at half strength reads as ink rather than as a border
Line widthin canvas cells, so it is a fraction of one painted pixel. It stops at two, because a line thicker than the pixels it outlines has stopped being an outline
Lines between coloursa line at every colour boundary, not only where the surface turns

The pictures in this book use a fifth of a cell, in black at about 45%, with lines between colours on. It is worth starting there: a hairline reads as drawing where a fat line reads as a border round each shape.

The press

Fills is Exact or Riso, and Riso began as a bug. It snaps every fill to a grid and leaves the outlines exact, so the colour sits a little off its lines — which is precisely what a risograph does when its two drums are half a millimetre out of register. It was a mistake in the preview, it looked wonderful, and it is a mode now.

Riso grid is how coarse that snapping is, in canvas cells. Because the effect is the ratio between the grid and the artwork, one cell is bold on a small canvas and nearly invisible on a large one — which is why it is a setting rather than a constant.

The page

ControlDoes
Parallel projectiondrops the perspective, so parallel edges stay parallel. The orthographic look, and the honest one for a technical drawing
Frame it like the canvasthe page takes the canvas’s own shape, which is what makes the line art line up with the artwork PNG beside it. Turn it off and the drawing is framed on itself, with Margin deciding the breathing room
Hidden surfaceshow carefully what-hides-what is worked out

Hidden surfaces has four settings. The first three are the same drawing at three prices: By distance is quick and occasionally wrong, By overlap works out every pair that actually overlaps on the page, and By outline — the default — is the most careful and the slowest, because it compares the traced shapes themselves rather than the boxes round them.

Check an ordering change from an orbited camera. A front view barely shows any of this — every face is a rectangle facing you and nothing much can hide anything — so a setting that looks fine straight on can be plainly wrong from three-quarters. Turn the model before you decide.

Steady while moving

The fourth setting is for film, and it exists because of something none of the first three can help: surfaces can contradict each other.

Three walls can be arranged so that A is in front of B, B is in front of C, and C is in front of A — each fact plainly true from where you are standing, and no order of the three that satisfies all of them. Something has to be drawn wrong. The first three rules give way wherever their measuring happens to reach first, and that measurement slides as the camera turns, so it is a different surface that gives way on each frame. What you see is a flicker: a wall that should be hidden flashing through, then not, then again.

Steady while moving asks exactly the questions By outline asks, and answers them the same way. What it changes is which contradiction it gives up on: the one covering the least of the page. That is a fact about the shapes rather than about where the camera is, so it stays the same choice while you orbit — and it is the least visible of the choices available, because the surfaces that share the smallest patch of page are the ones whose order shows least.

It leaves roughly a tenth as much of the picture flickering. It does not remove it — a drawing with contradictions in it still has them, and this decides where they go rather than making them absent. Reach for it whenever the camera moves: recording a turntable, or simply orbiting to judge a model.

On a still there is nothing to flicker, so the difference is smaller — the same surfaces are still contradicting each other, and all this does is choose smaller ones to be wrong about. It is By outline plus a tidying-up pass, so it costs a little more and is never worse; By outline stays the default because it is the one most drawings are composed on.

Getting it out

Two buttons, both in the Export pane:

  • Export line art (SVG) writes the vector file.
  • Export line art (PNG) writes the same drawing rasterised, at the size the card’s Image size says.

Neither has a renderer of its own — both are drawn by the very code the preview uses — so the file cannot disagree with what you were looking at.

Recording

A picture of your model shows one side of it. A recording turns it all the way round, films your canvas as you draw on it, or films Flatty itself while you work — and writes a file that plays, ready to post, or to drop into a store page.

Point any pane’s title at Recorder. Everything a recording needs is on the one pane, and the heading of each card tells you what you are about to get before you make it.

What you can film

The Record select at the top picks the subject, and the rest of the pane follows it — controls that make no sense for what you chose are greyed out with the reason on them, rather than disappearing. Whole cards are a different matter: filming the window has no turn, no frame and no background to set, so those three are not drawn at all.

The model, turning

The extruded model on a turntable, with the ground and the shading you have set, starting from whatever angle your 3D view is pointed at. Line the shot up there first — orbit until it looks right — and the recording begins from exactly that view.

The line art, turning

The same turn, drawn as line art instead. It uses the renderer and the settings your Vector pane is on, so what you have tuned there is what you get.

The canvas, as you draw

A time-lapse of your artwork appearing. This one does not turn anything — it takes a frame each time the drawing changes, so time spent thinking costs nothing and the length of the film follows how much you actually did rather than how long you sat there.

Press Record, then draw. Press Stop when you are happy, or let it run to the frame count in the heading and stop on its own.

The whole app window, as you use it

Flatty filming itself: the window exactly as it is on screen, while you work in it. This is the one recording that does not end on its own — it runs until you stop it, or until the cap on its card runs out — and it is the only one you can pause.

It needs ffmpeg, and it writes a video and nothing else.

Filming the window

Choosing the window swaps out the middle of the pane. The turn, the frame and the background all go — there is no camera to move, no shape to choose and no ground behind it, because the frame is the window — and one card takes their place.

Sizethe height the file comes out at. The window’s own size is the default and the cheapest, since anything else has the encoder resample every frame. The other three — 720p, 1080p, 1440p — are the heights video is actually delivered at.
Frames a secondten to sixty, thirty by default. Deliberately lower than the turn’s ceiling: every frame here is read back out of the window while you are using it, so a high rate slows down the very thing being filmed.
Video qualityhow hard the encoder tries. This one is about the picture rather than the file size.
Stop afterminutes, one to sixty, ten by default. A take nobody stopped would otherwise fill the disk.

The heading counts the pixels the file will hold, before you record anything, the same way the frame’s heading does for a turn.

The pointer in the recording is drawn, not filmed. The real one is not in the picture the window hands back, so without Draw the pointer the footage shows controls reacting to nothing at all. Mark clicks puts a ring wherever a button goes down — and with no pointer drawn there is nothing to mark on, so it is greyed out rather than left there doing nothing.

Both are on to begin with.

Under those, once the app has worked it out, a line says whether the video is being made by your graphics card or by the processor. It is the one thing on this card you cannot change, only find out, and it is the difference between a recording that costs the app almost nothing and one that shares a core with it.

The turn

This card and the two after it belong to a rendered recording — the model, the line art or the canvas. Filming the window they are not drawn at all: it has the one card above instead.

Camera picks how it moves, and the three are genuinely different films rather than settings on one.

Turntableall the way round, from the angle you set. The classic showcase.
Hold stillthe camera does not move — but the recording is not still. Your ground does: a drifting grid, a swell, the mist rolling. It is the shot for showing off the atmosphere with nothing else competing for attention.
Driftthe camera traces small circles around where you left it, the way a hand would. The near side of your model moves against the far side and the whole thing reads as solid — the trick that makes a still render look three-dimensional.

Then three sliders, and the heading adds them up for you.

Turnshow far round the camera goes — or, on a drift, how many little circles it makes. Either way a whole number of them ends exactly where it began, so the file loops without a jump. Holding still, there is nothing to count and the slider says so.
Secondshow long the finished film runs. Filming the canvas, this is the most it can run — it stops there, or when you do.
Frames a secondhow smooth it is. Thirty is the default and looks it.

A GIF cannot count faster than fifty frames a second. The format measures each frame in hundredths of a second, so above fifty it stops being able to hold the rate it claims. The slider stops there for that reason.

The frame

Size is the long edge, and it is the one setting that decides how big your file comes out — a recording pays for its size on every single frame, which is why the sizes offered here stop lower than the ones for still pictures.

Shape is the proportion:

Same as the viewyour 3D pane’s own shape, so what you framed is what you get. Filming the canvas, it is the canvas’s shape.
Squarefor a thumbnail or an avatar.
Wide (16:9)for a store page or a video.
Tall (9:16)for a phone held upright.

The heading shows the exact pixels the two settle on, before you record anything.

A taller frame shows less of your model, not more. The camera looks up and down by a fixed amount whatever shape you pick, so narrowing the frame narrows what is visible at the sides. A wide model in a tall frame would have its ends cut off — which is what the next switch is for.

Keep the model in frame stands the camera back far enough that nothing clips at any point in the turn, not just at the angle you started from. It is on by default. Turn it off if you have set the distance deliberately and want exactly that.

What it sits on

Sits on is the background. Four swatches cover most of it — the view’s own colour, black, white, or nothing at all — and the button beside them opens the full colour wheel for anything else.

The first swatch, the view’s own, follows your theme: change the interface colours later and a new recording follows them. A colour you mix stays exactly that colour.

Picking None gives you a recording with no background, so your model can go straight onto a coloured page.

What comes out

Animated GIF needs nothing installed, and for a rendered recording it is always there to be had. It plays in any browser, any chat window, any store page, with no player and no plugin. For flat pixel art it is exact — the colours you painted are the colours in the file.

Video makes an .mp4 as well, which is far smaller and sharper than the GIF for the same recording. It needs ffmpeg on your machine; if you have not got it, the switch is greyed out and says so. Video quality picks how hard it tries — Smaller file, Balanced or Best looking — and only the video reads it, never the GIF.

Two things can be wrong with ffmpeg, and they read differently. Not having one at all is visible straight away, and greys the switch out. Having one that cannot write where Flatty can see it — a sandboxed install is the usual cause — can only be found out by trying it, so that one is reported once the app has tried, and after it a recording with nothing else to write is refused rather than run into nothing. A turn asked for as a GIF and a video still gets made: the GIF is written by Flatty itself and needs nothing installed, so the missing video is a warning beside a finished file.

Filming the window there is nothing here to choose. It always writes a video and only a video, at the size and quality set on its own card. There is no GIF at all, and the switch says why: a take that runs until you stop it is not a length the format can carry.

Keep the frames leaves behind the numbered PNGs the recording was built from, in a folder beside it, in case you want to take them into something else. Off by default, since they are only working material.

Everything lands in your project’s exports folder, alongside every other export, under a name that says what it is: .view.gif for the model or the canvas, .vector.gif for the line art, the same two with .mp4, and .window.mp4 for the app itself.

Keys in the footer, at the foot of the SOURCE card, puts record, pause and stop along the bottom of the window, so a recording can be started, held and finished without coming back to this pane. That matters most for the one recording that films the pane you would otherwise be clicking in.

They lead the group at the right-hand end, ahead of the flag, so the three controls that are always there keep their places. All three appear together — pause is greyed out with its reason for the recordings that cannot pause, rather than left out, so the distance from record to stop never depends on what you are filming.

Off unless you ask for it. The footer was cut from eight controls to three on purpose, and this group has no business being there for somebody who is not filming anything.

While it is recording

A bar replaces the Record button and counts the frames as they are made.

Stop means two different things, and which one depends on what you are filming. A turn is thrown away: it is half a render, and nothing half-written is left behind. A take of the window is finished and written — its frames were encoded as they were made, so there is a film there worth keeping.

Pause is the window’s alone, next to Stop and greyed out with its reason for everything else. A paused recording is simply not fed, so the wait is left out of the film rather than held as a still: stop to think, go and find something, and the recording carries on from where it left off.

A turntable renders as fast as it can, which is deliberate: it is a job to wait for, and the app will feel slow for the few seconds it takes. Filming the canvas is the opposite — it only does any work when you actually draw, so it stays out of your way, and the app sits quietly while you think. Filming the window is the one that costs something the whole time it runs: each frame is read back out of the window, which is why its rate stops at sixty rather than the turn’s ceiling.

Opening a different project stops a recording in progress. It is filming this drawing into this project’s folder, and carrying it across would give you one film of two different things.

Bringing in a picture

Two jobs need an image from outside: putting a photo or sprite onto the canvas, and adding a texture to your media library. Both go through the same editor, so you learn it once.

Getting there

ToDo
put a picture on the canvasthe picture key in INSERT, at the foot of the canvas
put a picture on a new layerits chevron, then the key in the panel
add a brush textureAdd… in the texture brush’s card, or the + tile in the Media pane
paste from the clipboardCtrl+V with an image on it

What it will open

PNG, JPEG and GIF.

The media library itself holds PNG only, and that asymmetry is deliberate: source material arrives as whatever the camera or a colleague produced, and this screen is what turns it into the one format the library stores. A texture leaves here as PNG whatever it arrived as. A picture bound for the canvas is never a file at all — it goes straight into the document as pixels.

WebP and AVIF are not offered, because Go has no decoder for either in its standard library and the alternatives are a new dependency or a C toolchain.

A picture over 40 megapixels is refused with the reason on the panel — read from the file’s header, so an absurd panorama costs a few dozen bytes rather than a frozen second.

Large is otherwise fine. A 4000-pixel photograph is a perfectly good source for a 512-pixel brush. It opens, and the result is capped rather than the file being turned away.

Which cap applies depends on the job:

JobCap on the long edge
brush texture512 px
onto the canvasthe canvas’s own long edge

The size readout says (at the … limit) while a cap is holding the result down, so a picture that came out smaller than expected says why rather than looking like the sliders are broken.

Crop

Six ratio presets: Free, Square, 3:2, 4:3, 16:9 and Source (the shape the file already is). Free is first because it is what most sessions want — “the part of the photograph with the bricks in it” is a shape, not a ratio. Square is what a tiling brush texture usually wants.

With a ratio locked, a corner drag keeps the opposite corner still, and an edge drag grows the other axis symmetrically about the centre. Switching between presets keeps the crop centred and roughly its area, so it is safe to poke at.

Three actions sit under the keys:

ControlDoes
Fill (arrows into corners)grows the crop until it meets the picture — the largest frame with no empty corner
Trim (the scissors)shrinks the crop to what is actually opaque, losing no pixel
Resetthe whole picture again, unturned and unflipped

Trim takes the outermost opaque pixels whole rather than cutting through their centres, and ignores alpha below a threshold — otherwise a source whose “empty” margin is not quite empty would trim to nothing. If there is nothing opaque at all it says so instead.

Straighten

Rotate in 90° steps, flip horizontally or vertically, and nudge the Angle slider for the small correction a hand-held photo needs. The corners a fine angle opens up come out transparent, and Fill is what crops them away.

The readout beside the keys says where you are: upright, or how many turns and how many degrees.

Size

Size follows crop keeps the output at the crop’s own pixel count, up to whichever cap applies. Turn it off and the Width and Height sliders are yours, with keep shape locking the aspect. Any number can be typed into.

smooth blends pixels when resizing. It is right for a photograph and wrong for pixel art, which is why it is off — and why the preview says hard pixels or blended so you can see which you are getting.

For pixel art the number that matters is usually small — you are making a 32-pixel sprite, not a wallpaper — and the preview at the top right shows exactly what you will get, with how far it has been magnified or reduced.

Onto the canvas

A picture placed on the canvas arrives floating, exactly like a paste: drag it, resize it from the corners, turn it with the arm, nudge it with the arrows. Nothing is written into the layer until you drop it. See moving what is in flight.

Choose as a new layer and it lands on a layer of its own, which is usually what you want for reference art you intend to trace over and then hide.

Your libraries

Four collections belong to you rather than to any one drawing: your palettes, your media, your themes and your saved layouts. They follow you from project to project with no import step, and they live in folders of small readable files beside your settings.

LibraryWhereOne file is
Palettes~/.config/flatty/palettes/a .json file
Media~/.config/flatty/media/a .png plus a small .meta.json beside it
Themes~/.config/flatty/themes/a .json file
Layouts~/.config/flatty/layouts/a .json file

One rule decides what goes where. A preference is a setting you flipped, and it lives in your settings file. An asset is a thing you made or imported, named, and might want to copy, keep or send to somebody. Assets live in a folder, one file each — so you can back one up, mail it, or drop one in by hand.

Dropping a PNG into the media folder from your file manager makes it a brush the next time Flatty starts. That is not a side effect; it is the point of the folder being a folder.

There is a fifth place, and it is none of the above: a cache, in your system’s cache directory, holding what Flatty can rebuild by itself — the list of fonts on your machine, and the gallery’s thumbnails. Delete it whenever you like.

The Media pane

Everything you have imported — brush textures and reference pictures — in one gallery. Switch any pane to Media, or press Manage… in the texture brush’s settings.

Click a thumbnail and the column on the right fills in with that picture and everything you can do to it. The + tile at the end of the grid brings a new one in.

In the right-hand columnWhat it does
Namerename it in place. Renaming never moves the file, so anything pointing at it keeps working
KindBrush texture or Reference — a filter, not a folder
Paint with thisput a texture in the texture brush’s hand and pick the brush up
Place on the canvascrop and size it, then drag it into place as a floating paste
Edit…crop, straighten and resize. The result is filed as a new picture and this one is left alone
Pin / Unpinsay this project uses it, before you have painted with it
Tag… / Untag…file it, so the filter can find it again
Deleteremove it from the library and from disk, on a second click

The tick boxes on the thumbnails are for doing something to several at once. With some ticked, the right-hand column becomes Picked out and its buttons act on all of them. Clear unticks everything.

Ticks survive a change of filter. That is what makes the usual pass work: narrow to Untagged, tick the lot, tag them, then narrow to something else. A ticked row the filter has since hidden is left alone, though — the buttons never reach something you can no longer see.

Tags

A tag is any word you like. Add a few to something and the filter bar can find it again in a library of two hundred.

Case does not matter, and neither does how you typed it the first time. Forest, forest and FOREST are one tag. The chip shows the spelling you used first, and everything else compares them as the same word — so a library cannot quietly collect three near-identical tags that split your work between them.

Right-click a tag chip to rename it everywhere or remove it from everything. That is the only cure for a typo: forrest has to become forest on every picture at once, because the misspelling is the only thing tying them together. Renaming one onto a tag that already exists merges the two.

Typing in the tag box offers the words you have used before. Not being able to remember last week’s spelling is the main reason tag lists rot.

Finding things

The filter bar sits above both the media gallery and the palette library’s Manage tab, and it is the same set of controls in both.

ControlNarrows by
the scopewhich part of the library — see below
the kindmedia only: brush texture or reference
the sortby name, newest first, or recently used
the search boxpart of a name
the tag chipsclick one to require it

Every tag you add shows you less. Requiring forest and stone gives you the things carrying both, not the things carrying either. That is what makes a filter useful on a big library; the search box is there for the times you want the looser thing.

The five scopes

ScopeShows
Everythingthe whole library
This projectwhat this project pins, and what it has been seen using
Untaggedthe inbox — everything imported and not yet filed
Unusedin no project and never painted with — what is safe to delete
Missingreferenced by this project and no longer in the library

Untagged is your inbox. Import forty pictures and they all land there; it is where you go to file them.

Unused is the answer to the drawer everything ends up in. It is the one view that tells you what is safe to delete after three years — and it needs both halves to be true, so something a project pins is never listed there even if you have never painted with it.

What this project uses

The This project scope is about the drawing you have open rather than about your library.

Flatty watches what you actually paint with: stroke with a texture and it notes that this project used it. That is the half you get for free, and it is what makes This project worth trusting rather than aspirational.

Pin is the other half — you saying “this project uses these” before you have touched them, which is how a set gets gathered at the start of a job rather than discovered at the end. Pinned pictures are badged as such.

Why it does not tidy itself. Once you have stroked with a texture, its pixels are in your artwork. Nothing can tell later whether you painted over every trace of it, so Flatty never quietly drops something from the list — it would eventually drop one you were relying on. Forgetting is a button you press.

If this project names something you have since deleted, it is listed under Missing rather than silently vanishing, so a reference that has gone is something you find out about here rather than when you go looking for it.

Packing a project up to send

Pack for sharing…, in the Export pane, asks for a new, empty folder and copies your project into it along with every asset it uses:

somewhere/
  fluffy cloud/         the project, exports and all
  library/
    media/              the textures it uses
    palettes/           the palettes it uses

Zip that folder and it is a complete handover — the artwork, and everything it was made with.

It has to be an empty folder. Packing into one that already holds something is refused, because you would have no way of telling afterwards which files came from this run and which were an older copy.

Why the libraries are not inside each project to begin with. They could be, and then every project would be self-contained without a button. But forty textures across twenty projects is eight hundred files, and improving one leaves nineteen stale copies of it behind. Keeping one copy and packing on demand costs you one button on the days you are actually sending something, and nothing at all the rest of the time.

Projects

A project is a folder

That is the whole model. There is no library, no database, no designated root folder, and nothing registered anywhere.

A project is any folder containing a project.fdraw file. It can live wherever you keep your work — beside your game’s source, on a memory stick, in a folder your team syncs. Move it and it is still a project. Copy it and you have two.

sprites/fluffy cloud/
  project.fdraw          the drawing — this is your work
  exports/               everything you have exported
    latest/              the copy your game loads

Making one

New project — from the startup chooser or the Project pane — opens a browser on the folder your project will live inside.

Browse to where it should go, type a name in the row under the listing, and press Create. That makes a folder of that name inside the one you are standing in, and puts a project.fdraw in it.

The line at the bottom spells out exactly what is about to be written:

-> /home/you/sprites/fluffy cloud/project.fdraw

The answer is always a child of what you are looking at. The panel browses the parent and names the project underneath, so there is no way to accidentally turn the folder you were merely passing through into a project. The new-folder key in the toolbar makes a parent; the Name row names the project, and the two no longer compete.

The folder is the project’s identity, but not its name for ever: the Project pane’s Name field renames it whenever you like. Folder names are literal — spaces and all — and only characters no filesystem accepts are refused.

A folder that already holds a project is refused, with the reason shown in the panel rather than after the click.

The Project pane

Where the document’s own settings live. Everything about the drawing as an object rather than as a picture.

CardHolds
ProjectName, Location, and Save, Save as…, New project…, Open project…
Recent projectsthe ones you have opened before
Canvassize presets from 16 to 256, width and height, a ratio lock, the anchor pad, Apply / Revert, auto-grow, and how much undo history is being held
Side wallsShade — side = front pixel × shade — and a reminder that a rim face in 3D overrides it
World placementLayers bottom to top, Pivot and Px / unit, with the world size that gives you

Location names where the open project lives, and says not saved yet when it has no home. With no root folder anywhere in the design, “where is this?” has exactly one honest answer and it is written down.

Save as… moves a project without renaming it. A document that already has a name keeps it. Only a document that has never been named takes its name from the folder.

Nothing that writes a file you asked for is here — that is the Export pane. This pane writes project.fdraw, and that is all.

Opening one

Flatty opens on a chooser listing the projects you have opened before, newest first, with Continue “your project” at the top for the one you were last in. Browse… finds one that is not on the list, and New project starts a new one.

The button that is filled is the one you can actually press. With a project picked that is Open; with nothing picked — a first launch — it is New project, because Open cannot work and the strongest mark on the screen has no business sitting on a dead control.

The left column says what you are running: the letterhead, the version, one line about what the program is for, one line saying it is free and that your work is yours, the address, and the credits. Nothing on that screen asks anything of you.

Untick don’t show this at startup to skip the chooser in future; Settings turns it back on. Esc, or Skip, passes it for one run.

Opening or starting a project asks first, whenever there is unsaved work. The document is replaced outright and there is nothing to undo back through, so you get Save first, a button that names what it will lose, and Cancel. There is no don’t ask again on that one: a checkbox agreeing in advance to discard work you have not seen is not the same offer as skipping a question with no stakes.

The status bar shows a * while there are unsaved changes, which is exactly when that question has something to warn about.

Projects that go missing

A project on an unplugged drive, or in a folder moved outside the app, stays on the list, greyed and marked (missing), rather than quietly disappearing. An unplugged drive is not a deleted project, and the entry is the only record the app holds of where that work lives.

Selecting a missing one in the Project pane offers Forget in place of Open — the one useful thing left to do with it, and the only way an entry ever leaves the history.

The file browser

The same browser serves every job that needs a path: opening a project, creating one, importing a palette, exporting one, adding a brush texture, choosing where to pack one up.

PartWhat it does
the path bartype or paste a path to go there
the three keysup one folder · new folder · your system’s own dialog
hidden foldersshow dotfiles
PlacesHome, Downloads, Documents and your filesystem roots, named the way your desktop names them
the listinga .. row at the top, then folders; click to select, double-click to enter, the headers sort

Folders that already hold a project are badged project, so finding one is reading rather than opening each in turn.

Type a few letters with the listing focused to jump to a name. The image preview at the foot of the sidebar shows PNG, JPEG and GIF files as you highlight them.

The system dialog is offered as a shortcut when one is available, but the built-in browser always works — there is no guarantee a desktop portal is installed, and on a machine with no session there is nothing to call at all. For a new project the system dialog can only navigate, never answer, because it can only hand back a folder that already exists.

Sending one to somebody

Because your textures and palettes live in your libraries rather than inside each project, a project folder on its own is the artwork without the things it was made with.

Pack for sharing…, in the Export pane, copies the project and everything it uses into one new folder you can zip and send.

Where your settings live

The recent-project list, your workspaces and your preferences share one file, and your libraries sit beside it as folders:

PlatformSettings folder
Linux~/.config/flatty/
macOS~/Library/Application Support/flatty/
Windows%AppData%\flatty\
flatty/
  config.json          recent projects, workspaces, preferences, your keymap
  palettes/            one file per palette
  media/               one file per texture or reference
  themes/              one file per theme you have made or imported
  layouts/             one file per saved layout

Everything is written atomically, so an interrupted write cannot leave you with a truncated file.

Your projects are somewhere else entirely — wherever you put them. Nothing about a project lives in here.

Exporting to your game

Everything that comes out of one drawing has a card of its own in the Export pane: the model for your game, the same model for an editor or a printer, and four pictures. Reach it from the setup panel’s Export tile, or point any pane’s title at it.

Ctrl+E exports the model and Ctrl+Shift+E the artwork, without opening anything.

Exports live inside the project’s folder, so there is nowhere for them to go until the project has one. Until then every button here is drawn inert with the reason in a tooltip.

What ends up in one

A layer you have hidden is in none of these files — not the model, not a picture. The tick in the Outliner is saved with the project, so it means the same thing tomorrow as it does now, and everything written out of here honours it.

A solo is different, and stops short of a model file. It changes what you are looking at — the 3D view, the line art, any picture taken of either — but the .glb, the .bbmodel, the .obj and the .stl are built from every ticked layer regardless. Soloing is not saved with the project, so a model file that honoured it would come out differently tomorrow from the same drawing, with nothing in the drawing to say why.

A faded layer comes out solid, everywhere but the artwork PNG — and there only because that file is the 2D canvas written out. See Layers and depth.

The cards

3D model

<prefix>.glb and <prefix>.meshes.json — the extruded model and the sidecar naming its parts, ready for a game to load. This is the one the app exists for.

The .glb holds the mesh, an embedded PNG atlas, and a node hierarchy of sprite → layer → island.

The sidecar exists because raylib’s Model has no mesh names, only a Meshes array. It maps index to island so you can find “the sword” in a model without counting. Island names are numbered per layer, so look parts up by path ("face/part_1") rather than by bare name.

Unlit material is the card’s one switch. On, the file tells whoever opens it to draw your colours exactly as painted — no lighting, no shadows — which is how Flatty’s own 3D view shows them. Blender honours it, and so does any engine that understands unlit glTF; raylib has never heard of it and lights the model as it always did, so the switch costs a raylib game nothing either way. It is a preference rather than a project setting: it says how an engine should light the file, and one game wants the same answer for every export.

For editors

The same model for somebody who wants to keep working on it.

Export for Blockbench (BBMODEL) writes <prefix>.bbmodel, a Blockbench project that opens with no importer and no plugin: every layer a group, every piece a mesh of quads, the texture inside the file. Reach for this whenever Blockbench is where the model is going — it is the only route on which nothing is guessed on the way in.

Export 3D model (OBJ) writes three files that only work together:

FileIs
<prefix>.objthe geometry, as quads
<prefix>.mtlthe material file the .obj names
<prefix>.atlas.pngthe texture the material names

Delete either companion and the model imports untextured — that is how OBJ works, and every program that reads it expects the three side by side.

In Blender, set the texture to Closest. An OBJ has no way to ask for nearest-neighbour sampling, so Blender’s importer leaves the image on Linear and a small atlas blurs across the faces, with a dark fringe round every one where the edge of a pixel is averaged with the transparency beside it. Select the material, find the Image Texture node, and change Interpolation to Closest; the blur and the fringe go together. The button’s tooltip says the same, since the file cannot.

3D print

Export for printing (STL) writes <prefix>.stl: the model as one closed solid, ready for a slicer, at one millimetre per pixel — a 32-pixel sprite arrives 32 mm across. Px / unit does not apply here; it says how big the model is in a game world, not on a desk.

Layers that overlap or sit inside one another come out as one body, with nothing left inside — a printer needs a single watertight surface, and that is what this writes. The solid is white in every viewer, because STL carries geometry and nothing else, and it stands where the pivot puts it: bottom-centre rests the lowest point on the ground, Center in the Project pane centres it instead.

Artwork

<prefix>.png — the 2D canvas as painted, composited flat, at its own pixel size. The sprite, in other words.

Line art

<prefix>.svg, and <prefix>.vector.png for the same drawing rasterised.

The renderer and the style live in the Vector pane — this card only writes what that pane is set up to draw. Image size is the long edge of the PNG; the SVG is a vector file and has no pixel size to give.

3D view

<prefix>.view.png — a photograph of the 3D view in this workspace, without the ground under it. The picture is the model; a floor belongs to your workspace rather than to the thing you are exporting.

ControlDoes
Image sizethe long edge
Shapethe same shape as the view, or a fixed one. The camera looks up and down by a fixed amount, so the shape decides how much is visible to the sides
Transparent backgroundon by default — the model alone, with nothing behind it, which drops onto a store page or a README without a rectangle round it

The card says which 3D pane it is following, and if there is no 3D view in this workspace it holds the last angle rather than refusing.

There is a camera key on the 3D pane itself that writes the same picture, which is usually the shorter route: you line the shot up, then take it.

A translucent model over nothing composites against transparency, so Lam::pula’s glass comes out darker than it looks in the pane, which clears to an opaque background. Turning the background on is the answer, and is why it is a switch rather than a fact.

Share

Pack for sharing… — see below.

A recording lands here too. The Recorder pane writes its GIFs and videos into the same exports folder under their own names — see Recording. It has its own size, because a film pays for its size on every frame where a picture pays once.

Everything is written twice, on purpose

fluffy cloud/
  exports/
    2026-08-21_144312_fluffy_cloud.glb    kept forever, never overwritten
    2026-08-21_144312_fluffy_cloud.meshes.json
    latest/
      fluffy_cloud.glb                    replaced by every export
      fluffy_cloud.meshes.json

The archive is what stops an export destroying the previous one. The stable copy is what lets your game hard-code a path that does not change every time you press the button.

Point rl.LoadModel at exports/latest/.

Both copies are the same model. The scene name, the root node and the atlas all take the project’s prefix — deliberately not the filename — so a consumer reading the scene name does not see it change because a timestamp did. The sidecar is the one thing that differs: each copy names the .glb sitting beside it.

Show folder opens the exports folder in your file manager, and Show the folder afterwards does it on every export, with the file it just wrote picked out where your desktop can do that.

Prefix

The Prefix field is what the export files are called. It follows the project’s Name automatically until you edit it yourself, at which point it stops tracking — silently renaming somebody’s files is worse than letting the two drift apart. The card says which of the two is happening.

The slug that turns a Name into a Prefix folds accents rather than deleting them: Zażółć becomes zazolc, not z.

Pivot and scale

Both are in the Project pane, under World placement.

Px / unit sets the scale: at 16, a 64-pixel sprite becomes 4 world units.

The pivot defaults to bottom-centre, so DrawModel(m, pos, ...) puts a character’s feet at pos.

Draw your character touching the bottom of the canvas. X and Y come from the canvas, not from the artwork’s tight bounds. That is deliberate: an animation’s frames must share an origin, and tight bounds would move it every time the silhouette changed.

Loading it in raylib

m := rl.LoadModel("sprites/fluffy cloud/exports/latest/fluffy_cloud.glb")

// The one line you have to add. The file asks for nearest-neighbour filtering in
// its glTF sampler, but raylib's loader does not apply glTF samplers — so
// without this your pixels come out smoothed.
for _, mat := range m.GetMaterials() {
    if tex := mat.GetMap(rl.MapAlbedo).Texture; tex.ID != 0 {
        rl.SetTextureFilter(tex, rl.FilterPoint)
    }
}

rl.DrawModel(m, playerPos, 1, rl.White)  // the pivot is baked in

That is the whole integration. No conversion step, no import settings, no material to rebuild.

Opening the .glb in Blender

If the model imports grey, switch the viewport out of Solid shading — press Z and pick Material Preview, or click the third sphere at the top right of the 3D viewport.

Blender’s default Solid mode ignores materials entirely and shows every mesh in flat grey, which looks identical to a model that genuinely has no texture. The file is fine.

A lighter band running diagonally across the model is Blender’s lighting, not your texture. Material Preview lights the model from a studio environment and lets the front layer cast a shadow on the layer behind it; the band is the strip that is not in shadow, and it crosses several faces as one straight line, which no texture could do. Switch to Solid shading with Lighting: Flat and it goes. Better, turn on Unlit material before exporting: Blender then draws the colours as painted, exactly as the 3D pane does.

Blockbench opens the .glb through its glTF plugin, and the export is laid out so that it does; the .bbmodel is still the better door, because it arrives as quads with its layers already grouped.

Transparency

If any texel in the atlas is translucent, the material is written with alphaMode: "BLEND". If none is, no alphaMode key is written at all and the model behaves exactly as an opaque one. The Unlit material switch changes neither: it takes the lighting away and leaves the transparency exactly as it was.

See Colour for why, and what blending costs.

Packing a project up to send

Pack for sharing… asks for a new, empty folder and copies the project into it along with every library asset it uses — the textures and palettes that otherwise live in your folders rather than in the project. Zip that folder and it is a complete handover. See Your libraries.

Exporting without opening the window

For build scripts:

flatty -open ./sprites/cloud -export     # write exports/ and exports/latest/
flatty -project ./sprites/cloud -save    # create the project file

Both run headless and exit. They need somewhere to write, so they refuse to run without -project or -open rather than inventing a path — and neither touches your settings or your recent-project list on the way through.

Making it yours

Four panes are about the app rather than about the picture: how it is drawn, how it behaves, what its keys are, and what it is. None of them touches your artwork.

All four are on the setup panel — the key at the bottom right of the window, or Ctrl+, — which pops them out over your workspace and leaves your arrangement exactly as it was.

Appearance

Every colour, every corner and every gap in the interface is a theme, and you can change all of them.

Seven ship. Organic is warm and square-cornered; Night Wave is the dark one, and five of the seven are moods of it — Jungle and Kapuccino shift its hues, and Soft takes the contrast down. A fresh install opens in Night Wave Soft, which is what the pictures in this book are wearing.

ButtonDoes
Weardraw the interface in this theme, and remember it
Copymake an editable copy in your own themes — the only way to change a built-in
Deleteremove one of yours, and its file
Import…bring in a theme somebody sent you; it is copied into your own

A built-in cannot be edited or deleted, for the reason a built-in layout cannot: it belongs to the app, so a change would last until the next release and then quietly revert. Copy it and the copy is yours — and improving one in a later version improves it for you too.

What a theme holds

Under the list, everything the selected theme states, in cards:

CardHolds
Palettethe named colours — the grounds, the text, the accent, and the hues (pink, orange, yellow, green, cyan, purple) that mean something specific wherever they appear
Stated outrightevery colour the theme fixes rather than deriving. The rest are worked out from the palette, and the button beside one takes it into the theme’s own hands
Shapesix corner radii, the border weight, the focus ring, the section rule, and how far a lit surface glows
Spacingpadding, the gaps between controls, rows, sections and swatches, and the heights of a row, a control and a pane header
Typewhether section titles are set in small capitals

Everything is live — drag a corner radius and every card in the app re-cuts under you.

Six radii, not one. A corner is a fraction of the shape it is cut from, and these run from a 36-pixel tool key down to a 13-pixel tick box. Scaling them together makes the small things look like buttons and the big things look like pills, which is why each names the element it belongs to.

Text size is deliberately not here. Every pane is solved against the width its labels measure at, so a theme that moved the type would reflow every pane at once and quietly ellipsise a long label in one of them. Sizing is the app’s decision per surface, and the casing switch is what is left of the question.

Settings

The preferences that belong to you and your machine rather than to a drawing. The Project pane is the document’s settings; this is everything that outlives it.

CardHolds
LanguageEnglish, Polski, Español, Deutsch or Português
Inputreverse zoom, reverse pan, and the pan speed in screen pixels per detent
Canvasshow the pixel grid, and smooth the patterns
3D viewwhich ground every 3D pane draws — the same chooser as the chip on the pane
Startupshow the project chooser at startup; ask before quitting
Debugshow the frame rate, and show the model stats
Settings filewhere all of this is written, and Restore defaults

Reverse zoom and reverse pan are there because which way a trackpad scrolls to zoom in depends on your system’s natural scrolling setting, which the app has no way to read.

Smooth the patterns draws the pixel grid, the chequered backdrop behind transparent pixels and the pane grips with soft edges instead of hard ones. It is off by default — crisp is right for pixel art — and it is a taste rather than a fix.

These save the moment you change them. Restore defaults puts every one back.

A scripted run writes nothing. Started with -project, -save, -export or -screenshot, Flatty does not touch your history or preferences at all, and the pane says Not saving where it would otherwise name the file. A run told what to work on must not rewrite your settings as a side effect. That is why the picture above says it.

What is deliberately left out is state you arrive at rather than choose: a free orbit’s angle, the canvas zoom and pan, scroll positions.

Keys

Every shortcut in the app, in one pane, and the only place they change.

PartWhat it does
The filterreads the names and the keys, so typing a shortcut answers “what is that already doing”
A row’s keysclick them, then press what you would rather use. Esc leaves the row alone
The dashclears that shortcut, leaving the action deliberately unbound
The arrowputs that one row back to what it shipped with. Dim when there is nothing to put back
Restore every shortcutthe lot, at once
The mousewhich button orbits, which pans, and the modifiers for the eyedropper, the second colour and erasing

The list is grouped by where a shortcut applies: the ones that work everywhere, then the ones that only mean something on the 2D canvas, in the layer list, while a paste is in flight, in the image editor, in a panel or in the command palette. That is why Esc can appear several times without being a clash — only one of those is listening at a time.

Taking a shortcut something else already has is offered, not refused. The pane says which action holds it; take it anyway and that one is left with no shortcut, and says so. Nothing is quietly sitting on a key you thought you had.

A shortcut you remove stays removed. Clear one and it is still clear the next time you start the app — an updated version will not hand it back. That is the difference between a key you never had and one you took away.

What you change reaches the whole interface at once. The help cards, the hint along the bottom of a 3D pane, the line under the palette and the note under the brush size all read the keys you are actually using, not the ones the app came with.

Text editing is deliberately not here. Cut, copy and paste inside a text field follow your own system’s convention — Ctrl on Windows and Linux, Cmd on a Mac — and an app that let you change those would have broken a contract rather than offered a preference.

Language

Flatty speaks English, Polski, Español, Deutsch and Português. The same flag-and-name button opens the picker from three places: the launcher, the Settings pane, and the flag at the bottom right of the window — whichever is in front of you.

Each language is listed under its own name, never translated, so landing somewhere you cannot read still lets you find your way back. That is also why the flag leads the three controls in the footer, and why every pane’s tab carries an icon as well as a word.

On first launch, before there is any saved choice, the interface guesses from your operating system and remembers the guess — it will not ask again and does not re-guess every morning. Picking a language from any of the three buttons overrides that from then on. A message with no translation yet falls back to English rather than showing a blank, so an incomplete language is still a usable one.

Credits

What you are running, and whose work is inside it.

The version at the top is the one to quote if you ever report something. Under it, Built with lists the open-source components in the binary and their licences — their authors are not connected with this program and give no warranty for it, and the notices are here because every one of those licences requires it.

The link goes to flatty.higreg.pl, which is where the newest version always is.

Panes

Any pane can show any view. Click a pane’s title tab to change it — the menu is grouped by what a view is for, artwork, layers, painting and setup — or drag the pane by the grip in its header to move it somewhere else, including into another of your workspaces.

Any of them can also be popped out over the whole window, from the command palette or (for the setup family) the setup panel, without disturbing the arrangement you built — see popping a pane out.

Every pane explains itself: the ? at the head of its header opens a card saying what that pane is for and listing its own keys — The question mark.

ViewWhat it holds
2D Canvasthe drawing grid, the bar along its foot, zoom and pan
3D Viewthe model, camera controls, the ground, the shading, the orb, rim paint
Vectorthe model as line art, its renderer and its style
Layer Decklayers as cards in 3D space
Outlinerthe active layer’s depth and position, and the layer list
Toolsthe seven tools with their settings
Palettethe two colour slots, the swatch grid, and the palette library
Mediaeverything you have imported: filter, tag, search, and what this project uses
Glyphsevery character in a font on your machine, to pick one for the stamp
Projectname, folder, save, canvas size, side shading, world placement
Exportone card per thing that comes out of a drawing
Layoutsnamed arrangements: the six that ship, and the ones you save
Appearancehow the interface is drawn: a theme’s colours, shape and spacing
Shadersthe numbers inside the app’s own shaders
Settingsthe app’s own preferences
Keysevery shortcut in the app, and the only place they change
Creditswhat you are running, and whose work is inside it

Canvas

A bar along the foot of the pane, in five captioned groups:

SELECTthe marquee and free select
INSERTpaste and place-a-picture, each with a chevron for “onto a new layer”
CANVASthe mirror axes, and a cog holding the overwrite switch
LAYERwhich layer you are drawing into, solo, clear, and the opacity key that fades it on the canvas
VIEWrecentre

The canvas size and the zoom factor are at its right-hand end.

Everything you do to a selection is not here: those seven keys appear beside the selection itself. See Drawing.

3D View

Along the bottom: the camera preset chip, the ground chip, the model-shading chip, then five square keys — the orb, Recenter, Rim paint, the stepped block that reads the layers bottom to top, and the camera — then a readout giving the turn, the tilt and the distance as three marks with their numbers. A pane too narrow for all of it drops what will not fit, the hint first. Hover any key for its name.

The orientation orb sits in the pane’s top right corner: three coloured arms and a ring for the ground plane. It is per pane; the ground and the shading are app-wide.

See The 3D view.

Vector

A live preview of the model as line art, and the controls that decide it: the renderer, the treatment, the line, the press and the page. It follows whichever 3D view the workspace holds. See Line art.

Recorder

Films the model turning, the line art turning, the canvas as you draw on it, or the whole app window while you use it, and writes an animated GIF — plus an .mp4 where the machine has ffmpeg. A rendered recording gets five cards: what to film, how far it turns and for how long, how big it comes out, what it sits on, and what to write. Filming the window replaces the middle three with one card of its own, runs until you stop it, and writes a video only. See Recording.

Outliner

The active layer’s Depth and Z offset above the list, then one row per layer: a triangle that opens it to show its islands, a visibility tick, a solo dot, ^ and v to reorder, the name, and a small bar drawing where that layer’s slab sits — hover it for the depth and the z. The toolbar adds, removes, reorders, selects all, squashes a selection and packs the layers back to back, and its readout gives the layer and island counts.

A layer’s opacity is not here. It fades the layer on the 2D canvas alone, so it lives on that pane’s own bar — see Layers and depth.

Layer order decides which layer wins where two slabs contest the same range. See Layers and depth.

Palette

Two tabs. Pick is the two colour slots, the eraser, the swatch grid and the library. Manage is the library proper: New, Import…, Copy, Install…, Use, Export…, Restore, Delete, plus the name, about and author fields, the Show in the Swiss Army Knife switch, and the colour editor.

Install… opens the browser for the 87 palettes that come with Flatty; Restore puts one of them back the way it shipped, and reads Update when a newer version has arrived.

Project

CardWhat it does
ProjectName, Location, Save, Save as…, New project…, Open project…
Recent projectsthe history, and where each one lives
Canvassize presets, width and height, ratio lock, anchor pad, Apply / Revert, auto-grow, and the undo budget
Side wallsShade — side = front pixel × shade
World placementLayers bottom to top · Pivot · Px / unit, with the resulting world size

Export

One card per output — 3D model with its Unlit material switch, the same model for editors (Blockbench, OBJ) and for printing (STL), artwork, line art, 3D view — plus the prefix, the folder, and Pack for sharing…. See Exporting.

Layer Deck

Mode chips (Look, Paint, Move), True Z with its spread slider, Labels and Frame. See the layer deck.

Tools

A rail of seven tools down the left, the selected one’s settings on the right. Split that way because the two halves are consulted at different rates: which tool is in hand is glanced at constantly, while its settings are adjusted far less often and need room for real controls.

Layouts

CardWhat it holds
Currentthe layout these workspaces came from, whether they have drifted since, and Save as new / Revert
Built inthe six that ship. They cannot be renamed or deleted — copy one instead
My layoutsthe ones you have saved, and the folder they are written to
Selecteda picture of the chosen one, and Apply, Copy, Update, Delete

See saved layouts.

Media

A gallery of everything you have imported, a filter bar above it, and a column on the right holding whatever you clicked and everything you can do to it. See Your libraries.

Glyphs

Every character in the chosen font, in a grid. The toolbar picks the font, filters the list by name and offers Rescan; a field reaches any codepoint by number or by paste; nine category chips narrow the grid. See the glyph stamp.

Appearance

The theme library — seven built in — and every value the selected theme states: its palette, the colours it fixes outright, its six radii and other shape values, its spacing, and whether section titles are set in capitals. See Appearance.

Shaders

The numbers inside the app’s own shaders, grouped as 3D model, Scene and Interface. Everything is live, only what you move is remembered, and Reset to defaults is safe to reach for. See tuning a shader.

Settings

Language, input, canvas, the 3D ground, startup, debug readouts, and the settings file. See Settings.

Keys

Every shortcut, grouped by where it applies, with a filter that reads the names and the keys. See Keys.

Credits

The version, what the program is for, that it is free and your work is yours, the address, and the open-source components inside the binary with their licences.

Tools

Seven of them, in a rail down the left of the Tools pane, in the Swiss Army Knife’s Tools card, and on the keys below.

ToolKeyGesture
BrushBdrag to lay colour down
BucketGclick to flood a region
Texture brushNdrag to work a texture into pixels already there
Glyph stampTclick to press a character in
FlextrudeFpaint to mark cells, then raise them
ShapesUdrag out a line, box or ellipse; click out a polygon
GeneratorKclick to grow one item, drag to sow a handful

Three modifiers mean the same thing to every tool that lays colour down:

left buttonthe primary colour
Ctrl + leftthe secondary colour
Shift + lefterase to transparent

The texture brush ignores both modifiers — it lays down the texture’s own colours. The bucket and the glyph stamp ignore mirror symmetry.

Ctrl+wheel resizes whatever mark you are holding, whichever tool that is: the brush’s footprint, the glyph’s ink height, the generator’s item height. So do [ and ].

Brush

SettingRange
Size1 upwards, in canvas pixels. The card draws the exact footprint
ShapeSquare (the whole footprint) or Circle (the disc inside it). Below 4 px a circle draws square

Plus Mixing.

Bucket

SettingDoes
Tolerancethe largest per-channel difference a colour may have from the one clicked and still be taken. 0 is an exact match; 255 fills the layer
Only what it toucheson, it stops at the edges of the region clicked; off, it takes every matching colour on the layer

A selection confines it. Shift+bucket floods a hole rather than a colour. The fill is four-connected, so two areas touching only at a corner are separate regions — the same rule the extruder finds islands by.

Brush size and symmetry are both ignored: a fill is defined by the region it finds, not by a footprint.

Texture brush

SettingDoes
the textures stripthe ones you have reached for lately. Add… brings a picture in; Manage… opens the Media pane; right-click removes one from the strip
Size, Shapeas the brush
Scalemagnifies the texture in whole steps, so its grain can be coarser than one canvas pixel

Plus Mixing — and here Intensity stays live in every mode, Normal included, because how much of a picture shows through means something even when the mode is a straight replacement.

A stamp can recolour a pixel that is already there and can do nothing else. This brush never creates one.

Glyph stamp

SettingDoes
the fontany font on your machine. Browse glyphs… opens the Glyphs pane
My glyphsthe characters you have stamped, each keeping the font it came from. The list holds still; Remove takes one off
Sizethe height of the letter’s own ink, in canvas pixels — not a point size
Fit to canvasgrow the letter until it fills the canvas without spilling over an edge
Weightfive steps, from only the pixels the letter fills completely to every pixel it touches at all

Plus Mixing, except Build up: a stamp lands once per press, so there is no second pass to deepen, and the switch and its Speed stay grey.

Colour emoji fonts are left out of the list entirely — they hold pictures rather than outlines, so there is nothing to scale. Monochrome emoji faces work normally.

Flextrude

SettingDoes
Size, Shapethe brush you mark with
Depthhow far the marked pixels are raised, in canvas pixels
Instant punchon, a stroke raises itself as you let go; off, paint as much as you like and press Raise
Raise / Clearlift the painted cells into a slab of their own; or unpaint them, leaving the drawing as it is

It lays no colour down and reads the whole stack rather than the active layer. Only cells the canvas actually draws can be marked. The layer deck refuses it. See Flextrude.

Shapes

SettingDoes
the shapeLine, Rectangle, Ellipse, Polygon
the fillOutline (boundary only, first colour), Filled (whole shape, first colour), Filled + outline (first colour inside, second on the edge)
Keep it regulara square, a circle, or a line on the horizontal, vertical or diagonal
The edgeSize and Shape for the boundary. A Filled shape has no edge to thicken and says so

Plus Mixing.

A polygon outlives a single press: Enter closes it, Backspace takes back the last corner, Esc throws it away.

Generator

SettingDoes
the growerGrass blade · Toon grass · Rock · Toon rock · Toon mushroom · Celestial body
the nurserya preview of the exact item in hand, at the size it will stamp
Keep the same itemoff, every stamp is a fresh roll; on, the item in the nursery is what you get
Re-rollone new item now
Coloursthe shelf the item grows from, bottom of the item first. Empty means the colour in hand is used
Heighthow tall the item stands, in canvas pixels
Shape, Growth, Detail, Toon, Skywhichever of these the chosen grower has
SowingSpacing along a drag, and Scatter off the line

It refuses to grow the canvas — a sow stamps along a path, and a canvas that grew mid-drag would move every position not yet reached. It mirrors, but grows a fresh item at each reflection.

Mixing

The same card wherever it appears.

ModeNormal · Multiply · Screen · Darken · Lighten · Overlay · Hard light · Soft light
Intensity0 leaves the artwork alone, 1 applies the mode in full
Build upoff, each pixel is mixed once per stroke; on, lingering keeps deepening it
Speedhow much each pass adds while Build up is on

Any mode but Normal recolours existing pixels only — there is nothing to mix with where there is no pixel. Normal ignores Intensity, and the slider goes grey to say so: a half-strength replacement would be a transparency, and transparency here is a hole in the model rather than thinner paint.

Selection

Both selection tools live in SELECT, at the foot of the canvas rather than in the tools rail — they suspend drawing rather than being a way to draw, and coming back out of one has to restore whichever tool was in hand.

ToolGesture
Selectdrag out a rectangle. Ctrl+A takes the layer’s contents
Free selecttrace a region by hand; the loop closes itself on release

A finished selection stays a marked-out region. Seven keys appear beside it:

Floattake the pixels off the layer, into your hand — a press inside the box does the same
Copy, Cutinto the copy buffer; Cut also takes them off the layer
Turn left, Turn righta quarter turn each way
Dropland what is in your hand
Clearput a float back, or take the marquee away

The overwrite switch, behind the cog in CANVAS, decides what a drop does to what is underneath: off, only the block’s own pixels land; on, the whole region it covers is erased first, empty space included.

See Selection.

Symmetry

Four mirror axes, behind one key in CANVAS that wears a picture of the axes themselves: | vertical, - horizontal, \ and / for the two diagonals. M cycles off · one · two · all four without opening it. Inside the panel, chevrons move an axis a cell at a time and a centre key puts them back.

With all four on, one press lands in eight places. Diagonals need a canvas whose sides differ by an even number, and are refused with a reason where they cannot land on whole cells.

Solo

The solo key in LAYER, at the foot of the canvas, shows the active layer on its own. Each row in the Outliner has one as well, and those accumulate — solo three and you see those three.

It reaches everything you look at and every picture taken of it: the 3D view, the line art, the artwork PNG, a recording. It does not reach a model file. The .glb, the .bbmodel, the .obj and the .stl are built from every ticked layer whatever is soloed, because soloing is not saved with the project. To keep a layer out of a model, untick it instead. See Layers and depth.

Opacity

The opacity key in LAYER, at the foot of the canvas, opens a slider that fades the active layer so you can see through it while you draw the one behind.

It changes the 2D canvas and nothing else — not the 3D view, not the layer deck, not the line art, and not a model file, at any value including nothing at all. The one file that follows it is the artwork PNG, because that picture is the canvas written out. See Layers and depth.

Keyboard and mouse

Everything here is what the app ships with. All of it can be changed in the Keys pane, and everything the interface draws on a keycap reads your own bindings rather than these — so a card that mentions a shortcut says so the moment you rebind it.

On a Mac, Cmd takes the place of Ctrl in every binding below. That is a rule rather than a table, so a shortcut added later follows it without anyone having to remember. Text editing is the one section that does not work that way, and it says so.

A shortcut belongs to a context — where it is listening — which is why Esc can appear several times without being a clash.

Everywhere

KeysDoes
Ctrl+Psearch every pane and command by name
Ctrl+,open the setup panel
Sopen the Swiss Army Knife
Ctrl+Ssave the project
Ctrl+Eexport the model
Ctrl+Shift+Eexport a PNG of the artwork
Ctrl+Zundo
Ctrl+Shift+Z · Ctrl+Yredo
Ctrl+Qquit — it asks first
Escclear the selection. Never quits

Tools

KeysDoes
Bbrush
Gbucket
Ntexture brush
Tglyph stamp
FFlextrude
Ushapes
Kgenerator
Xswap the two colours
[ / ]smaller / bigger mark
Mcycle the mirror

Workspaces

KeysDoes
Ctrl+1 … Ctrl+9go straight to that workspace

On the 2D canvas

These belong to the canvas and to it alone. They used to fire from every pane in the workspace, which meant Ctrl+A selected the artwork while you were reading the outliner.

KeysDoes
Ctrl+Aselect the layer’s contents
Ctrl+Ccopy
Ctrl+Xcut
Ctrl+Vpaste
Ctrl+Shift+Vpaste as a new layer
Deldelete what is selected
Enterclose the shape in flight
Backspacetake back the last corner

In the layer list

KeysDoes
Deldelete the selected layers

While a paste is in flight

A paste, a floated selection or a placed picture — all three are the same state. A cut is not: it takes the pixels away rather than putting them in your hand.

KeysDoes
← → ↑ ↓nudge a pixel — hold Shift for eight
Enterdrop it where it is
Esccancel — the pixels go back where they came from
Delempty the region instead of moving it
Ctrl+Vpaste again

In the image editor

KeysDoes
R / Shift+Rrotate a quarter turn, clockwise / anticlockwise
H / Vflip left-to-right / top-to-bottom
0reset the zoom
Enteruse the image
Escclose the editor

In a panel

KeysDoes
Enterconfirm
Escdismiss

In the command palette

KeysDoes
↑ / ↓move through the list
Enterrun
Escclose

The mouse

The Keys pane lists these as jobs the mouse does rather than as buttons, because that is what you rebind.

JobShips as
Orbit in 3Dleft button
Pan in 3Dmiddle button, or Space + left
Pan the canvasmiddle button, or Space + left
EyedropperAlt + left
Use the second colourCtrl
EraseShift + left
Resize the mark with the wheelCtrl
Add a row to the selectionCtrl
Select up to this rowShift
Open the Swiss Army Kniferight button, over the 2D canvas

A key chord matches exactly; a mouse gesture matches on a floor. A chord with no Shift in it will not fire while Shift is down — that is what makes the conflict check mean anything. A mouse role’s modifiers are a minimum, and unnamed ones are ignored, because the roles compose: Alt picks a colour, Ctrl means the other slot, and holding both picks into the other slot.

Shift beats Ctrl. Erasing is the destructive one, so if both are held by accident, the reading that destroys least is taken.

Scrolling and zooming

Not bindings — these are how the pointer works, everywhere.

DoGet
wheel, or two fingers, over the canvaszoom, anchored on the cursor
Shift+wheelpan the canvas
two fingers sidewayspan left and right
wheel over a panescroll it
wheel over a list inside a panescroll the list; at its end the pane behind takes over
wheel in a 3D panedolly the camera

Reverse zoom and reverse pan are in Settings, because which way a trackpad scrolls to zoom in depends on your system’s natural scrolling setting.

In a text field

Deliberately not rebindable: these follow your own system’s convention.

KeysDoes
Ctrl/Cmd+C / X / Vcopy · cut · paste
Ctrl/Cmd+Aselect all
Home / Endstart · end of the line. On a Mac, Cmd+← / → as well
Ctrl+← / → — Option on a Macmove a word at a time. The same modifier with Backspace or Del deletes one
Entercommit
Esccancel, putting back what was there

Clicking away from a field commits it too.

Panes and gutters

DoGet
click a pane’s title tabchoose what that pane shows
drag the dotted gripmove the pane, here or into another workspace
double-click the gripfold the pane to a strip, and unfold it again
drag a guttergive one of two panes more room
right-click a workspace squarerename, duplicate or close it

Files on disk

A project folder

A project is any folder containing a project.fdraw. Nothing else marks one, nothing registers it anywhere, and moving the folder moves the project.

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 is JSON: the canvas size, the layers as embedded PNGs, the per-layer depth and Z offset, the side-wall shade, the pivot, the scale, the mirror axes, and the palette’s colours.

The palette’s colours travel with the project, not a reference to a palette. A project has to open with its right colours on a machine that has never seen your library. Everything else it merely references.

Every export is written twice — a timestamped archive that is never replaced, and a fixed-name copy in latest/ for a path your game can hard-code. See Exporting.

What an export writes

SuffixWhat it is
.glbthe mesh, an embedded PNG atlas, and a node hierarchy of sprite → layer → island
.meshes.jsonthe sidecar: index → island, plus the pivot, the scale, which way the layers run, and the bounds
.bbmodelthe model as a Blockbench project — quads, a group per layer, the texture inside
.obj · .mtl · .atlas.pngthe model as Wavefront OBJ, its material file, and the texture the material names — three files that only work together
.stlthe model as one closed solid for printing, at a millimetre per pixel
.pngthe artwork, composited flat, at its own pixel size
.vector.pngthe line art, rasterised
.view.pngthe 3D view, model only, no ground
.svgthe line art as a vector file

Four of those are PNGs of the same project, told apart by suffix alone. That is deliberate and worth knowing before you write a script that globs *.png.

What is in a .glb

Standard binary glTF, loadable by anything that reads glTF 2.0.

  • One mesh per island — a separately connected piece of artwork — grouped under a node per layer.
  • One material, one embedded PNG atlas, NEAREST sampling requested. The atlas is never taller than it is wide, and a power of two when the canvas is one.
  • alphaMode: "BLEND" only when some texel in the atlas is translucent; otherwise the key is absent and the model behaves as an opaque one.
  • KHR_materials_unlit on the material when Unlit material is on — listed as used, never as required, so a loader that does not know it still opens the file.
  • The pivot is baked into the geometry, so DrawModel(m, pos, …) needs no offset.

The .meshes.json sidecar

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

It exists because raylib’s Model has no mesh names, only a Meshes array. Look parts up by path rather than by bare name: island names are numbered per layer, so two layers can each hold a part_1.

orientation is back-to-front or bottom-to-top — which way the layers were read into the model. The geometry and the bounds are already turned, so it changes nothing a game has to do; it is there so a script can tell which axis the layer stack runs along without measuring.

Your settings and your libraries

PlatformSettings folder
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

Everything is written atomically, so an interrupted write cannot leave a truncated file.

config.json stores only what you changed. Your keymap is a list of deviations from the shipped one, which is what lets a later version move a default without overriding your choice — and what makes a shortcut you cleared on purpose stay cleared.

There is a second folder, in your system’s cache directory, for what Flatty can rebuild by itself: the list of fonts on your machine, and the media gallery’s thumbnails. Deleting it costs nothing but the seconds it takes to fill in again.

Your projects are somewhere else entirely — wherever you put them.

Palette files it reads and writes

Reads: .gpl (GIMP), .pal, .hex, .txt, and .ase (Aseprite).

Writes: .gpl, .pal, .hex, .txt.

Image formats

opensPNG, JPEG, GIF
the media library storesPNG only
exportsPNG

WebP and AVIF are not offered, because Go has no decoder for either in its standard library.

A source over 40 megapixels is refused, read from the file’s header. Anything smaller opens, and the result is capped instead — 512 px on the long edge for a brush texture, the canvas’s own long edge for a picture going onto it.

Command line

flatty -h prints the lot. Nothing here is needed for ordinary use — these are for build scripts, for reproducing a bug report, and for opening the app already pointed at something.

Opening something

FlagDoes
-open <path>open a project: its folder, or its project.fdraw
-project <dir>the project folder to work in; created by -save if it is not one yet
-name "Nice Name"the project’s name, which also sets the export filenames
-palette <file>import a palette file at startup
-tool <name>put a tool in hand: brush, bucket, texture, glyph, flextrude, shapes or generator
-no-launcherskip the startup chooser
-show-launcherforce it, even when something else would have skipped it

Running headless

FlagDoes
-savewrite the project file and exit
-exportwrite exports/ and exports/latest/, then exit
flatty -project ./sprites/cloud -demo cloud -save   # create it and write the project file
flatty -open ./sprites/cloud -export                # write the exports

Both need somewhere to write, so they refuse to run without -project or -open rather than inventing a path. Deriving one from a root plus the title is what used to move somebody’s work when they renamed a project.

A scripted run writes no settings. -project, -save, -export and -screenshot all suppress config writes, so a run told what to work on cannot rewrite your history, your workspaces or your preferences as a side effect. The Settings pane says Not saving when that is in force.

The window

FlagDoes
-width N / -height Nwindow size; 0 fills the monitor
-layout <id>start with a built-in layout instead of the saved workspaces
-workspaces Nstart with N workspaces, showing an empty one
-theme <id>interface theme for this run only, by id
-lang <code>interface language for this run only: en, pl, es, de, pt

Layout ids are default, full, deck, palette, settings and rico-full. They are ids rather than the names the pane shows — default is Simple, full is Claudy, rico-full is Rico — because an id has to keep working after a layout is renamed. No flag restores your session; a name that is not a built-in stops the run rather than quietly giving you your own workspaces back.

Theme ids are organic, night-wave, and the five moods — night-wave-jungle, night-wave-kapuccino, night-wave-soft, night-wave-soft-jungle and night-wave-soft-kapuccino — plus any of your own. A name that is not one stops the run and prints the list.

-theme and -lang change nothing on disk: they are for this run only.

Opening a panel at startup

Each of these does exactly what a click somewhere in the interface does. They exist so a panel can be photographed or reproduced without a hand on the mouse.

FlagOpens
-show-helpthe app’s help card
-show-setupthe setup panel
-show-commandsthe command palette
-show-knifethe Swiss Army Knife, pinned open
-show-pickerthe project chooser
-show-new-projectthe New Project panel
-show-quitthe quit dialog
-show-unsavedthe unsaved-changes dialog
-show-wheelthe colour wheel
-show-layoutsthe Layouts pane
-show-mediathe Media pane
-show-vectorthe Vector pane
-show-recorderthe Recorder pane
-show-glyphsthe Glyphs pane, with the stamp in hand
-show-keysthe Keys pane
-show-texture-pickerthe file browser in file mode
-edit-image <file>the image editor, on its way to the media library
-place-image <file>the image editor, on its way onto the canvas
-popout <name>pop a pane out over the workspace — any pane’s written name: settings, keys, theme, view3d, vector, export, recorder, …
-recordstart a recording at once and quit when it is written. Needs -project or -open, and will not film the canvas — that one waits for somebody to draw. Filming the window is allowed: it ends on its own at the cap on its card

Screenshots and test artwork

FlagDoes
-screenshot <file>render N frames, write a PNG, exit
-frames Nhow many frames first. Default 30
-demo <name>seed test artwork
-show-redrawtint each pane on the frame it is redrawn, to see which are being kept

-demo takes cloud, layers, mirror, clip, lasso, palettes, deck, deckback, decksolo and texture.

Two things about -screenshot are worth knowing, because both look like bugs:

  • It writes relative to the current directory, not to where you thought you asked. An absolute path fails.
  • A low -frames count barely advances an animation. The first frames are not yet paced by the display, so -frames 30 can be hundredths of a second of animated time — and anything that moves looks as if it is not drawing at all. Use 60 or more before concluding anything is broken.

-screenshot also switches tooltips and hover off for the run, because a scripted run has no hand on the pointer and the pointer sits wherever the compositor left it.