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

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.