diff options
Diffstat (limited to 'doc/chalk/commands-toolbars.docbook')
| -rw-r--r-- | doc/chalk/commands-toolbars.docbook | 752 |
1 files changed, 752 insertions, 0 deletions
diff --git a/doc/chalk/commands-toolbars.docbook b/doc/chalk/commands-toolbars.docbook new file mode 100644 index 00000000..b99457f1 --- /dev/null +++ b/doc/chalk/commands-toolbars.docbook @@ -0,0 +1,752 @@ +<sect1 id="commands-toolbars"> +<title>Toolbars</title> + +<para>This section describes &chalk;'s toolbars. By default, the +<guilabel>Chalk</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 &chalk;'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-chalk"> +<title>The <guilabel>Chalk</guilabel> Toolbar</title> + +<para> +<screenshot> +<screeninfo>The <guilabel>Chalk</guilabel> toolbar</screeninfo> +<mediaobject> +<imageobject> +<imagedata fileref="toolbar-chalk.png" format="PNG" /> +</imageobject> +<textobject> +<phrase>The <guilabel>Chalk</guilabel> toolbar</phrase> +</textobject> +<caption><para>The <guilabel>Chalk</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. &chalk; 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> +&chalk; 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. &chalk; 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 &chalk;'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> |