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.
| Tool | Key | What it does |
|---|---|---|
| Brush | B | drag to lay colour down |
| Bucket | G | click to flood a region with one colour |
| Texture brush | N | drag to work a texture into pixels already there |
| Glyph stamp | T | click to press a character from any font into the canvas |
| Flextrude | F | paint over the drawing, then raise what you painted into a slab of its own |
| Shapes | U | drag out a line, a rectangle or an ellipse, or click out a polygon |
| Generator | K | click 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 button | the primary colour |
| Ctrl + left | the secondary colour |
| Shift + left | erase 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.
| Mode | Normal, Multiply, Screen, Darken, Lighten, Overlay, Hard light, Soft light — how a stroke combines with what is underneath |
| Intensity | how much of that combination to apply. 0 leaves the artwork alone, 1 applies the mode in full |
| Build up | off, each pixel is mixed once per stroke; on, lingering keeps deepening it, like an airbrush |
| Speed | how 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:
| Shape | Gesture |
|---|---|
| Line | drag from one end to the other |
| Rectangle | drag out a box |
| Ellipse | drag out the box it fits inside |
| Polygon | click 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:
| Outline | the boundary only, in the first colour |
| Filled | the whole shape, in the first colour |
| Filled + outline | first 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
| Do | Get |
|---|---|
| drag with the marquee | a rectangular selection |
| the free-select tool | a freehand region; the loop closes itself when you let go |
| Ctrl+A | the whole of the layer’s contents |
| Ctrl+C / Ctrl+X | copy / cut |
| Ctrl+V | paste |
| Ctrl+Shift+V | paste onto a new layer |
| Del | empty 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:
| Float | take the pixels off the layer, into your hand |
| Copy | into the copy buffer |
| Cut | into the copy buffer, and off the layer |
| Turn left, Turn right | a quarter turn each way |
| Drop | land what is in your hand where it is |
| Clear | put 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.
| Do | Get |
|---|---|
| drag it | move it |
| drag a grip | resize it — eight of them, corners and sides |
| drag the arm above it | turn it to any angle; hold Shift for 15° steps |
| the two quarter-turn keys | exactly 90°, left or right |
| arrow keys | nudge a pixel, or eight with Shift |
| Enter, or a click off it | drop it where it is |
| Esc | call it off — the pixels go back where they came from |
| Del | empty 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.
| off | only the block’s own pixels land; empty space in it leaves what is under it alone |
| on | the 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
| Do | Get |
|---|---|
| middle-drag, or Space+drag | pan |
| wheel, or two fingers | zoom, anchored on the cursor |
| Shift+wheel | pan — the trackpad gesture |
| two fingers sideways | pan left and right |
| Ctrl+wheel | resize 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.