PyDPainter logo PyDPainter Docs Gallery Download Blog

Brush Menu

A brush is a rectangle of pixels grabbed from the screen, which can in turn be used in all drawing tools, animation tools, or certain fill modes. To define a brush, first click the Brush tool in the toolbar then drag a rectangle around the desired area on screen. After releasing the mouse button, you will see the brush follows the mouse cursor and you can draw with it on the screen. The current background color (black by default) will be interpreted as a transparent color.

Open...

Shows a file requestor to allow you to choose a file to load as a brush.

You can load these examples in docs/menus/src directory. Starting Earth brush is original.png

Save as...

Shows a file requestor to allow you to save current brush to a file as a brush. This is mostly used with iff/ilbm file types.

Restore

Restore the brush as you defined it the first time you grabbed or loaded it.

original
key: SHIFT-B


Size

Stretch

Use the mouse to freely resize the brush. Proportions will be lost.

stretch
key: SHIFT-Z

Realtime resizing with shortkeys

Please note you can use the + and - keys for resizing with an accuracy of 1 pixel for each press. Proportions are respected. A reminder in % of the original size is displayed in the menu bar. resize ba
It will be updated realtime. This is useful in conjunction with the repeated use of the + and - keys to enlarge or reduce the size. This can also be useful for previewing your rotation settings so that you can use them in the new Brush Trail functions (formerly Spacing). Use Restore Brush if unhappy with the result.

Halve

Reduces brush size by half, without any anti-aliasing.

Half
key: h

Double

Double brush size, without any anti-aliasing. This can help create a highly pixelated retro effect on text or graphics.


key: SHIFT H

Double Horiz

Horizontally double the size of the brush.


key: SHIFT-X

Double Vert

Vertically double the size of the brush.


key: SHIFT-Y


Flip

Horiz

Flips brush direction horizontally, right and left are reversed.


key: x

Vert

Reverse brush direction vertically, top and bottom are flipped.


key: y


Edge

Outline

Adds an outline of the foreground color. This operation can be repeated for a larger contour, including by changing the color.


key: o

Please note that as black (colour 0) is already the default transparency colour, adding an outline in this colour is not possible. If you need a black outline, redefine your brush on a reserved background such as pink 255,0,255. This trick will allow you to catch a sprite with the Brush tool with this pink background as transparency, and then use Outline to define a black outline.

Trim

Removes a one-pixel edge around the brush. If the brush has holes (background color is transparency) or irregularities inside, this will also alter them. If this operation is repeated, the brush will eventually be completely trimmed.


key: O


Rotate

90 Degrees

Turn the brush 90 degrees. If repeated, the brush will be rotated 180 then 270 degrees, and finally back to its original position.

Please note that this is not the same as FLIP X or Y. Very useful for adding some variety using the same brush.


key: z

Any Angle

Use your mouse to rotate the brush freely. The brush rotates around its centre.

Use 23.4° for Earth 🙂

Right 1°

Rotate the Brush 1° clockwise around current handle. Note that the handle serves as the rotation point. key: 0

Left 1°

Rotate the Brush 1° anticlockwise around current handle. Note that the handle serves as the rotation point. key: 9

New in 2.2


A reminder in degrees of the current rotation is displayed in the menu bar. It will be updated realtime. This is useful in conjunction with the repeated use of the 0 and 9 keys for rotation right or left. This can also be useful for previewing your rotation settings so that you can use them in the new Brush Trail functions (formerly Spacing).

Set to 0°

Reset the brush rotation to 0° (as grabbed, or loaded) shift 0

Shear X

Slant the brush horizontally with the mouse. Think italics!

Shear Y

Slant the brush vertically with the mouse.


Change Color

BG -> FG

Changes one color to another in the brush. This makes everything that is the current Background (BG) color into the current Foreground color (FG). Carefully select each color in the toolbar before using this function.

(orange has been changed to yellow)

BG <-> FG

Exchanges two colors in the brush. This is the current Background (BG) color and the current Foreground color (FG). Carefully select each color in the toolbar before using this function.

Remap

Try to remap, to approximate as closely as possible, the original brush colors in the context of the new palette colors. This only makes sense if:

Change Transp

Changes the brush transparency from the current background color. Note: if you want a brush with no transparency, just use Repl MODE (F3).

Only one color can be transparent. If you had transparent black and wanted orange to be transparent too, you couldn't. In this case, fill the orange with black before redefining your brush.


Bend

Horiz

Deforms brush horizontally along a curve.

Vert

Deforms brush vertically along a curve.


Handle

Defines the handle point (shown as a crosshair). This point is used for all on-screen drawing and animation tools. It cannot "leave" the screen.

Center

Defines the handle point in the center of the brush. It's by default.


key: Alt-s

Corner

Sets the cross at a corner of the brush, starting with the top left corner. If you repeat, the corner changes around the imaginary square that surrounds the brush.


key: Alt-x

Drawing with a brush held by a corner allows you to draw close to the edges of the screen and change the behavior of drawing tools.

Place

Use the mouse to freely define the brush's handle point.


key: Alt-z

Documentation written by Stephane Anquetil

Participate in the community:
Facebook Github Twitter Mastodon Ko-fi RSS feed