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

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.