How to Use (version 3.4 and older) - NinthDesertDude/Dynamic-Draw GitHub Wiki

Get Dynamic Draw 3.3 here (this is an old version for people using legacy Paint.Net versions).

Dynamic draw

Overview

Note: These notes describe an old version of Dynamic Draw. See the updated documentation here.

Dynamic Draw is a plugin that can be installed alongside Paint.Net that enables much more in-depth illustration as well as tablet drawing. It's useful for making effects like hearts or rain, textures, and repetitive textures like grass. Major features:

  • Custom brushes and brush images
  • Dynamic behaviors
  • Channel locks and blend modes
  • Symmetry drawing
  • Tablet support and canvas rotation

Install Location

After putting the DynamicDraw folder within the Effects folder of your Paint.NET installation, you will see it appear under the Effects → Tools menu.

Plugin Install Location

Using the Plugin

The white rectangle is your image, also called the canvas. The rectangle centered around the mouse is the brush indicator, which hints at the bounds of the brush. On the right side of the screen are the settings, which are separated into collapsible sections.

Tablets are currently supported for Huion and Wacom using the WinTab API. At the moment, this includes position, pressure, and tablet button shortcuts. There are plans to include the Windows Ink API.

Plugin Layout

Canvas Behavior

Navigation

Use the Canvas Zoom slider under the Basics section, or Ctrl + Mouse Wheel to zoom in and out.
Use the Canvas Angle slider under the Basics section, or Shift + Mouse Wheel to rotate the canvas. This is useful mainly for tablet users.

When zoomed in, you can move the image by panning. Use the middle mouse button or Ctrl + left mouse button and move the mouse to pan.

Tip: You can also nudge the canvas using Ctrl + arrow keys, or reset canvas zoom, position, and rotation by pressing Zero (not numpad Zero).

How to Draw

Making a brush stroke is similar to Paint.Net. Panning is also automatic when drawing beyond the visible screen. The brush indicator will be hidden when drawing.

Drawing With a Selection

If you select a region before opening the plugin, you will see everything around that area darkened. Changes you make in the darkened area will be discarded when you apply the plugin, since only the selected pixels are affected. The white area in the image below is the selected area.

Selection on Canvas

Setting the Canvas Background

You can right-click the canvas to open a dialog that lets you set the color of the background for transparent regions (white rectangle). It can be transparent, white, black, the grey canvas background color, or replaced by the image on the clipboard.

Tip: When working with multiple layers, to see the layers underneath the current layer, merge them down before opening the plugin, copy the merged layer, and undo the merge. Now that it's on the clipboard, open the plugin and right-click to set the image on the clipboard. You can now see the layers underneath the current layer.

Canvas Background Options

Tools

The tools located above the normal settings let you switch between various applications. From left-to-right, the tools are: Brush, Eraser, Color Picker, Set Origin.

Tools

Brush: Allows you to draw on the canvas. This is the default tool when starting the plugin.

Tip: Press B to switch to the brush tool. Press again to return.

Eraser: Works exactly like the brush, except it erases wherever you draw. Instead of erasing to be fully transparent, this tool erases to reveal the image as it originally was when first starting the plugin. (Use the brush tool at full transparency in overwrite blend mode for typical erase behavior.)

Tip: Press E to switch to the erase tool. Press again to return.

Color Picker: Replaces the current color with the color on the canvas where the user clicks, then switches to the previous tool. When this tool is active, left click anywhere on the canvas to copy the color at that point.

Tip: Press K to switch to the color picker tool. Press again to return.

Set Origin: Used exclusively with symmetry modes, this tool lets you change the point of symmetry. See the section below.

Tip: Press O to switch to the set origin tool. Press again to return.

Tools - Set Symmetry Origin

When this tool is active, a crosshair will be displayed to show the symmetry origin (default is centered). Unless a symmetry mode is active, the crosshair will disappear when the tool is no longer selected.

Symmetry Origin Crosshair

For all symmetry modes except multi-point ("Symmetry: At Points"), you can click to change the symmetry origin.

For multi-point symmetry, left-clicking adds a point and right-clicking near a point removes it. Press Ctrl + Right click to remove all points in symmetry origin mode with multipoint symmetry. Below is an example of drawing with multi-point symmetry.

multi-point symmetry drawing

Sections

Each section has its own settings.
Basics: Contains basic brush attributes and canvas controls.

Special Settings: Contains specific options and modes, like drawing with symmetry, rotating with the mouse, and minimum draw distance.

Jitter - Basics: Sliders that cause basic attributes of the brush to be randomly different as you draw.

Jitter - Color: Sliders that cause the color of the brush to be randomly different as you draw.

Shift - Basics: Sliders that cause basic attributes of the brush to continually increase or decrease as you draw.

Tablet - Assign Pressure: Sliders that change the way the brush behaves depending on how much pressure is applied by a drawing pen.

Settings - Brush: Buttons to define and delete custom brushes.

Sections

Basics Section

Basics section

1: Canvas Zoom: This is how far zoomed in the current image is. 100% is normal. Larger values mean you've zoomed in much closer to the image and smaller values mean you've zoomed away.

Tip: Use Ctrl + Mouse Wheel, or Ctrl with the plus and minus keys (not numpad) to zoom in and out.

2: Canvas Angle: This is the orientation of the canvas. Tablet users may find it useful to rotate the canvas rather than make brush strokes at certain angles on their tablet.

Tip: Use Shift + Mouse Wheel to rotate.

canvas rotation example

3: Brushes: This box shows the available brushes (a brush is a collection of settings). Click one to replace the current settings with that brush's settings. The Delete Brush button is only available when a non-default brush is selected.

4: Brush Images: This box shows pictures of the current brush you use to draw with. Click a picture to make it your active drawing brush. If you hover the mouse over a brush, it will display its name if it's a built-in brush, otherwise it shows where the brush was loaded from.

Tip: If a brush is added without any transparency in it, the brightness of the image will be used to compute transparency, which works well with black-and-white images. If there is any transparency at all, the existing transparency will be used instead.

5: Add Brush Images: Clicking this button opens a dialog box that lets you browse your computer for images to add as brushes. Images added will appear later when opening the plugin (and can be removed from Custom Brush Locations). When images are added, they appear at the bottom of the list. It supports the very common formats, including limited support for photoshop brushes (.abr).

6: No Mixing: To use the colors in a brush image instead of replacing it with the active color, turn off no mixing. When no mixing is off, you can decide how much of the active color to mix into the brush image. Example below.

No mixing off

7: Brush Color: Clicking this button opens a dialog box that lets you choose the color to use for the brush.

8: Mix Colors: Only shown when No Mixing is off, this is the amount of the active color to blend into the image. 0% will just use the actual brush image itself. 100% will replace whatever HSV channels are selected (and is the same as No Mixing if all the H, S, and V checkboxes are active). Values between will fade smoothly from the brush image to the active color in the channels chosen.

9: Hue, Sat, Val: Only shown when No Mixing is off, these checkboxes determine which channels are affected by the active color. They stand for hue, saturation, and value. You can think of these as the color, the grayness of that color, and its brightness (all the way to white and black).

10: Blending Mode: This dropdown lets you change the blending mode used by the brush tool when drawing. The blending modes available are the same as in Paint.Net. See the Paint.Net documentation page.

various blend modes

11: Brush Opacity: The brush transparency. In normal blend mode, you get nothing at 0 opacity, half-transparency at 128, and full opacity at 255. This works by limiting how opaque pixels can be as you draw, which leads to flat evenly transparent regions. Some drawing programs call this phenomenon "wash". This is preferred for most brushes.

Tip You can hold Ctrl + O while moving the mouse wheel up and down to increase and decrease the opacity of the brush. Alternatively, Hold O and use [ to increase or ] to decrease it, and hold Ctrl to do it faster.

12: Brush Flow: A multiplier for brush transparency. It works similar to brush opacity, except that transparency is applied per stamp instead of for the whole brush stroke at once, which means they can overlap within the same brush stroke (and will get fully opaque, or as opaque as brush opacity allows, if both are used). Some drawing programs call this phenomenon "build-up". This is preferred for airbrush-style effects.

Tip You can hold Ctrl + F while moving the mouse wheel up and down to increase and decrease the opacity of the brush. Alternatively, Hold F and use [ to increase or ] to decrease it, and hold Ctrl to do it faster.

13: Brush Rotation: This is the tilt of the brush, which goes from -180 to 180 degrees. Negative tilt rotates the image counter-clockwise and positive tilt rotates it clockwise.

Tip You can hold Ctrl + R while moving the mouse wheel up and down to tilt the brush counter-clockwise and clockwise; respectively. Alternatively, Hold R and use [ to increase or ] to decrease it, and hold Ctrl to do it faster.

14: Brush Size: This determines how large the brush is (in pixels). You can see this by hovering the mouse over the canvas and looking at how large the rectangle is.

Tip You can hold Ctrl + S while moving the mouse wheel up and down to increase and decrease the brush size; respectively. Alternatively, use [ to increase or ] to decrease it, and hold Ctrl to do it faster.

Special Settings Section

Special settings section

Effect filter: Lets you set any paint.net effect or adjustment to be drawn to the canvas using the brush. In this mode, inapplicable options such as color-related settings are disabled. The dropdown lets you set the effect settings (if any), while the settings button lets you adjust them. The effect is recomputed after every brush stroke, and after each undo/redo step (which can make it slow). Some effects are incompatible.

Tested effect compatibility list

Plugins that don't actually work in paint.net v4.3.11 natively Asmageddon -> Strange Bulger Asmageddon -> Strange Bulger B Curtis -> Blur Map Curtis -> Channel Mask Curtis -> Displacement Map Curtis -> Equations Simon B -> That other app

Plugins that fail to work when selected Asmageddon -> PS Only TechnoRobbo -> TR's Brush Strokes TechnoRobbo -> TR's DistortThis! TechnoRobbo -> TR's FreeWarp TechnoRobbo -> TR's SelfEeZ Toehead -> Barcode

Plugins that always crash to desktop Boltbait -> Paste Alpha (hangs on re-render, conditionally hangs if no image is on clipboard) TechnoRobbo -> TR's Copy With Alpha (hangs on re-render, conditionally hangs if no image is on clipboard) TechnoRobbo -> TRs Displacement Map 3D (hangs) TechnoRobbo -> TR's Filaments (hangs)

Plugins that crash to desktop intermittently or conditionally Asmageddon -> PS Mega (crashes on re-render) Boltbait -> From Clipboard (intermittent hang on re-render, conditionally hangs if no image is on clipboard) DYPY -> Spiral (intermittent crash when selected) Pyrochild -> Random Effect (fully works, but may randomize to an effect that doesn't) TechnoRobbo -> TR's Export Selection TechnoRobbo -> TR's Intensity Warp (conditionally hangs if no image is on clipboard) Toehead -> BlendModes Plus

Plugins that fail to render correctly / do anything Ed Harvey -> Vitrious (does nothing) Ed Harvey -> White Balance (does nothing) Jesse Chunn -> Stencil (makes the canvas solid black) Tim! -> Rounded Rectangle (doesn't update preview when adjusting settings)

List of all tested plugins by author (every usable plugin from every plugin pack thread):

BOLTBAIT'S PLUGIN PACK VERSION 5.2 Tested plugins: Black and White+, Color Balance, Combined Adjustments, Hue/Saturation+, Temperature/Tint, Transparency, Dream, Oil Painting+, Pastel, Gaussian Blur+, Complementary Colors, From Clipboard, From File, Bevel Object, Feather Object, Inner Shadow, Object Shadow, Object Shadow 3D, Outline Object, Pasta Alpha, Switch Alpha to Gray, Switch Gray to Alpha, Combined Adjustments, Level Horizon/Plumb Bob, Meme Maker, Remove Dust, Seam Carving - Horizontal, Seam Carving - Vertical, Sharpen Landscape, Vignette+, Calendar, Chart or Graph, Dimensions, Flames, Gradient, Grid/Checkerboard, Polygon/Stars, Bevel Selection, Blur Selection Edge, Feather Selection, Inner Shadow, Outline Selection, Floyd-Steinberg Dithering, Creative Text Pro, Outlined / Gradient Text, Paste Alpha

PYROCHILD'S PLUGINS 2020-11-21 Tested plugins: Color Match, Curves+, Gradient Mapping, Splatter, Gradient Blocks, Pixelate+, Jitter, Stitch, Outline Object, Trail, Film, Borders N' Shapes, Gradient Bars, Gradient Grid, Random Shape Fill, Grid Warp, Liquify, Smudge, Twist, Random Effect

RED OCHRE PLUGIN PACK 10.1 Tested plugins: TwoToneThreshold, ArtyThing, Contour, Cobweb, Scribble, Furblur, Overblur, EarthsnGreys, Psychocolour, Recolour Choice, Compo Grids, Poster, Vanishing Point, Aardvark, ClipDisplace, Squirkle Warp, CalliColour, Cuboids, Dryad, Facet, Gears, Gossamer, Helix, MultiSpline, slinky, String and Pin, NoiseChoice, Object Bevel, Object2colour, Objectedge, Compo tool, Bezncurve, Flourish, Gradients galore, Highlight, Squirkle, Table, Scintillate, ClipWarpNew, Alphathreshold, Selection2Clear

KRISVDM'S PLUGIN PACK v4.3.3.0 Tested plugins: Color Accent, Cyanotype, Duotone Ink on Paper, Duotone Light, Grayscale on Colored Paper, Make Color Transparent, Monochrome Ink on Paper, Sepia 2, Average Blur, Smart Blur, Zoom Blur, Drop Shadow, Center Both, Center Horizontally, Center Vertically, Horizontal: Left, Horizontal: Right, Vertical: Bottom, Vertical: Top, Fade Edge, Gradient, Gridlines

DYPY'S PLUGIN PACK 2014-05-04 Tested plugins: Black and Alpha+, Color Balance+, Alpha_to_0, Alpha_to_255, Metallize, 1px Expansion, Perspective, Rotate/Zoom+, AA's Assistant, Circle Text, RotateText, RotateTextSUI, Speech bubble, SpiralText, TextPlus, WaveText, WaveTextSUI, Multi-Threshold

MADJIK' ALL PLUGINS (2018-04-07) PACK V4.21e Tested plugins: Color Zoom Blur, Gradient Blur, Change Extreme Colors, Color Aberration, Expand Color, Recolor Gray, Reverse Colors, Displacement, Distorting Mirror, Donut, Gravity, Kaleidoscope, Magnifier, Melting, Motion Sharpen, Oblique, Page Curl, Paneling, Polar transformation, Seamless Texture Maker, Sin Waves, Tiles Reflection XY, Tube Oblique, TwistZ with zoom, Water Reflection, Waves, Wet Floor reflection, Auto Chrome Noise, Smooth Noise, Bars, Buttons, Fractal curly tree, Fractal fern leaf, Frames, Grid Checker Maker, Hexagonal Grid, KaleidoGen, Lens Flare, Polygons, Random Lines, Random Maze 1, Random Maze 2, Roses, Shapes, Sparkles, Spiral, Spirograph, SpiroShapes, Splashes, Stars, Volutes, Spot the Center, Majority, Overliner, Star Glow, Animal texture, Auto Chrome - Grain Filler, Color Modulo, Fractal attractor, Hilbert filling curve texture, Julia Plus, Light Rays, Moire, Nebulous, Newton Fractal, Perlin Texture, Radial Colors, Rainbow Twist, Regular Noise Texture, Tournesol, Vibrato, Fill from Palette, Generate 96 distinct colors, List of Palettes, XYCoords, Signature stamp

TECHNOROBBO'S PLUGIN PAK (June 3rd,2015) Tested plugins: TR's Alpha Mapper, DH ShapeMaker, Line Tracer, TR's Brush Strokes, TR's Color Waves, TR's DoodleMatic, TRs Croquis, TR's TiltShift, CMY Ghost, Cycle HSV, FSPosterizer, Noise Bleacher, TR's BW Photo, TR's ColorizerHMS, TR's ColorReducer, TR's Contour Filler, TR's Coquin Filter, TR's Custom Palette Matcher, TR's Intense Filtration, Layer Cake, TR's DistortThis!, TR's Drum Skin, TR's Fish Eye, TR's FreeWarp, TR's Glass Vignette, TR's Intensity Warp, TR's Pixel Puller v1.1, TR's Pixel Pusher, TR's Radial Extruder, TR's ReverseFishEye, TR's ReverseFishEye35, TR's Smudger, TR's ZigZag, TRs Displacement Map 3D, TR's Filaments, TR's iPollock, TR's TreeMaker, TR's Kaboom, TR's KlumpNoiz, TR's Scatter, TR's AlphaCutter, TR's Keyframe, TR's PseudoSnap!, TR's Str8 Edge, TRs EFX, TR's Bokeh, TR's Dodge and Burn, TR's Film Stock, TR's FilmStrip, TR's PanoPDN, TR's Pixel Sharpener, TR's Portrait Retouch, TR's SelfEeZ, TR's SphereCuber, TR's Star Filter, Frames, TR's Custom Random Filler, TR's FireWorks, TR's Fuego, TR's Morpher, TR's Plasmatics v1.0, TR's Snow Flake Maker, TR's SplineMaster, TR's Strobe Motion, TR's Tesla Coil, TR's Third Dimension, TR's StrangeAttractor, TR's Copy with Alpha, TR's Export Selection, TR's Paste Fill, TR's Paste Frame, TR's Paste Warp, TR's QuickOutLiner, TR's Half Tone, TR's Tiled Pixels, TR's MonoLithic

SIMON B'S PLUGIN PACK 2014-06-22 Tested plugins: ThatOtherApp, Printer+, Find Edges, Olden, Extend Border, DragFrom

TANEL'S PHOTO AND COLOR PLUGINS 2012-03-05 Tested plugins: Color Mixer, Alpha Blur, Bidirectional Blur, Color to Alpha, Grain, Basic Adjustments, Black and White Converter, Eyeshine Removal, Local Contrast, Red Eye Quick Fix, Shadow / Highlight Recovery, Sharpen+

ED HARVEY EFFECTS v4.0 2012-02-13 Tested plugins: Vibrance, Simplify, Splinter, True Blur, Color Filter, Color Flip/Rotate, Color Tint, Extract Channel, Filtered Black and White, Invert Intensity, Single Hue, Solarize, Threshold, Vitrious, White Balance, Drop Ripple, Glass Blocks, InsideOut, Lens, MultiView Warp, Pixelate (Cairo Pentagonal), Pixelate (Hexagon), Ripple, Wobble, Cross Processing, Vignette EH, Halftone, Seismograph

ASMAGEDDON TOOLS PACK 11/15/07 Tested plugins: Alpha works, Channel multiplier, Channel Shift, Channel works+, Color Percentage+, From P to S, From P to S simple, HSV inversion, Hue (Red<--->Psychodelic), Hue Channeling multiply, Image coder, Inverto pushing, Inverto pushing Kaleidoscope, Inverto pushing plus, Multiplo uniqua, PS Mega, PS Only, Quadro Disorter, Quadro Disorter B, Render-Border, Render-Quadro bumperoo, Render-Quadro inverto, Render-Quadro sharper, RGB tricks, Strange Bulger, Strange Bulger B, Strange Bulger Kaleidoscope, Water

REMAKE'S PLUGIN PACK 1/22/22 Tested plugins: Alpha Transform, Dynamic Contrast, Intensity RGB, Saturation RGB, Transparency RGB, Color Sketch, Dragan Effect, Linocut, Reticulation, Scratch Art, Sponge, Averaged Color Blur, Color Range, Eliminate Dark/Light, Lines/Grid, Emboss+, Neon Edges, Center Lines

EER'S PLUGIN PACK 1/22/22 Tested plugins: CellMaker, ChessFEN, Fibonacci Fill, Organigram, Polaroid Frame, TileWorld, MathLaTex

TOE_HEAD2001'S PLUGINS (Sept 29, 2018) Tested plugins: SubLCD, Gaussian Blur (Clamped), Distort This!, Droste, Screen Pixel, Blur Fill, Rubber Stamp, Green Tint Reduction, Inset Box Shadow, Barcode, Bulletin Board Trim, Coordinate Plane Points, Gingham, Isometric Cuboid, Jigsaw Puzzle, Pie Chart, Postage Stamp, Ruler, Spoked Wheel, Tattersall, Two-point Perspective, Radius Corners, Text Window, Tartan, BlendModes Plus, Quadrilateral Correction

ARGUSMAGNUS' PLUGIN PACK (2018/10/19) Tested plugins: Unblend, Barcode, Band Pass Filter, High Pass Filter, Low Pass Filter, Edge Detect+, Fast Fourier Transform, Inverse Fast Fourier Transform

MCCREERY'S PLUGINS (3/23/21) Tested plugins: Clean Transparent, Color Ramp, Erode, Isolate Channel, Move Seams, Outline, Remove Transparent

AHMED'S PLUGINS (3/23/21) Tested plugins: posterize+, Cartoonize, InkSketch+, Apply Color, Quick Gravity, Vibration, Clarifaction+, Clarify,

PERSON_321'S PLUGINS Tested plugins: invert channels, Rainbow Loom, Sound waves, X Rainbow bars

CURTIS' PLUGIN PACK (3.5.4) Tested plugins: Effects Lab, Blur Map, Selective Palette, Displacement Map, Jumble, Tile Image, Channel Mask, Equations, Fern Fractal, Rounded Rectangle, Dots

EVAN'S EFFECTS PLUGINS (Oct 16, 2012) Tested plugins: Conditional Hue/Saturation, Quadrilateral Reshape, Mirror over line, Mirror bottom half over top half, Mirror top half over bottom half, Mirror left half over right half, Mirror right half over left half, 3D Object, Pie Chart, Polygonal Transparency

NULL54'S PLUGIN PACK (2019-09-14) Tested plugins: 8bf Filter, Kuwahara

STUS EFFECTS (1/10/2010) Tested plugins: Advanced Rotate, AlphaContrast, iPhone TabbarIcon Maker Alpha From RGB Intensity, Vignette1, RGB_Remap, Obscure

JESSE CHUNN PLUGIN PACK (3/8/2008) Tested plugins: Stencil, Focal Point, Soften Edges, Bricks, Varicose, Color Replace

TOLI'S EFFECTS 2.0.2 FOR V4.0 Tested plugins: Smooth, 1st Diagonal Mirror, 2nd Diagonal Mirror, Horizontal Mirror, Vertical Mirror, Rotate 90 Clockwise, Rotate 180 Clockwise, Rotate 270 Clockwise, Engrave / Emboss, Mirror / Rotate

HARDWARE ACCELERATED BLUR PACK V3.2 Tested plugins: (GPU) Channel Blur, (GPU) Gaussian Blur, (GPU) Motion Blur, (GPU) Radial Blur, (GPU) Zoom Blur

COLOR TARGET PLUGIN PACK (13TH JULY 2008) Tested plugins: Color Stretch, Color Target, Target Panel

MIKE RYAN'S PLUGIN'S (September 2, 2008) Tested plugins: Input To Output, Invert Alpha, Brightness / Darkness to Alpha, Color Timming, Alias, Silhouette Plus

TIM'S EFFECTS (Feb 27 2017) Tested plugins: Mosaic, Rounded Rectangle

effect filter example

1: Minimum Draw Distance: The mouse must move a certain number of pixels away from the last position that the brush was stamped at in order to stamp the brush again. This has the effect of making dotted trails as the mouse moves. When minimum draw distance is nonzero, a red circle will be displayed around the mouse with a size equal to the minimum draw distance, as a useful visual indicator. As soon as you cross the circle boundary, the brush will be stamped again.

Tip: With Brush Density set to 0, this setting lets you control exactly in pixels the amount of space between the centers of two brush stamps.

min draw distance example

2: Auto Manage Brush Density: When true, the brush density slider will be disabled and automatically update based on the current brush size at any time. At brush size 1, if the brush density is auto-managed, the Jagged smoothing mode will be used to ensure a clean line when drawing (otherwise, it would be oddly transparent where the brush is stamped between pixels, due to sub-pixel rendering).

3: Brush Stroke Density: Controls the amount of space between brush stamps, as a fraction of the brush's size. A density of 1 is the full brush width, 2 is half the brush width (so twice as dense), 3 is a third the brush width and so on. This allows lines to remain smooth when the mouse is moved quickly, though they may be angular. A brush density of 0 is special and means that as long as the mouse is moving, the brush will be stamped. This mode doesn't draw uniformly, so it may become dotty based on lag and mouse speed.

brush stroke density example

4: Brush Smoothing: This setting controls how anti-aliasing is applied to each brush stroke. When you click on the button, a list drops down with options to choose the anti-aliasing amount.

  • High: If the brush is resized or scaled while drawing, it uses a slow cubic filter that produces smoothed results.
  • Normal: If the brush is resized or scaled while drawing, it uses a fast linear filter that at small sizes may produce pixelated results.
  • Jagged: If the brush is resized or scaled while drawing, it uses a faster nearest neighbor filter and forces hard-edged pixelation.

Tip: The jagged smoothing mode is the ideal mode for creating pixel art. It will always guarantee hard edges in the brush image.

5: Symmetry Mode: This enables symmetrical drawing around an origin point (which you can change with the Set Origin tool) which duplicates your drawings in a few different ways. While enabled, the symmetry origin guide will be overlayed on the canvas for easier use.

  • Horizontal, Vertical, Both: Draws the brush stroke across the horizontal or vertical line of the origin point, or both.
  • At Points: Draws the brush stroke at offset locations from itself. The points will be overlayed on the canvas for easier use. You must use the Set Origin tool with multipoint symmetry on to set these points.
  • Radial: Draws the brush stroke at radial offsets from the origin point, like wheel spokes.

symmetry example

6: Seamless Drawing: When this checkbox is active, the parts of a brush stroke that would go beyond the edge of the canvas get copied to the other side. Seamlessness is only guaranteed when the parts drawn over the edge are smaller than the canvas dimensions. The effect is that if you tiled the image horizontally and/or vertically (meaning, put copies of it edge-to-edge), you wouldn't see any seam. This is useful with textures, wallpaper designs, etc. Here's an example showing the drawing (left) and how it's naturally seamless (right)

seamless drawing

7: Rotate With Mouse: When this checkbox is active, the current brush will be rotated to follow the motion of the mouse. It's assumed that if the image looks like it points somewhere that it must point to the right for this to work properly. If the image doesn't point to the right, change the brush rotation under the Basics section until it does.

rotate with mouse example

8: Lock Alpha: When this checkbox is active, the alpha channel is locked so it cannot change. This can be useful when you only want to change the colors in the image without affecting the transparency, like when you have black text on a transparent background and you want to color it.

lock alpha example

9: Lock RGB: These checkboxes lock the red, green, and blue channels respectively. When these are active, the respective channel is locked so it cannot change. These are useful when you only want to change one or two channels while leaving others unaffected, like when you want to change the image colors in a precise way.

10: Lock HSV: These checkboxes lock the hue (color spectrum), saturation (grayness), and value (brightness) respectively. When these are active, these values are locked so they cannot be changed. The RGB and these HSV channel locks combine well with blend modes to achieve different effects, or control the image colors in a precise way.

Tip: For hue, perfectly black/white/transparent pixels are considered red. For saturation, note that desaturated colors may look way closer than their saturated counterparts. Therefore, locking hue and saturation may lead to surprising (but correct) results.

Jitter - Basics Section

Every time the mouse moves as you draw, a number between 0 and the displayed value for one of these settings is generated. That number is used to change the default setting. This has the effect of visually 'jittering' the brush as you draw.

Jitter - Basics section

1: Random Min Size: As you draw, the size of your brush is randomly reduced by up to this much.

2: Random Max Size: As you draw, the size of your brush is randomly increased by up to this much.

3: Random Rot to Left: As you draw, the brush is randomly tilted counter-clockwise by up to this many degrees.

4: Random Rot to Right: As you draw, the brush is randomly tilted clockwise by up to this many degrees.

random angle example

5: Random Min Alpha: As you draw, the brush is randomly up to this much more transparent.

6: Horizontal Spray: As you draw, the brush is moved horizontally left or right up to % amount of the canvas size. Note that on a rotated canvas, 100% may reach past or fail to reach the edges of the canvas.

7: Vertical Spray: As you draw, the brush is moved vertically up and down up to % amount of the canvas size. Note that on a rotated canvas, 100% may reach past or fail to reach the edges of the canvas.

random spray example

Jitter - Color Section

These options work like the options in the Jitter - Basics section, but deal with the color of the brush. These options are unavailable when colorize brush is off, or when using the erase tool.

Jitter Color Section

1: Red Jitter: As you draw, the redness in brush stamps of the image is randomly decreased (first slider) and increased (second slider) by this much.

2: Green Jitter: As you draw, the greenness in brush stamps of the image is randomly decreased (first slider) and increased (second slider) by this much.

3: Blue Jitter: As you draw, the blueness in brush stamps of the image is randomly decreased (first slider) and increased (second slider) by this much.

4: Hue Jitter: As you draw, the hue in brush stamps of the image is randomly decreased (first slider) and increased (second slider) by this much. This step is performed after RGB jitter.

Tip: Hue jitter does not "wrap around" the spectrum, so if you have a red brush (hue of zero) and raise the first slider, you will see no change.

5: Saturation Jitter: As you draw, the saturation in brush stamps of the image is randomly grayer (first slider) and more vibrant (second slider) by this much. This step is performed after RGB jitter.

6: Value Jitter: As you draw, the brightness in brush stamps of the image is randomly darker (first slider) and brighter (second slider) by this much. This step is performed after RGB jitter.

Shift - Basics Section

Whenever the brush is stamped to the canvas, these values update by increasing or decreasing by a set amount.

Shift Section

1: Size Shift: The size of the brush increases or decreases by the chosen amount as you draw. When it's as large as allowed, it begins to shrink, and vice versa.

2: Rotation Shift: The brush tilts by the chosen amount as you draw. It tilts clockwise if the amount is positive, or counter-clockwise instead. It can tilt indefinitely in one direction.

3: Alpha Shift: The transparency of the brush changes increases or decreases by the chosen amount as you draw. If it becomes fully transparent, it begins to become opaque again, and vice versa. ("Alpha" is another name for transparency.)

Tablet - Assign Pressure Section

The main advantage of a tablet is pressure sensitivity. This section allows you to decide how attributes change based on that pressure. The "deadzone" is set to 10% and 90% to avoid picking up really light brush strokes and discourage pressing too hard on the tablet. That means only the range of pressure from 11 to 89% is used by these controls.

Tablet - Assign Pressure Section

The amount (1) is the value used by the influence method to change the attribute. The influence method (2) is a dropdown that determines how the amount will affect the attribute. For example, "Add as number" with an amount of 10 for Brush Size will increase it by 10 at full pressure or 5 at half pressure. The amounts shown in (3) both use the same influence method.

How the associated number will influence the setting for full pressure on a drawing tablet. Partial pressure will also influence the setting to a proportionally smaller degree (on a linear curve). The settings for it follow:

  • Not in use: Tablet pressure doesn't affect anything.

  • Add as number: At full pressure, the setting equals itself plus this number.

  • Add as percent of max: At full value, the setting equals itself plus this percent of the max possible value it can have, e.g. if the setting is 50 out of 200 and the percent is 30%, at full pressure the setting would be 110.

  • Add as percent of self: At full pressure, the setting equals itself plus this percent of itself, e.g. 30% when the setting is 50 would make the setting 65.

  • Match the number: At full pressure, the setting equals this number.

  • Match the percent of max: At full pressure, the setting equals this percent of the max possible value it can have, e.g. 30% of 200 at full pressure would make the setting 60.

Settings - Brush Section

Settings Brush Section

1: Brush Image Locations: Clicking this button opens the preferences dialog that allows you to define locations to look for brushes when the plugin loads. All images will be loaded if possible, and images from each directory will be loaded if possible. Loading large amounts of images can lead to lag when the plugin is opened.

2: Clear Current Brush: Resets all setting changes to the brush's defaults. For example, if you select a brush called Pencil and change the brush size, this will change it back to the brush. It's equivalent to clicking the brush in the brushes box.

3: Delete Brush: This is available only when a custom brush is selected. Clicking this button will delete the brush.

Tip: Your settings aren't changed when deleting a brush, making it easy to create a similar brush if it was deleted by accident.

4: Save New Brush: Creates a new custom brush with the given name. All the current settings become the settings of that brush, and it will be added to the bottom of the brushes box. When you select it in the future, your settings will change to match that brush's settings.

Undo, Redo, Ok, Cancel

undo, redo, ok, cancel

Undo and Redo: Each brush stroke is saved as an image to a temporary location on your computer. Once you have made a brush stroke by clicking and releasing the mouse, you may undo that stroke. Any brush stroke you undo can be redone with redo, but if you make a new brush stroke after undoing old ones, those ones are lost and cannot be redone.

Tip You can press Ctrl + Z to undo a brush stroke and Ctrl + Y or Ctrl + Shift + Z to redo one.

Ok and Cancel: Once you're done with the plugin, click the Ok button to apply all changes from the plugin and close it. Click cancel to discard those changes instead. You can also press enter to apply the plugin, or escape to cancel it. All settings are saved between uses of the plugin when changes are saved.

Tip: Pressing enter or escape after making changes when the button is not focused will prompt if you want to return or not.

Preferences dialog

This is the dialog that opens when the Brush Image Locations button is clicked. It has a textbox where you can type in image locations. Alternatively, you can click 'Add Folder' to add a directory to search through for images when the plugin loads. All images found will be added to the list of brushes if possible.

Preferences dialog

1: Custom brush images textbox: You can type the full path to images and directories here rather than using the add folder or add files buttons. It's ideal when pasting a list of locations.

2: Add folder: This opens a dialog that lets you pick a folder to load all images from. Only images directly within the folder will be loaded, not sub-directories.

3: Add files: This opens a dialog that lets you pick any number of files to load.

4: Load Default Brush Images?: When checked, the default brushes will be loaded. When unchecked, only the default circle will be loaded. Custom brush images you define will still be loaded regardless.

5: Save: Saves and immediately reloads the available brush images.

6: Cancel: Discards all changes to the brush image directories.

⚠️ **GitHub.com Fallback** ⚠️