path: root/doc/krita/commands-toolbars.docbook

<sect1 id="commands-toolbars">
<title>Toolbars</title>

<para>This section describes &krita;'s toolbars. By default, the
<guilabel>Krita</guilabel> toolbar is located to the left of the drawing area,
while the others can be found at the top, below the menu bar.</para>

<para>You can customize your toolbars by choosing
<menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure
Toolbars...</guimenuitem></menuchoice> or by clicking with the &RMB; on a
toolbar and choosing <guimenuitem>Configure Toolbars...</guimenuitem>.</para>

<sect2 id="commands-toolbars-file">
<title>The <guilabel>File</guilabel> Toolbar</title>

<para>
<screenshot>
<screeninfo>The <guilabel>File</guilabel> toolbar</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="toolbar-file.png" format="PNG" />
</imageobject>
<textobject>
<phrase>The <guilabel>File</guilabel> toolbar</phrase>
</textobject>
<caption><para>The <guilabel>File</guilabel> toolbar</para></caption>
</mediaobject>
</screenshot>
</para>

<para>This toolbar contains actions for working with files. In &krita;'s
default, there are five buttons on this toolbar: <guilabel>New</guilabel>,
<guilabel>Open</guilabel>, <guilabel>Save</guilabel>, <guilabel>Print
Preview</guilabel>, and <guilabel>Print</guilabel>.</para>

<para>These actions all correspond to entries in the <link
linkend="commands-menus-file"><guimenu>File</guimenu> menu</link>.</para>

</sect2>

<sect2 id="commands-toolbars-edit">
<title>The <guilabel>Edit</guilabel> Toolbar</title>

<para>
<screenshot>
<screeninfo>The <guilabel>Edit</guilabel> toolbar</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="toolbar-edit.png" format="PNG" />
</imageobject>
<textobject>
<phrase>The <guilabel>Edit</guilabel> toolbar</phrase>
</textobject>
<caption><para>The <guilabel>Edit</guilabel> toolbar</para></caption>
</mediaobject>
</screenshot>
</para>

<para>This toolbar contains editing actions. With default settings this
toolbar offers four buttons: <guilabel>Undo</guilabel>,
<guilabel>Redo</guilabel>, <guilabel>Cut</guilabel>, and
<guilabel>Copy</guilabel>.</para>

<para>These actions all correspond to entries in the <link
linkend="commands-menus-edit"><guimenu>Edit</guimenu> menu</link>.</para>
</sect2>

<sect2 id="commands-toolbars-navigation">
<title>The <guilabel>Navigation</guilabel> Toolbar</title>

<para>
<screenshot>
<screeninfo>The <guilabel>Navigation</guilabel> toolbar</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="toolbar-navigation.png" format="PNG" />
</imageobject>
<textobject>
<phrase>The <guilabel>Navigation</guilabel> toolbar</phrase>
</textobject>
<caption><para>The <guilabel>Navigation</guilabel> toolbar</para></caption>
</mediaobject>
</screenshot>
</para>

<para>This toolbar offers easy access to navigation actions. The two
default actions available are <guilabel>Zoom In</guilabel> and
<guilabel>Zoom Out</guilabel>. With <guilabel>Zoom In</guilabel>, the zoom 
level is increased. You will see less, but in higher detail. With
<guilabel>Zoom Out</guilabel>, the zoom level is decreased, so that you see
more at less detail. </para>

</sect2>

<sect2 id="commands-toolbars-krita">
<title>The <guilabel>Krita</guilabel> Toolbar</title>

<para>
<screenshot>
<screeninfo>The <guilabel>Krita</guilabel> toolbar</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="toolbar-krita.png" format="PNG" />
</imageobject>
<textobject>
<phrase>The <guilabel>Krita</guilabel> toolbar</phrase>
</textobject>
<caption><para>The <guilabel>Krita</guilabel> toolbar</para></caption>
</mediaobject>
</screenshot>
</para>

<para>
This toolbar contains painting operations and tools, as well as editing and
selecting tools. The available actions and some controls are listed below. You
can change the behaviour of most tools (and with that, usually the resulting
effect) by setting their <link
linkend="commands-palettes-controlbox-tool">options</link>.
</para>

<variablelist>

<varlistentry><term><inlinemediaobject><imageobject><imagedata
fileref="tool-brush.png" format="PNG"></imagedata>
</imageobject></inlinemediaobject> <guilabel>Brush</guilabel></term>
<listitem><para>
With this tool you can paint freely. Click the &LMB; to paint a
single instance of the currently selected brush, or hold the &LMB; and drag
your mouse around to paint. The mouse movements you make are directly used for
painting.
</para></listitem></varlistentry>

<varlistentry><term><inlinemediaobject><imageobject><imagedata
fileref="tool-line.png" format="PNG"></imagedata>
</imageobject></inlinemediaobject> <guilabel>Line</guilabel></term>
<listitem><para>
This tool is used to draw lines. Click the &LMB; to indicate the first
endpoint, keep the button pressed, drag to the second endpoint and release the
button.
</para><para>
Use &Shift; while holding the mouse button to restrict drawing to only
horizontal or vertical lines. You can press &Alt; while still keeping the &LMB;
down to move the line to a different location.
</para></listitem></varlistentry>

<varlistentry><term><inlinemediaobject><imageobject><imagedata
fileref="tool-rectangle.png" format="PNG"></imagedata>
</imageobject></inlinemediaobject> <guilabel>Rectangle</guilabel></term>
<listitem><para>
This tool can be used to paint rectangles. Click and hold the &LMB; to indicate
one corner of the rectangle, drag to the opposite corner, and release the
button.
</para><para>
If you hold &Shift; while drawing, a square will be drawn instead of a
rectangle. Holding &Ctrl; will change the way the rectangle is constructed.
Normally, the first mouse click indicates one corner and the second click the
opposite. With &Ctrl;, the initial mouse position indicates the center of the
rectangle, and the final mouse position indicates a corner.
You can press &Alt; while still keeping the &LMB; down to move the rectangle to
a different location.
</para><para>
You can change between the corner/corner and center/corner drawing
methods as often as you want by pressing or releasing &Ctrl;, provided that you
keep the &LMB; pressed. With &Ctrl; pressed, mouse movements will affect all
four corners of the rectangle (relative to the center), without &Ctrl;, one
of the corners is unaffected.
</para></listitem></varlistentry>

<varlistentry><term><inlinemediaobject><imageobject><imagedata
fileref="tool-ellipse.png" format="PNG"></imagedata>
</imageobject></inlinemediaobject> <guilabel>Ellipse</guilabel></term>
<listitem><para>
Use this tool to paint an ellipse. The currently selected brush is used for
drawing the ellipse outline. Click and hold the &LMB; to indicate one corner of
the <quote>bounding rectangle</quote> of the ellipse, then move your mouse to
the opposite corner. &krita; will show a preview of the ellipse using a thin
line. Release the button to draw the ellipse.
</para><para>
If you hold &Shift; while drawing, a circle will be drawn instead of an
ellipse. Holding &Ctrl; will change the way the ellipse is constructed: instead
of two corners, the initial mouse position indicates the ellipse center, and the
final mouse position indicates one of the corners of the bounding rectangle.
You can press &Alt; while still keeping the &LMB; down to move the ellipse to a
different location.
</para><para>
You can change between the corner/corner and center/corner drawing
methods as often as you want by pressing or releasing &Ctrl;, provided that you
keep the &LMB; pressed. With &Ctrl; pressed, mouse movements will
affect all four corners of the bounding rectangle (relative to the center),
without &Ctrl;, the corner opposite to the one you are moving remains still.
</para></listitem></varlistentry>

<varlistentry><term><inlinemediaobject><imageobject><imagedata
fileref="tool-polygon.png" format="PNG"></imagedata>
</imageobject></inlinemediaobject> <guilabel>Polygon</guilabel></term>
<listitem><para>
With this tool you can draw polygons. Click the &LMB; to indicate the
starting point and successive vertices, then double-click or press &Enter; to
connect the last vertex to the starting point.
</para></listitem></varlistentry>

<varlistentry> <term><inlinemediaobject><imageobject><imagedata
fileref="tool-polyline.png" format="PNG"></imagedata>
</imageobject></inlinemediaobject> <guilabel>Polyline</guilabel></term>
<listitem><para>
Polylines are drawn like polygons, with the difference that the double-click
indicating the end of the polyline does not connect the last vertex to the
first one.
</para></listitem></varlistentry>

<varlistentry><term><inlinemediaobject><imageobject><imagedata
fileref="tool-star.png" format="PNG"></imagedata>
</imageobject></inlinemediaobject> <guilabel>Star</guilabel></term>
<listitem><para>
This tool creates star-shaped objects. Press the &LMB; to indicate the center,
and drag the mouse to change the size and rotation of the star.
</para><para>
You can press &Alt; while still keeping the &LMB; down to move the star to a
different location.
</para></listitem></varlistentry>

<varlistentry><term><inlinemediaobject><imageobject><imagedata
fileref="tool-bezier.png" format="PNG"></imagedata>
</imageobject></inlinemediaobject> <guilabel>Bezier</guilabel></term>
<listitem><para>
You can draw Bezier curves by using this tool. Click the &LMB; to indicate the
starting point of the curve, then click again for consecutive control points
of the curve. 
</para>
<para>
<screenshot>
<screeninfo>Drawing a Bezier curve</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="tool-bezier-example.png" format="PNG" />
</imageobject>
<textobject>
<phrase>Drawing a Bezier curve</phrase>
</textobject>
<caption><para>Drawing a Bezier curve</para></caption>
</mediaobject>
</screenshot>
</para>
<para>
&krita; will show a blue line with two handles when you add a control point.
You can drag these handles to change the direction of the curve in that point.
</para>
<para>
<screenshot>
<screeninfo>Modifying a Bezier curve</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="tool-bezier-example2.png" format="PNG" />
</imageobject>
<textobject>
<phrase>Modifying a Bezier curve</phrase>
</textobject>
<caption><para>Modifying a Bezier curve</para></caption>
</mediaobject>
</screenshot>
</para>
<para>
You can click on a previously inserted control point to modify it. With an intermediate
control point (&ie; a point that is not the starting point and not the ending
point), you can move the direction handles seperately to have the curve enter
and leave the point in different directions. After editing a point, you can
just click on the canvas to continue adding points to the curve.
</para>
<para>
Pressing <keycap>Delete</keycap> will remove the currently selected control
point from the curve. Double-click the &LMB; on any point of the curve or
press &Enter; to finish drawing, or press &Esc; to cancel the entire curve.
You can use &Ctrl; while keeping the &LMB; pressed to move the entire curve to
a different position.
</para>
<para>
<screenshot>
<screeninfo>A finished Bezier curve</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="tool-bezier-example3.png" format="PNG" />
</imageobject>
<textobject>
<phrase>A finished Bezier curve</phrase>
</textobject>
<caption><para>A finished Bezier curve</para></caption>
</mediaobject>
</screenshot>
</para></listitem></varlistentry>

<varlistentry><term><inlinemediaobject><imageobject><imagedata
fileref="tool-duplicate.png" format="PNG"></imagedata>
</imageobject></inlinemediaobject> <guilabel>Duplicate</guilabel></term>
<listitem><para>
You can use this tool to duplicate parts of an image. Press &Shift; and click
with the &LMB; on the location you want to duplicate from. &krita; will
indicate this location by an outline of your current brush. Then click with
the &LMB; to designate the location where you want to duplicate to, and drag
with the mouse. You will then duplicate whatever is at the source location to
the current (destination) location.
</para><para>
While you are painting the duplicate, both your cursor in the destination
location and the brush outline in the source location will move, in order to
give you visual feedback.
</para><para>
You can also use this tool to correct colors in a part of the image: use the
<guilabel>Healing</guilabel> option for that.
</para></listitem></varlistentry>

<varlistentry><term><inlinemediaobject><imageobject><imagedata
fileref="tool-paintwithfilters.png" format="PNG"></imagedata>
</imageobject></inlinemediaobject> <guilabel>Paint with
filters</guilabel></term>
<listitem><para>
This tool allows you to pick a filter and draw with it. The image below shows
the effect of using a large circular brush and painting with, from left to
right, the Maximize Channel, Minimize Channel, Invert, and Desaturate filters.
</para>
<para>
<screenshot>
<screeninfo>Painting with filters</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="tool-paintwithfilters-example.png" format="PNG" />
</imageobject>
<textobject>
<phrase>Painting with filters</phrase>
</textobject>
<caption><para>Painting with filters</para></caption>
</mediaobject>
</screenshot>
</para></listitem></varlistentry>

<varlistentry><term><inlinemediaobject><imageobject><imagedata
fileref="tool-crop.png" format="PNG"></imagedata>
</imageobject></inlinemediaobject> <guilabel>Crop</guilabel></term>
<listitem><para>
With this tool you can crop a layer or an image to a certain rectangular area.
Click and drag with the &LMB; to define an area. This area is designated by an
outline with 8 handles. You can then use the handles to change the size of the
area which the image or layer is to be cropped to. You can also click and drag
inside the area to move the outline in its entirety.
</para><para>
Double-click outside the area (i.e. on a part of the image that is to be removed)
to confirm the cropping operation.
</para></listitem></varlistentry>

<varlistentry><term><inlinemediaobject><imageobject><imagedata
fileref="tool-move.png" format="PNG"></imagedata>
</imageobject></inlinemediaobject> <guilabel>Move</guilabel></term>
<listitem><para>
With this tool, you can move the current layer or selection by dragging the
mouse.
</para></listitem></varlistentry>

<varlistentry>
<term><inlinemediaobject><imageobject><imagedata fileref="tool-transform.png"
format="PNG"></imagedata> </imageobject></inlinemediaobject> Transform</term>
<listitem><para>
With this tool you can quickly transform the current selection or layer.
Handles will appear at the corners and sides, with which you can resize the
selection or layer. You can perform rotations by moving the mouse above or to
the left of the handles and dragging it. You can also click anywhere inside
the selection or layer and move it by dragging the mouse.
</para></listitem></varlistentry>

<varlistentry><term><inlinemediaobject><imageobject><imagedata
fileref="tool-perspectivetransform.png" format="PNG"></imagedata>
</imageobject></inlinemediaobject> <guilabel>Perspective Transform</guilabel></term>
<listitem><para>
This tool allows you to change the perspective of an image. Designate the area
which should become the new image by clicking at its top-left, top-right,
bottom-right and bottom-left corners. The area given by these four corners
will then be transformed so that the given corners become the corners of the
actual image.
</para></listitem></varlistentry>

<varlistentry><term><inlinemediaobject><imageobject><imagedata
fileref="tool-contiguousfill.png" format="PNG"></imagedata>
</imageobject></inlinemediaobject> <guilabel>Contiguous Fill</guilabel></term>
<listitem><para>
Use this tool to fill a contiguous area of one color with the current
foreground color or a pattern. Simply click to fill up the area.
</para></listitem></varlistentry>

<varlistentry><term><inlinemediaobject><imageobject><imagedata
fileref="tool-gradient.png" format="PNG"></imagedata>
</imageobject></inlinemediaobject> <guilabel>Gradient</guilabel></term>
<listitem><para>
This tool fills the current layer or selection with the currently selected
gradient. Click the &LMB;, hold it, and drag the mouse to define two endpoints.
The gradient will be drawn along this line. If the line does not extend to the
border of the selection or layer, the color at the corresponding endpoint of
the gradient will be used to fill up the rest of the area at that side.
</para></listitem></varlistentry>

<varlistentry><term><inlinemediaobject><imageobject><imagedata
fileref="tool-text.png" format="PNG"></imagedata>
</imageobject></inlinemediaobject> <guilabel>Text</guilabel></term>
<listitem><para>
With this tool you can add simple text to your image. Click the &LMB; on the
location at which you want have the text. Then enter the desired text in the
dialog window that appears. The text will be horizontally centered on, and
the top of the text will be at the same height as, the chosen location.
</para></listitem></varlistentry>

<varlistentry><term><inlinemediaobject><imageobject><imagedata
fileref="tool-colorpicker.png" format="PNG"></imagedata>
</imageobject></inlinemediaobject> <guilabel>Color Picker</guilabel></term>
<listitem><para>
With this tool you can find the color values of a point. Click the &LMB;
somewhere in the image to see color information about that point in the
<guilabel>Control box</guilabel>.
</para></listitem></varlistentry>

<varlistentry><term><inlinemediaobject><imageobject><imagedata
fileref="tool-pan.png" format="PNG"></imagedata>
</imageobject></inlinemediaobject> <guilabel>Pan</guilabel></term>
<listitem><para>
This tool can be used to navigate through your image. Click and hold the &LMB;
and move the mouse to scroll in a certain direction.
</para></listitem></varlistentry>

<varlistentry><term><inlinemediaobject><imageobject><imagedata
fileref="tool-zoom.png" format="PNG"></imagedata>
</imageobject></inlinemediaobject> <guilabel>Zoom</guilabel></term>
<listitem><para>
Use this tool to zoom in and out. Click the &LMB; to increase the zoom by
a factor 2 (e.g. 1:1 to 2:1), click the &RMB; to decrease the zoom by a factor
2 (e.g. 1:1 to 1:2).
</para></listitem></varlistentry>

<varlistentry><term><inlinemediaobject><imageobject><imagedata
fileref="tool-perspectivegrid.png" format="PNG"></imagedata>
</imageobject></inlinemediaobject> <guilabel>Perspective Grid</guilabel></term>
<listitem><para>
You can create and edit a perspective grid with this tool. Click the &LMB; and
drag the mouse to indicate the first two corners of the grid, then click for
the third and fourth corners. The outline of the grid is now shown and you can
edit it if you are not completely happy. When you switch to a different tool,
the perspective grid will be subdivided and shown as thin gray lines.
</para>
<note><para>If you only see three corners instead of four, you probably
clicked instead of dragging initially. In this case you can still click the
handle of your now combined first and second corners and drag it to get four
separate corners.</para></note>
<para>
Clicking the <guilabel>Perspective Grid</guilabel> tool again later will allow
you to modify the grid. You can hide or remove the grid by choosing the
<guimenuitem>Hide Perspective Grid</guimenuitem> or <guimenuitem>Clear
Perspective Grid</guimenuitem> options from the <guimenu>View</guimenu> menu.
</para></listitem></varlistentry>

<varlistentry><term><inlinemediaobject><imageobject><imagedata
fileref="tool-paintselection.png" format="PNG"></imagedata>
</imageobject></inlinemediaobject> <guilabel>Paint Selection</guilabel></term>
<listitem><para>
This tool can be used to select custom areas. The currently selected brush is
used to select areas: instead of painting on the image, the area is selected.
For more information on selections, see <link
linkend="selections">the Selections chapter</link>.
</para></listitem></varlistentry>

<varlistentry>
<term><inlinemediaobject><imageobject><imagedata
fileref="tool-eraseselection.png" format="PNG"></imagedata>
</imageobject></inlinemediaobject> <guilabel>Erase Selection</guilabel></term>
<listitem><para>
This tool works almost the same as the <guilabel>Paint Selection</guilabel>
tool, but a selection, if it exists at the mouse location, is removed instead
of created.
</para></listitem></varlistentry>

<varlistentry>
<term><inlinemediaobject><imageobject><imagedata
fileref="tool-selectrectangular.png" format="PNG"></imagedata>
</imageobject></inlinemediaobject> <guilabel>Select Rectangular</guilabel></term>
<listitem><para>
You can use this tool to select rectangular areas. Operation is similar to the
<guilabel>Rectangle</guilabel> tool, and &Shift;, &Ctrl; and &Alt; can be used
like when painting rectangles.
</para></listitem></varlistentry>

<varlistentry>
<term><inlinemediaobject><imageobject><imagedata
fileref="tool-selectelliptical.png" format="PNG"></imagedata>
</imageobject></inlinemediaobject> <guilabel>Select Elliptical</guilabel></term>
<listitem><para>
You can use this tool to select elliptical areas. Operation is similar to the
<guilabel>Ellipse</guilabel> tool, and &Shift;, &Ctrl; and &Alt; can be used
like when painting ellipses.
</para></listitem></varlistentry>

<varlistentry>
<term><inlinemediaobject><imageobject><imagedata
fileref="tool-selectpolygonal.png"
format="PNG"></imagedata> </imageobject></inlinemediaobject> <guilabel>Select
Polygonal</guilabel></term>
<listitem><para>
You can use this tool to select polygonal areas. Operation is similar to the
<guilabel>Polygon</guilabel> tool, and &Shift;, &Ctrl; and &Alt; can be used
like when painting polygons.
</para></listitem></varlistentry>

<varlistentry>
<term><inlinemediaobject><imageobject><imagedata
fileref="tool-selectoutline.png"
format="PNG"></imagedata> </imageobject></inlinemediaobject> <guilabel>Select
Outline</guilabel></term>
<listitem><para>
You can use this tool to select custom outlined areas. Click the &LMB; and drag
with your mouse, like when painting with the <guilabel>Brush</guilabel> tool,
to define the outline. When you release the mouse button, the outline will be
finished with a straight line between the current position and the start
position.
</para></listitem></varlistentry>

<varlistentry>
<term><inlinemediaobject><imageobject><imagedata
fileref="tool-selectcontiguous.png" format="PNG"></imagedata>
</imageobject></inlinemediaobject> <guilabel>Select Contiguous</guilabel></term>
<listitem><para>
With this tool you can select contiguous areas of a color. Click with the
&LMB; to select an area.
</para></listitem></varlistentry>

<varlistentry>
<term><inlinemediaobject><imageobject><imagedata
fileref="tool-selectsimilar.png" format="PNG"></imagedata>
</imageobject></inlinemediaobject> <guilabel>Select Similar</guilabel></term>
<listitem><para>
With this tool you can select multiple areas with the same color. Detection is
done the same as with the contiguous fill, but the areas do not need to be
adjacent.
</para></listitem></varlistentry>

<varlistentry><term><inlinemediaobject><imageobject><imagedata
fileref="tool-selectmagnetic.png" format="PNG"></imagedata>
</imageobject></inlinemediaobject> <guilabel>Magnetic Selection</guilabel></term>
<listitem><para>
With this tool you can easily select a visually distinct area. Click with the
&LMB; and move the mouse around the area that you want to select. If the area
has a well enough defined boundary, the selection will be drawn nicely around
it. You will see a number of control points appear, which connect the various
parts of the selection boundary.
</para><para>
If you want more control over the area that is selected, press &Ctrl; to
switch to manual mode. You will now have to click for each control point.
In manual mode, you can also move control points by clicking on them with the
&LMB; and dragging with the mouse.
</para><para>
When you want to return to automatic mode, simply press &Ctrl; again. You can
switch between these two modes as often as you like.
</para></listitem></varlistentry>

<varlistentry><term><inlinemediaobject><imageobject><imagedata
fileref="tool-selectbezier.png" format="PNG"></imagedata>
</imageobject></inlinemediaobject> <guilabel>Select Bezier</guilabel></term>
<listitem><para>
With this tool you can select an area by drawing a Bezier outline. See the
description of the Bezier tool for details.
</para></listitem></varlistentry>

</variablelist>

</sect2>

<sect2 id="commands-toolbars-brushesandstuff">
<title>The <guilabel>Brushes and Stuff</guilabel> Toolbar</title>

<para>
<screenshot>
<screeninfo>The <guilabel>Brushes and Stuff</guilabel> toolbar</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="toolbar-brushesandstuff.png" format="PNG" />
</imageobject>
<textobject>
<phrase>The <guilabel>Brushes and Stuff</guilabel> toolbar</phrase>
</textobject>
<caption><para>The <guilabel>Brushes and Stuff</guilabel> toolbar</para></caption>
</mediaobject>
</screenshot>
</para>

<para>This toolbar contains dropdown <quote>palettes</quote> in which you
can choose brush shapes, gradients, and fill patterns. It also contains a
dropdown box for painter's tools, and a tablet pressure setting.</para>

<sect3 id="commands-toolbars-brushesandstuff-brushshapes">
<title><guilabel>Brush Shapes</guilabel></title>

<para>
<screenshot>
<screeninfo>The <guilabel>Brush Shapes</guilabel> palette</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="toolbar-brushes-brushshapes-predefined.png" format="PNG" />
</imageobject>
<textobject>
<phrase>The <guilabel>Brush Shapes</guilabel> palette</phrase>
</textobject>
<caption><para>The <guilabel>Brush Shapes</guilabel> palette</para></caption>
</mediaobject>
</screenshot>
</para>

<para>In the <guilabel>Brush Shapes</guilabel> palette, you can choose
which brush to paint with. This brush is used for painting operations
like <guilabel>Freehand</guilabel>, <guilabel>Rectangle</guilabel>,
<guilabel>Ellipse</guilabel>, etcetera. You can choose a predefined
brush (in the <guilabel>Predefined Brushes</guilabel> tab, shown above), or
customize or create one.</para>

<para>
<screenshot>
<screeninfo>The <guilabel>Brush Shapes</guilabel> palette with the <guilabel>Autobrush</guilabel> tab</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="toolbar-brushes-brushshapes-autobrush.png" format="PNG" />
</imageobject>
<textobject>
<phrase>The <guilabel>Brush Shapes</guilabel> palette with the <guilabel>Autobrush</guilabel> tab</phrase>
</textobject>
<caption><para>The <guilabel>Brush Shapes</guilabel> palette with the <guilabel>Autobrush</guilabel>
tab</para></caption>
</mediaobject>
</screenshot>
</para>

<para>The <guilabel>Autobrush</guilabel> tab allows you to create a customized
rectangular or ellipsoid brush. You can set its height and width using
the <guilabel>Size</guilabel> spin boxes. The link icon controls whether 
the height and width are forced to be the same or not. If a connected link
picture is shown, changing one value will automatically change the other one 
as well. A disconnected link indicates that both values can be set
independently. The fuzziness of the brush can be set with the
<guilabel>Fade</guilabel> spin boxes. Again, horizontal and vertical values can
be allowed to differ or not, depending on the state of the link button.</para>

<para>
<screenshot>
<screeninfo>The <guilabel>Brush Shapes</guilabel> palette with the <guilabel>Custom Brush</guilabel> tab</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="toolbar-brushes-brushshapes-custombrush.png" format="PNG" />
</imageobject>
<textobject>
<phrase>The <guilabel>Brush Shapes</guilabel> palette with the <guilabel>Custom Brush</guilabel> tab</phrase>
</textobject>
<caption><para>The <guilabel>Brush Shapes</guilabel> palette with the <guilabel>Custom Brush</guilabel>
tab</para></caption>
</mediaobject>
</screenshot>
</para>

<para>The <guilabel>Custom Brush</guilabel> tab of this palette lets you
use the current image as a brush. With the <guibutton>Add to
Predefined Brushes</guibutton> button, you can save it for later use.</para>

</sect3>

<sect3 id="commands-toolbars-brushesandstuff-gradients">
<title>Gradients</title>

<para>
<screenshot>
<screeninfo>The <guilabel>Gradients</guilabel> palette</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="toolbar-brushes-gradients.png" format="PNG" />
</imageobject>
<textobject>
<phrase>The <guilabel>Gradients</guilabel> palette</phrase>
</textobject>
<caption><para>The <guilabel>Gradients</guilabel> palette</para></caption>
</mediaobject>
</screenshot>
</para>

<para>In the <guilabel>Gradients</guilabel> palette, you can choose a gradient
to paint with using the <guilabel>Gradient</guilabel> tool. Clicking once on a gradient in the
palette will show a larger preview. Click it again to make it the current
gradient.</para>
<para>You can create your own gradients with the <guibutton>Custom
Gradient</guibutton> button.</para>

</sect3>

<sect3 id="commands-toolbars-brushesandstuff-patterns">
<title>Patterns</title>

<para>
<screenshot>
<screeninfo>The <guilabel>Patterns</guilabel> palette</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="toolbar-brushes-patterns.png" format="PNG" />
</imageobject>
<textobject>
<phrase>The <guilabel>Patterns</guilabel> palette</phrase>
</textobject>
<caption><para>The <guilabel>Patterns</guilabel> palette</para></caption>
</mediaobject>
</screenshot>
</para>

<para>The <guilabel>Patterns</guilabel> palette allows you to choose a pattern
for operations like Pattern fill. Click a pattern to see a preview at
actual size, then click it again to select it.</para>

<para>
<screenshot>
<screeninfo>The <guilabel>Patterns</guilabel> palette with the <guilabel>Custom Pattern</guilabel> tab selected</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="toolbar-brushes-patterns-custompattern.png" format="PNG" />
</imageobject>
<textobject>
<phrase>The <guilabel>Patterns</guilabel> palette with the <guilabel>Custom Pattern</guilabel> tab selected</phrase>
</textobject>
<caption><para>The <guilabel>Patterns</guilabel> palette with the <guilabel>Custom Pattern</guilabel> tab selected</para></caption>
</mediaobject>
</screenshot>
</para>

<para>You can also create a custom pattern, as is shown above.</para>

</sect3>

<sect3 id="commands-toolbars-brushesandstuff-painterstools">
<title>Painter's tools</title>

<para>With the <guilabel>Painter's tools</guilabel> dropdown box, you can
select the tool your painting operation should simulate. For example, you can
paint with a normal brush, an airbrush, or a filter.</para>

</sect3>

<sect3 id="commands-toolbars-brushesandstuff-pressurevariation">
<title>Pressure variation</title>

<para>This setting allows you to change &krita;'s behaviour when you use a
tablet to paint with. When you change the pressure on the tablet, you can
choose between changing the line width (<guilabel>size</guilabel>), the
opacity, and the darkness.</para>

</sect3>

</sect2>

</sect1>