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

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.