diff options
Diffstat (limited to 'doc/chalk/commands-palettes.docbook')
| -rw-r--r-- | doc/chalk/commands-palettes.docbook | 769 |
1 files changed, 769 insertions, 0 deletions
diff --git a/doc/chalk/commands-palettes.docbook b/doc/chalk/commands-palettes.docbook new file mode 100644 index 00000000..f71be732 --- /dev/null +++ b/doc/chalk/commands-palettes.docbook @@ -0,0 +1,769 @@ +<sect1 id="commands-palettes"> +<title>Palettes</title> + +<para> +This section describes &chalk;'s palettes. The palettes are usually found at +the right hand side of &chalk;'s main window. There are three palettes which +help you in customizing your images: +</para> + +<sect2 id="commands-palettes-controlbox"> +<title>The <guilabel>Control box</guilabel> palette</title> +<para>The <guilabel>Control box</guilabel> contains three tabs. You can get an +overview of the image, view a color histogram, and modify options for the +current tool.</para> + +<sect3 id="commands-palettes-controlbox-overview"> +<title><guilabel>Overview</guilabel></title> + +<para> +<screenshot> +<screeninfo>The <guilabel>Overview</guilabel> tab</screeninfo> +<mediaobject> +<imageobject> +<imagedata fileref="palettes-controlbox-overview.png" format="PNG" /> +</imageobject> +<textobject> +<phrase>The <guilabel>Overview</guilabel> tab</phrase> +</textobject> +<caption><para>The <guilabel>Overview</guilabel> tab</para></caption> +</mediaobject> +</screenshot> +</para> +<para>This tab offers you two settings. With the spinbox, slider, and +<guibutton>1:1</guibutton> button at the bottom, you can set the zoom level +for the document. The <guilabel>Exposure</guilabel> slider and textbox can be +used to choose the exposure level for OpenEXR images. Furthermore, the +<guilabel>X</guilabel> and <guilabel>Y</guilabel> labels indicate the current +pointer position, with (0,0) being the top left corner of the canvas.</para> +</sect3> + +<sect3 id="commands-palettes-controlbox-histogram"> +<title><guilabel>Histogram</guilabel></title> + +<para> +<screenshot> +<screeninfo>The <guilabel>Histogram</guilabel> tab</screeninfo> +<mediaobject> +<imageobject> +<imagedata fileref="palettes-controlbox-histogram.png" format="PNG" /> +</imageobject> +<textobject> +<phrase>The <guilabel>Histogram</guilabel> tab</phrase> +</textobject> +<caption><para>The <guilabel>Histogram</guilabel> tab</para></caption> +</mediaobject> +</screenshot> +</para> +<para>This tab displays a color histogram showing the distribution of +colors over the image. The histogram is split up in red, green and blue +levels.</para> +</sect3> + +<sect3 id="commands-palettes-controlbox-tool"> +<title><guilabel>Tool</guilabel></title> + +<para>Actually, there is no tab named like this, since the tab name changes to +reflect the name of the currently selected tool. This tab shows the +customization options available for the tools that have them.</para> + +<sect4 id="commands-palettes-controlbox-tool-brush"> +<title><guilabel>Brush</guilabel></title> +<para> +<screenshot> +<screeninfo>The <guilabel>Tool</guilabel> tab for <guilabel>Brush</guilabel></screeninfo> +<mediaobject> +<imageobject> +<imagedata fileref="palettes-controlbox-brush.png" format="PNG" /> +</imageobject> +<textobject> +<phrase>The <guilabel>Tool</guilabel> tab for <guilabel>Brush</guilabel></phrase> +</textobject> +<caption><para>The <guilabel>Tool</guilabel> tab for <guilabel>Brush</guilabel></para></caption> +</mediaobject> +</screenshot> +</para> +<para>There are three options available on this tab. +</para><para> +The <guilabel>Opacity</guilabel> slider and spin box are used to set the +opacity when drawing (opacity is the opposite of transparency, i.e. 100% +opaque is 0% transparent, and vice versa). +</para><para> +In the <guilabel>Mode</guilabel> drop down box, you can choose a drawing +mode. This changes the actual effect that results from drawing on the image +(for example, only changing the saturation or lightness). +</para><para> +With the <guilabel>Paint direct</guilabel> option, you can determine whether +you want to paint directly on the current layer, or on a temporary layer which +is then composited onto the actual layer. This makes a difference especially +when using relative low opacity values.</para> +</sect4> + +<sect4 id="commands-palettes-controlbox-tool-line"> +<title><guilabel>Line</guilabel></title> +<para> +<screenshot> +<screeninfo>The <guilabel>Tool</guilabel> tab for <guilabel>Line</guilabel></screeninfo> +<mediaobject> +<imageobject> +<imagedata fileref="palettes-controlbox-line.png" format="PNG" /> +</imageobject> +<textobject> +<phrase>The <guilabel>Tool</guilabel> tab for <guilabel>Line</guilabel></phrase> +</textobject> +<caption><para>The <guilabel>Tool</guilabel> tab for <guilabel>Line</guilabel></para></caption> +</mediaobject> +</screenshot> +</para> +<para>See <link +linkend="commands-palettes-controlbox-tool-brush">Brush</link> +for the description of <guilabel>Opacity</guilabel> and +<guilabel>Mode</guilabel>. The <guilabel>?</guilabel> button shows a tip about +the usage of modifier keys.</para> +</sect4> + +<sect4 id="commands-palettes-controlbox-tool-rectangle"> +<title><guilabel>Rectangle</guilabel></title> +<para> +<screenshot> +<screeninfo>The <guilabel>Tool</guilabel> tab for <guilabel>Rectangle</guilabel></screeninfo> +<mediaobject> +<imageobject> +<imagedata fileref="palettes-controlbox-rectangle.png" format="PNG" /> +</imageobject> +<textobject> +<phrase>The Tool tab for <guilabel>Rectangle</guilabel></phrase> +</textobject> +<caption><para>The Tool tab for <guilabel>Rectangle</guilabel></para></caption> +</mediaobject> +</screenshot> +</para> +<para>See <link +linkend="commands-palettes-controlbox-tool-brush">Brush</link> for a description of <guilabel>Opacity</guilabel> and +<guilabel>Mode</guilabel>. +</para><para> +The <guilabel>Fill</guilabel> drop down box is used to specify whether the +inside of the rectangle should be filled. You can choose between three fill +options: the current foreground color, background color or pattern is +used.</para> +</sect4> + +<sect4 id="commands-palettes-controlbox-tool-bezier"> +<title><guilabel>Bezier</guilabel></title> +<para>See <link +linkend="commands-palettes-controlbox-tool-brush">Brush</link> for the +description of <guilabel>Mode</guilabel> and <guilabel>Opacity</guilabel>.</para> +</sect4> + + +<sect4 id="commands-palettes-controlbox-tool-ellipse"> +<title><guilabel>Ellipse</guilabel></title> +<para>The same options as for <link +linkend="commands-palettes-controlbox-tool-rectangle">Rectangle</link> are +available here.</para> +</sect4> + +<sect4 id="commands-palettes-controlbox-tool-polygon"> +<title><guilabel>Polygon</guilabel></title> +<para>The same options as for <link +linkend="commands-palettes-controlbox-tool-rectangle">Rectangle</link> are +available here.</para> +</sect4> + +<sect4 id="commands-palettes-controlbox-tool-polyline"> +<title><guilabel>Polyline</guilabel></title> +<para>The same options as for <link +linkend="commands-palettes-controlbox-tool-line">Line</link> +are available here.</para> +</sect4> + +<sect4 id="commands-palettes-controlbox-tool-star"> +<title><guilabel>Star</guilabel></title> +<para> +<screenshot> +<screeninfo>The <guilabel>Tool</guilabel> tab for <guilabel>Star</guilabel></screeninfo> +<mediaobject> +<imageobject> +<imagedata fileref="palettes-controlbox-star.png" format="PNG" /> +</imageobject> +<textobject> +<phrase>The <guilabel>Tool</guilabel> tab for <guilabel>Star</guilabel></phrase> +</textobject> +<caption><para>The <guilabel>Tool</guilabel> tab for <guilabel>Star</guilabel></para></caption> +</mediaobject> +</screenshot> +</para> +<para>The options for <link +linkend="commands-palettes-controlbox-tool-rectangle">Rectangle</link> are +available here, as well as two options specific to this tool. +</para><para> +The <guilabel>Vertices</guilabel> drop down box is used to set the amount +of vertices (points) in the star. +</para><para> +The <guilabel>Ratio</guilabel> setting defines the shape of the +star. A ratio of 0% will create a star with no inner area (when drawing the +star, the two lines that make up a star point, overlap). Increasing the ratio +will slowly make the star more outlined (the two lines are <quote>pulled +apart</quote>). A star with a ratio of 100% is a regular polygon. +</para> +</sect4> + +<sect4 id="commands-palettes-controlbox-tool-duplicate"> +<title><guilabel>Duplicate</guilabel></title> +<para> +<screenshot> +<screeninfo>The <guilabel>Tool</guilabel> tab for <guilabel>Duplicate</guilabel></screeninfo> +<mediaobject> +<imageobject> +<imagedata fileref="palettes-controlbox-duplicate.png" format="PNG" /> +</imageobject> +<textobject> +<phrase>The <guilabel>Tool</guilabel> tab for <guilabel>Duplicate</guilabel></phrase> +</textobject> +<caption><para>The <guilabel>Tool</guilabel> tab for <guilabel>Duplicate</guilabel></para></caption> +</mediaobject> +</screenshot> +</para> +<para>The same options as for <link +linkend="commands-palettes-controlbox-tool-line">Line</link> +are available here. In addition, there are three other options. +</para><para> +With the <guilabel>Healing</guilabel> and +<guilabel>Healing radius</guilabel> options, you can specify that the +duplication should not copy the colors, but only the <quote>structure</quote> +of the source area. +</para><para> +If you enable the <guilabel>Correct the perspective</guilabel> option, the +duplicate tool will follow your perspective grid. +</para> +</sect4> + +<sect4 id="commands-palettes-controlbox-tool-paintwithfilters"> +<title><guilabel>Paint with Filters</guilabel></title> +<para> +<screenshot> +<screeninfo>The <guilabel>Tool</guilabel> tab for <guilabel>Paint with Filters</guilabel></screeninfo> +<mediaobject> +<imageobject> +<imagedata fileref="palettes-controlbox-paintwithfilters.png" format="PNG" /> +</imageobject> +<textobject> +<phrase>The <guilabel>Tool</guilabel> tab for <guilabel>Paint with Filters</guilabel></phrase> +</textobject> +<caption><para>The <guilabel>Tool</guilabel> tab for <guilabel>Paint with Filters</guilabel></para></caption> +</mediaobject> +</screenshot> +</para> +<para>Depending on the filter, you can set different options here. The +options you can set are the same as those available in the +<quote>normal</quote> settings dialog for the chosen filter. See the +<link linkend="commands-dialogs-filters">Filters section in the Dialogs +chapter</link> for more information.</para> </sect4> + +<sect4 id="commands-palettes-controlbox-tool-transform"> +<title><guilabel>Transform</guilabel></title> +<para> +<screenshot> +<screeninfo>The <guilabel>Tool</guilabel> tab for <guilabel>Transform</guilabel></screeninfo> +<mediaobject> +<imageobject> +<imagedata fileref="palettes-controlbox-transform.png" format="PNG" /> +</imageobject> +<textobject> +<phrase>The <guilabel>Tool</guilabel> tab for <guilabel>Transform</guilabel></phrase> +</textobject> +<caption><para>The <guilabel>Tool</guilabel> tab for <guilabel>Transform</guilabel></para></caption> +</mediaobject> +</screenshot> +</para> +<!-- >The <guilabel>Move X</guilabel> and <guilabel>Move Y</guilabel> +spin boxes show, and can be used to set, the displacement of the layer or +selection. The same applies to <guilabel>Scale X</guilabel> and <guilabel>Scale +Y</guilabel> for the scaling of the current layer or selection. Finally, --> +<para>You can choose which transformation algorithm to use in the +<guilabel>Filter</guilabel> drop down box.</para> +</sect4> + +<sect4 id="commands-palettes-controlbox-tool-crop"> +<title><guilabel>Crop</guilabel></title> +<para> +<screenshot> +<screeninfo>The <guilabel>Tool</guilabel> tab for <guilabel>Crop</guilabel></screeninfo> +<mediaobject> +<imageobject> +<imagedata fileref="palettes-controlbox-crop.png" format="PNG" /> +</imageobject> +<textobject> +<phrase>The <guilabel>Tool</guilabel> tab for <guilabel>Crop</guilabel></phrase> +</textobject> +<caption><para>The <guilabel>Tool</guilabel> tab for <guilabel>Crop</guilabel></para></caption> +</mediaobject> +</screenshot> +</para> +<para>Set the corner coordinates of the area that should remain with the +four spin boxes <guilabel>X</guilabel>, <guilabel>Y</guilabel>, +<guilabel>Width</guilabel> and <guilabel>Height</guilabel>. You can also +fill in <guilabel>Ratio</guilabel> to determine the Y/X ratio. Check one of +the checkboxes to have the respective value remain constant while changing the +size of the area. The drop down box can be used to select whether the entire +image or only the current layer should be cropped. Clicking the +<guibutton>Crop</guibutton> button has the same effect as double-clicking +outside the area in the image.</para> +</sect4> + +<sect4 id="commands-palettes-controlbox-tool-contiguousfill"> +<title><guilabel>Contiguous Fill</guilabel></title> +<para> +<screenshot> +<screeninfo>The <guilabel>Tool</guilabel> tab for <guilabel>Contiguous Fill</guilabel></screeninfo> +<mediaobject> +<imageobject> +<imagedata fileref="palettes-controlbox-contiguousfill.png" format="PNG" /> +</imageobject> +<textobject> +<phrase>The <guilabel>Tool</guilabel> tab for <guilabel>Contiguous Fill</guilabel></phrase> +</textobject> +<caption><para>The <guilabel>Tool</guilabel> tab for <guilabel>Contiguous Fill</guilabel></para></caption> +</mediaobject> +</screenshot> +</para> +<para>The same options as for <link +linkend="commands-palettes-controlbox-tool-brush">Brush</link> +are available here, as are a couple of other options. +</para><para> +The setting in the <guilabel>Threshold</guilabel> slider and spin box +determines how near the color of a point should be to the color of the +starting point of the fill, in order for the fill to spread out over the +former point. A higher threshold will therefore fill areas that have less +similar colors, a lower threshold limits the spread. +</para><para> +If you check the <guilabel>Fill entire selection</guilabel> checkbox, the +entire selection will be filled instead of only the neighboring area. +</para><para> +Checking the <guilabel>Limit to current layer</guilabel> checkbox changes the +behavior of the fill: the extent to which the fill is done, is determined from +the current layer only instead of the entire image. +</para><para> +By checking the <guilabel>Use pattern</guilabel> checkbox you can choose to +fill with the currently selected pattern instead of with the foreground color. +</para> +</sect4> + +<sect4 id="commands-palettes-controlbox-tool-gradient"> +<title><guilabel>Gradient</guilabel></title> +<para> +<screenshot> +<screeninfo>The <guilabel>Tool</guilabel> tab for <guilabel>Gradient</guilabel></screeninfo> +<mediaobject> +<imageobject> +<imagedata fileref="palettes-controlbox-gradient.png" format="PNG" /> +</imageobject> +<textobject> +<phrase>The <guilabel>Tool</guilabel> tab for <guilabel>Gradient</guilabel></phrase> +</textobject> +<caption><para>The <guilabel>Tool</guilabel> tab for <guilabel>Gradient</guilabel></para></caption> +</mediaobject> +</screenshot> +</para> +<para>The same options as for <link +linkend="commands-palettes-controlbox-tool-brush">Brush</link> +are available here, as are a couple of other options. +</para><para> +The <guilabel>Shape</guilabel> drop down box can be used to select the gradient +type: <guilabel>Linear</guilabel>, <guilabel>Bi-Linear</guilabel>, <guilabel>Radial</guilabel>, +<guilabel>Square</guilabel>, <guilabel>Conical</guilabel> and <guilabel>Conical Symmetric</guilabel>. +</para><para> +The <guilabel>Repeat</guilabel> option determines whether the gradient is +repeated if it does not fill the entire image. With <guilabel>None</guilabel>, the colors on the +ends of the gradient are used to fill the remaining space. With <guilabel>Forwards</guilabel>, the +gradient is normally repeated (connecting the back end of one occurrence with +the front end of the next). With <guilabel>Alternating</guilabel>, the gradient is repeated with +every second occurrence being drawn from back to front (linking front to front +and back to back). +</para><para> +Check the <guilabel>Reverse</guilabel> checkbox to have the gradient drawn +reversed (from back to front). +</para><para> +The final setting is <guilabel>Anti-alias threshold</guilabel>, which +determines how smooth the gradient will become. +</para> +</sect4> + +<sect4 id="commands-palettes-controlbox-tool-text"> +<title><guilabel>Text</guilabel></title> +<para> +<screenshot> +<screeninfo>The <guilabel>Tool</guilabel> tab for <guilabel>Text</guilabel></screeninfo> +<mediaobject> +<imageobject> +<imagedata fileref="palettes-controlbox-text.png" format="PNG" /> +</imageobject> +<textobject> +<phrase>The <guilabel>Tool</guilabel> tab for <guilabel>Text</guilabel></phrase> +</textobject> +<caption><para>The <guilabel>Tool</guilabel> tab for <guilabel>Text</guilabel></para></caption> +</mediaobject> +</screenshot> +</para> +<para>The same options as for <link +linkend="commands-palettes-controlbox-tool-brush">Brush</link> +are available here. Furthermore there is an option <guilabel>Font</guilabel>, +which shows the font that will be used for the text. Click the +<guibutton>...</guibutton> button to change the font. +</para> +</sect4> + +<sect4 id="commands-palettes-controlbox-tool-colorpicker"> +<title><guilabel>Color Picker</guilabel></title> +<para> +<screenshot> +<screeninfo>The <guilabel>Tool</guilabel> tab for <guilabel>Color Picker</guilabel></screeninfo> +<mediaobject> +<imageobject> +<imagedata fileref="palettes-controlbox-colorpicker.png" format="PNG" /> +</imageobject> +<textobject> +<phrase>The <guilabel>Tool</guilabel> tab for <guilabel>Color Picker</guilabel></phrase> +</textobject> +<caption><para>The <guilabel>Tool</guilabel> tab for <guilabel>Color Picker</guilabel></para></caption> +</mediaobject> +</screenshot> +</para> +<para>The first option is a dropdown box in which you can choose which +layer to pick the color from. If you choose a specific layer, +the color of the point in that layer will be retrieved. With <guilabel>Sample +All Visible Layers</guilabel>, the topmost visible layer which is not +transparent at that point is used. +</para><para> +If the <guilabel>Update current color</guilabel> checkbox is checked, then the +current foreground color (when clicking with the &LMB;) or background color +(when clicking with the &RMB;) is set to the picked color. +</para><para> +The checkbox <guilabel>Add to palette</guilabel> and the accompanying +dropdown box determine whether the picked color should be added to an existing +palette. Check the checkbox, and choose the desired palette from the list, if +you want to do so. +</para><para> +The checkbox <guilabel>Show colors as percentages</guilabel> switches the +range of color values displayed from the <quote>normal</quote> range (e.g. 0 to +255) to a scaled value between 0% and 100%. +</para><para> +With the <guilabel>Sample radius</guilabel> option, you can choose the area +size to use when picking the color. A radius of one just picks one pixel, +larger radii will make the picker average over the colors of the circle-shaped +area with the chosen radius that is centered around the chosen pixel. +</para> +</sect4> + +<sect4 id="commands-palettes-controlbox-tool-select"> +<title><guilabel>Select</guilabel> tools</title> +<para> +<screenshot> +<screeninfo>The <guilabel>Tool</guilabel> tab for <guilabel>Select</guilabel> tools</screeninfo> +<mediaobject> +<imageobject> +<imagedata fileref="palettes-controlbox-select.png" format="PNG" /> +</imageobject> +<textobject> +<phrase>The <guilabel>Tool</guilabel> tab for <guilabel>Select</guilabel> tools</phrase> +</textobject> +<caption><para>The <guilabel>Tool</guilabel> tab for <guilabel>Select</guilabel> tools</para></caption> +</mediaobject> +</screenshot> +</para> +<para>The <guilabel>Paint Selection</guilabel>, <guilabel>Erase Selection</guilabel>, +<guilabel>Select Rectangular</guilabel>, <guilabel>Select Elliptical</guilabel>, <guilabel>Select Polygonal</guilabel> and <guilabel>Select Outline</guilabel> tools have one option: +the <guilabel>Action</guilabel> to perform. You can choose between <guilabel>Add</guilabel> to, or +<guilabel>Subtract</guilabel> from the selection.</para> +</sect4> + +<sect4 id="commands-palettes-controlbox-tool-selectcontiguous"> +<title><guilabel>Select Contiguous Area</guilabel></title> +<para> +<screenshot> +<screeninfo>The <guilabel>Tool</guilabel> tab for <guilabel>Select Contiguous</guilabel></screeninfo> +<mediaobject> +<imageobject> +<imagedata fileref="palettes-controlbox-selectcontiguous.png" format="PNG" /> +</imageobject> +<textobject> +<phrase>The <guilabel>Tool</guilabel> tab for <guilabel>Select Contiguous</guilabel></phrase> +</textobject> +<caption><para>The <guilabel>Tool</guilabel> tab for <guilabel>Select Contiguous</guilabel></para></caption> +</mediaobject> +</screenshot> +</para> +<para>The <guilabel>Action</guilabel> is the same as discussed with the +<link linkend="commands-palettes-controlbox-tool-select">Select +operations</link>. +</para><para> +The slider and spin box at <guilabel>Fuzziness</guilabel> determine how near +colors must be to the color at the clicked point to be added to the selection. +</para><para> +When the <guilabel>Sample merged</guilabel> checkbox is checked, the +bounds of the selection are determined by looking at the entire image instead +of at the current layer. +</para> +</sect4> + +<sect4 id="commands-palettes-controlbox-tool-selectsimilar"> +<title><guilabel>Similar Select</guilabel></title> +<para>The <guilabel>Action</guilabel> and <guilabel>Fuzziness</guilabel> +options are the same as with <link +linkend="commands-palettes-controlbox-tool-selectcontiguous">Select +contiguous</link>. </para> +</sect4> + +<sect4 id="commands-palettes-controlbox-tool-selectmagnetic"> +<title><guilabel>Select Magnetic</guilabel></title> +<para> +<screenshot> +<screeninfo>The <guilabel>Tool</guilabel> tab for <guilabel>Select Magnetic</guilabel></screeninfo> +<mediaobject> +<imageobject> +<imagedata fileref="palettes-controlbox-selectmagnetic.png" format="PNG" /> +</imageobject> +<textobject> +<phrase>The <guilabel>Tool</guilabel> tab for <guilabel>Select Magnetic</guilabel></phrase> +</textobject> +<caption><para>The <guilabel>Tool</guilabel> tab for <guilabel>Select Magnetic</guilabel></para></caption> +</mediaobject> +</screenshot> +</para> +<para>The <guilabel>Action</guilabel> option is the same as with the other +<link linkend="commands-palettes-controlbox-tool-select">Select tools</link>. +</para> +<para> +The <guilabel>Distance</guilabel> option determines the maximal distance at +which boundaries to attach to, are searched for. The <guibutton>To +Selection</guibutton> button has the same effect as double-clicking the &LMB;: +the selection is finished. +</para> +</sect4> + +</sect3> + +</sect2> + +<sect2 id="commands-palettes-colors"> +<title>The <guilabel>Colors</guilabel> palette</title> +<para>In this palette you can choose the foreground and background colors +that should be used for painting. You can choose these in five different +ways. Each of these has its own tab on this palette. +</para><para> +You can choose which color to set by clicking the corresponding +buttons at the top left. The topmost color is the foreground color, the +bottom one is the background color. You can click the double-headed arrow +to swap the colors: foreground color becomes background color and vice +versa. You can reset the colors to the default (foreground black, background +white) by clicking the small black/white icon. +</para> + +<sect3 id="commands-palettes-colors-hsv"> +<title><guilabel>HSV</guilabel></title> +<para> +<screenshot> +<screeninfo>The <guilabel>HSV</guilabel> tab</screeninfo> +<mediaobject> +<imageobject> +<imagedata fileref="palettes-colors-hsv.png" format="PNG" /> +</imageobject> +<textobject> +<phrase>The <guilabel>HSV</guilabel> tab</phrase> +</textobject> +<caption><para>The <guilabel>HSV</guilabel> tab</para></caption> +</mediaobject> +</screenshot> +</para> +<para>On this tab, you can select a color via the Hue / Saturation / Value +system. +</para><para> +The hue determines the major color and starts at red with 0, then increases +along the color spectrum (that is, along the <quote>line</quote> yellow, green, +blue, violet) to a maximum of 359. This is represented in the circle on the tab +as the angle component (starting at the top, rotate along the circle +in clockwise direction to increase the hue). +</para><para> +The saturation determines the pureness of the color. A saturation of 255 +yields the pure color, while a saturation of 0 yields a gray. This is the +radius component of the color circle on the tab: the center corresponds to +no saturation, the circle boundary corresponds to fully saturated. +</para><para> +The value determines the lightness of the color. This darkens or lightens the +color, as can be set using the vertical slider on the tab. A value of 0 gives +black, a value of 255 gives the pure color. +</para> +</sect3> + +<sect3 id="commands-palettes-colors-rgb"> +<title><guilabel>RGB</guilabel></title> +<para> +<screenshot> +<screeninfo>The <guilabel>RGB</guilabel> tab</screeninfo> +<mediaobject> +<imageobject> +<imagedata fileref="palettes-colors-rgb.png" format="PNG" /> +</imageobject> +<textobject> +<phrase>The <guilabel>RGB</guilabel> tab</phrase> +</textobject> +<caption><para>The <guilabel>RGB</guilabel> tab</para></caption> +</mediaobject> +</screenshot> +</para> +<para>On this tab, colors can be selected using their Red / Green / Blue +components. +</para><para> +You can set red, green and blue components on a scale of 0 to 255. At 0 that +color component is absent, at 255 it is used at maximum intensity. The sliders +will change color to give you a hint about which color you will produce by +altering the corresponding value. +</para> +</sect3> + +<sect3 id="commands-palettes-colors-gray"> +<title><guilabel>Gray</guilabel></title> +<para> +<screenshot> +<screeninfo>The <guilabel>Gray</guilabel> tab</screeninfo> +<mediaobject> +<imageobject> +<imagedata fileref="palettes-colors-gray.png" format="PNG" /> +</imageobject> +<textobject> +<phrase>The <guilabel>Gray</guilabel> tab</phrase> +</textobject> +<caption><para>The <guilabel>Gray</guilabel> tab</para></caption> +</mediaobject> +</screenshot> +</para> +<para>On this tab, you can choose a gray value (indicated with a K for Key, +the usual designation for black).</para> +<para>The gray value can be chosen on a scale from 0 (pure white) to 255 +(pure black).</para> +</sect3> + +<sect3 id="commands-palettes-colors-palettes"> +<title><guilabel>Palettes</guilabel></title> +<para> +<screenshot> +<screeninfo>The <guilabel>Palettes</guilabel> tab</screeninfo> +<mediaobject> +<imageobject> +<imagedata fileref="palettes-colors-palettes.png" format="PNG" /> +</imageobject> +<textobject> +<phrase>The <guilabel>Palettes</guilabel> tab</phrase> +</textobject> +<caption><para>The <guilabel>Palettes</guilabel> tab</para></caption> +</mediaobject> +</screenshot> +</para> +<para>On this tab, you can select a color from one of several predefined +color palettes.</para> +<para>You can choose which color palette to pick from in the drop down +box at the top.</para> +</sect3> + +<sect3 id="commands-palettes-colors-watercolors"> +<title><guilabel>Watercolors</guilabel></title> +<para> +<screenshot> +<screeninfo>The <guilabel>Watercolors</guilabel> tab</screeninfo> +<mediaobject> +<imageobject> +<imagedata fileref="palettes-colors-watercolors.png" format="PNG" /> +</imageobject> +<textobject> +<phrase>The <guilabel>Watercolors</guilabel> tab</phrase> +</textobject> +<caption><para>The <guilabel>Watercolors</guilabel> tab</para></caption> +</mediaobject> +</screenshot> +</para> +<para>This tab offers you a selection of watercolors for painting with <quote>wet +paint</quote>. +</para><para> +You can set two options to modify the painting behaviour: <guilabel>Paint +strength</guilabel> influences how much paint you will apply to the canvas, +and <guilabel>Wetness</guilabel> determines how wet the paint is when it is +applied. You can dry the paint later. +</para> +</sect3> + +</sect2> + +<sect2 id="commands-palettes-layers"> +<title>The <guilabel>Layers</guilabel> palette</title> +<para>This palette offers two tabs.</para> + +<sect3 id="commands-palettes-layers-layers"> +<title><guilabel>Layers</guilabel></title> +<para> +<screenshot> +<screeninfo>The <guilabel>Layers</guilabel> tab</screeninfo> +<mediaobject> +<imageobject> +<imagedata fileref="palettes-layers-layers.png" format="PNG" /> +</imageobject> +<textobject> +<phrase>The <guilabel>Layers</guilabel> tab</phrase> +</textobject> +<caption><para>The <guilabel>Layers</guilabel> tab</para></caption> +</mediaobject> +</screenshot> +</para> +<para>This tab offers you access to various operations on layers. +</para><para> +On the top left, you can select what blending mode should be used for the +selected layer. These are the same possibilities as you can choose from for +drawing modes. +</para><para> +The slider/textbox at the top right determines the opacity of the selected +layer. 0% opacity corresponds to 100% transparency, and vice versa. +</para><para> +The list shows all layers and their names, and offers various controls for each +layer. The eye icon toggles whether the layer is visible or not. The link icon +is used to link layers together. The lock icon determines if the layer is +locked or not. Locked layers cannot be edited. +</para><para> +Below the layer list, there are some other controls. You can create a new +layer, move the current layer up or down, show the layer's properties and +delete it. +</para> +<para> +There are some more handy tricks you can do with the mouse within the list. +Right-click on the layer list and select <guilabel>New Folder</guilabel> to +create a new layer folder, which you can use to group layers in. You can also +drag and drop layers to change their order. To do so, click on the bottom part +of the list item representing the layer, drag the mouse, and release the mouse +button at the desired position. If you click at the top part of the list item +instead, you will get a text field so that you can rename the layer. +</para> +</sect3> + +<sect3 id="commands-palettes-layers-scriptsmanager"> +<title><guilabel>Scripts Manager</guilabel></title> +<para> +<screenshot> +<screeninfo>The <guilabel>Script Manager</guilabel> tab</screeninfo> +<mediaobject> +<imageobject> +<imagedata fileref="palettes-layers-scriptsmanager.png" format="PNG" /> +</imageobject> +<textobject> +<phrase>The <guilabel>Script Manager</guilabel> tab</phrase> +</textobject> +<caption><para>The <guilabel>Script Manager</guilabel> tab</para></caption> +</mediaobject> +</screenshot> +</para> +<para>This tab is a smaller version of the <guilabel>Script +Manager</guilabel> dialog. See the description over there for more +information. +</para> +</sect3> + +</sect2> + +</sect1> |