Join GitHub today
GitHub is home to over 28 million developers working together to host and review code, manage projects, and build software together.Sign up
v1.2 Main Toolbar
The Main Toolbar contains MyPaint's painting tools, and other commands. It is located at the top of the main window, next to the menu. It continues into the UI toolbar. Clicking on a blank area of the main toolbar with the right mouse button shows a popup menu which you can use to tailor what appears on it.
- File Handling
- Scraps Switcher
- Undo and Redo
- Blend Modes
- Line Modes
- View (Main)
- View (Alternative/Secondary)
- View (Resetting)
The File Handling toolbar buttons let you load and save the working canvas. They are visible by default.
New File (File → New, or
Ctrl+N). Starts a new, blank canvas.
Open File (File → Open…, or
Ctrl+O). Open a file on disk, so it can be edited in the canvas area.
Save File (File → Save…, or
Ctrl+S). Saves the current canvas to a file on disk. If it hasn't got a file name yet, you'll be asked for one.
The core set of tools cannot be hidden using the popup menu.
Eraser (Brush → Paint Mode → Paint Mode: Eraser, or
Freehand (paint brush) (Edit → Freehand, or
- Paint using the current brush and colour, without constraints.
- This is the default painting tool.
- Main article: v1.2 Freehand Tool
Pick Colour (eye dropper) (Colour → Pick Colour, or
- Pick a new painting colour from the canvas.
- This may be moved to the footer bar in future versions of MyPaint.
- Main article: v1.2 Pick Colour
Flood fill (paint bucket) (Edit → Flood Fill) Since MyPaint 1.2.0
- Fills an area with the current painting colour.
Reposition Layer (Layer → Reposition Layer)
- Move the current layer relative to all the other layers.
Edit Frame (picture frame) (FIXME: no simple menu item!) Since MyPaint 1.2.0
- Defines a rectangular canvas area for exports etc.
- MyPaint's canvas is infinite: this allows you define a scope.
Edit Painting Symmetry (butterfly) (Edit → Edit Painting Symmetry) Since MyPaint 1.2.0
- Define an axis for painting symmetrically.
- Symmetry mode affects all normal painting tools.
The Scraps Switcher toolbar buttons let you quickly save drafts to a dedicated folder on disk, and load them in again. These items are optional, you need to use the main toolbar's context menu to make them visible.
Save As Scrap (File → Save As Scrap, or
F2). Saves the working canvas to a scrap file.
- This changes the filename, so File → Save will write over the new scrap.
- If the file is already a scrap file, a new revision is saved.
Open Previous Scrap (File → Open Previous Scrap, or
F6). Loads the scrap file before the current one.
- If your working file isn't a scrap file, you'll get the last scrap file in your scrap folder.
- If the scrap file has revisions, this will load only the latest revision.
Open Next Scrap (File → Open Next Scrap, or
- This works just like Open Previous Scrap, but in the opposite direction.
Scrap file revisions are stored with numbered filenames in a single folder. The scrap folder's location can be changed in the Preferences window.
Undo and Redo
These are the normal undo and redo controls. The only difference between these and their equivalents from other apps is that MyPaint's freehand mode uses shortish fragments of continuous painting as its undo step.
Undo (Edit → Undo <action>, or
Redo (Edit → Redo <action>, or
The toolbar items are only sensitive when you can undo or redo a step.
These are additional paint blend modes. These toolbar buttons are optional. You need to use the main toolbar's context menu to make them visible.
Lock Alpha (padlock) (Brush → Paint Mode → Paint Mode: Lock Alpha, or press
- Applying the brush doesn't change the transparency of the pixels you paint over (in the target layer).
- Use this for further highlighting or shading objects that are painted on their own layer.
- It's analogous to painting on layer groups which contain a mask, but a lot less fiddly.
- Main article: v1.2 Paint Modes: Lock Alpha
Colourize (rainbow) (Brush → Paint Mode → Paint Mode: Colourize, or press
- Painting applies the hue (kind of colour) and saturation (degree of colour) of your brush to whatever you paint on.
- The value (brightness or darkness) of what you paint on isn't affected.
- This paint mode also doesn't change the transparency of what you paint on.
- Use this for adjusting colours, or assigning colour to something you've painted in greyscale.
- Main article: v1.2 Paint Modes: Colourize
Paint blend modes change how your brush affects the layer you paint on. See v1.2 Paint Modes for the full list.
These tools let you draw geometric shapes. The lines that are created will be made with the current brush, colour, and paint blend mode.
Lines and Curves (Edit → Lines and Curves, or press
- Draw straight lines, hold down
Ctrlto constrain the angle.
- When this tool is active, you can add curves to the last straight line you drew by pressing
- You can add up to two bends in each straight line.
- Main article: v1.2 Lines and Curves
- Draw straight lines, hold down
Connected Lines (Edit → Connected Lines, or press
- Draw a line from where you last painted.
- Constraints and curving work just like the Lines and Curves tool.
- Main article: v1.2 Connected Lines
Ellipses and Circles (Edit → Ellipses and Circles, or press
- Draw circles and ellipses (stretched-out circles).
- Holding down
Shiftallows you to change the angle of an ellipse.
- Holding down
Ctrlconstrains the aspect ratio (how stretched-out it looks).
- When you hold down
Ctrl+Shifttogether, the angle is constrained instead.
- Main article: v1.2 Ellipses and Circles
Inking (Edit → Inking) Since MyPaint 1.2.0
- Draw smooth strokes with your stylus or mouse.
- Main article: v1.2 Inking Tool.
These items allow you to adjust the viewport by clicking and dragging on the canvas. They are standard view manipulation tools, so they are visible by default.
Pan View (View → Pan View)
- Move the view horizontally or vertically across the canvas.
Zoom View (View → Zoom View)
- Zoom the view in to the canvas (for detailed work) or zoom out (for an overview).
Rotate View (View → Rotate View)
- Tilt/turn the canvas within the viewport.
Mirror Horizontal (View → Adjust View → Mirror Horizontal, or press
- Flip the current view from left to right.
- This allows you to ensure your sketches look right from both directions.
These buttons allow single-click adjustments of the view. These items are optional, you need to use the main toolbar's context menu to make them visible.
Zoom In and Zoom Out (in View → Adjust View, or press
,to zoom out, or
.to zoom in)
- Change the canvas magnification by one step.
Rotate Counterclockwise and Rotate Clockwise (in View → Adjust View, or press
- Change the canvas rotation by one angular step.
There's no equivalent of these buttons for the canvas position, but the cursor keys will pan around the canvas.
These are for resetting the view. These items are optional, you need to use the main toolbar's context menu to make them visible.
Reset and Centre View (View → Reset and Centre View, or press
- Resets the view fully, discarding any rotation, mirroring, or position.
Fit to View (View → Fit to View,
- The view is toggled between a fitted view, and an overview of your whole canvas.
- The fitted view retains your mirroring and rotation settings.
- Adjusting the view while it's fitted to your work discards your old saved zoom and position.
- This can be used for selecting a new area to work on, or for bouncing between a quick overview and what you're currently focussing on.