Shortcuts

Every action in Blockwright's menus and docks, menu by menu, with the keys it starts with and what it does. Any of them can be given a key. Help > Keyboard Shortcuts shows the actions that have a key, with the keys they have now.

Typing keys aren't actions, and nor are the keys a tool takes while you use it (the select tool's arrows, Enter and Esc, the glyph brush's F-keys). Keyboard mode lists the typing keys and the F-key glyph sets.

Changing a shortcut

Open Edit > Preferences and its Shortcuts tab (Preferences). Pick an action in the list (the search box finds an action by its name or its key), then press the new key in Key. No Key takes the action's keys away. Default gives it its default keys back, but for any of them another action has now: it leaves that key off and names the action that has it under the list. Reset All gives every action its default keys back. Nothing changes until you press OK.

An action gets one key here: a single key, with any modifiers it needs, and not a modifier on its own. Meta is the Windows key. The editor refuses these, and says why under the list:

a key keyboard mode types or edits with:
- any key but an F-key, unless Ctrl or Meta is held;
- F1 to F10 alone or with Shift, but for Shift+F1;
- Ctrl or Meta with Alt and a character, as Ctrl+Alt is AltGr on Windows;
a key the desktop takes:
- Alt with an F-key;
- Ctrl with an F-key, unless Shift or Meta is held too;
- Ctrl+Alt+Del and Ctrl+Alt+Backspace;
a key another action already has.

Every action

These are the keys Blockwright 0.1.1 (bd67fae) starts with on Qt 6.12.0.

Keys marked (standard) are the platform's standard keys for that action: the table gives the ones Qt gives a Linux desktop, and another platform, or another version of Qt, can give the action other keys.

F14, Undo and Redo are keys some keyboards have.

File

Action	Shortcut	What it does
New	`Ctrl`+`N` (standard)	Start a new blank canvas, asking to save unsaved edits first
Open	`Ctrl`+`O` (standard)	Open a file, asking to save unsaved edits first
Open Project Directory		Open a project saved as a directory
Open Scene		Open a Python scene as a new project, a generator layer for each of its layers
Start Screen		Start over on a new canvas with the start screen over it, asking to save unsaved edits first
Save	`Ctrl`+`S` (standard)	Save the document to its file, asking for a name if it has none
Save As	`Ctrl`+`Shift`+`S` (standard)	Save the document under another name
Save As Project Directory		Save the document under another name as a project directory
Take Snapshot		Add the canvas as the project's next round, an .ans kept in the project
SAUCE		Edit the SAUCE record: title, author, group, date and comments
Export IRC Text		Write the canvas as IRC lines, one message each, as the row meter measures them
Export Micron		Write the canvas as a Micron page (.mu) for NomadNet
Publish to Library		Write the document into the art library folder as a named piece with tags
Send to WeeChat		Copy the document over SSH to a host's wip folder for WeeChat, as the piece's next round
Open Reference Image		Add a picture as a reference layer to draw over
Quit	`Ctrl`+`Q` (standard)	Close Blockwright, asking to save unsaved edits first

File > Reopen with Encoding

Action	Shortcut	What it does
Auto (as its bytes say)		Open the .ans again, read as its bytes say
CP437		Open the .ans again, read as CP437
UTF-8		Open the .ans again, read as UTF-8

Edit

Action	Shortcut	What it does
Undo	`Ctrl`+`Z`, `F14`, `Undo` (standard)	Undo the last edit
Redo	`Ctrl`+`Shift`+`Z`, `Redo` (standard)	Redo the last edit undone
Preferences		Set the fonts folder, the target new documents get, and the actions' keys
Cut	`Ctrl`+`X`	Copy the selection and clear its cells
Copy	`Ctrl`+`C`	Copy the selection
Paste	`Ctrl`+`V`	Float what was copied at the cell cursor
Delete	`Del`	Clear the selected cells
Mirror Mode	`Ctrl`+`M`	Repeat what the drawing tools paint as Edit > Symmetry says

Edit > Symmetry

Action	Shortcut	What it does
Mirror X		Mirror mode repeats a stroke flipped left to right about the canvas centre
Mirror Y		Mirror mode repeats a stroke flipped top to bottom about the canvas centre
Mirror X and Y		Mirror mode repeats a stroke flipped both ways about the canvas centre, four in all
Radial		Mirror mode repeats a stroke turned about a centre, as many times as Tool Options says

View

Action	Shortcut	What it does
Zoom In	`Ctrl`+`=`, `Ctrl`+`+`	Zoom in on the canvas
Zoom Out	`Ctrl`+`-`	Zoom out from the canvas
Actual Size	`Ctrl`+`0`	Show the canvas at its actual size
iCE Colours		Bright backgrounds as 16 colours; off, they blink on the dark colour
9 px Letter Spacing		9 px cells, line-drawing glyphs 0xC0-0xDF joined as on VGA; off, 8 px

View > IRC

Action	Shortcut	What it does
Row Meter		Every row's size in bytes as an IRC line, beside the canvas
IRC View		Show or hide the IRC View dock
Budget		Set the bytes an IRC line may take, which the row meter and Export IRC Text hold lines to
Fit Lines to the Budget		Merge the least visible colours in a line over the budget until it fits
Pad Lines		Keep blank rows and trailing black, so clients that trim spaces keep the shape
Swap Shades		Draw ░ as ▓ with the colours swapped, and ▓ as ░, where it saves bytes

View > Guides

Action	Shortcut	What it does
None		Show no screen-size guides
80x25		Show a guide after column 80 and after every 25 rows
80x40		Show a guide after column 80 and after every 40 rows
80x50		Show a guide after column 80 and after every 50 rows

Format

Action	Shortcut	What it does
Canvas Size		Make the canvas another size, keeping it at a side, a corner or the centre

Format > Target

Action	Shortcut	What it does
ANSI (.ans)		The 16 colours and the glyphs an .ans holds
IRC		mIRC's 99 colours; saving as .ans, XBIN or BIN reports what it can't hold

Colours

Action	Shortcut	What it does
Previous Foreground	`Ctrl`+`Up`	Make the foreground the palette's previous colour
Next Foreground	`Ctrl`+`Down`	Make the foreground the palette's next colour
Previous Background	`Ctrl`+`Left`	Make the background the palette's previous colour
Next Background	`Ctrl`+`Right`	Make the background the palette's next colour
Default Colours	`Ctrl`+`D`	Set the pen back to grey on black, with no formatting
Swap Colours		Swap the foreground and background colours

Glyphs

Action	Shortcut	What it does
Previous Set	`Ctrl`+`,`	Make the previous glyph set the one F1 to F10 type
Next Set	`Ctrl`+`.`	Make the next glyph set the one F1 to F10 type
Default Set	`Ctrl`+`/`	Make the default glyph set the one F1 to F10 type
Set 1: ┌┐└┘─│├┤┴┬	`Ctrl`+`Shift`+`F1`	Make set 1 the glyphs F1 to F10 type
Set 2: ╔╗╚╝═║╠╣╩╦	`Ctrl`+`Shift`+`F2`	Make set 2 the glyphs F1 to F10 type
Set 3: ╒╕╘╛═│╞╡╧╤	`Ctrl`+`Shift`+`F3`	Make set 3 the glyphs F1 to F10 type
Set 4: ╓╖╙╜─║╟╢╨╥	`Ctrl`+`Shift`+`F4`	Make set 4 the glyphs F1 to F10 type
Set 5: ┼╬╪╫ΦΦ¢£Ö∩	`Ctrl`+`Shift`+`F5`	Make set 5 the glyphs F1 to F10 type
Set 6: ░▒▓█▀▄▌▐■·	`Ctrl`+`Shift`+`F6`	Make set 6 the glyphs F1 to F10 type
Set 7: ☺☻♥♦♣♠≡♫☼	`Ctrl`+`Shift`+`F7`	Make set 7 the glyphs F1 to F10 type
Set 8: ↑↓▲▼►◄↕↔¶§	`Ctrl`+`Shift`+`F8`	Make set 8 the glyphs F1 to F10 type
Set 9: «»≥≤⌐¬²÷½¼	`Ctrl`+`Shift`+`F9`	Make set 9 the glyphs F1 to F10 type
Set 10: π±⌠⌡Ω¥Σ°√ⁿ	`Ctrl`+`Shift`+`F10`	Make set 10 the glyphs F1 to F10 type
Set 11: αßΓσµτδ∞φε		Make set 11 the glyphs F1 to F10 type
Set 12: ÇçÑñÿƒ≈∙¡¿		Make set 12 the glyphs F1 to F10 type
Set 13: âäàáªåÄÅæÆ		Make set 13 the glyphs F1 to F10 type
Set 14: êëèéÉîïìí₧		Make set 14 the glyphs F1 to F10 type
Set 15: ôöòóºûüùúÜ		Make set 15 the glyphs F1 to F10 type
Set 16: /\(){}[]`'		Make set 16 the glyphs F1 to F10 type
Set 17: ▖▗▘▝▚▞▙▛▜▟		Make set 17 the glyphs F1 to F10 type Offered only in IRC and UTF-8 documents.
Set 18: ▁▂▃▄▅▆▇█▔▕		Make set 18 the glyphs F1 to F10 type Offered only in IRC and UTF-8 documents.
Set 19: ▏▎▍▌▋▊▉█▐▕		Make set 19 the glyphs F1 to F10 type Offered only in IRC and UTF-8 documents.
Set 20: ◢◣◤◥◆◇○●★☆		Make set 20 the glyphs F1 to F10 type Offered only in IRC and UTF-8 documents.
Set 21: ✦✧✶✷✸✹⋆✱✺❖		Make set 21 the glyphs F1 to F10 type Offered only in IRC and UTF-8 documents.

Tools

Action	Shortcut	What it does
Keyboard	`Ctrl`+`K`	Types at the cell cursor in the pen's colours, the way a text editor does.
Select	`Ctrl`+`E`	Selects a rectangle of cells to copy, move, flip or rotate. While there is a selection, the brushes, the shapes, Fill and Gradient paint only inside it; typing with Keyboard or Text does not keep to it.
Move/Transform	`Ctrl`+`Shift`+`J`	Moves the active layer, and moves and resizes a reference layer. Alt+drag does the same move with any other tool.
Half-Block Brush	`Ctrl`+`B`	A pencil of half-block pixels: each cell is two square pixels, top and bottom, drawn with ▀ and ▄.
Shade Brush	`Ctrl`+`Shift`+`B`	Builds a cell up through space, ░, ▒, ▓ and █ in the pen's colours, a step each time the brush passes.
Ramp Shade Brush	`Ctrl`+`T`	Lightens or darkens the cells under it along a colour ramp, through the ░▒▓ shades between each pair of colours.
Form Brush	`Ctrl`+`Shift`+`T`	Shades a shape as a lit dome, cylinder or flat plane along the ramp, with a lit side, a short fall of shades and a shadow side.
Soft Brush	`Ctrl`+`Shift`+`N`	The ramp shade brush with a soft edge: it moves the middle of the tip the most and the edge a rung, in bands a cell wide.
Despeckle Brush	`Ctrl`+`Shift`+`D`	Cleans up specks: a lone cell lighter or darker than every neighbour on the ramp takes the rung most of its neighbours share.
Smudge Brush	`Ctrl`+`Shift`+`M`	Picks up the ramp colours under the tip and drags them along the stroke, like a finger through paint.
Glyph Brush	`Ctrl`+`G`	Paints one glyph in the pen's colours wherever it passes.
Colorize Brush	`Ctrl`+`Shift`+`C`	Recolours the cells it passes and keeps their glyphs.
Line	`Ctrl`+`L`	Draws a straight line of half-block pixels from where you press to where you let go.
Rectangle	`Ctrl`+`U`	Draws a rectangle of half-block pixels from the corner you press to the corner you let go at.
Ellipse	`Ctrl`+`Shift`+`O`	Draws an ellipse of half-block pixels inside the box from where you press to where you let go.
Frame	`Ctrl`+`Shift`+`I`	Draws a border to fit the rectangle you drag, from the corner you press to the corner you let go at.
Fill	`Ctrl`+`J`	Floods the area of one colour under the click with the pen's colour, a half-block pixel at a time.
Ramp Gradient	`Ctrl`+`Shift`+`G`	Fills with a gradient along the ramp, in bands of whole cells shaded ░▒▓, from where you press to where you let go.
Eyedropper	`Ctrl`+`I`	Picks a colour off the canvas into the pen.
Outline Brush	`Ctrl`+`Shift`+`E`	Draws a one-cell outline round a shape: each edge cell under the brush aims for the ramp colour one step darker than the darkest of the shape just inside it. Where that would break the shading rules the lint checks, the cell takes a lighter shade instead, or is left as it is.
Rim Light Brush	`Ctrl`+`Shift`+`L`	Lights a shape's edge: edge cells of the ramp's shape that face the light go one rung lighter.
Texture Stamp	`Ctrl`+`Shift`+`P`	Stamps a texture of small lit forms along the ramp: scales, foliage, a coin hoard, brick or mottled stone.
Clone Stamp	`Ctrl`+`Shift`+`K`	Copies whole cells from one place to another: glyphs, colours and transparency.
Glyph Spray	`Ctrl`+`Shift`+`Y`	Scatters stars, haze or smoke across the cells it passes.
Text	`Ctrl`+`Shift`+`X`	Writes live text in a font: a bundled face or a TheDraw font. The text stays editable on its own layer.
Filled Shapes	`Ctrl`+`Shift`+`F`	Draw rectangles and ellipses filled; off, as outlines
Smaller Brush	`Ctrl`+`[`	Make the brush a cell smaller
Larger Brush	`Ctrl`+`]`	Make the brush a cell larger

Selection

Action	Shortcut	What it does
Select All	`Ctrl`+`A`	Select the whole canvas
Deselect	`Ctrl`+`Shift`+`A`	Select nothing, landing a floating selection
Flip Horizontally	`Ctrl`+`Shift`+`H`	Flip the selection left to right
Flip Vertically	`Ctrl`+`Shift`+`V`	Flip the selection top to bottom
Rotate Clockwise	`Ctrl`+`R`	Turn the selection a quarter turn clockwise
Rotate Counterclockwise	`Ctrl`+`Shift`+`R`	Turn the selection a quarter turn counterclockwise
Save to Library		Keep the selection in the Library as a stamp, with a name, category and tags
Save as Frame Style		Keep the selection as a frame style for the Frame tool, with a name and insets

Selection > Paste Mode

Action	Shortcut	What it does
Normal		Paste every cell, blank ones too
Transparent (blank cells don't paste)		Paste all but the blank cells, so what is under them shows
Under (only into blank cells)		Paste only into blank cells, leaving drawn ones as they are

Layer

Action	Shortcut	What it does
New Cells Layer		Add a Cells layer above the active layer: glyphs and shades
New Pixels Layer		Add a Pixels layer above the active layer: half-block drawing
Delete Layer		Delete the active layer
Raise Layer		Move the active layer up one
Lower Layer		Move the active layer down one
Layer Style		Edit the active layer's style: plate, glow, shadow, outline, fill, shade and bevel
Bake Layer		Make the layer a cells layer of what it shows: a text layer's text, a generator's output, or a layer's style, can't be edited after

Layer > Reference Opacity

Action	Shortcut	What it does
25%		Show the active reference layer's picture at 25% opacity
50%		Show the active reference layer's picture at 50% opacity
75%		Show the active reference layer's picture at 75% opacity
100%		Show the active reference layer's picture at 100% opacity

Window

Action	Shortcut	What it does
Toolbox		Show or hide the Toolbox dock
Tool Options		Show or hide the Tool Options dock
Preview (1x)		Show or hide the Preview (1x) dock
Palette		Show or hide the Palette dock
Layers		Show or hide the Layers dock
Library		Show or hide the Library dock
Lint		Show or hide the Lint dock
Glyphs		Show or hide the Glyphs dock
Reset Layout		Put every dock back where it starts

Help

Action	Shortcut	What it does
What's This?	`Shift`+`F1`	Click a toolbox button, a menu item or a tool option to see what it does
Keyboard Shortcuts		List every action that has a key, with its keys
Manual		What each tool, its options and each kind of layer do
About Blockwright		Blockwright's version, commit, licence and credits
About Qt		The version of Qt Blockwright runs on, and its licence

Palette

Action	Shortcut	What it does
B		Bold: the glyph brush writes ^B
I		Italic: the glyph brush writes ^]
U		Underline: the glyph brush writes ^_

Describes Blockwright 0.1.0 (12ee9ef).