> For the complete documentation index, see [llms.txt](https://docs.openbrush.app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.openbrush.app/user-guide/repaint-tool.md). # Repaint Tool and Jitter ### What does it do? It expands on the previous Recolor tool which is now renamed to "Repaint". The following features can be used individually or in any combination: #### Recolor Same as before (but see the "jitter" feature below which adds new functionality to Recolo) #### Rebrush Similar to "Recolor" except it repaints existings strokes with a different brush. This is the same as the"Rebrush" tool in previous experimental builds. That feature is now part of this Repaint Tool) #### Resize Change the brush size of existing strokes. #### Jitter When this option is turned on, recolor and resize will add random variations based on your current Jitter settings. ### Jitter Improvements Open the Jitter settings from the dice button near the bottom of the colour picker. These settings affect new strokes and can also be applied by the Repaint tool. #### Colour Jitter The Hue, Saturation and Value sliders control how much those colour components can vary from one stroke to the next. A value at the far left adds no variation; increasing a slider widens the random range around the selected colour. #### Jitter Brush Size This slider controls how much the stroke size varies from stroke to stroke. The far-left position adds no variation; moving it right increases the random size range. #### Jitter Positions ![](https://3738774261-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mikdwm98p33AibfiSqN%2Fuploads%2Fgit-blob-d4d0fdd537a1e9904494b0c0a103449065e02a9d%2Fimage-017.png?alt=media) This slider controls how much randomness is applied to each point on a brush stroke. The far-left position adds no variation; moving it right shifts points farther from their usual positions. At higher settings, some brushes appear to split into multiple small strokes. ### Things to try 1. Try a high setting for "Jitter positions" and press the trigger to draw but don't move your hand. You'll get a small spherical "squiggle" that can be very interesting with some brushes. 2. Draw something regular with the Hull brush and make copies of it. Then use the "Repaint Tool" with a low setting for "Jitter positions" to add random variation to each copy 3. Position jitter can cause strokes to break into many small strokes. This depends on the brush you use and amount of jitter. Try really low jitter settings, try smaller brush sizes and try different brush types such as tube brushes (they tend not to break up as much) ### What's it good for? Modifying parts of existing sketches. Adding random variation after you've already painted something. Trying out different brushes and reusing parts of a sketch with different properties. (try duplicating some strokes and then repainting the duplicate) ### How do I use it? The Recolor button on the Tools Panel has been replaced with "Repaint". When you select it, a side panel appears with 4 toggle buttons: Recolor, Resize, Rebrush and Jitter. Any combination of these 4 options can be selected at any time. If you choose "jitter" then set your chosen amount of jitter using the button with the dice icon at the bottom of the Color Picker Panel ## Repaint Selection Instead of repainting strokes one at a time, you can select multiple strokes and apply repaint operations to all of them at once: 1. Use the Selection tool to select the strokes you want to modify. 2. Open the Repaint options and enable the operations you want: Recolor, Resize, Rebrush or Jitter. 3. Choose the new colour, brush and size, and configure jitter if required. 4. Select **Repaint Selected** on the selection controls to apply those settings to every selected stroke. This is particularly useful for: 1. Changing the colour scheme of multiple strokes at once. 2. Applying consistent size changes to a group of strokes. 3. Converting multiple strokes to a different brush type. 4. Adding jitter variation to duplicated elements. ### Can I see it in action? {% embed url="" %} ![Hull brush drawn with the Polyhedra tool with color and position jitter added](https://3738774261-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mikdwm98p33AibfiSqN%2Fuploads%2Fgit-blob-c1322e90fc3037a15e92c55cad9aecbc1d4618e6%2Fimage-014.png?alt=media) --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.openbrush.app/user-guide/repaint-tool.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.