diff options
Diffstat (limited to 'doc/krita')
245 files changed, 0 insertions, 10764 deletions
diff --git a/doc/krita/Makefile.am b/doc/krita/Makefile.am deleted file mode 100644 index 085981d9..00000000 --- a/doc/krita/Makefile.am +++ /dev/null @@ -1,4 +0,0 @@ - -KDE_LANG = en -KDE_DOCS = AUTO - diff --git a/doc/krita/README.SCREENSHOTS b/doc/krita/README.SCREENSHOTS deleted file mode 100644 index bc1d55bd..00000000 --- a/doc/krita/README.SCREENSHOTS +++ /dev/null @@ -1,7 +0,0 @@ -Note for translators: - -The file "mountains.png" is the original photo used for creating the screenshots -in the Dialogs section. - - -- ASK
\ No newline at end of file diff --git a/doc/krita/commands-dialogs.docbook b/doc/krita/commands-dialogs.docbook deleted file mode 100644 index 758a4924..00000000 --- a/doc/krita/commands-dialogs.docbook +++ /dev/null @@ -1,1411 +0,0 @@ -<sect1 id="commands-dialogs"> -<title>Dialogs</title> - -<para> -This section describes &krita;'s dialog windows. -</para> - -<sect2 id="commands-dialogs-image"> -<title>Dialogs for working with images</title> - -<sect3 id="commands-dialogs-images-colorrange"> -<title>The <guilabel>Color Range</guilabel> dialog</title> - -<para> -<screenshot> -<screeninfo>The <guilabel>Color Range</guilabel> dialog</screeninfo> -<mediaobject> -<imageobject> -<imagedata fileref="dialogs-colorrange.png" format="PNG" /> -</imageobject> -<textobject> -<phrase>The <guilabel>Color Range</guilabel> dialog</phrase> -</textobject> -<caption><para>The <guilabel>Color Range</guilabel> dialog</para></caption> -</mediaobject> -</screenshot> -</para> - -<para> -You can create a selection based on the color values of pixels here. In the -dropdown box, choose which color range you want to select. Pixels will be -selected according to their color value on this scale (⪚ a fully yellow -pixel would score maximally on the yellow scale and on the red and green scales). -If you check the <guilabel>Invert</guilabel> box, the selection becomes inverted: -pixels will become selected if they have a lower value in the specified range instead. -You can choose whether the current selection should be -added to or subtracted from the color range selection by clicking the -respective option: <guilabel>Add to current selection</guilabel> or -<guilabel>Subtract from current selection</guilabel>. Choose -<guibutton>Select</guibutton> to actually perform the selection or -<guibutton>Deselect</guibutton> to remove these pixels from the selection. -</para> - -</sect3> - -<sect3 id="commands-dialogs-image-convertimagetype"> -<title>The <guilabel>Convert Image Type</guilabel> dialog</title> - -<para> -<screenshot> -<screeninfo>The <guilabel>Convert Image Type</guilabel> dialog</screeninfo> -<mediaobject> -<imageobject> -<imagedata fileref="dialogs-convertimagetype.png" format="PNG" /> -</imageobject> -<textobject> -<phrase>The <guilabel>Convert Image Type</guilabel> dialog</phrase> -</textobject> -<caption><para>The <guilabel>Convert Image Type</guilabel> dialog</para></caption> -</mediaobject> -</screenshot> -</para> - -<para> -This dialog allows you to convert your image from one color space to another. -The <guilabel>Target color space</guilabel> and <guilabel>Destination ICM -profile</guilabel> are used to set to which colorspace and profile the image -will be converted. You can influence how this conversion is done with the -<guilabel>Rendering Intent</guilabel> option. -</para> -<para> -With <guilabel>Perceptual</guilabel> conversion, the source color space is -mapped linearly to the destination color space. If the destination color space -<quote>accepts</quote> a lesser color range than the source, shifts may occur -because the range is compressed. <guilabel>Relative colorimetric</guilabel> -conversion converts every color to the closest color in the destination color -space. This may mean that a certain color range is mapped to one color in the -destination color space. <guilabel>Saturation</guilabel> means that fully -saturated colors will remain fully saturated, even if this means that the -actual color is changed. With <guilabel>Absolute colorimetric</guilabel> -conversion, the same approach is used as with <guilabel>Relative -colorimetric</guilabel>, but the white point of the color space (the value -designating the color white) is not changed to match the new color space, -which may result in unwanted changes to near colors. -</para> - -</sect3> - -<sect3 id="commands-dialogs-image-imageproperties"> -<title>The <guilabel>Image Properties</guilabel> dialog</title> - -<para> -<screenshot> -<screeninfo>The <guilabel>Image Properties</guilabel> dialog</screeninfo> -<mediaobject> -<imageobject> -<imagedata fileref="dialogs-imageproperties.png" format="PNG" /> -</imageobject> -<textobject> -<phrase>The <guilabel>Image Properties</guilabel> dialog</phrase> -</textobject> -<caption><para>The <guilabel>Image Properties</guilabel> dialog</para></caption> -</mediaobject> -</screenshot> -</para> - -<para> -In this dialog you can change a couple of image properties. First of all, the -<guilabel>Name</guilabel> of the image. If you did not set a name earlier -(that can also be done when creating the image), it will have a default name -like <quote>Image1</quote>. Then, you can set its size (determined by the -<guilabel>Width</guilabel> and <guilabel>Height</guilabel> in pixels and -the <guilabel>Resolution</guilabel> in dots per inch) and the color profile to -be used (<guilabel>Profile</guilabel>). Finally, you can fill in the -<guilabel>Description</guilabel> field with any information you want to add to -the image. -</para> - -</sect3> - -<sect3 id="commands-dialogs-image-imagesize"> -<title>The <guilabel>Image Size</guilabel> dialog</title> - -<para> -<screenshot> -<screeninfo>The <guilabel>Image Size</guilabel> dialog</screeninfo> -<mediaobject> -<imageobject> -<imagedata fileref="dialogs-imagesize.png" format="PNG" /> -</imageobject> -<textobject> -<phrase>The <guilabel>Image Size</guilabel> dialog</phrase> -</textobject> -<caption><para>The <guilabel>Image Size</guilabel> dialog</para></caption> -</mediaobject> -</screenshot> -</para> - -<para> -This dialog lets you resize your image. In the top part, you can choose the -way the image is resized. If you choose <guilabel>Resize</guilabel>, the size -of the image is changed, but its layers (which contain the actual contents) -will not be modified. So, when you double the height and width of the image, -your original image will occupy the top-left quarter part of your new image. -On decreasing the size of your image, the image layers will stretch out over -the image borders, unless you choose <guilabel>Crop layers on image -resize</guilabel>, which will crop all layers to the new image size. -</para><para> -With <guilabel>Scale</guilabel>, the image layers will be resized with the -image. So increasing the image size will actually enlarge the contents, and -similar for decreasing. -</para><para> -Under <guilabel>Pixel dimensions</guilabel>, you can set which new size you -want the image to have. The original size is given as a reference. The new -size can be set both as pixels or as a percentage, with 100% being the -original size. If you select <guilabel>Constrain proportions</guilabel>, the -new width and height will always be set to the same percentage. For example, -if you have an image of 200 x 100 pixels, and set the width to 20 pixels, the -height will automatically be changed to 10. With this checkbox unselected, you -can also resize the image non-proportionally. -</para><para> -The <guilabel>Filter:</guilabel> dropdown box can be used to select a -different algorithm for determining the colors of the pixels in the newly -resized image that did not correspond to a pixel in the old image (the -calculated corresponding location in the old image was located in between -pixels). <guilabel>BSpline</guilabel> uses a 4 x 4 pixel grid and results into a quite high -blurring. <guilabel>Bell</guilabel> is quite fast while resulting in a reasonably smooth image. -<guilabel>Box</guilabel> is the fastest method, but yields the least appealing result. <guilabel>Hermite</guilabel> -keeps the image quite sharp, while smoothing it as well, and is reasonably -fast. <guilabel>Lanczos3</guilabel> results in sharp images, but is very slow. <guilabel>Mitchell</guilabel> (the -default) is not very fast, but often yields a good intermediate result. -<guilabel>Triangle/Bilinear</guilabel> uses the 2 x 2 pixel grid around the calculated location -resulting in relatively sharp lines. -</para> - -</sect3> - -<sect3 id="commands-dialogs-image-rotateimage"> -<title>The <guilabel>Rotate Image</guilabel> dialog</title> - -<para> -<screenshot> -<screeninfo>The <guilabel>Rotate Image</guilabel> dialog</screeninfo> -<mediaobject> -<imageobject> -<imagedata fileref="dialogs-rotateimage.png" format="PNG" /> -</imageobject> -<textobject> -<phrase>The <guilabel>Rotate Image</guilabel> dialog</phrase> -</textobject> -<caption><para>The <guilabel>Rotate Image</guilabel> dialog</para></caption> -</mediaobject> -</screenshot> -</para> - -<para> -With this dialog, you can rotate the image. The top part of the dialog shows -the result of the rotation in the form of a change in dimension (if any). -Under <guilabel>Direction</guilabel> you can choose between -rotating clockwise and counter-clockwise. Under <guilabel>Angle</guilabel>, -you can set the amount of rotation. 90, 180 and 270 degrees can be selected -using the respective option button, other amounts need to be specified with -the <guilabel>Custom</guilabel> spin box. -</para> - -</sect3> - -<sect3 id="commands-dialogs-image-separateimage"> -<title>The <guilabel>Separate Image</guilabel> dialog</title> - -<para> -<screenshot> -<screeninfo>The <guilabel>Separate Image</guilabel> dialog</screeninfo> -<mediaobject> -<imageobject> -<imagedata fileref="dialogs-separateimage.png" format="PNG" /> -</imageobject> -<textobject> -<phrase>The <guilabel>Separate Image</guilabel> dialog</phrase> -</textobject> -<caption><para>The <guilabel>Separate Image</guilabel> dialog</para></caption> -</mediaobject> -</screenshot> -</para> - -<para> -With this dialog, you can separate (part of) your image. Every color component -(channel) will be put into a separate layer or image. At the top of the -dialog, the current color model is shown. Below that, a couple of options can -be set. -</para> -<para> -Under <guilabel>Source</guilabel>, you can choose what part of the image to -separate. The two options are <guilabel>Current layer</guilabel>, which -(obviously) only uses the currently selected layer and <guilabel>Flatten all -layers before separation</guilabel>, which uses the entire image. -</para> -<para> -Under <guilabel>Output</guilabel>, you can choose where the result of the -separation should be written to: either to a couple of layers, or to a couple -of images. -</para> -<para> -Under <guilabel>Alpha Options</guilabel>, you can choose what should be done -with the alpha channel of the selected layer(s). It can be copied to each new -channel, be discarded, or separated on its own. -</para> -<para> -The two options at the bottom of the dialog, finally, determine whether the -source should be downscaled to 8 bit colors (if it contains more), and whether -the output should be in color (default is to separate the channels to grayscale -values). -</para> -</sect3> - -<sect3 id="commands-dialogs-image-shearimage"> -<title>The <guilabel>Shear Image</guilabel> dialog</title> - -<para> -<screenshot> -<screeninfo>The <guilabel>Shear Image</guilabel> dialog</screeninfo> -<mediaobject> -<imageobject> -<imagedata fileref="dialogs-shearimage.png" format="PNG" /> -</imageobject> -<textobject> -<phrase>The <guilabel>Shear Image</guilabel> dialog</phrase> -</textobject> -<caption><para>The <guilabel>Shear Image</guilabel> dialog</para></caption> -</mediaobject> -</screenshot> -</para> - -<para> -This dialog allows you to shear your image. By shearing, the bounding -rectangle of your image is transformed into a parallellogram. One pixel -row/column is kept in place, the next one is shifted by a certain amount, the -next one by the same amount relative to the previous one, etcetera. -The X and Y shearing angles can be set using the two spin boxes. -</para> - -</sect3> - -<sect3 id="commands-dialogs-image-substrate"> -<title>The <guilabel>Substrate</guilabel> dialog</title> - -<para> -<screenshot> -<screeninfo>The <guilabel>Substrate</guilabel> dialog</screeninfo> -<mediaobject> -<imageobject> -<imagedata fileref="dialogs-substrate.png" format="PNG" /> -</imageobject> -<textobject> -<phrase>The <guilabel>Substrate</guilabel> dialog</phrase> -</textobject> -<caption><para>The <guilabel>Substrate</guilabel> dialog</para></caption> -</mediaobject> -</screenshot> -</para> - -<para> -(This dialog is still to be described.) -</para> - -</sect3> - -</sect2> - -<sect2 id="commands-dialogs-layers"> -<title>Dialogs for working with layers</title> - -<sect3 id="commands-dialogs-layers-convertlayertype"> -<title>The <guilabel>Convert Layer Type</guilabel> dialog</title> - -<para> -<screenshot> -<screeninfo>The <guilabel>Convert Layer Type</guilabel> dialog</screeninfo> -<mediaobject> -<imageobject> -<imagedata fileref="dialogs-convertlayertype.png" format="PNG" /> -</imageobject> -<textobject> -<phrase>The <guilabel>Convert Layer Type</guilabel> dialog</phrase> -</textobject> -<caption><para>The <guilabel>Convert Layer Type</guilabel> dialog</para></caption> -</mediaobject> -</screenshot> -</para> - -<para> -This dialog is exactly the same as the <link -linkend="commands-dialogs-image-convertimagetype"><guilabel>Convert Image -Type</guilabel> dialog</link>, which converts an entire image instead of a -single layer. See the description there for details. -</para> - -</sect3> - -<sect3 id="commands-dialogs-layers-dropshadow"> -<title>The <guilabel>Drop Shadow</guilabel> dialog</title> - -<para> -<screenshot> -<screeninfo>The <guilabel>Drop Shadow</guilabel> dialog</screeninfo> -<mediaobject> -<imageobject> -<imagedata fileref="dialogs-dropshadow.png" format="PNG" /> -</imageobject> -<textobject> -<phrase>The <guilabel>Drop Shadow</guilabel> dialog</phrase> -</textobject> -<caption><para>The <guilabel>Drop Shadow</guilabel> dialog</para></caption> -</mediaobject> -</screenshot> -</para> - -<para> -With this dialog, you can add a drop shadow effect to the current layer. -Select the X and Y offsets (displacements) of the shadow relative to the -original layer with the two topmost spin boxes. The <guilabel>Blur -radius</guilabel> spinbox determines the radius in which the shadow will be -blurred (to achieve a smooth transition at the shadow border). If you want -a special color for the shadow, you can choose one with the -<guilabel>Color</guilabel> field. The <guilabel>Opacity</guilabel> slider and -spinbox can be used to make the shadow more or less transparent. Disable the -<guilabel>Allow resizing</guilabel> checkbox if you don't want the layer to be -resized in order to give it a shadow. -</para> - -</sect3> - -<sect3 id="commands-dialogs-layers-histogram"> -<title>The <guilabel>Histogram</guilabel> dialog</title> - -<para> -<screenshot> -<screeninfo>The <guilabel>Histogram</guilabel> dialog</screeninfo> -<mediaobject> -<imageobject> -<imagedata fileref="dialogs-histogram.png" format="PNG" /> -</imageobject> -<textobject> -<phrase>The <guilabel>Histogram</guilabel> dialog</phrase> -</textobject> -<caption><para>The <guilabel>Histogram</guilabel> dialog</para></caption> -</mediaobject> -</screenshot> -</para> - -<para> -This dialog shows a histogram for the current layer. With the -<guilabel>Method:</guilabel> settings, you can choose what kind of histogram -to show. You can change the channel(s) to show with the -<guilabel>Channels:</guilabel> listbox, and the scale on which it should be -drawn with the <guilabel>Linear</guilabel> and -<guilabel>Logarithmic</guilabel> radio buttons. Under the preview, there are -buttons available to zoom in to, and move over, the histogram. These are -activated for 16-bit colorspace layers. -</para> - -</sect3> - -<sect3 id="commands-dialogs-layers-layerproperties"> -<title>The <guilabel>Layer Properties</guilabel> dialog</title> - -<para> -<screenshot> -<screeninfo>The <guilabel>Layer Properties</guilabel> dialog</screeninfo> -<mediaobject> -<imageobject> -<imagedata fileref="dialogs-layerproperties.png" format="PNG" /> -</imageobject> -<textobject> -<phrase>The <guilabel>Layer Properties</guilabel> dialog</phrase> -</textobject> -<caption><para>The <guilabel>Layer Properties</guilabel> dialog</para></caption> -</mediaobject> -</screenshot> -</para> - -<para> -This dialog is in essence the same as the <link -linkend="commands-dialogs-layers-newlayer">New Layer</link> dialog, with the difference that -you cannot change its colorspace or profile anymore. These properties are -shown, though, to keep the information complete. -</para> -</sect3> - -<sect3 id="commands-dialogs-layers-layersize"> -<title>The <guilabel>Layer Size</guilabel> dialog</title> - -<para> -<screenshot> -<screeninfo>The <guilabel>Layer Size</guilabel> dialog</screeninfo> -<mediaobject> -<imageobject> -<imagedata fileref="dialogs-layersize.png" format="PNG" /> -</imageobject> -<textobject> -<phrase>The <guilabel>Layer Size</guilabel> dialog</phrase> -</textobject> -<caption><para>The <guilabel>Layer Size</guilabel> dialog</para></caption> -</mediaobject> -</screenshot> -</para> - -<para> -This dialog allows you to resize the current layer. -Under <guilabel>Pixel dimensions</guilabel>, you can set which new size you -want the layer to have. The original size is given as a reference. The new -size can be set both as pixels or as a percentage, with 100% being the -original size. If you select <guilabel>Constrain proportions</guilabel>, the -new width and height will always be set to the same percentage. For example, -if you have a layer of 200 x 100 pixels, and set the width to 20 pixels, the -height will automatically be changed to 10. With this checkbox unselected, you -can also resize the layer non-proportionally. The <guilabel>Filter:</guilabel> -dropdown list can be used to select a different algorithm for resizing the -layer. -</para> - -</sect3> - -<sect3 id="commands-dialogs-layers-newadjustmentlayer"> -<title>The <guilabel>New Adjustment Layer</guilabel> dialog</title> - -<para> -<screenshot> -<screeninfo>The <guilabel>New Adjustment Layer</guilabel> dialog</screeninfo> -<mediaobject> -<imageobject> -<imagedata fileref="dialogs-newadjustmentlayer.png" format="PNG" /> -</imageobject> -<textobject> -<phrase>The <guilabel>New Adjustment Layer</guilabel> dialog</phrase> -</textobject> -<caption><para>The <guilabel>New Adjustment Layer</guilabel> dialog</para></caption> -</mediaobject> -</screenshot> -</para> - -<para> -In this dialog, you can select the type of adjustment layer to add to the -image. In the left-hand list, you can see the available adjustment layers, -each with a preview. When you select one, the <guilabel>Preview</guilabel> -will change to show a correctly scaled preview of what the result of the -adjustment layer is going to be. -</para><para> -You can then choose to show either the original image or the preview of the -adjustment layer with the radio buttons below the preview window. The buttons -next to these allow you to zoom in, zoom out, and refresh the preview, -respectively. The <guilabel>Autoupdate</guilabel> checkbox determines if the -preview window should update automatically after you made a change. -</para><para> -The various options available for the filter that is used to create the -adjustment layer, are shown at the bottom of the dialog. See the section on -<link linkend="commands-dialogs-filters">filters</link> of this chapter for -descriptions. -</para> - -</sect3> - -<sect3 id="commands-dialogs-layers-newlayer"> -<title>The <guilabel>New Layer</guilabel> dialog</title> - -<para> -<screenshot> -<screeninfo>The <guilabel>New Layer</guilabel> dialog</screeninfo> -<mediaobject> -<imageobject> -<imagedata fileref="dialogs-newlayer.png" format="PNG" /> -</imageobject> -<textobject> -<phrase>The <guilabel>New Layer</guilabel> dialog</phrase> -</textobject> -<caption><para>The <guilabel>New Layer</guilabel> dialog</para></caption> -</mediaobject> -</screenshot> -</para> - -<para> -You can add a new layer to your image with this dialog. If you want a -descriptive name for your layer, you can fill one in at -<guilabel>Name:</guilabel>. You can select the desired colorspace for the new -layer from the <guilabel>Colorspace:</guilabel> list, and the specific -color profile for that colorspace at <guilabel>Profile:</guilabel>. -You can preset the layer's <guilabel>Opacity</guilabel> (you can change it later with the slider in -the <guilabel>Layer</guilabel> box), and choose the mode with which the layer should be composited -onto the final image. -</para> - -</sect3> - -<sect3 id="commands-dialogs-layers-rotatelayer"> -<title>The <guilabel>Rotate Layer</guilabel> dialog</title> - -<para> -<screenshot> -<screeninfo>The <guilabel>Rotate Layer</guilabel> dialog</screeninfo> -<mediaobject> -<imageobject> -<imagedata fileref="dialogs-rotatelayer.png" format="PNG" /> -</imageobject> -<textobject> -<phrase>The <guilabel>Rotate Layer</guilabel> dialog</phrase> -</textobject> -<caption><para>The <guilabel>Rotate Layer</guilabel> dialog</para></caption> -</mediaobject> -</screenshot> -</para> - -<para> -This dialog, similar to the <link -linkend="commands-dialogs-image-rotateimage"><guilabel>Rotate Image</guilabel> -dialog</link>, allows you to rotate the current layer. You can choose the -direction in which to rotate and the amount to rotate the layer by. -</para> - -</sect3> - -<sect3 id="commands-dialogs-layers-shearlayer"> -<title>The <guilabel>Shear Layer</guilabel> dialog</title> - -<para> -<screenshot> -<screeninfo>The <guilabel>Shear Layer</guilabel> dialog</screeninfo> -<mediaobject> -<imageobject> -<imagedata fileref="dialogs-shearlayer.png" format="PNG" /> -</imageobject> -<textobject> -<phrase>The <guilabel>Shear Layer</guilabel> dialog</phrase> -</textobject> -<caption><para>The <guilabel>Shear Layer</guilabel> dialog</para></caption> -</mediaobject> -</screenshot> -</para> - -<para> -This dialog works the same as the <link -linkend="commands-dialogs-image-shearimage"><guilabel>Shear Image</guilabel> -dialog</link>, except that it operates on the current layer instead of on the -entire image. -</para> - -</sect3> - -</sect2> - -<sect2 id="commands-dialogs-filters"> -<title>Dialogs for working with filters</title> - -<para> -All filter dialogs consist of a filter-specific part, at the left, and a -generic part, at the right. The generic part contains a preview window, which -you can configure using the controls below it. Choose -<guilabel>Preview</guilabel> or <guilabel>Original</guilabel> depending on -whether you want the preview window to show the preview of the filter effect -or the original image. The four buttons at the bottom right allow you to zoom -in and zoom out, set the zooming factor to 100% (this shows the image at its -original size), and refresh the preview, respectively. Furthermore, the option -<guilabel>Autoupdate</guilabel> determines if the preview window is updated -automatically. If you uncheck this checkbox, you will have to refresh the -preview yourself. -</para> - -<sect3 id="commands-dialogs-filters-blur"> -<title>The <guilabel>Blur</guilabel> dialog</title> - -<para> -<screenshot> -<screeninfo>The <guilabel>Blur</guilabel> dialog</screeninfo> -<mediaobject> -<imageobject> -<imagedata fileref="dialogs-blur.png" format="PNG" /> -</imageobject> -<textobject> -<phrase>The <guilabel>Blur</guilabel> dialog</phrase> -</textobject> -<caption><para>The <guilabel>Blur</guilabel> dialog</para></caption> -</mediaobject> -</screenshot> -</para> - -<para> -This dialog allows you to customize the way your image is blurred. The -<guilabel>Half-width</guilabel> and <guilabel>Half-height</guilabel> spinboxes -determine the size of the areas of your image that are consecutively blurred. -With the <guilabel>Strength</guilabel> spinbox you can set the strength with which the -blurring should be applied, and with the <guilabel>Angle</guilabel> spinbox -you can add a rotation to the area. The <guilabel>Shape</guilabel> setting, -finally, allows you to choose between circular and rectangular areas -</para> - -</sect3> - - -<sect3 id="commands-dialogs-filters-brightnesscontrast"> -<title>The <guilabel>Brightness / Contrast</guilabel> dialog</title> - -<para> -<screenshot> -<screeninfo>The <guilabel>Brightness / Contrast</guilabel> dialog</screeninfo> -<mediaobject> -<imageobject> -<imagedata fileref="dialogs-brightnesscontrast.png" format="PNG" /> -</imageobject> -<textobject> -<phrase>The <guilabel>Brightness / Contrast</guilabel> dialog</phrase> -</textobject> -<caption><para>The <guilabel>Brightness / Contrast</guilabel> dialog</para></caption> -</mediaobject> -</screenshot> -</para> - -<para> -With this dialog, you can customize the brightness and contrast of your image. -</para><para> -The curve diagram has a histogram-like background that shows you the abundance -of various brightness levels. The curve itself (initially a diagonal line from -bottom left to top right) determines to which new brightness level (on the -vertical axis) pixels with a certain original level (on the horizontal axis) are -to be mapped. For example, the default diagonal line from bottom left to top -right sets every original pixel to its own brightness value, meaning no -change. A horizontal line means that all pixels will get the same brightness. -This means minimal contrast, the brightness itself is indicated by the height -at which the line is placed. -</para><para> -You can click on a handle (red circle) to select it (a selected handle is -indicated by a filled circle) and drag it around to change the shape of the -curve. The curve will be drawn smoothly through the handles (always -strictly from left to right). If you click on the curve, a handle is added to -it at that position. Clicking somewhere else in the image will also add a -handle at that point. You can press <keycap>Delete</keycap> to delete the -currently selected handle. -</para> - -</sect3> - -<sect3 id="commands-dialogs-filters-bumpmap"> -<title>The <guilabel>Bumpmap</guilabel> dialog</title> - -<para> -<screenshot> -<screeninfo>The <guilabel>Bumpmap</guilabel> dialog</screeninfo> -<mediaobject> -<imageobject> -<imagedata fileref="dialogs-bumpmap.png" format="PNG" /> -</imageobject> -<textobject> -<phrase>The <guilabel>Bumpmap</guilabel> dialog</phrase> -</textobject> -<caption><para>The <guilabel>Bumpmap</guilabel> dialog</para></caption> -</mediaobject> -</screenshot> -</para> - -<para> -You can apply a bumpmap effect and customize it using this dialog. One layer -is used as bumpmap layer: it is read as grayscale image and the gray values of -its pixels are used to to distort the other layer for creating the depth -illusion. High grey values, &ie; more white, mean a larger height, small -values, &ie; near black, mean a smaller height — or a larger depth, the -height can get <quote>below sealevel</quote>. A light source, shining -<quote>from above</quote> on the image that lies <quote>on the ground</quote>, -is simulated to determine the depth and direction of the shadows. -</para><para> -The first option in this dialog offers you the selection of the -<guilabel>Bumpmap layer</guilabel>. -</para><para> -Under <guilabel>Type</guilabel>, you can select what kind of bumpmap to be -applied. There are three types, <guilabel>Linear</guilabel> (a normal -application of the bumpmap), <guilabel>Spherical</guilabel> (focusing on the -extremes, that is, the shadow and highlight values) and -<guilabel>Sinusoidal</guilabel> (focusing on the midtone values). -</para><para> -Then, there are three options to modify the bumpmap apart from its -algorithmical application. With <guilabel>Compensate for darkening</guilabel>, -the image is restored to about its original average lightness if using the -bumpmap filter would make it darker. The <guilabel>Invert bumpmap</guilabel> -option creates an inverted bumpmap (high and low are reversed). With -<guilabel>Tile bumpmap</guilabel>, a bumpmap layer that is smaller than the -layer it is applied to, will be tiled (repeatedly) to cover the entire layer. -</para><para> -Under <guilabel>Settings</guilabel>, you can select the mathematical -parameters for the bumpmap. First of all, <guilabel>Azimuth</guilabel> (the -angle of the light source in the X-Y plane), <guilabel>Elevation</guilabel> -(the height of the simulated light source above the surface in degrees, with 0 -degrees being on the ground and 90 degrees being vertically above the image), -and <guilabel>Depth</guilabel> (the maximal vertical distortion of the image). -</para><para> -Then, there are the <guilabel>X offset</guilabel> and <guilabel>Y -offset</guilabel>, with which you can displace the bumpmap layer relative to -the destination layer, <guilabel>Water level</guilabel> (the depth seen as -neutral), and <guilabel>Ambient light</guilabel>, which determines the -relative amount of ambient (environmental) light. -</para> - -</sect3> - -<sect3 id="commands-dialogs-filters-coloradjustment"> -<title>The <guilabel>Color Adjustment</guilabel> dialog</title> - -<para> -<screenshot> -<screeninfo>The <guilabel>Color Adjustment</guilabel> dialog</screeninfo> -<mediaobject> -<imageobject> -<imagedata fileref="dialogs-coloradjustment.png" format="PNG" /> -</imageobject> -<textobject> -<phrase>The <guilabel>Color Adjustment</guilabel> dialog</phrase> -</textobject> -<caption><para>The <guilabel>Color Adjustment</guilabel> dialog</para></caption> -</mediaobject> -</screenshot> -</para> - -<para> -This dialog allows you to customize the <guilabel>Color Adjustment</guilabel> filter. You can use -the curve (see the section on <link -linkend="commands-dialogs-filters-brightnesscontrast">Brightness / -Contrast</link> for a description on the curve) to determine the mapping -from old to new color levels, for each of the channels separately. -</para> - -</sect3> - -<sect3 id="commands-dialogs-filters-colortoalpha"> -<title>The <guilabel>Color to Alpha</guilabel> dialog</title> - -<para> -<screenshot> -<screeninfo>The <guilabel>Color to Alpha</guilabel> dialog</screeninfo> -<mediaobject> -<imageobject> -<imagedata fileref="dialogs-colortoalpha.png" format="PNG" /> -</imageobject> -<textobject> -<phrase>The <guilabel>Color to Alpha</guilabel> dialog</phrase> -</textobject> -<caption><para>The <guilabel>Color to Alpha</guilabel> dialog</para></caption> -</mediaobject> -</screenshot> -</para> - -<para> -With this dialog, you can make parts of the image having a certain color -transparent (officially <quote>alpha-transparent</quote>). You can select the -color you want to remove from the image (replacing it with transparency) with -the <guilabel>Color</guilabel> swatch, and how much a color may differ from -the selected one before it is considered not to match, with the -<guilabel>Threshold</guilabel> spinbox. Setting a threshold of zero (0) -ensures that only pixels with the exact matching color will be made -transparent, higher thresholds will make other colors match as well. -</para> - -</sect3> -<sect3 id="commands-dialogs-filters-colortransfer"> -<title>The <guilabel>Color Transfer</guilabel> dialog</title> - -<para> -<screenshot> -<screeninfo>The <guilabel>Color Transfer</guilabel> dialog</screeninfo> -<mediaobject> -<imageobject> -<imagedata fileref="dialogs-colortransfer.png" format="PNG" /> -</imageobject> -<textobject> -<phrase>The <guilabel>Color Transfer</guilabel> dialog</phrase> -</textobject> -<caption><para>The <guilabel>Color Transfer</guilabel> dialog</para></caption> -</mediaobject> -</screenshot> -</para> - -<para> -This dialog lets you copy the colors from one image (the <guilabel>Reference -Image</guilabel>) to the current one. The colors in both images are compared -and each color in the one you are working with, will be replaced by the -nearest one in the reference image. -</para> - -</sect3> - -<!-- -<sect3 id="commands-dialogs-filters-cubism"> -<title>The <guilabel>Cubism</guilabel> dialog</title> - -<para> -<screenshot> -<screeninfo>The <guilabel>Cubism</guilabel> dialog</screeninfo> -<mediaobject> -<imageobject> -<imagedata fileref="dialogs-cubism.png" format="PNG" /> -</imageobject> -<textobject> -<phrase>The <guilabel>Cubism</guilabel> dialog</phrase> -</textobject> -<caption><para>The Cubism dialog</para></caption> -</mediaobject> -</screenshot> -</para> - -<para> -This dialog has two filter-specific options. The <guilabel>Tile -size:</guilabel> slider and spinbox determine how big the tiles are in which -the image is subdivided, the <guilabel>Tile saturation:</guilabel> setting -sets the color saturation of the tiles. -</para> - -</sect3> ---> - -<sect3 id="commands-dialogs-filters-customconvolution"> -<title>The <guilabel>Custom Convolution</guilabel> dialog</title> - -<para> -<screenshot> -<screeninfo>The <guilabel>Custom Convolution</guilabel> dialog</screeninfo> -<mediaobject> -<imageobject> -<imagedata fileref="dialogs-customconvolution.png" format="PNG" /> -</imageobject> -<textobject> -<phrase>The <guilabel>Custom Convolution</guilabel> dialog</phrase> -</textobject> -<caption><para>The <guilabel>Custom Convolution</guilabel> dialog</para></caption> -</mediaobject> -</screenshot> -</para> - -<para> -With this filter, you can apply a customized distortion effect to your image. -The nine spinboxes at the top left determine the distortion. Each pixel is -assigned a new value based on these values: the old color values of the pixel -inself and the eight surrounding pixels are each multiplied by the values in -the respective spinboxes, these results are added, and the final result is the -new color value for the pixel. Before being applied, this final result can be -multiplied with a certain <guilabel>Factor:</guilabel> or a certain -<guilabel>Offset:</guilabel> can be added to it. -</para><para> -In the example screenshot, each pixel is assigned a new value based on its -own (the 1 in the center), to which are added the values of the pixels to its -top right and directly below it (each with a factor of 1, &ie; the actual -value, since multiplying by one has no effect), and from which are subtracted -the values of the pixels to its bottom right and directly above it (added with -a factor of -1, so subtracted by a factor of 1). -</para> - -</sect3> - -<sect3 id="commands-dialogs-filters-emboss"> -<title>The <guilabel>Emboss</guilabel> dialog</title> - -<para> -<screenshot> -<screeninfo>The <guilabel>Emboss</guilabel> dialog</screeninfo> -<mediaobject> -<imageobject> -<imagedata fileref="dialogs-emboss.png" format="PNG" /> -</imageobject> -<textobject> -<phrase>The <guilabel>Emboss</guilabel> dialog</phrase> -</textobject> -<caption><para>The <guilabel>Emboss</guilabel> dialog</para></caption> -</mediaobject> -</screenshot> -</para> - -<para> -This dialog contains just one option, the <guilabel>Depth:</guilabel> slider -and spinbox which determines the depth of the embossing effect. -</para> - -</sect3> - -<sect3 id="commands-dialogs-filters-filtersgallery"> -<title>The <guilabel>Filters Gallery</guilabel> dialog</title> - -<para> -<screenshot> -<screeninfo>The <guilabel>Filters Gallery</guilabel> dialog</screeninfo> -<mediaobject> -<imageobject> -<imagedata fileref="dialogs-filtersgallery.png" format="PNG" /> -</imageobject> -<textobject> -<phrase>The <guilabel>Filters Gallery</guilabel> dialog</phrase> -</textobject> -<caption><para>The <guilabel>Filters Gallery</guilabel> dialog</para></caption> -</mediaobject> -</screenshot> -</para> - -<para> -This dialog can be used to get a quick overview of what the various available -filters do. The filters are in turn applied to the current image and the -results are put in the left list box as thumbnails. If you select one, its -options become available in the <guilabel>Configuration</guilabel> section. -See the description of the respective filter for details. -</para> - -</sect3> - -<sect3 id="commands-dialogs-filters-gaussiannoise"> -<title>The <guilabel>Gaussian Noise Reduction</guilabel> dialog</title> - -<para> -<screenshot> -<screeninfo>The <guilabel>Gaussian Noise Reduction</guilabel> dialog</screeninfo> -<mediaobject> -<imageobject> -<imagedata fileref="dialogs-gaussiannoise.png" format="PNG" /> -</imageobject> -<textobject> -<phrase>The <guilabel>Gaussian Noise Reduction</guilabel> dialog</phrase> -</textobject> -<caption><para>The <guilabel>Gaussian Noise Reduction</guilabel> dialog</para></caption> -</mediaobject> -</screenshot> -</para> - -<para> -This dialog allows you to customize a Gaussian noise reduction. The -<guilabel>Threshold</guilabel> setting is a measure for how much noise should -be removed (&ie; how quickly a <quote>lonely</quote> pixel should be made -equal to its surroundings), while the <guilabel>Window Size</guilabel> setting -determines the radius of the area considered when changing pixels. -</para> - -</sect3> - -<sect3 id="commands-dialogs-filters-lenscorrection"> -<title>The <guilabel>Lens Correction</guilabel> dialog</title> - -<para> -<screenshot> -<screeninfo>The <guilabel>Lens Correction</guilabel> dialog</screeninfo> -<mediaobject> -<imageobject> -<imagedata fileref="dialogs-lenscorrection.png" format="PNG" /> -</imageobject> -<textobject> -<phrase>The <guilabel>Lens Correction</guilabel> dialog</phrase> -</textobject> -<caption><para>The <guilabel>Lens Correction</guilabel> dialog</para></caption> -</mediaobject> -</screenshot> -</para> - -<para> -With this dialog, you can fix an image which is distorted due to common lens -anomalies. You can specify a <guilabel>Distortion correction</guilabel>, -indicating how much the image should be corrected if its -concaveness / convexness is not right, for areas near the center and areas -near the edges. If you want an asymmetrical correction, you can specify -different <guilabel>X</guilabel> and <guilabel>Y</guilabel> coordinates for -the center (in percentages of the total width and height, measured from the -top left). -</para><para> -You can also correct a too light or too dark image with the -<guilabel>Brightness correction</guilabel> spinbox. -</para> - -</sect3> - -<sect3 id="commands-dialogs-filters-imagerestoration"> -<title>The <guilabel>Image Restoration</guilabel> dialog</title> - -<para> -<screenshot> -<screeninfo>The <guilabel>Image Restoration</guilabel> dialog</screeninfo> -<mediaobject> -<imageobject> -<imagedata fileref="dialogs-imagerestoration.png" format="PNG" /> -</imageobject> -<textobject> -<phrase>The <guilabel>Image Restoration</guilabel> dialog</phrase> -</textobject> -<caption><para>The <guilabel>Image Restoration</guilabel> dialog</para></caption> -</mediaobject> -</screenshot> -</para> - -<para> -Using this dialog, you can specify exactly how the image restoration should -be done. This filter tries to increase the quality of an image, for instance -by removing scratches. Various options are available to customize its -behaviour. -</para><para> -(Unfortunately, these are not described as of yet.) -</para> - -</sect3> - -<sect3 id="commands-dialogs-filters-oilpaint"> -<title>The <guilabel>Oilpaint</guilabel> dialog</title> - -<para> -<screenshot> -<screeninfo>The <guilabel>Oilpaint</guilabel> dialog</screeninfo> -<mediaobject> -<imageobject> -<imagedata fileref="dialogs-oilpaint.png" format="PNG" /> -</imageobject> -<textobject> -<phrase>The <guilabel>Oilpaint</guilabel> dialog</phrase> -</textobject> -<caption><para>The <guilabel>Oilpaint</guilabel> dialog</para></caption> -</mediaobject> -</screenshot> -</para> - -<para> -This dialog can configure two parameters for the associated filter. The -<guilabel>Brush size:</guilabel> setting determines the size of the brush that -is used to simulate the oilpaint effect, the <guilabel>Smooth:</guilabel> -setting specifies if the difference in colors between adjacent -<quote>swatches</quote> may be large (low smoothness) or should be small (high -smoothness). -</para> - -</sect3> - -<sect3 id="commands-dialogs-filters-pixelize"> -<title>The <guilabel>Pixelize</guilabel> dialog</title> - -<para> -<screenshot> -<screeninfo>The <guilabel>Pixelize</guilabel> dialog</screeninfo> -<mediaobject> -<imageobject> -<imagedata fileref="dialogs-pixelize.png" format="PNG" /> -</imageobject> -<textobject> -<phrase>The <guilabel>Pixelize</guilabel> dialog</phrase> -</textobject> -<caption><para>The <guilabel>Pixelize</guilabel> dialog</para></caption> -</mediaobject> -</screenshot> -</para> - -<para> -On this dialog, you can adjust two settings. <guilabel>Pixel width:</guilabel> -and <guilabel>Pixel height:</guilabel> indicate the width and height of the -area that should be taken together and averaged to form one new, large -<quote>pixel</quote>. -</para> - -</sect3> - -<sect3 id="commands-dialogs-filters-raindrops"> -<title>The <guilabel>Raindrops</guilabel> dialog</title> - -<para> -<screenshot> -<screeninfo>The <guilabel>Raindrops</guilabel> dialog</screeninfo> -<mediaobject> -<imageobject> -<imagedata fileref="dialogs-raindrops.png" format="PNG" /> -</imageobject> -<textobject> -<phrase>The <guilabel>Raindrops</guilabel> dialog</phrase> -</textobject> -<caption><para>The <guilabel>Raindrops</guilabel> dialog</para></caption> -</mediaobject> -</screenshot> -</para> - -<para> -This filter can be configured using the settings <guilabel>Drop -size:</guilabel> (the average diameter of the raindrops), -<guilabel>Number:</guilabel> (the number of raindrop effects that should be -added to the image), and <guilabel>Fish eyes:</guilabel> (the percentage of -raindrops that should be rendered as fisheye lens effects instead of plain -raindrop effects). -</para> -</sect3> - -<sect3 id="commands-dialogs-filters-randomnoise"> -<title>The <guilabel>Random Noise</guilabel> dialog</title> - -<para> -<screenshot> -<screeninfo>The <guilabel>Random Noise</guilabel> dialog</screeninfo> -<mediaobject> -<imageobject> -<imagedata fileref="dialogs-randomnoise.png" format="PNG" /> -</imageobject> -<textobject> -<phrase>The <guilabel>Random Noise</guilabel> dialog</phrase> -</textobject> -<caption><para>The <guilabel>Random Noise</guilabel> dialog</para></caption> -</mediaobject> -</screenshot> -</para> - -<para> -This filter adds random noise (speckles, or something similar) to your image. -There are two customizable settings: the amount of noise -(<guilabel>Level</guilabel>, as a percentage) and the -<guilabel>Opacity</guilabel> of the noise (should the original color still be -a bit visible or not). -</para> - -</sect3> -<sect3 id="commands-dialogs-filters-randompick"> -<title>The <guilabel>Random Pick</guilabel> dialog</title> - -<para> -<screenshot> -<screeninfo>The <guilabel>Random Pick</guilabel> dialog</screeninfo> -<mediaobject> -<imageobject> -<imagedata fileref="dialogs-randompick.png" format="PNG" /> -</imageobject> -<textobject> -<phrase>The <guilabel>Random Pick</guilabel> dialog</phrase> -</textobject> -<caption><para>The <guilabel>Random Pick</guilabel> dialog</para></caption> -</mediaobject> -</screenshot> -</para> - -<para> -In this dialog, you can specify parameters for the <guilabel>Random Pick</guilabel> -filter. The <guilabel>Level</guilabel> setting determines how much pixels will -be affected (measured as a percentage), the area which is looked in to take a -new color for a pixel is set with the <guilabel>Size of the window</guilabel> -setting, and the <guilabel>Opacity</guilabel> of the modifications can be set as -well. -</para> - -</sect3> - - -<sect3 id="commands-dialogs-filters-roundcorners"> -<title>The <guilabel>Round Corners</guilabel> dialog</title> - -<para> -<screenshot> -<screeninfo>The <guilabel>Round Corners</guilabel> dialog</screeninfo> -<mediaobject> -<imageobject> -<imagedata fileref="dialogs-roundcorners.png" format="PNG" /> -</imageobject> -<textobject> -<phrase>The <guilabel>Round Corners</guilabel> dialog</phrase> -</textobject> -<caption><para>The <guilabel>Round Corners</guilabel> dialog</para></caption> -</mediaobject> -</screenshot> -</para> - -<para> -This dialog has one setting: the radius of the rounded corners. -</para> - -</sect3> - -<sect3 id="commands-dialogs-filters-smalltiles"> -<title>The <guilabel>Small Tiles</guilabel> dialog</title> - -<para> -<screenshot> -<screeninfo>The <guilabel>Small Tiles</guilabel> dialog</screeninfo> -<mediaobject> -<imageobject> -<imagedata fileref="dialogs-smalltiles.png" format="PNG" /> -</imageobject> -<textobject> -<phrase>The <guilabel>Small Tiles</guilabel> dialog</phrase> -</textobject> -<caption><para>The <guilabel>Small Tiles</guilabel> dialog</para></caption> -</mediaobject> -</screenshot> -</para> - -<para> -In this dialog, you can set the amount of subdivisions with the -<guilabel>Number of tiles</guilabel> settings. -</para> - -</sect3> - -<sect3 id="commands-dialogs-filters-sobel"> -<title>The <guilabel>Sobel</guilabel> dialog</title> - -<para> -<screenshot> -<screeninfo>The <guilabel>Sobel</guilabel> dialog</screeninfo> -<mediaobject> -<imageobject> -<imagedata fileref="dialogs-sobel.png" format="PNG" /> -</imageobject> -<textobject> -<phrase>The <guilabel>Sobel</guilabel> dialog</phrase> -</textobject> -<caption><para>The <guilabel>Sobel</guilabel> dialog</para></caption> -</mediaobject> -</screenshot> -</para> - -<para> -Here, you can set the parameters for the <guilabel>Sobel</guilabel> edge -detection filter. First of all you can determine which directions to sobel in: -horizontally, vertically, or both. The <guilabel>Keep sign of -result</guilabel> setting does not affect regular images. -<guilabel>Make image opaque</guilabel> determines whether the resulting image -is opaque or transparent. -</para> - -</sect3> - -<sect3 id="commands-dialogs-filters-unsharpmask"> -<title>The <guilabel>Unsharp Mask</guilabel> dialog</title> - -<para> -<screenshot> -<screeninfo>The <guilabel>Unsharp Mask</guilabel> dialog</screeninfo> -<mediaobject> -<imageobject> -<imagedata fileref="dialogs-unsharpmask.png" format="PNG" /> -</imageobject> -<textobject> -<phrase>The <guilabel>Unsharp Mask</guilabel> dialog</phrase> -</textobject> -<caption><para>The <guilabel>Unsharp Mask</guilabel> dialog</para></caption> -</mediaobject> -</screenshot> -</para> - -<para> -This dialog offers three options for the sharpening filter -<guilabel>Unsharp Mask</guilabel>: the radius (<guilabel>Half-size</guilabel>) -of the mask, the <guilabel>Amount</guilabel> of sharpening that should be -done, and the <guilabel>Threshold</guilabel> level. -</para> - -</sect3> - -<sect3 id="commands-dialogs-filters-wave"> -<title>The <guilabel>Wave</guilabel> dialog</title> - -<para> -<screenshot> -<screeninfo>The <guilabel>Wave</guilabel> dialog</screeninfo> -<mediaobject> -<imageobject> -<imagedata fileref="dialogs-wave.png" format="PNG" /> -</imageobject> -<textobject> -<phrase>The <guilabel>Wave</guilabel> dialog</phrase> -</textobject> -<caption><para>The <guilabel>Wave</guilabel> dialog</para></caption> -</mediaobject> -</screenshot> -</para> - -<para> -For both the horizontal and the vertical components of the wave distortion -(note: a vertical wave means that the vertical position is dependent on the -horizontal one, and hence looks like a <quote>W</quote>), -you can determine four settings here. The <guilabel>Wavelength</guilabel> (a -shorter wavelength means a more erratical wave), the -<guilabel>Shift</guilabel> (which point of the wave should be started at), the -<guilabel>Amplitude</guilabel> (the amount of distortion), and the -<guilabel>Shape</guilabel> (<guilabel>Sinusoidal</guilabel> or rounded, -versus <guilabel>Triangle</guilabel> or pointy). -</para> - -</sect3> - -<sect3 id="commands-dialogs-filters-waveletnoise"> -<title>The <guilabel>Wavelet Noise Reduction</guilabel> dialog</title> - -<para> -<screenshot> -<screeninfo>The <guilabel>Wavelet Noise Reduction</guilabel> dialog</screeninfo> -<mediaobject> -<imageobject> -<imagedata fileref="dialogs-waveletnoise.png" format="PNG" /> -</imageobject> -<textobject> -<phrase>The <guilabel>Wavelet Noise Reduction</guilabel> dialog</phrase> -</textobject> -<caption><para>The <guilabel>Wavelet Noise Reduction</guilabel> dialog</para></caption> -</mediaobject> -</screenshot> -</para> - -<para> -The only setting here, <guilabel>Threshold</guilabel>, indicates how easily pixels -are seen as noise that should be removed and made equal to the surrounding area. -</para> - -</sect3> - -</sect2> - -<sect2 id="commands-dialogs-misc"> -<title>Miscellaneous dialogs</title> - -<sect3 id="commands-dialogs-misc-addpalette"> -<title>The <guilabel>Add Palette</guilabel> dialog</title> - -<para> -<screenshot> -<screeninfo>The <guilabel>Add Palette</guilabel> dialog</screeninfo> -<mediaobject> -<imageobject> -<imagedata fileref="dialogs-addpalette.png" format="PNG" /> -</imageobject> -<textobject> -<phrase>The <guilabel>Add Palette</guilabel> dialog</phrase> -</textobject> -<caption><para>The <guilabel>Add Palette</guilabel> dialog</para></caption> -</mediaobject> -</screenshot> -</para> - -<para> -With this dialog, you can add a custom color palette to &krita;. Fill in the -name for your palette in the text field at the top. Then make the palette: use -the button <guibutton>Add New Color...</guibutton> to add a color to the palette -and <guibutton>Remove Selected Color</guibutton> to remove the currently -selected color. Click the button <guibutton>Add to Predefined -Palettes</guibutton> to add your newly created palette to the palette list, or -just choose <guibutton>OK</guibutton> when you're done. -</para> - -</sect3> - -<sect3 id="commands-dialogs-misc-documentinformation"> -<title>The <guilabel>Document Information</guilabel> dialog</title> - -<para> -<screenshot> -<screeninfo>The <guilabel>Document Information</guilabel> dialog</screeninfo> -<mediaobject> -<imageobject> -<imagedata fileref="dialogs-documentinformation.png" format="PNG" /> -</imageobject> -<textobject> -<phrase>The <guilabel>Document Information</guilabel> dialog</phrase> -</textobject> -<caption><para>The <guilabel>Document Information</guilabel> dialog</para></caption> -</mediaobject> -</screenshot> -</para> - -<para> -This dialog is the same as in other &koffice; programs. You can enter various -information about your document here, which will be saved with the document so -that you can retrieve it later to review or edit. -</para> - -<para> -On the <guilabel>General</guilabel> tab, you can enter the title, subject and -keywords, as well as an abstract. On the bottom of this tab, some statistical -information is displayed. On the <guilabel>Author</guilabel> tab, you can -store information about yourself. The third tab, <guilabel>User-defined -Metadata</guilabel>, allows you to store any other information. -</para> -</sect3> - -</sect2> - - -</sect1> diff --git a/doc/krita/commands-menus.docbook b/doc/krita/commands-menus.docbook deleted file mode 100644 index b3abdcc9..00000000 --- a/doc/krita/commands-menus.docbook +++ /dev/null @@ -1,2158 +0,0 @@ -<sect1 id="commands-menus"> -<title>Menus</title> - -<para> -Some of &krita;'s menus are standard in &kde; or &koffice;, while others are -particular to &krita;. The <guimenu>File</guimenu> menu contains commands for -manipluating files. In the <guimenu>Edit</guimenu> menu, you can find commands -that do things with the current selection. With the commands from the -<guimenu>View</guimenu> menu, you can change the way you look at the image. -The <guimenu>Image</guimenu> menu contains commands that change the entire -image, like converting all layers to another color model or resizing or -scaling the image. The <guimenu>Layer</guimenu> menu is like the -<guimenu>Image</guimenu> menu, but the commands only work on the current -layer. The <guimenu>Select</guimenu> menu contains commands to create and -manipulate selections. The <guimenu>Filter</guimenu> menu contains all the -filters you have installed. These work on the current layer. The -<guimenu>Scripts</guimenu> menu contains entries for working with scripts. -The <guimenu>Settings</guimenu> menu is again common to &koffice; and allows -you to manipulate the toolbars, shortcuts and configuration of &krita;. -Finally, the <guimenu>Help</guimenu> menu gives you access to various -(hopefully helpful) information, such as this handbook. -</para> - -<!-- ====== File ================================================ --> - -<sect2 id="commands-menus-file"> -<title>The <guimenu>File</guimenu> Menu</title> -<para> -<variablelist> - -<varlistentry> -<term><menuchoice> -<shortcut><keycombo -action="simul">&Ctrl;<keycap>N</keycap></keycombo></shortcut> -<guimenu>File</guimenu> -<guimenuitem>New</guimenuitem> -</menuchoice></term> -<listitem><para><action>Creates a new document.</action> This displays the -<guilabel>New document</guilabel> dialog, standard across &koffice;, in which -you can choose to start with a blank document of a certain type, or to open a -recently opened document.</para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<shortcut><keycombo -action="simul">&Ctrl;<keycap>O</keycap></keycombo></shortcut> -<guimenu>File</guimenu> -<guimenuitem>Open...</guimenuitem> -</menuchoice></term> -<listitem><para><action>Opens an existing document.</action> -Because this uses the usual &kde; <guilabel>Open Document</guilabel> -dialog to let you select a file, you can open files via various protocols -(ftp, fish, etcetera). -</para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<guimenu>File</guimenu> -<guimenuitem>Open Recent</guimenuitem> -</menuchoice></term> -<listitem><para><action>Opens a recently -opened document.</action> Clicking this menu item will show a -submenu with the ten most recently opened documents in which -you can quickly open an image you have been working on lately.</para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<shortcut><keycombo -action="simul">&Ctrl;<keycap>S</keycap></keycombo></shortcut> -<guimenu>File</guimenu> -<guimenuitem>Save</guimenuitem> -</menuchoice></term> -<listitem><para><action>Saves the document.</action> If you -haven't saved the document before, you will get the <guilabel>Save -Document As</guilabel> dialog, otherwise the document will be saved under -its current name. </para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<guimenu>File</guimenu> -<guimenuitem>Save As...</guimenuitem> -</menuchoice></term> -<listitem><para><action>Saves the document under a different name.</action> -The default &kde; dialog is used, so saving remotely via ftp -or ssh (fish) is perfectly possible.</para> </listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<guimenu>File</guimenu> -<guimenuitem>Reload</guimenuitem> -</menuchoice></term> -<listitem><para><action>Reloads the current document -from disk.</action> All changes since you last saved the document -will be lost.</para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<guimenu>File</guimenu> -<guimenuitem>Import...</guimenuitem> -</menuchoice></term> -<listitem><para><action>Opens an existing document.</action> Unlike -<menuchoice><guimenu>File</guimenu><guimenuitem>Open</guimenuitem></menuchoice>, -this does not load the actual document, but only its contents: you receive a -copy of the chosen file as a new document. -</para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<guimenu>File</guimenu> -<guimenuitem>Export...</guimenuitem> -</menuchoice></term> -<listitem><para><action>Saves the document under a different name.</action> (For -the moment, this is the same as -<menuchoice><guimenu>File</guimenu><guimenuitem>Save -As...</guimenuitem></menuchoice>.) -</para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<guimenu>File</guimenu> -<guimenuitem>Mail...</guimenuitem> -</menuchoice></term> -<listitem><para><action>Sends the document via email.</action> The default &kde; -mail compose window will be used.</para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<shortcut><keycombo -action="simul">&Ctrl;<keycap>P</keycap></keycombo></shortcut> -<guimenu>File</guimenu> -<guimenuitem>Print...</guimenuitem> -</menuchoice></term> -<listitem><para><action>Prints the document.</action> You will see the usual -&kde; print dialog appear.</para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<guimenu>File</guimenu> -<guimenuitem>Print Preview...</guimenuitem> -</menuchoice></term> -<listitem><para><action>Shows a preview of what the printed document -will look like.</action></para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<guimenu>File</guimenu> -<guimenuitem>Document Information</guimenuitem> -</menuchoice></term> -<listitem><para><action>Opens the <link -linkend="commands-dialogs-misc-documentinformation"><guilabel>Document -Information</guilabel> dialog</link>.</action> This dialog can be used to add -various information to the image, like title, subject, keywords, author -information, and any other information you want to save with the -image.</para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<shortcut><keycombo -action="simul">&Ctrl;<keycap>W</keycap></keycombo></shortcut> -<guimenu>File</guimenu> -<guimenuitem>Close</guimenuitem> -</menuchoice></term> -<listitem><para><action>Closes the document.</action></para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<shortcut><keycombo -action="simul">&Ctrl;<keycap>Q</keycap></keycombo></shortcut> -<guimenu>File</guimenu> -<guimenuitem>Quit</guimenuitem> -</menuchoice></term> -<listitem><para><action>Quits &krita;.</action></para></listitem> -</varlistentry> - -</variablelist> -</para> - -</sect2> - -<!-- ====== Edit ================================================ --> - - -<sect2 id="commands-menus-edit"> -<title>The <guimenu>Edit</guimenu> Menu</title> -<para> -<variablelist> - -<varlistentry> -<term><menuchoice> -<shortcut><keycombo -action="simul">&Ctrl;<keycap>Z</keycap></keycombo></shortcut> -<guimenu>Edit</guimenu> -<guimenuitem>Undo</guimenuitem> -</menuchoice></term> -<listitem><para><action>Undoes the last action carried out.</action> Actions -(like painting a stroke, filling an area, etcetera) are stored on -a <quote>stack</quote>. The last action you did will be undone, and the image is -restored to the state before that. Immediately choosing -<guimenuitem>Undo</guimenuitem> again will undo the action that was carried -out before the one just undone, etcetera.</para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<shortcut><keycombo -action="simul">&Ctrl;&Shift;<keycap>Z</keycap></keycombo></shortcut> -<guimenu>Edit</guimenu> -<guimenuitem>Redo</guimenuitem> -</menuchoice></term> -<listitem><para><action>Redoes the last action undone.</action> As described at -<guimenuitem>Undo</guimenuitem>, a series of actions can be undone. With -<guimenuitem>Redo</guimenuitem>, an action undone is carried out again, and if -more actions have been undone before that, you can redo these in -turn.</para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<shortcut><keycombo -action="simul">&Ctrl;<keycap>X</keycap></keycombo></shortcut> -<guimenu>Edit</guimenu> -<guimenuitem>Cut</guimenuitem> -</menuchoice></term> -<listitem><para><action>Cuts the selection to the -clipboard.</action> The current selection is put on the &kde; -clipboard, and the selection is cleared.</para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<shortcut><keycombo -action="simul">&Ctrl;<keycap>C</keycap></keycombo></shortcut> -<guimenu>Edit</guimenu> -<guimenuitem>Copy</guimenuitem> -</menuchoice></term> -<listitem><para><action>Copies the selection to the -clipboard.</action></para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<shortcut><keycombo -action="simul">&Ctrl;<keycap>V</keycap></keycombo></shortcut> -<guimenu>Edit</guimenu> -<guimenuitem>Paste</guimenuitem> -</menuchoice></term> -<listitem><para><action>Pastes the contents of the -clipboard.</action></para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<guimenu>Edit</guimenu> -<guimenuitem>Paste into New Image</guimenuitem> -</menuchoice></term> -<listitem><para><action>Pastes the contents of the -clipboard as a new image.</action></para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<guimenu>Edit</guimenu> -<guimenuitem>Clear</guimenuitem> -</menuchoice></term> -<listitem><para><action>Clears the selection.</action></para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<shortcut><keycombo -action="simul">&Alt;&Backspace;</keycombo></shortcut> -<guimenu>Edit</guimenu> -<guimenuitem>Fill with Foreground Color</guimenuitem> -</menuchoice></term> -<listitem><para><action>Fills the selection with the current foreground -color.</action> The current foreground color is shown in the top left color -square of the <guilabel>Colors</guilabel> palette.</para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<shortcut>&Backspace;</shortcut> -<guimenu>Edit</guimenu> -<guimenuitem>Fill with Background Color</guimenuitem> -</menuchoice></term> -<listitem><para><action>Fills the selection with the current background -color.</action> The current background color is shown in the bottom right color -square in the top left corner of the <guilabel>Colors</guilabel> -palette.</para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<guimenu>Edit</guimenu> -<guimenuitem>Fill with Pattern</guimenuitem> -</menuchoice></term> -<listitem><para><action>Fills the selection with the current pattern.</action> -The current pattern is shown on the <guilabel>Brush Shapes</guilabel> toolbar, -usually at the top right of the &krita; window.</para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<guimenu>Edit</guimenu> -<guisubmenu>Resources</guisubmenu> -</menuchoice></term> -<listitem><para><action>Contains options for working with color -palettes.</action></para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<guimenu>Edit</guimenu> -<guisubmenu>Resources</guisubmenu> -<guimenuitem>Add New Palette...</guimenuitem> -</menuchoice></term> -<listitem><para><action>Opens the <link -linkend="commands-dialogs-misc-addpalette"><guilabel>Add Palette</guilabel> -dialog</link>.</action> You can create a custom color palette -here.</para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<guimenu>Edit</guimenu> -<guisubmenu>Resources</guisubmenu> -<guimenuitem>Edit Palette...</guimenuitem> -</menuchoice></term> -<listitem><para><action>Opens the <guilabel>Edit Palette</guilabel> -dialog.</action> Choose a color palette to edit from this list. You will then be -given the same dialog as with <guilabel>Add Palette</guilabel>, with the -difference that you edit the chosen color palette instead of adding a new -one.</para> -</listitem></varlistentry> - -</variablelist> -</para> - -</sect2> - -<!-- ====== View ================================================ --> - - -<sect2 id="commands-menus-view"> -<title>The <guimenu>View</guimenu> Menu</title> -<para> -<variablelist> - -<varlistentry> -<term><menuchoice> -<shortcut><keycombo -action="simul">&Ctrl;&Shift;<keycap>F</keycap></keycombo></shortcut> -<guimenu>View</guimenu> -<guimenuitem>Full Screen Mode</guimenuitem> -</menuchoice></term> -<listitem><para><action>Switches between normal view -and full screen view.</action> In full screen view, the title -bar is hidden and the actual application window is resized to the entire -screen.</para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<guimenu>View</guimenu> -<guimenuitem>New View</guimenuitem> -</menuchoice></term> -<listitem><para><action>Opens a new view for the -current document.</action> A new application window is opened -so that you can have two different views of the same document, for example -to work on different areas at the same time, or to look at an area at different -zoom levels simultaneously. Changes you make to the document in one view are -immediately visible in other views.</para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<shortcut><keycombo -action="simul">&Ctrl;&Shift;<keycap>W</keycap></keycombo></shortcut> -<guimenu>View</guimenu> -<guimenuitem>Close All Views</guimenuitem> -</menuchoice></term> -<listitem><para><action>Closes all views.</action></para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<guimenu>View</guimenu> -<guimenuitem>Split View</guimenuitem> -</menuchoice></term> -<listitem><para><action>Splits the current view.</action> The -drawing area will be split into two parts, which can be used -just like two views in different windows.</para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<guimenu>View</guimenu> -<guimenuitem>Remove View</guimenuitem> -</menuchoice></term> -<listitem><para><action>Unsplits the view.</action> The second -view (the bottom or right one) will be closed and the first one will remain -visible.</para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<guimenu>View</guimenu> -<guisubmenu>Splitter Orientation</guisubmenu> -</menuchoice></term> -<listitem><para><action>Changes the way the split -view is displayed.</action></para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<guimenu>View</guimenu> -<guisubmenu>Splitter Orientation</guisubmenu> -<guimenuitem>Vertical</guimenuitem> -</menuchoice></term> -<listitem><para><action>Changes the orientation of -the splitter to vertical.</action> The two split -views will be positioned side by side.</para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<guimenu>View</guimenu> -<guisubmenu>Splitter Orientation</guisubmenu> -<guimenuitem>Horizontal</guimenuitem> -</menuchoice></term> -<listitem><para><action>Changes the orientation of -the splitter to horizontal.</action> The two split views will -be positioned above each other.</para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<shortcut><keycombo -action="simul">&Ctrl;<keycap>+</keycap></keycombo></shortcut> -<guimenu>View</guimenu> -<guimenuitem>Zoom In</guimenuitem> -</menuchoice></term> -<listitem><para><action>Zooms in on the view.</action> The view -will be more detailed, but a smaller area will be visible at the -same time.</para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<shortcut><keycombo -action="simul">&Ctrl;<keycap>-</keycap></keycombo></shortcut> -<guimenu>View</guimenu> -<guimenuitem>Zoom Out</guimenuitem> -</menuchoice></term> -<listitem><para><action>Zooms out of the view.</action> A larger -area will be visible at the same time, but it will be less -detailed.</para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<shortcut><keycombo -action="simul">&Ctrl;<keycap>0</keycap></keycombo></shortcut> -<guimenu>View</guimenu> -<guimenuitem>Actual Pixels</guimenuitem> -</menuchoice></term> -<listitem><para><action>Zooms the view to actual pixel -level.</action> (1:1 scale)</para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<guimenu>View</guimenu> -<guimenuitem>Actual Size</guimenuitem> -</menuchoice></term> -<listitem><para><action>Zooms the view to the actual image -size.</action></para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<guimenu>View</guimenu> -<guimenuitem>Fit to Page</guimenuitem> -</menuchoice></term> -<listitem><para><action>Zooms the view so that the image fills the available -workspace.</action></para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<shortcut><keycombo -action="simul">&Ctrl;<keycap>R</keycap></keycombo></shortcut> -<guimenu>View</guimenu> -<guimenuitem>Show Rulers</guimenuitem> -</menuchoice></term> -<listitem><para><action>Toggles display of the -rulers on and off.</action></para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<guimenu>View</guimenu> -<guimenuitem>Show Grid</guimenuitem> -</menuchoice></term> -<listitem><para><action>Toggles display of the -grid lines on and off.</action></para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<guimenu>View</guimenu> -<guisubmenu>Grid Spacing</guisubmenu> -</menuchoice></term> -<listitem><para><action>Contains various options to set the distance between -grid lines.</action> The available spacing options are -<guimenuitem>1x1</guimenuitem>, <guimenuitem>2x2</guimenuitem>, -<guimenuitem>5x5</guimenuitem>, <guimenuitem>10x10</guimenuitem>, -<guimenuitem>20x20</guimenuitem>, and <guimenuitem>40x40</guimenuitem>.</para> -</listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<guimenu>View</guimenu> -<guisubmenu>Show Perspective Grid</guisubmenu> -</menuchoice></term> -<listitem><para><action>Toggles display of the perspective grid on and off.</action> -</para> -</listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<guimenu>View</guimenu> -<guisubmenu>Clear Perspective Grid</guisubmenu> -</menuchoice></term> -<listitem><para><action>Clears the perspective grid.</action> (All grid lines -that were created, are deleted.)</para> -</listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<guimenu>View</guimenu> -<guisubmenu>Palettes</guisubmenu> -</menuchoice></term> -<listitem><para><action>Allows you to toggle the -display of the various palettes on and off.</action> The -default view of &krita; shows all palettes, and the items are listed as Hide -<replaceable>palette</replaceable> therefore. When a certain palette is hidden, -the corresponding menu item changes to Show -<replaceable>palette</replaceable>.</para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<shortcut><keycombo -action="simul">&Ctrl;&Shift;<keycap>H</keycap></keycombo></shortcut> -<guimenu>View</guimenu> -<guisubmenu>Palettes</guisubmenu> -<guimenuitem>Hide All Palette Windows</guimenuitem> -</menuchoice></term> -<listitem><para><action>Hides all palettes.</action></para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<guimenu>View</guimenu> -<guisubmenu>Palettes</guisubmenu> -<guimenuitem>Hide Overview</guimenuitem> -</menuchoice></term> -<listitem><para><action>Hides the -<guilabel>Overview</guilabel> palette.</action></para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<guimenu>View</guimenu> -<guisubmenu>Palettes</guisubmenu> -<guimenuitem>Hide HSV</guimenuitem> -</menuchoice></term> -<listitem><para><action>Hides the -<guilabel>HSV</guilabel> palette.</action></para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<guimenu>View</guimenu> -<guisubmenu>Palettes</guisubmenu> -<guimenuitem>Hide RGB</guimenuitem> -</menuchoice></term> -<listitem><para><action>Hides the -<guilabel>RGB</guilabel> palette.</action></para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<guimenu>View</guimenu> -<guisubmenu>Palettes</guisubmenu> -<guimenuitem>Hide Gray</guimenuitem> -</menuchoice></term> -<listitem><para><action>Hides the -<guilabel>Gray</guilabel> palette.</action></para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<guimenu>View</guimenu> -<guisubmenu>Palettes</guisubmenu> -<guimenuitem>Hide Palettes</guimenuitem> -</menuchoice></term> -<listitem><para><action>Hides the -<guilabel>Palettes</guilabel> palette.</action></para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<guimenu>View</guimenu> -<guisubmenu>Palettes</guisubmenu> -<guimenuitem>Hide Layers</guimenuitem> -</menuchoice></term> -<listitem><para><action>Hides the <guilabel>Layers</guilabel> -palette.</action></para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<guimenu>View</guimenu> -<guisubmenu>Palettes</guisubmenu> -<guimenuitem>Hide Scripts Manager</guimenuitem> -</menuchoice></term> -<listitem><para><action>Hides the <guilabel>Scripts Manager</guilabel>. -</action></para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<guimenu>View</guimenu> -<guisubmenu>Palettes</guisubmenu> -<guimenuitem>Hide Histogram</guimenuitem> -</menuchoice></term> -<listitem><para><action>Hides the -<guilabel>Histogram</guilabel> palette.</action></para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<guimenu>View</guimenu> -<guisubmenu>Palettes</guisubmenu> -<guimenuitem>Hide Watercolors</guimenuitem> -</menuchoice></term> -<listitem><para><action>Hides the <guilabel>Watercolors</guilabel> -palette.</action></para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<guimenu>View</guimenu> -<guisubmenu>Palettes</guisubmenu> -<guimenuitem>Hide Brush, Ellipse, Filter tool, Line, Polygon &etc;</guimenuitem> -</menuchoice></term> -<listitem><para><action>Hides the palette of the selected -<guilabel>Tool</guilabel>.</action></para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<guimenu>View</guimenu> -<guimenuitem>Wetness Visualisation</guimenuitem> -</menuchoice></term> -<listitem><para><action>Toggles indication of the wetness of watercolor paint -on and off.</action></para></listitem> -</varlistentry> - -</variablelist> -</para> - -</sect2> - -<!-- ====== Image =============================================== --> - - -<sect2 id="commands-menus-image"> -<title>The <guimenu>Image</guimenu> Menu</title> -<para> -<variablelist> - -<varlistentry> -<term><menuchoice> -<guimenu>Image</guimenu> -<guimenuitem>Image Properties</guimenuitem> -</menuchoice></term> -<listitem><para><action>Opens the <link -linkend="commands-dialogs-image-imageproperties"><guilabel>Image -Properties</guilabel> dialog</link>, -in which you can change the image name, size, -profile and description.</action></para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<guimenu>Image</guimenu> -<guimenuitem>Resize Image to Size of Current Layer</guimenuitem> -</menuchoice></term> -<listitem><para><action>Resizes the image to the -size of the currently active layer.</action></para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<guimenu>Image</guimenu> -<guisubmenu>Substrate...</guisubmenu> -</menuchoice></term> -<listitem><para><action>Opens the <link -linkend="commands-dialogs-image-substrate"><guilabel>Substrate</guilabel> dialog</link>.</action></para></listitem> -</varlistentry> -<varlistentry> -<term><menuchoice> -<guimenu>Image</guimenu> -<guisubmenu>Rotate</guisubmenu> -</menuchoice></term> -<listitem><para><action>Rotates the image.</action></para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<guimenu>Image</guimenu> -<guisubmenu>Rotate</guisubmenu> -<guimenuitem>Rotate Image...</guimenuitem> -</menuchoice></term> -<listitem><para><action>Opens the <link -linkend="commands-dialogs-image-rotateimage"><guilabel>Rotate Image</guilabel> -dialog</link>.</action></para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<guimenu>Image</guimenu> -<guisubmenu>Rotate</guisubmenu> -<guimenuitem>Rotate Image CW</guimenuitem> -</menuchoice></term> -<listitem><para><action>Rotates the image 90 degrees -clockwise.</action></para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<guimenu>Image</guimenu> -<guisubmenu>Rotate</guisubmenu> -<guimenuitem>Rotate Image CCW</guimenuitem> -</menuchoice></term> -<listitem><para><action>Rotates the image 90 degrees counterclockwise -(270 degrees clockwise).</action></para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<guimenu>Image</guimenu> -<guisubmenu>Rotate</guisubmenu> -<guimenuitem>Rotate 180</guimenuitem> -</menuchoice></term> -<listitem><para><action>Rotates the image 180 degrees.</action></para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<guimenu>Image</guimenu> -<guimenuitem>Convert Image Type...</guimenuitem> -</menuchoice></term> -<listitem><para><action>Opens the <link -linkend="commands-dialogs-image-convertimagetype"><guilabel>Convert All -Layers</guilabel> dialog</link>.</action> This allows you to convert the image -to a different color space. Apart from the color space, the profile and -rendering intent can be specified as well.</para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<guimenu>Image</guimenu> -<guimenuitem>Separate Image...</guimenuitem> -</menuchoice></term> -<listitem><para><action>Opens the -<link linkend="commands-dialogs-image-separateimage"><guilabel>Separate Image</guilabel> -dialog</link>.</action> You can separate the image into layers for each -individual colorspace component there.</para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<guimenu>Image</guimenu> -<guimenuitem>Change Image Size...</guimenuitem> -</menuchoice></term> -<listitem><para><action>Opens the -<link linkend="commands-dialogs-image-imagesize"><guilabel>Image Size</guilabel> -dialog </link>.</action> You can resize or scale the image using various -algorithms here.</para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<guimenu>Image</guimenu> -<guimenuitem>Shear Image...</guimenuitem> -</menuchoice></term> -<listitem><para><action>Opens the <link -linkend="commands-dialogs-image-shearimage"><guilabel>Shear Image</guilabel> -dialog</link>.</action> You can shear the image in X or Y directions, -or both.</para></listitem> -</varlistentry> - -</variablelist> -</para> - -</sect2> - -<!-- ====== Layer =============================================== --> - -<sect2 id="commands-menus-layer"> -<title>The <guimenu>Layer</guimenu> Menu</title> - -<para> -<variablelist> - -<varlistentry> -<term><menuchoice> -<guimenu>Layer</guimenu> -<guisubmenu>New</guisubmenu> -</menuchoice></term> -<listitem><para><action>Creates a new layer.</action></para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<shortcut><keycombo -action="simul">&Ctrl;&Shift;<keycap>N</keycap></keycombo></shortcut> -<guimenu>Layer</guimenu> -<guisubmenu>New</guisubmenu> -<guimenuitem>Add...</guimenuitem> -</menuchoice></term> -<listitem><para><action>Opens the -<link linkend="commands-dialogs-layers-newlayer"><guilabel>New Layer</guilabel> -dialog</link>.</action> This will create a new empty -layer. You can set the name, opacity, composite mode and -layer type.</para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<guimenu>Layer</guimenu> -<guisubmenu>New</guisubmenu> -<guisubmenu>Object Layer</guisubmenu> -</menuchoice></term> -<listitem><para><action>Creates a new layer for a -given &koffice; object type.</action></para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<guimenu>Layer</guimenu> -<guisubmenu>New</guisubmenu> -<guisubmenu>Object Layer</guisubmenu> -<guimenuitem>Scalable Graphics</guimenuitem> -</menuchoice></term> -<listitem><para><action>Creates a new layer for an -embedded &karbon14; object.</action></para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<guimenu>Layer</guimenu> -<guisubmenu>New</guisubmenu> -<guisubmenu>Object Layer</guisubmenu> -<guimenuitem>Text Documents</guimenuitem> -</menuchoice></term> -<listitem><para><action>Creates a new layer for an -embedded &kword; document.</action></para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<guimenu>Layer</guimenu> -<guisubmenu>New</guisubmenu> -<guisubmenu>Object Layer</guisubmenu> -<guimenuitem>Flowchart & Diagram</guimenuitem> -</menuchoice></term> -<listitem><para><action>Creates a new layer for an embedded -&kivio; object.</action></para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<guimenu>Layer</guimenu> -<guisubmenu>New</guisubmenu> -<guisubmenu>Object Layer</guisubmenu> -<guimenuitem>Slide Presentations</guimenuitem> -</menuchoice></term> -<listitem><para><action>Creates a new layer for an embedded -&kpresenter; object.</action></para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<guimenu>Layer</guimenu> -<guisubmenu>New</guisubmenu> -<guisubmenu>Object Layer</guisubmenu> -<guimenuitem>Image Object</guimenuitem> -</menuchoice></term> -<listitem><para><action>Creates a new layer for an -embedded &krita; object.</action></para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<guimenu>Layer</guimenu> -<guisubmenu>New</guisubmenu> -<guisubmenu>Object Layer</guisubmenu> -<guimenuitem>Report Template</guimenuitem> -</menuchoice></term> -<listitem><para><action>Creates a new layer for an embedded -&kugar; Designer object.</action></para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<guimenu>Layer</guimenu> -<guisubmenu>New</guisubmenu> -<guisubmenu>Object Layer</guisubmenu> -<guimenuitem>Chart</guimenuitem> -</menuchoice></term> -<listitem><para><action>Creates a new layer for an -embedded &kchart; object.</action></para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<guimenu>Layer</guimenu> -<guisubmenu>New</guisubmenu> -<guisubmenu>Object Layer</guisubmenu> -<guimenuitem>Formula Editor</guimenuitem> -</menuchoice></term> -<listitem><para><action>Creates a new layer for an -embedded &kformula; object.</action></para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<guimenu>Layer</guimenu> -<guisubmenu>New</guisubmenu> -<guisubmenu>Object Layer</guisubmenu> -<guimenuitem>Report Generator</guimenuitem> -</menuchoice></term> -<listitem><para><action>Creates a new layer for an -embedded &kugar; object.</action></para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<guimenu>Layer</guimenu> -<guisubmenu>New</guisubmenu> -<guisubmenu>Object Layer</guisubmenu> -<guimenuitem>Project Management</guimenuitem> -</menuchoice></term> -<listitem><para><action>Creates a new layer for an -embedded KPlato object.</action></para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<guimenu>Layer</guimenu> -<guisubmenu>New</guisubmenu> -<guisubmenu>Object Layer</guisubmenu> -<guimenuitem>Spreadsheets</guimenuitem> -</menuchoice></term> -<listitem><para><action>Creates a new layer for an -embedded &kspread; document.</action></para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<guimenu>Layer</guimenu> -<guisubmenu>New</guisubmenu> -<guimenuitem>Adjustment Layer</guimenuitem> -</menuchoice></term> -<listitem><para><action>Opens the <link -linkend="commands-dialogs-layers-newadjustmentlayer"><guilabel>New Adjustment -Layer</guilabel>dialog</link>.</action></para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<guimenu>Layer</guimenu> -<guisubmenu>New</guisubmenu> -<guimenuitem>Insert Image as Layer...</guimenuitem> -</menuchoice></term> -<listitem><para><action>Opens the <guilabel>Import Image</guilabel> -dialog.</action> You can browse and select an image file, -which will be inserted in a new layer.</para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<shortcut><keycombo -action="simul">&Ctrl;&Shift;<keycap>J</keycap></keycombo></shortcut> -<guimenu>Layer</guimenu> -<guisubmenu>New</guisubmenu> -<guimenuitem>Cut Selection to New Layer</guimenuitem> -</menuchoice></term> -<listitem><para><action>Cuts the current selection -and inserts it as a new layer.</action></para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<shortcut><keycombo -action="simul">&Ctrl;<keycap>J</keycap></keycombo></shortcut> -<guimenu>Layer</guimenu> -<guisubmenu>New</guisubmenu> -<guimenuitem>Copy Selection to New Layer</guimenuitem> -</menuchoice></term> -<listitem><para><action>Copies the current selection -and inserts it as a new layer.</action></para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<guimenu>Layer</guimenu> -<guimenuitem>Remove</guimenuitem> -</menuchoice></term> -<listitem><para><action>Removes the current layer -and its contents.</action></para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<guimenu>Layer</guimenu> -<guimenuitem>Duplicate</guimenuitem> -</menuchoice></term> -<listitem><para><action>Duplicates the current -layer.</action></para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<guimenu>Layer</guimenu> -<guimenuitem>Hide/Show</guimenuitem> -</menuchoice></term> -<listitem><para><action>Toggles the visibility of -the current layer in the image editing window.</action></para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<guimenu>Layer</guimenu> -<guisubmenu>Mask</guisubmenu> -</menuchoice></term> -<listitem><para>Contains actions for working with layer masks.</para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<guimenu>Layer</guimenu> -<guisubmenu>Mask</guisubmenu> -<guimenuitem>Create Mask</guimenuitem> -</menuchoice></term> -<listitem><para><action></action></para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<guimenu>Layer</guimenu> -<guisubmenu>Mask</guisubmenu> -<guimenuitem>Mask From Selection</guimenuitem> -</menuchoice></term> -<listitem><para><action></action></para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<guimenu>Layer</guimenu> -<guisubmenu>Mask</guisubmenu> -<guimenuitem>Mask To Selection</guimenuitem> -</menuchoice></term> -<listitem><para><action></action></para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<guimenu>Layer</guimenu> -<guisubmenu>Mask</guisubmenu> -<guimenuitem>Apply Mask</guimenuitem> -</menuchoice></term> -<listitem><para><action></action></para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<guimenu>Layer</guimenu> -<guisubmenu>Mask</guisubmenu> -<guimenuitem>Remove Mask</guimenuitem> -</menuchoice></term> -<listitem><para><action></action></para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<guimenu>Layer</guimenu> -<guisubmenu>Mask</guisubmenu> -<guimenuitem>Edit Mask</guimenuitem> -</menuchoice></term> -<listitem><para><action></action></para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<guimenu>Layer</guimenu> -<guisubmenu>Mask</guisubmenu> -<guimenuitem>Show Mask</guimenuitem> -</menuchoice></term> -<listitem><para><action></action></para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<shortcut><keycombo -action="simul">&Ctrl;<keycap>]</keycap></keycombo></shortcut> -<guimenu>Layer</guimenu> -<guimenuitem>Raise</guimenuitem> -</menuchoice></term> -<listitem><para><action>Moves the current layer one -level upward.</action></para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<shortcut><keycombo -action="simul">&Ctrl;<keycap>[</keycap></keycombo></shortcut> -<guimenu>Layer</guimenu> -<guimenuitem>Lower</guimenuitem> -</menuchoice></term> -<listitem><para><action>Moves the current layer one -level downward.</action></para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<shortcut><keycombo -action="simul">&Ctrl;&Shift;<keycap>]</keycap></keycombo></shortcut> -<guimenu>Layer</guimenu> -<guimenuitem>To Top</guimenuitem> -</menuchoice></term> -<listitem><para><action>Moves the current layer to the -top.</action></para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<shortcut><keycombo -action="simul">&Ctrl;&Shift;<keycap>[</keycap></keycombo></shortcut> -<guimenu>Layer</guimenu> -<guimenuitem>To Bottom</guimenuitem> -</menuchoice></term> -<listitem><para><action>Moves the current layer to -the bottom.</action></para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<guimenu>Layer</guimenu> -<guimenuitem>Save Layer as Image...</guimenuitem> -</menuchoice></term> -<listitem><para><action>Opens the <guilabel>Export Layer</guilabel> -dialog.</action> The current layer will be saved to the -chosen file.</para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<guimenu>Layer</guimenu> -<guimenuitem>Flip on X Axis</guimenuitem> -</menuchoice></term> -<listitem><para><action>Flips the current layer -horizontally.</action></para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<guimenu>Layer</guimenu> -<guimenuitem>Flip on Y Axis</guimenuitem> -</menuchoice></term> -<listitem><para><action>Flips the current layer -vertically.</action></para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<guimenu>Layer</guimenu> -<guimenuitem>Properties</guimenuitem> -</menuchoice></term> -<listitem><para><action>Opens the <link -linkend="commands-dialogs-layers-layerproperties"><guilabel>Layer -Properties</guilabel> dialog</link>.</action> You can change the name, -colorspace, opacity, composite mode and position of the current layer -here.</para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<shortcut><keycombo -action="simul">&Ctrl;<keycap>E</keycap></keycombo></shortcut> -<guimenu>Layer</guimenu> -<guimenuitem>Merge with Layer Below</guimenuitem> -</menuchoice></term> -<listitem><para><action>Merges the current layer -with the one below it.</action></para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<shortcut><keycombo -action="simul">&Ctrl;&Shift;<keycap>E</keycap></keycombo></shortcut> -<guimenu>Layer</guimenu> -<guimenuitem>Flatten Image</guimenuitem> -</menuchoice></term> -<listitem><para><action>Merges all visible layers.</action></para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<guimenu>Layer</guimenu> -<guisubmenu>Rotate</guisubmenu> -</menuchoice></term> -<listitem><para><action>Rotates the current layer.</action></para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<guimenu>Layer</guimenu> -<guisubmenu>Rotate</guisubmenu> -<guimenuitem>Rotate Layer...</guimenuitem> -</menuchoice></term> -<listitem><para><action>Opens the <link -linkend="commands-dialogs-layers-rotatelayer"><guilabel>Rotate Layer</guilabel> -dialog</link>.</action></para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<guimenu>Layer</guimenu> -<guisubmenu>Rotate</guisubmenu> -<guimenuitem>Rotate CW</guimenuitem> -</menuchoice></term> -<listitem><para><action>Rotates the current layer 90 degrees -clockwise.</action></para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<guimenu>Layer</guimenu> -<guisubmenu>Rotate</guisubmenu> -<guimenuitem>Rotate CCW</guimenuitem> -</menuchoice></term> -<listitem><para><action>Rotates the current layer 90 degrees counterclockwise -(270 degrees clockwise).</action></para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<guimenu>Layer</guimenu> -<guisubmenu>Rotate</guisubmenu> -<guimenuitem>Rotate 180</guimenuitem> -</menuchoice></term> -<listitem><para><action>Rotates the current layer by -180 degrees.</action></para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<guimenu>Layer</guimenu> -<guimenuitem>Histogram...</guimenuitem> -</menuchoice></term> -<listitem><para><action>Opens the <link -linkend="commands-dialogs-layers-histogram"><guilabel>Histogram</guilabel> -dialog</link>, in which you can see histograms for the current -layer.</action></para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<guimenu>Layer</guimenu> -<guimenuitem>Convert Layer Type...</guimenuitem> -</menuchoice></term> -<listitem><para><action>Opens the -<link linkend="commands-dialogs-layers-convertlayertype"><guilabel>Convert -Current Layer</guilabel> dialog</link>.</action> You can -set various options with respect to the colorspace and -rendering intent.</para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<guimenu>Layer</guimenu> -<guimenuitem>Scale Layer...</guimenuitem> -</menuchoice></term> -<listitem><para><action>Opens the <link -linkend="commands-dialogs-layers-layersize"><guilabel>Layer -Size</guilabel> dialog</link>.</action> You can choose the new -dimensions and the resize filter to use.</para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<guimenu>Layer</guimenu> -<guisubmenu>Layer Effects</guisubmenu> -</menuchoice></term> -<listitem><para>Contains commands to add effects to the current layer. -</para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<guimenu>Layer</guimenu> -<guisubmenu>Layer Effects</guisubmenu> -<guimenuitem>Add Drop Shadow...</guimenuitem> -</menuchoice></term> -<listitem><para><action>Opens the <link -linkend="commands-dialogs-layers-dropshadow"><guilabel>Drop Shadow</guilabel> -dialog</link>.</action> This dialog can be used to add a drop shadow beneath -the current layer.</para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<guimenu>Layer</guimenu> -<guimenuitem>Shear Layer...</guimenuitem> -</menuchoice></term> -<listitem><para><action>Opens the <link -linkend="commands-dialogs-layers-shearlayer"><guilabel>Shear Layer</guilabel> -dialog</link>.</action> You can select the X and Y angles to shear -by.</para></listitem> -</varlistentry> - -</variablelist> -</para> - -</sect2> - -<!-- ====== Select ============================================== --> - - -<sect2 id="commands-menus-select"> -<title>The <guimenu>Select</guimenu> Menu</title> -<para> -<variablelist> - -<varlistentry> -<term><menuchoice> -<shortcut><keycombo -action="simul">&Ctrl;<keycap>A</keycap></keycombo></shortcut> -<guimenu>Select</guimenu> -<guimenuitem>Select All</guimenuitem> -</menuchoice></term> -<listitem><para><action>Selects the entire -current layer.</action></para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<shortcut><keycombo -action="simul">&Ctrl;&Shift;<keycap>A</keycap></keycombo></shortcut> -<guimenu>Select</guimenu> -<guimenuitem>Deselect</guimenuitem> -</menuchoice></term> -<listitem><para><action>Unselects everything.</action></para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<shortcut><keycombo -action="simul">&Ctrl;&Shift;<keycap>D</keycap></keycombo></shortcut> -<guimenu>Select</guimenu> -<guimenuitem>Reselect</guimenuitem> -</menuchoice></term> -<listitem><para><action>Reselects the previous -unselected areas.</action></para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<shortcut><keycombo -action="simul">&Ctrl;<keycap>I</keycap></keycombo></shortcut> -<guimenu>Select</guimenu> -<guimenuitem>Invert</guimenuitem> -</menuchoice></term> -<listitem><para><action>Inverts the selection.</action> -(Everything that is selected will be unselected and vice -versa.)</para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<shortcut><keycombo -action="simul">&Alt;&Ctrl;<keycap>D</keycap></keycombo></shortcut> -<guimenu>Select</guimenu> -<guimenuitem>Feather...</guimenuitem> -</menuchoice></term> -<listitem><para><action>Feathers the selection.</action> (Adds -a soft border around it.)</para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<guimenu>Select</guimenu> -<guimenuitem>Similar</guimenuitem> -</menuchoice></term> -<listitem><para><action></action></para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<shortcut><keycombo -action="simul">&Ctrl;<keycap>H</keycap></keycombo></shortcut> -<guimenu>Select</guimenu> -<guisubmenu>Hide Selection</guisubmenu> -</menuchoice></term> -<listitem><para><action>Hides the selection.</action> The selection is still -active, but it is not made visible anymore.</para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<guimenu>Select</guimenu> -<guisubmenu>Grow Selection...</guisubmenu> -</menuchoice></term> -<listitem><para><action>Grows the selection.</action></para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<guimenu>Select</guimenu> -<guisubmenu>Shrink Selection...</guisubmenu> -</menuchoice></term> -<listitem><para><action>Shrinks the selection.</action></para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<guimenu>Select</guimenu> -<guisubmenu>Border Selection...</guisubmenu> -</menuchoice></term> -<listitem><para><action>Borders the selection.</action></para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<guimenu>Select</guimenu> -<guimenuitem>Color Range...</guimenuitem> -</menuchoice></term> -<listitem><para><action>Opens the <link -linkend="commands-dialogs-images-colorrange"><guilabel>Color Range</guilabel> -dialog</link>.</action></para></listitem> -</varlistentry> - -</variablelist> -</para> - -</sect2> - -<!-- ====== Filter ============================================== --> - - -<sect2 id="commands-menus-filter"> -<title>The <guimenu>Filter</guimenu> Menu</title> - -<para>See the <link linkend="filters">Filters</link> chapter for more -information on filters.</para> <para> -<variablelist> - -<varlistentry> -<term><menuchoice> -<shortcut><keycombo -action="simul">&Ctrl;&Shift;<keycap>J</keycap></keycombo></shortcut> -<guimenu>Filter</guimenu> -<guimenuitem>Apply Filter Again</guimenuitem> -</menuchoice></term> -<listitem><para><action>Repeats the last filter -action.</action></para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<guimenu>Filter</guimenu> -<guisubmenu>Adjust</guisubmenu> -</menuchoice></term> -<listitem><para>Contains various options for changing the -colors in your image.</para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<guimenu>Filter</guimenu> -<guisubmenu>Adjust</guisubmenu> -<guimenuitem>Auto Contrast</guimenuitem> -</menuchoice></term> -<listitem><para><action>Automatically changes the image to obtain as much -contrast as possible.</action></para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<guimenu>Filter</guimenu> -<guisubmenu>Adjust</guisubmenu> -<guimenuitem>Brightness/Contrast...</guimenuitem> -</menuchoice></term> -<listitem><para><action>Opens the -<link -linkend="commands-dialogs-filters-brightnesscontrast"><guilabel>Brightness/Contrast</guilabel> -dialog</link>.</action> You can set the -brightness and contrast ratio of your image here.</para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<guimenu>Filter</guimenu> -<guisubmenu>Adjust</guisubmenu> -<guimenuitem>Desaturate</guimenuitem> -</menuchoice></term> -<listitem><para><action>Desaturates the image.</action> This -will effectively convert the current image to grayscale, but all subsequent -painting is done with usual colors.</para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<guimenu>Filter</guimenu> -<guisubmenu>Adjust</guisubmenu> -<guimenuitem>Invert</guimenuitem> -</menuchoice></term> -<listitem><para><action>Inverts the image or -selection.</action> (Black becomes white, blue becomes yellow, -etcetera.)</para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<guimenu>Filter</guimenu> -<guisubmenu>Adjust</guisubmenu> -<guimenuitem>Color Adjustment...</guimenuitem> -</menuchoice></term> -<listitem><para><action>Opens the <link -linkend="commands-dialogs-filters-coloradjustment"><guilabel>Color Adjustment</guilabel> -dialog</link>.</action> You can adjust the colorspace components -of the current image there (for example, in an RGB image, you can change the -contribution of red, green, and blue to the total image).</para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<guimenu>Filter</guimenu> -<guisubmenu>Artistic</guisubmenu> -</menuchoice></term> -<listitem><para>Contains various filters for -<quote>artistic</quote> actions.</para></listitem> -</varlistentry> - -<!--<varlistentry> -<term><menuchoice> -<guimenu>Filter</guimenu> -<guisubmenu>Artistic</guisubmenu> -<guimenuitem>Cubism...</guimenuitem> -</menuchoice></term> -<listitem><para><action>Opens the <link -linkend="commands-dialogs-filters-cubism"><guilabel>Cubism</guilabel> -dialog</link>.</action> This allows you to add a cubism effect to the -selection or image.</para></listitem> -</varlistentry>--> - -<varlistentry> -<term><menuchoice> -<guimenu>Filter</guimenu> -<guisubmenu>Artistic</guisubmenu> -<guimenuitem>Oilpaint...</guimenuitem> -</menuchoice></term> -<listitem><para><action>Opens the <link -linkend="commands-dialogs-filters-oilpaint"><guilabel>Oilpaint</guilabel> -dialog</link> to add -an oilpaint effect to the selection or image.</action></para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<guimenu>Filter</guimenu> -<guisubmenu>Artistic</guisubmenu> -<guimenuitem>Pixelize...</guimenuitem> -</menuchoice></term> -<listitem><para><action>Opens the <link -linkend="commands-dialogs-filters-pixelize"><guilabel>Pixelize</guilabel> -dialog</link> to pixelize the image.</action> (A block of pixels is -changed so that they all become the same, averaged color.)</para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<guimenu>Filter</guimenu> -<guisubmenu>Artistic</guisubmenu> -<guimenuitem>Raindrops...</guimenuitem> -</menuchoice></term> -<listitem><para><action>Opens the <link -linkend="commands-dialogs-filters-raindrops"><guilabel>Raindrops</guilabel> -dialog</link> to add a raindrops effect to the selection or -image.</action></para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<guimenu>Filter</guimenu> -<guisubmenu>Artistic</guisubmenu> -<guimenuitem>Dry the Paint</guimenuitem> -</menuchoice></term> -<listitem><para><action>Dries wet paint.</action></para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<guimenu>Filter</guimenu> -<guisubmenu>Blur</guisubmenu> -</menuchoice></term> -<listitem><para>Contains various blur filters.</para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<guimenu>Filter</guimenu> -<guisubmenu>Blur</guisubmenu> -<guimenuitem>Gaussian Blur</guimenuitem> -</menuchoice></term> -<listitem><para><action>Performs a slight blur on the image or -selection.</action></para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<guimenu>Filter</guimenu> -<guisubmenu>Colors</guisubmenu> -</menuchoice></term> -<listitem><para>Contains filters that change the image colors.</para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<guimenu>Filter</guimenu> -<guisubmenu>Colors</guisubmenu> -<guimenuitem>Color to Alpha</guimenuitem> -</menuchoice></term> -<listitem><para><action></action></para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<guimenu>Filter</guimenu> -<guisubmenu>Colors</guisubmenu> -<guimenuitem>Color Transfer</guimenuitem> -</menuchoice></term> -<listitem><para><action>Opens the <link -linkend="commands-dialogs-filters-colortransfer">Color Transfer</link> dialog -to give the image a new look.</action></para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<guimenu>Filter</guimenu> -<guisubmenu>Colors</guisubmenu> -<guimenuitem>Maximize Channel</guimenuitem> -</menuchoice></term> -<listitem><para><action>Adjusts the colors of each pixel by removing color -channels that are less abundant.</action></para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<guimenu>Filter</guimenu> -<guisubmenu>Colors</guisubmenu> -<guimenuitem>Minimize Channel</guimenuitem> -</menuchoice></term> -<listitem><para><action>Adjusts the colors of each pixel by removing color -channels that are abundant.</action></para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<guimenu>Filter</guimenu> -<guisubmenu>Edge Detection</guisubmenu> -</menuchoice></term> -<listitem><para>Contains edge detecting filters.</para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<guimenu>Filter</guimenu> -<guisubmenu>Edge Detection</guisubmenu> -<guimenuitem>Bottom Edge Detection</guimenuitem> -</menuchoice></term> -<listitem><para><action>Performs edge detection with the bottom sides of image -parts as references.</action></para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<guimenu>Filter</guimenu> -<guisubmenu>Edge Detection</guisubmenu> -<guimenuitem>Left Edge Detection</guimenuitem> -</menuchoice></term> -<listitem><para><action>Performs edge detection with the left sides of image -parts as references.</action></para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<guimenu>Filter</guimenu> -<guisubmenu>Edge Detection</guisubmenu> -<guimenuitem>Right Edge Detection</guimenuitem> -</menuchoice></term> -<listitem><para><action>Performs edge detection with the right sides of image -parts as references.</action></para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<guimenu>Filter</guimenu> -<guisubmenu>Edge Detection</guisubmenu> -<guimenuitem>Sobel...</guimenuitem> -</menuchoice></term> -<listitem><para><action>Opens the <guilabel>Sobel</guilabel> -dialog.</action></para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<guimenu>Filter</guimenu> -<guisubmenu>Edge Detection</guisubmenu> -<guimenuitem>Top Edge Detection</guimenuitem> -</menuchoice></term> -<listitem><para><action>Performs edge detection with the top sides of image -parts as references.</action></para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<guimenu>Filter</guimenu> -<guisubmenu>Enhance</guisubmenu> -</menuchoice></term> -<listitem><para>Contains image enhancing -filters.</para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<guimenu>Filter</guimenu> -<guisubmenu>Enhance</guisubmenu> -<guimenuitem>CImg Image Restoration...</guimenuitem> -</menuchoice></term> -<listitem><para><action>Opens the <link -linkend="commands-dialogs-filters-imagerestoration"><guilabel>Image -Restoration</guilabel> dialog</link>.</action></para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<guimenu>Filter</guimenu> -<guisubmenu>Enhance</guisubmenu> -<guimenuitem>Custom Convolution...</guimenuitem> -</menuchoice></term> -<listitem><para><action>Opens the <link -linkend="commands-dialogs-filters-customconvolution"><guilabel>Custom -Convolution</guilabel> dialog</link>.</action></para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<guimenu>Filter</guimenu> -<guisubmenu>Enhance</guisubmenu> -<guimenuitem>Gaussian Noise Reduction...</guimenuitem> -</menuchoice></term> -<listitem><para><action></action></para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<guimenu>Filter</guimenu> -<guisubmenu>Enhance</guisubmenu> -<guimenuitem>Mean Removal</guimenuitem> -</menuchoice></term> -<listitem><para><action>Sharpens the image or selection by aggravating color -borders.</action></para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<guimenu>Filter</guimenu> -<guisubmenu>Enhance</guisubmenu> -<guimenuitem>Sharpen</guimenuitem> -</menuchoice></term> -<listitem><para><action>Sharpens the image or selection.</action></para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<guimenu>Filter</guimenu> -<guisubmenu>Enhance</guisubmenu> -<guimenuitem>Unsharp Mask</guimenuitem> -</menuchoice></term> -<listitem><para><action>Applies an unsharp mask to the image or -selection.</action></para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<guimenu>Filter</guimenu> -<guisubmenu>Enhance</guisubmenu> -<guimenuitem>Wavelet Noise Reducer</guimenuitem> -</menuchoice></term> -<listitem><para><action>Reduces noise in the image or -selection.</action></para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<guimenu>Filter</guimenu> -<guisubmenu>Emboss</guisubmenu> -</menuchoice></term> -<listitem><para>Contains emboss filters.</para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<guimenu>Filter</guimenu> -<guisubmenu>Emboss</guisubmenu> -<guimenuitem>Emboss Horizontal & Vertical</guimenuitem> -</menuchoice></term> -<listitem><para><action>Embosses the image or selection on the two main -directions.</action></para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<guimenu>Filter</guimenu> -<guisubmenu>Emboss</guisubmenu> -<guimenuitem>Emboss with Variable Depth...</guimenuitem> -</menuchoice></term> -<listitem><para><action>Opens the <link -linkend="commands-dialogs-filters-emboss"><guilabel>Emboss</guilabel> -dialog</link>.</action></para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<guimenu>Filter</guimenu> -<guisubmenu>Emboss</guisubmenu> -<guimenuitem>Emboss in All Directions</guimenuitem> -</menuchoice></term> -<listitem><para><action>Embosses the image or -selection.</action></para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<guimenu>Filter</guimenu> -<guisubmenu>Emboss</guisubmenu> -<guimenuitem>Emboss Horizontal Only</guimenuitem> -</menuchoice></term> -<listitem><para><action>Embosses the image or selection on the horizontal axis -only.</action></para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<guimenu>Filter</guimenu> -<guisubmenu>Emboss</guisubmenu> -<guimenuitem>Emboss Laplascian</guimenuitem> -</menuchoice></term> -<listitem><para><action>Embosses the image or selection using the Laplace -technique.</action></para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<guimenu>Filter</guimenu> -<guisubmenu>Emboss</guisubmenu> -<guimenuitem>Emboss Vertical Only</guimenuitem> -</menuchoice></term> -<listitem><para><action>Embosses the image or selection on the vertical axis -only.</action></para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<guimenu>Filter</guimenu> -<guisubmenu>Map</guisubmenu> -</menuchoice></term> -<listitem><para>Contains map filters.</para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<guimenu>Filter</guimenu> -<guisubmenu>Map</guisubmenu> -<guimenuitem>Bumpmap...</guimenuitem> -</menuchoice></term> -<listitem><para><action>Opens the <link -linkend="commands-dialogs-filters-bumpmap"><guilabel>Bumpmap</guilabel> -dialog</link>.</action></para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<guimenu>Filter</guimenu> -<guisubmenu>Map</guisubmenu> -<guimenuitem>Round Corners...</guimenuitem> -</menuchoice></term> -<listitem><para><action>Opens the <link -linkend="commands-dialogs-filters-roundcorners"><guilabel>Round -Corners</guilabel> dialog</link> to round off the corners of the image or -selection.</action></para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<guimenu>Filter</guimenu> -<guisubmenu>Map</guisubmenu> -<guimenuitem>Small Tiles...</guimenuitem> -</menuchoice></term> -<listitem><para><action>Shrinks the image or selection and then tiles -it.</action></para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<guimenu>Filter</guimenu> -<guisubmenu>Other</guisubmenu> -</menuchoice></term> -<listitem><para>Contains miscellaneous filters.</para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<guimenu>Filter</guimenu> -<guisubmenu>Other</guisubmenu> -<guimenuitem>Lens Correction...</guimenuitem> -</menuchoice></term> -<listitem><para><action>Opens the <link -linkend="commands-dialogs-filters-lenscorrection">Lens Correction</link> -dialog to correct for lens anomalies.</action></para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<guimenu>Filter</guimenu> -<guisubmenu>Other</guisubmenu> -<guimenuitem>Random Noise...</guimenuitem> -</menuchoice></term> -<listitem><para><action>Opens the <link -linkend="commands-dialogs-filters-randomnoise">Random Noise</link> dialog to add -random noise to the image.</action></para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<guimenu>Filter</guimenu> -<guisubmenu>Other</guisubmenu> -<guimenuitem>Random Pick...</guimenuitem> -</menuchoice></term> -<listitem><para><action>Opens the <link -linkend="commands-dialogs-filters-randompick">Random Pick</link> dialog to -distort the image.</action></para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<guimenu>Filter</guimenu> -<guisubmenu>Other</guisubmenu> -<guimenuitem>Wave...</guimenuitem> -</menuchoice></term> -<listitem><para><action>Opens the <link -linkend="commands-dialogs-filters-wave">Wave</link> dialog to distort the -image</action></para></listitem> -</varlistentry> - - -<varlistentry> -<term><menuchoice> -<guimenu>Filter</guimenu> -<guimenuitem>Filters Gallery</guimenuitem> -</menuchoice></term> -<listitem><para><action>Opens the -<link linkend="commands-dialogs-filters-filtersgallery"><guilabel>Filters -Gallery</guilabel> dialog</link>.</action> This -shows previews of the various filters and allows for easy -comparison.</para></listitem> -</varlistentry> - -</variablelist> -</para> - -</sect2> - -<!-- ====== Scripts ============================================= --> - - -<sect2 id="commands-menus-scripts"> -<title>The <guimenu>Scripts</guimenu> Menu</title> -<para> -<variablelist> - -<varlistentry> -<term><menuchoice> -<guimenu>Scripts</guimenu> -<guimenuitem>Execute Script File</guimenuitem> -</menuchoice></term> -<listitem><para><action>Executes a script file.</action></para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<guimenu>Scripts</guimenu> -<guimenuitem>Script Manager</guimenuitem> -</menuchoice></term> -<listitem><para><action>Opens the <guilabel>Script Manager</guilabel> dialog. -</action></para></listitem> -</varlistentry> - -</variablelist> -</para> - -</sect2> - -<!-- ====== Settings ============================================ --> - -<sect2 id="commands-menus-settings"> -<title>The <guimenu>Settings</guimenu> Menu</title> -<para> -<variablelist> - -<varlistentry> -<term><menuchoice> -<guimenu>Settings</guimenu> -<guisubmenu>Toolbars</guisubmenu> -</menuchoice></term> -<listitem><para>Contains options to display or hide the various -toolbars.</para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<guimenu>Settings</guimenu> -<guisubmenu>Toolbars</guisubmenu> -<guimenuitem>File</guimenuitem> -</menuchoice></term> -<listitem><para><action>Displays or hides the <guilabel>File</guilabel> -toolbar.</action></para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<guimenu>Settings</guimenu> -<guisubmenu>Toolbars</guisubmenu> -<guimenuitem>Edit</guimenuitem> -</menuchoice></term> -<listitem><para><action>Displays or hides the <guilabel>Edit</guilabel> -toolbar.</action></para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<guimenu>Settings</guimenu> -<guisubmenu>Toolbars</guisubmenu> -<guimenuitem>Navigation</guimenuitem> -</menuchoice></term> -<listitem><para><action>Displays or hides the <guilabel>Navigation</guilabel> -toolbar.</action></para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<guimenu>Settings</guimenu> -<guisubmenu>Toolbars</guisubmenu> -<guimenuitem>&krita;</guimenuitem> -</menuchoice></term> -<listitem><para><action>Displays or hides the -<guilabel>&krita;</guilabel> toolbar.</action></para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<guimenu>Settings</guimenu> -<guisubmenu>Toolbars</guisubmenu> -<guimenuitem>Brushes and Stuff</guimenuitem> -</menuchoice></term> -<listitem><para><action>Displays or hides the -<guilabel>Brushes and Stuff</guilabel> toolbar.</action></para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<guimenu>Settings</guimenu> -<guimenuitem>Configure Shortcuts...</guimenuitem> -</menuchoice></term> -<listitem><para><action>Opens the <guilabel>Configure Shortcuts -</guilabel> dialog.</action> This dialog is common to most &kde; applications -and allows you to configure shortcuts for all actions &krita; has to -offer.</para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<guimenu>Settings</guimenu> -<guimenuitem>Configure Toolbars...</guimenuitem> -</menuchoice></term> -<listitem><para><action>Opens the <guilabel>Configure Toolbars</guilabel> -dialog.</action> This dialog is common to most &kde; applications -and allows you to configure &krita;'s toolbars.</para></listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice> -<guimenu>Settings</guimenu> -<guimenuitem>Configure &krita;...</guimenuitem> -</menuchoice></term> -<listitem><para><action>Opens the -<link linkend="settings-preferences"><guilabel>Preferences</guilabel> -dialog</link>.</action> You can configure &krita; here to match your personal -preferences.</para></listitem> -</varlistentry> - -</variablelist> -</para> - -</sect2> - - -<!-- ====== Help ================================================ --> - -<sect2 id="commands-menus-help"> -<title>The <guimenu>Help</guimenu> Menu</title> -&help.menu.documentation; -</sect2> - -</sect1> diff --git a/doc/krita/commands-palettes.docbook b/doc/krita/commands-palettes.docbook deleted file mode 100644 index 3661be60..00000000 --- a/doc/krita/commands-palettes.docbook +++ /dev/null @@ -1,769 +0,0 @@ -<sect1 id="commands-palettes"> -<title>Palettes</title> - -<para> -This section describes &krita;'s palettes. The palettes are usually found at -the right hand side of &krita;'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> diff --git a/doc/krita/commands-toolbars.docbook b/doc/krita/commands-toolbars.docbook deleted file mode 100644 index 05ddea55..00000000 --- a/doc/krita/commands-toolbars.docbook +++ /dev/null @@ -1,752 +0,0 @@ -<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> diff --git a/doc/krita/commands.docbook b/doc/krita/commands.docbook deleted file mode 100644 index 13ab46b0..00000000 --- a/doc/krita/commands.docbook +++ /dev/null @@ -1,14 +0,0 @@ -<chapter id="commands"> -<title>Command Reference</title> - -<para> -This chapter explains &krita;'s user interface in detail. Each of the menus, -toolbars, palettes, and dialogs will be discussed. -</para> - -&commands-menus; -&commands-toolbars; -&commands-palettes; -&commands-dialogs; - -</chapter> diff --git a/doc/krita/createdocument.png b/doc/krita/createdocument.png Binary files differdeleted file mode 100644 index 79047af8..00000000 --- a/doc/krita/createdocument.png +++ /dev/null diff --git a/doc/krita/credits.docbook b/doc/krita/credits.docbook deleted file mode 100644 index 9059e147..00000000 --- a/doc/krita/credits.docbook +++ /dev/null @@ -1,63 +0,0 @@ -<chapter id="credits"> - -<title>Credits and License</title> - -<para> -&krita; -</para> -<para> -Program copyright © 1999-2006 The &krita; Team -</para> - -<para> -Contributors: - -<itemizedlist> -<listitem><para>Adrian Page -<email>[email protected]</email></para></listitem> -<listitem><para>Andrew Richards -<email>[email protected]</email></para></listitem> -<listitem><para>Bart Coppens <email>[email protected]</email></para></listitem> -<listitem><para>Boudewijn Rempt -<email>[email protected]</email> (current maintainer)</para></listitem> -<listitem><para>Carsten Pfeiffer -<email>[email protected]</email></para></listitem> -<listitem><para>Casper Boemann <email>[email protected]</email></para></listitem> -<listitem><para>Cyrille Berger <email>[email protected]</email></para></listitem> -<listitem><para>Danny Allen -<email>[email protected]</email></para></listitem> -<listitem><para>Dirk Schoenberger -<email>[email protected]</email></para></listitem> -<listitem><para>Gábor Lehel -<email>[email protected]</email></para></listitem> -<listitem><para>John Califf -<email>[email protected]</email></para></listitem> -<listitem><para>Matthias Elter <email>[email protected]</email></para></listitem> -<listitem><para>Melchior Franz <email>[email protected]</email></para></listitem> -<listitem><para>Michael Koch <email>[email protected]</email></para></listitem> -<listitem><para>Michael Thaler -<email>[email protected]</email></para></listitem> -<listitem><para>Patrick Julien -<email>[email protected]</email></para></listitem> -<listitem><para>Roger Larsson -<email>[email protected]</email></para></listitem> -<listitem><para>Sven Langkamp -<email>[email protected]</email></para></listitem> -</itemizedlist> -</para> - -<para> -Documentation copyright © 2005-2006 Boudewijn Rempt -<email>[email protected]</email>, Sander Koning -<email>[email protected]</email> -with contributions from Casper Boemann, Bart Coppens, Cyrille Berger, Burkhard -Lueck, and Anne-Marie Mahfouf. -</para> - -<!-- TRANS:CREDIT_FOR_TRANSLATORS --> -&underFDL; <!-- FDL: do not remove --> -&underGPL; <!-- GPL License --> - -</chapter> - - diff --git a/doc/krita/crocusses-autocontrast.png b/doc/krita/crocusses-autocontrast.png Binary files differdeleted file mode 100644 index 3e73db57..00000000 --- a/doc/krita/crocusses-autocontrast.png +++ /dev/null diff --git a/doc/krita/crocusses-blur.png b/doc/krita/crocusses-blur.png Binary files differdeleted file mode 100644 index 3b31dbe1..00000000 --- a/doc/krita/crocusses-blur.png +++ /dev/null diff --git a/doc/krita/crocusses-brightnesscontrast.png b/doc/krita/crocusses-brightnesscontrast.png Binary files differdeleted file mode 100644 index b60ad77d..00000000 --- a/doc/krita/crocusses-brightnesscontrast.png +++ /dev/null diff --git a/doc/krita/crocusses-bumpmap.png b/doc/krita/crocusses-bumpmap.png Binary files differdeleted file mode 100644 index cd1037c1..00000000 --- a/doc/krita/crocusses-bumpmap.png +++ /dev/null diff --git a/doc/krita/crocusses-coloradjustment.png b/doc/krita/crocusses-coloradjustment.png Binary files differdeleted file mode 100644 index 8efbc9db..00000000 --- a/doc/krita/crocusses-coloradjustment.png +++ /dev/null diff --git a/doc/krita/crocusses-colortoalpha.png b/doc/krita/crocusses-colortoalpha.png Binary files differdeleted file mode 100644 index 232aab29..00000000 --- a/doc/krita/crocusses-colortoalpha.png +++ /dev/null diff --git a/doc/krita/crocusses-colortransfer.png b/doc/krita/crocusses-colortransfer.png Binary files differdeleted file mode 100644 index a6abfb6a..00000000 --- a/doc/krita/crocusses-colortransfer.png +++ /dev/null diff --git a/doc/krita/crocusses-customconvolution.png b/doc/krita/crocusses-customconvolution.png Binary files differdeleted file mode 100644 index 6a1da4fc..00000000 --- a/doc/krita/crocusses-customconvolution.png +++ /dev/null diff --git a/doc/krita/crocusses-desaturate.png b/doc/krita/crocusses-desaturate.png Binary files differdeleted file mode 100644 index e2add125..00000000 --- a/doc/krita/crocusses-desaturate.png +++ /dev/null diff --git a/doc/krita/crocusses-edgebottom.png b/doc/krita/crocusses-edgebottom.png Binary files differdeleted file mode 100644 index 4c42077f..00000000 --- a/doc/krita/crocusses-edgebottom.png +++ /dev/null diff --git a/doc/krita/crocusses-edgeleft.png b/doc/krita/crocusses-edgeleft.png Binary files differdeleted file mode 100644 index 4b384320..00000000 --- a/doc/krita/crocusses-edgeleft.png +++ /dev/null diff --git a/doc/krita/crocusses-edgeright.png b/doc/krita/crocusses-edgeright.png Binary files differdeleted file mode 100644 index e2071f65..00000000 --- a/doc/krita/crocusses-edgeright.png +++ /dev/null diff --git a/doc/krita/crocusses-embossall.png b/doc/krita/crocusses-embossall.png Binary files differdeleted file mode 100644 index eb937422..00000000 --- a/doc/krita/crocusses-embossall.png +++ /dev/null diff --git a/doc/krita/crocusses-embosshorvert.png b/doc/krita/crocusses-embosshorvert.png Binary files differdeleted file mode 100644 index 685e34b1..00000000 --- a/doc/krita/crocusses-embosshorvert.png +++ /dev/null diff --git a/doc/krita/crocusses-embossvariable.png b/doc/krita/crocusses-embossvariable.png Binary files differdeleted file mode 100644 index cfeabd1a..00000000 --- a/doc/krita/crocusses-embossvariable.png +++ /dev/null diff --git a/doc/krita/crocusses-gaussianblur.png b/doc/krita/crocusses-gaussianblur.png Binary files differdeleted file mode 100644 index bf1633eb..00000000 --- a/doc/krita/crocusses-gaussianblur.png +++ /dev/null diff --git a/doc/krita/crocusses-gaussiannoise.png b/doc/krita/crocusses-gaussiannoise.png Binary files differdeleted file mode 100644 index cc0605c5..00000000 --- a/doc/krita/crocusses-gaussiannoise.png +++ /dev/null diff --git a/doc/krita/crocusses-invert.png b/doc/krita/crocusses-invert.png Binary files differdeleted file mode 100644 index 9f1d9eb5..00000000 --- a/doc/krita/crocusses-invert.png +++ /dev/null diff --git a/doc/krita/crocusses-lenscorrection.png b/doc/krita/crocusses-lenscorrection.png Binary files differdeleted file mode 100644 index 7bc8087f..00000000 --- a/doc/krita/crocusses-lenscorrection.png +++ /dev/null diff --git a/doc/krita/crocusses-maximizechannel.png b/doc/krita/crocusses-maximizechannel.png Binary files differdeleted file mode 100644 index 9e6dc3f9..00000000 --- a/doc/krita/crocusses-maximizechannel.png +++ /dev/null diff --git a/doc/krita/crocusses-meanremoval.png b/doc/krita/crocusses-meanremoval.png Binary files differdeleted file mode 100644 index a1df0ac0..00000000 --- a/doc/krita/crocusses-meanremoval.png +++ /dev/null diff --git a/doc/krita/crocusses-minimizechannel.png b/doc/krita/crocusses-minimizechannel.png Binary files differdeleted file mode 100644 index 14e9fe07..00000000 --- a/doc/krita/crocusses-minimizechannel.png +++ /dev/null diff --git a/doc/krita/crocusses-oilpaint.png b/doc/krita/crocusses-oilpaint.png Binary files differdeleted file mode 100644 index d005ef3e..00000000 --- a/doc/krita/crocusses-oilpaint.png +++ /dev/null diff --git a/doc/krita/crocusses-pixelize.png b/doc/krita/crocusses-pixelize.png Binary files differdeleted file mode 100644 index 3fb5ba60..00000000 --- a/doc/krita/crocusses-pixelize.png +++ /dev/null diff --git a/doc/krita/crocusses-raindrops.png b/doc/krita/crocusses-raindrops.png Binary files differdeleted file mode 100644 index bdee271c..00000000 --- a/doc/krita/crocusses-raindrops.png +++ /dev/null diff --git a/doc/krita/crocusses-randomnoise.png b/doc/krita/crocusses-randomnoise.png Binary files differdeleted file mode 100644 index d7525a3f..00000000 --- a/doc/krita/crocusses-randomnoise.png +++ /dev/null diff --git a/doc/krita/crocusses-randompick.png b/doc/krita/crocusses-randompick.png Binary files differdeleted file mode 100644 index d3fb496d..00000000 --- a/doc/krita/crocusses-randompick.png +++ /dev/null diff --git a/doc/krita/crocusses-roundcorners.png b/doc/krita/crocusses-roundcorners.png Binary files differdeleted file mode 100644 index d997aca7..00000000 --- a/doc/krita/crocusses-roundcorners.png +++ /dev/null diff --git a/doc/krita/crocusses-sharpen.png b/doc/krita/crocusses-sharpen.png Binary files differdeleted file mode 100644 index 18998da9..00000000 --- a/doc/krita/crocusses-sharpen.png +++ /dev/null diff --git a/doc/krita/crocusses-smalltiles.png b/doc/krita/crocusses-smalltiles.png Binary files differdeleted file mode 100644 index 0dcd880d..00000000 --- a/doc/krita/crocusses-smalltiles.png +++ /dev/null diff --git a/doc/krita/crocusses-sobel.png b/doc/krita/crocusses-sobel.png Binary files differdeleted file mode 100644 index 90506e6a..00000000 --- a/doc/krita/crocusses-sobel.png +++ /dev/null diff --git a/doc/krita/crocusses-topedge.png b/doc/krita/crocusses-topedge.png Binary files differdeleted file mode 100644 index e52c0878..00000000 --- a/doc/krita/crocusses-topedge.png +++ /dev/null diff --git a/doc/krita/crocusses-unsharpmask.png b/doc/krita/crocusses-unsharpmask.png Binary files differdeleted file mode 100644 index 7760cb74..00000000 --- a/doc/krita/crocusses-unsharpmask.png +++ /dev/null diff --git a/doc/krita/crocusses-wave.png b/doc/krita/crocusses-wave.png Binary files differdeleted file mode 100644 index 053cd4e6..00000000 --- a/doc/krita/crocusses-wave.png +++ /dev/null diff --git a/doc/krita/crocusses-waveletnoise.png b/doc/krita/crocusses-waveletnoise.png Binary files differdeleted file mode 100644 index 4088373d..00000000 --- a/doc/krita/crocusses-waveletnoise.png +++ /dev/null diff --git a/doc/krita/crocusses.png b/doc/krita/crocusses.png Binary files differdeleted file mode 100644 index 9b8913c3..00000000 --- a/doc/krita/crocusses.png +++ /dev/null diff --git a/doc/krita/developers-plugins.docbook b/doc/krita/developers-plugins.docbook deleted file mode 100644 index 58dd345e..00000000 --- a/doc/krita/developers-plugins.docbook +++ /dev/null @@ -1,1553 +0,0 @@ -<sect1 id="developers-plugins"> -<title>Developing &krita; Plugins</title> - -<sect2 id="developers-plugins-introduction"> -<title>Introduction</title> - -<para> -&krita; is infinitely extensible with plugins. Tools, filters, large -chunks of the user interface and even colorspaces are plugins. In fact, -&krita; recognizes these six types of plugins: -</para> - -<itemizedlist> -<listitem><para>colorspaces — these define the channels that constitute -a single pixel</para></listitem> -<listitem><para>tools — anything that is done with a mouse or tablet -input device</para></listitem> -<listitem><para>paint operations — pluggable painting effects for -tools</para></listitem> -<listitem><para>image filters — change all pixels, or just the selected -pixels in a layer</para></listitem> -<listitem><para>viewplugins — extend Krita’s user interface with new -dialog boxes, palettes and operations</para></listitem> -<listitem><para>import/export filters — read and write all kinds of -image formats</para></listitem> -</itemizedlist> - -<para> -&krita; itself consists of three layered libraries and a directory with some -common support classes: kritacolor, kritaimage and kritaui. Within -&krita;, objects can by identified by a <classname>KisID</classname>, that is -the combination of a unique untranslated string (used when saving, for -instance) and a translated string for GUI purposes. -</para><para> -A word on compatibility: &krita; is still in development. From &krita; 1.5 to -1.6 not many API changes are expected, but there may be some. From &krita; 1.6 -to 2.0 we will move from &Qt;3 to &Qt;4, from &kde;3 to &kde;4, from -<command>automake</command> to <command>cmake</command>: many changes are to -be expected. If you develop a plugin for &krita; and choose to do so in -&krita;’s subversion repository, chances are excellent that we’ll help you -porting. These changes may also render parts of this document out of date. -Always check with the latest API documentation or the header files installed -on your system. -</para> - -<sect3 id="developers-plugins-introduction-kritacolor"> -<title>KritaColor</title> - -<para> -The first library is kritacolor. This library loads the colorspace plugins. -</para><para> -A colorspace plugin should implement the <classname>KisColorSpace</classname> -abstract class or, if the basic capabilities of the new colorspace will be -implemented by <command>lcms</command> (<ulink url="http://www.littlecms.com/" -/>), extend <classname>KisAbstractColorSpace</classname>. The kritacolor -library could be used from other applications and does not depend on -&koffice;. -</para> -</sect3> - -<sect3 id="developers-plugins-introduction-kritaimage"> -<title>KritaImage</title> - -<para> -The libkritaimage library loads the filter and paintop plugins and is -responsible for working with image data: changing pixels, compositing and -painting. Brushes, palettes, gradients and patterns are also loaded by -libkritaimage. It is our stated goal to make libkritaimage independent of -&koffice;, but we currently share the gradient loading code with &koffice;. -</para><para> -It is not easy at the moment to add new types of resources such as brushes, -palettes, gradients or patterns to &krita;. (Adding new brushes, palettes, -gradients and patterns is easy, of course.) &krita; follows the guidelines of -the Create project (<ulink url="http://create.freedesktop.org/" />) for these. -Adding support for Photoshop's brush file format needs libkritaimage hacking; -adding more gimp brush data files not. -</para><para> -<classname>KritaImage</classname> loads the following types of plugins: -</para> - -<itemizedlist> -<listitem><para>&krita; filters must extend and implement the abstract class -<classname>KisFilter</classname>, -<classname>KisFilterConfiguration</classname> and possibly -<classname>KisFilterConfigurationWidget</classname>. -An example of a filter is Unsharp Mask.</para></listitem> -<listitem><para>Paint operations or paintops are the set of operations -painting tools suchs as freehand or circle have access to. Examples of -paintops are pen, airbrush or eraser. Paintops should extend the -<classname>KisPaintop</classname> base class. Examples of new paintops could -be a chalk brush, an oilpaint brush or a complex programmable -brush.</para></listitem> -</itemizedlist> - -</sect3> - -<sect3 id="developers-plugins-introduction-kritaui"> -<title>KritaUI</title> - -<para> -The libkritaui library loads the tool and viewplugins. This library is a -&koffice; Part, but also contains a number of widgets that are useful for -graphics applications. Maybe we will have to split this library in kritapart -and kritaui in the 2.0 release. For now, script writers are not given access -to this library and plugin writers are only allowed to use this library when -writing tools or viewplugins. <classname>KritaUI</classname> loads the -following types of plugins: -</para> - -<itemizedlist> -<listitem><para>Tools are derived from <classname>KisTool</classname> or one -of the specialized tool base classes such as -<classname>KisToolPaint</classname>, <classname>KisToolNonPaint</classname> or -<classname>KisToolFreehand</classname>. A new tool could be a foreground -object selection tool. Painting tools (and that includes tools that paint on -the selection) can use any paintop to determine the way pixels are -changed.</para></listitem> -<listitem><para>Viewplugins are ordinary KParts that use -<command>kxmlgui</command> to insinuate themselves into &krita;'s user -interface. Menu options, dialogs, toolbars — any kind of user interface -extension can be a viewplugin. In fact, important functionality like &krita;'s -scripting support is written as a viewplugin.</para></listitem> -</itemizedlist> - -</sect3> - -<sect3 id="developers-plugins-introduction-importexport"> -<title>Import/Export filters</title> - -<para> -Import/Export filters are &koffice; filters, subclasses of -<classname>KoFilter</classname>. Filters read and write image data in any of -the myriad image formats in existence. And example of a new &krita; -import/export filter could be a PDF filter. Filters are loaded by the -&koffice; libraries. -</para> - -</sect3> - -</sect2> - -<sect2 id="developers-plugins-creating"> -<title>Creating plugins</title> - -<para> -Plugins are written in C++ and can use all of &kde; and &Qt; and the &krita; -developer API. Only viewplugins should use the &koffice; API. Don’t worry: -&krita;’s API’s are quite clear and rather extensively documented (for free -software) and coding your first filter is really easy. -</para><para> -If you do not want to use C++, you can write scripts in Python or Ruby; that -is a different thing altogether, though, and you cannot currently write tools, -colorspaces, paintops or import/export filters as scripts. -</para><para> -&krita; plugins use &kde;'s parts mechanism for loading, so the parts -documentation at <ulink url="http://developer.kde.org" /> is relevant here, too. -</para><para> -Your distribution should have either installed the relevant header files with -&krita; itself, or might have split the header files into either a &koffice; -dev or a &krita; dev package. You can find the API documentation for &krita;'s -public API at <ulink url="http://koffice.org/developer/apidocs/krita/html/" />. -</para> - -<sect3 id="developers-plugins-creating-automake"> -<title>Automake (and CMake)</title> - -<para> -&kde; 3.x and thus &koffice; 1.5 and 1.6 use <command>automake</command>; -&kde; 4.0 and &koffice; 2.0 use <command>cmake</command>. This tutorial -describes the <command>automake</command> way of creating plugins. -<!-- If I have not updated this manual when we release KOffice 2.0, please -remind me to do so. --> -</para><para> -Plugins are &kde; modules and should be tagged as such in their -<filename>Makefile.am</filename>. Filters, tools, paintops, colorspaces and -import/export filters need <literal role="extension">.desktop</literal> files; -viewplugins need a <application>KXMLGui</application> -<filename>pluginname.rc</filename> file in addition. The easiest way to get -started is to checkout the krita-plugins project from the &koffice; Subversion -repository and use it as the basis for your own project. We intend to prepare -a skeleton &krita; plugin pack for KDevelop, but haven’t had the time to do -so yet. -</para> - -<sect4 id="d-p-c-a-makefile"> -<title><filename>Makefile.am</filename></title> - -<para> -Let's look at the skeleton for a plugin module. First, the -<filename>Makefile.am</filename>. This is what &kde; uses to generate the -makefile that builds your plugin: - -<programlisting> -kde_services_DATA = kritaLIBRARYNAME.desktop - -INCLUDES = $(all_includes) - -kritaLIBRARYNAME_la_SOURCES = sourcefile1.cc sourcefile2.cc - -kde_module_LTLIBRARIES = kritaLIBRARYNAME.la -noinst_HEADERS = header1.h header2.h - -kritaLIBRARYNAME_la_LDFLAGS = $(all_libraries) -module $(KDE_PLUGIN) -kritaLIBRARY_la_LIBADD = -lkritacommon - -kritaextensioncolorsfilters_la_METASOURCES = AUTO -</programlisting> - -This is the makefile for a filter plugin. Replace -<replaceable>LIBRARYNAME</replaceable> with the name of your work, and you are -set. -</para><para> -If your plugin is a viewplugin, you will likely also install a <literal -role="extension">.rc</literal> file with entries for menubars and toolbars. -Likewise, you may need to install cursors and icons. That is all done through -the ordinary &kde; <filename>Makefile.am</filename> magic incantantions: - -<programlisting> -kritarcdir = $(kde_datadir)/krita/kritaplugins -kritarc_DATA = LIBRARYNAME.rc -EXTRA_DIST = $(kritarc_DATA) - -kritapics_DATA = \ - bla.png \ - bla_cursor.png -kritapicsdir = $(kde_datadir)/krita/pics -</programlisting> - -</para> -</sect4> - -<sect4 id="d-p-c-a-desktop"> -<title>Desktop files</title> - -<para> -The <literal role="extension">.desktop</literal> file announces the type of plugin: - -<programlisting> -[Desktop Entry] -Encoding=UTF-8 -Icon= -Name=User-visible Name -ServiceTypes=Krita/Filter -Type=Service -X-KDE-Library=kritaLIBRARYNAME -X-KDE-Version=2 -</programlisting> -</para><para> -Possible ServiceTypes are: -</para> - -<itemizedlist> -<listitem><para>Krita/Filter</para></listitem> -<listitem><para>Krita/Paintop</para></listitem> -<listitem><para>Krita/ViewPlugin</para></listitem> -<listitem><para>Krita/Tool</para></listitem> -<listitem><para>Krita/ColorSpace</para></listitem> -</itemizedlist> - -<para> -File import and export filters use the generic &koffice; filter framework and -need to be discussed separately. -</para> -</sect4> - -<sect4 id="d-p-c-a-boilerplate"> -<title>Boilerplate</title> - -<para> -You also need a bit of boilerplate code that is called by the &kde; part -framework to instantiate the plugin — a header file and an implementation file. -</para><para> -A header file: -<programlisting> -#ifndef TOOL_STAR_H_ -#define TOOL_STAR_H_ - -#include <kparts/plugin.h> - -/** -* A module that provides a star tool. -*/ -class ToolStar : public KParts::Plugin -{ - Q_OBJECT -public: - ToolStar(QObject *parent, const char *name, const QStringList &); - virtual ~ToolStar(); - -}; - -#endif // TOOL_STAR_H_ -</programlisting> -</para> - -<para> -And an implementation file: -<programlisting> -#include <kinstance.h> -#include <kgenericfactory.h> - -#include <kis_tool_registry.h> - -#include "tool_star.h" -#include "kis_tool_star.h" - - -typedef KGenericFactory<ToolStar> ToolStarFactory; -K_EXPORT_COMPONENT_FACTORY( kritatoolstar, ToolStarFactory( "krita" ) ) - - -ToolStar::ToolStar(QObject *parent, const char *name, const QStringList &) - : KParts::Plugin(parent, name) -{ - setInstance(ToolStarFactory::instance()); - if ( parent->inherits("KisToolRegistry") ) - { - KisToolRegistry * r = dynamic_cast<KisToolRegistry*>( parent ); - r -> add(new KisToolStarFactory()); - } - -} - -ToolStar::~ToolStar() -{ -} - -#include "tool_star.moc" -</programlisting> -</para> -</sect4> - -<sect4 id="d-p-c-a-registries"> -<title>Registries</title> - -<para> -Tools are loaded by the tool registry and register themselves with the tool -registry. Plugins like tools, filters and paintops are loaded only once: view -plugins are loaded for every view that is created. Note that we register -factories, generally speaking. For instance, with tools a new instance of a -tool is created for every pointer (mouse, stylus, eraser) for every few. And a -new paintop is created whenever a tool gets a mouse-down event. -</para> - -<para> -Filters call the filter registry: -<programlisting> - if (parent->inherits("KisFilterRegistry")) { - KisFilterRegistry * manager = dynamic_cast<KisFilterRegistry *>(parent); - manager->add(new KisFilterInvert()); - } -</programlisting> -</para><para> -Paintops the paintop registry: -<programlisting> - if ( parent->inherits("KisPaintOpRegistry") ) { - KisPaintOpRegistry * r = dynamic_cast<KisPaintOpRegistry*>(parent); - r -> add ( new KisSmearyOpFactory ); - } -</programlisting> -</para><para> -Colorspaces the colorspace registry (with some complications): -<programlisting> - if ( parent->inherits("KisColorSpaceFactoryRegistry") ) { - KisColorSpaceFactoryRegistry * f = dynamic_cast<isColorSpaceFactoryRegistry*>(parent); - - KisProfile *defProfile = new KisProfile(cmsCreate_sRGBProfile()); - f->addProfile(defProfile); - - KisColorSpaceFactory * csFactory = new KisRgbColorSpaceFactory(); - f->add(csFactory); - - KisColorSpace * colorSpaceRGBA = new KisRgbColorSpace(f, 0); - KisHistogramProducerFactoryRegistry::instance() -> add( - new KisBasicHistogramProducerFactory<KisBasicU8HistogramProducer> - (KisID("RGB8HISTO", i18n("RGB8 Histogram")), colorSpaceRGBA) ); - } -</programlisting> -</para><para> -View plugins do not have to register themselves, and they get access to a -<classname>KisView</classname> object: -<programlisting> - if ( parent->inherits("KisView") ) - { - setInstance(ShearImageFactory::instance()); - setXMLFile(locate("data","kritaplugins/shearimage.rc"), true); - - (void) new KAction(i18n("&Shear Image..."), 0, 0, this, SLOT(slotShearImage()), actionCollection(), "shearimage"); - (void) new KAction(i18n("&Shear Layer..."), 0, 0, this, SLOT(slotShearLayer()), actionCollection(), "shearlayer"); - - m_view = (KisView*) parent; - } -</programlisting> -</para><para> -Remember that this means that a view plugin will be created for every view the -user creates: splitting a view means loading all view plugins again. -</para> -</sect4> - -<sect4 id="d-p-c-a-versioning"> -<title>Plugin versioning</title> - -<para> -&krita; 1.5 loads plugins with <literal>X-KDE-Version=2</literal> set in the -<literal role="extension">.desktop</literal> file. &krita; 1.6 plugins will -probably be binary incompatible with 1.5 plugins and will need the version -number 3. &krita; 2.0 plugins will need the version number 3. Yes, this is not -entirely logical. -</para> - -</sect4> -</sect3> -</sect2> - -<sect2 id="developers-plugins-colorspaces"> -<title>Colorspaces</title> - -<para> -Colorspaces implement the <classname>KisColorSpace</classname> pure virtual -class. There are two types of colorspaces: those that can use -<command>lcms</command> for transformations between colorspaces, and those -that are too weird for <command>lcms</command> to handle. Examples of the -first are cmyk, rgb, yuv. An example of the latter is watercolor or wet & -sticky. Colorspaces that use <command>lcms</command> can be derived from -<classname>KisAbstractColorSpace</classname>, or of one of the base classes -that are specialized for a certain number of bits per channel. -</para><para> -Implementing a colorspace is pretty easy. The general principle is that -colorspaces work on a simple array of bytes. The interpretation of these bytes -is up to the colorspace. For instance, a pixel in 16-bit GrayA consists of -four bytes: two bytes for the gray value and two bytes for the alpha value. -You are free to use a struct to work with the memory layout of a pixel in your -colorspace implementation, but that representation is not exported. The only -way the rest of &krita; can know what channels and types of channels your -colorspace pixels consist of is through the -<classname>KisChannelInfo</classname> class. -</para><para> -Filters and paintops make use of the rich set of methods offered by -<classname>KisColorSpace</classname> to do their work. In many cases, the -default implementation in <classname>KisAbstractColorSpace</classname> will -work, but more slowly than a custom implementation in your own colorspace -because <classname>KisAbstractColorSpace</classname> will convert all pixels -to 16-bit L*a*b and back. -</para> - -<sect3 id="developers-plugins-colorspaces-kischannelinfo"> -<title><classname>KisChannelInfo</classname></title> - -<programlisting> -(http://websvn.kde.org/trunk/koffice/krita/kritacolor/kis_channelinfo.h) -</programlisting> -<para> -This class defines the channels that make up a single pixel in a particular -colorspace. A channel has the following important characteristics: -</para> -<itemizedlist> -<listitem><para>a name for display in the user interface</para></listitem> -<listitem><para>a position: the byte where the bytes representing this channel -start in the pixel.</para></listitem> -<listitem><para>a type: color, alpha, substance or substrate. Color is plain -color, alpha is see-throughishness, substance is a representation of amount of -pigment or things like that, substrate is the representation of the canvas. -(Note that this may be refactored at the drop of a hat.)</para></listitem> -<listitem><para>a valuetype: byte, short, integer, float — or -other.</para></listitem> -<listitem><para>size: the number of bytes this channel takes</para></listitem> -<listitem><para>color: a <classname>QColor</classname> representation of this -channel for user interface visualization, for instance in -histograms.</para></listitem> -<listitem><para>an abbreviaton for use in the GUI when there’s not much -space</para></listitem> -</itemizedlist> -</sect3> - -<sect3 id="developers-plugins-colorspaces-kiscompositeop"> -<title><classname>KisCompositeOp</classname></title> - -<para> -As per original Porter-Duff, there are many ways of combining pixels to get a -new color. The <classname>KisCompositeOp</classname> class defines most of -them: this set is not easily extensible except by hacking the kritacolor -library. -</para><para> -A colorspace plugin can support any subset of these possible composition -operations, but the set must always include "OVER" (same as "NORMAL") and -"COPY". The rest are more or less optional, although more is better, of -course. -</para> -</sect3> - -<sect3 id="developers-plugins-colorspaces-kiscolorspace"> -<title><classname>KisColorSpace</classname></title> - -<para> -The methods in the <classname>KisColorSpace</classname> pure virtual classs -can be divided into a number of groups: conversion, identification and -manipulation. -</para><para> -All classes must be able to convert a pixel from and to 8 bit RGB (i.e., a -<classname>QColor</classname>), and preferably also to and from 16 bit L*a*b. -Additionally, there is a method to convert to any colorspace from the current -colorspace. -</para><para> -Colorspaces are described by the <classname>KisChannelInfo</classname> vector, -number of channels, number of bytes in a single pixel, whether it supports -High Dynamic Range images and more. -</para><para> -Manipulation is for instance the combining of two pixels in a new -pixel: bitBlt, darkening or convolving of pixels. -</para><para> -Please consult the API documentation for a full description of all methods you -need to implement in a colorspace. -</para><para> -<classname>KisAbstractColorSpace</classname> implements many of the virtual -methods of <classname>KisColorSpace</classname> using functions from the -<command>lcms</command> library. On top of -<classname>KisAbstractColorSpace</classname> there are base colorspace classes -for 8 and 16 bit integer and 16 and 32 bit float colorspaces that define -common operations to move between bit depths. -</para> - -</sect3> -</sect2> - -<sect2 id="developers-plugins-filters"> -<title>Filters</title> - -<para> -Filters are plugins that examine the pixels in a layer and them make changes -to them. Although &krita; uses an efficient tiled memory backend to store -pixels, filter writers do not have to bother with that. When writing a filter -plugin for the &Java; imaging API, Photoshop or The Gimp, you need to take care -of tile edges and <quote>cobble</quote> tiles together: &krita; hides that -implementation detail. -</para> -<note><para>Note that it is theoretically easy to replace the current tile -image data storage backend with another backend, but that backens are not true -plugins at the moment, for performance reasons.</para></note> -<para> -&krita; uses iterators to read and write pixel values. Alternatively, you can -read a block of pixels into a memory buffer, mess with it and then write it -back as a block. But that is not necessarily more efficient, it may even be -slower than using the iterators; it may just be more convenient. See the API -documentation. -</para><para> -&krita; images are composed of layers, of which there are currently four -kinds: paint layers, group layers, adjustment layers (that contain a filter -that is applied dynamically to layers below the adjustment layer) and part -layers. Filters always operate on paint layers. Paint layers contain paint -devices, of the class <classname>KisPaintDevice</classname>. A paint device in -its turn gives access to the actual pixels. -</para><para> -<classname>PaintDevice</classname>s are generally passed around wrapped in -shared pointers. A shared pointer keeps track of in how many places the paint -device is currently used and deletes the paint device when it is no longer -used anywhere. You recognize the shared pointer version of a paint device -through its <literal>SP</literal> suffix. Just remember that you never have to -explicitly delete a <classname>KisPaintDeviceSP</classname>. -</para><para> -Let's examine a very simple filter, one that inverts every pixel. The code for -this filter is in the <filename -class="directory">koffice/krita/plugins/filters/example</filename> directory. -The main method is -<programlisting> -KisFilterInvert::process(KisPaintDeviceSP src, KisPaintDeviceSP dst, - KisFilterConfiguration* /*config*/, const QRect& rect). -</programlisting> -The function gets passed two paint devices, a configuration object (which is -not used in this simple filter) and a <varname>rect</varname>. The -<varname>rect</varname> describes the area of the -paint device which the filter should act on. This area is described by -integers, which means no sub-pixel accuracy. -</para><para> -The <varname>src</varname> paint device is for reading from, the -<varname>dst</varname> paint device for writing to. These parameters may point -to the same actual paint device, or be two different paint devices. (Note: -this may change to only one paint device in the future.) -</para><para> -Now, let's look at the code line by line: -</para> -<programlisting> -void KisFilterInvert::process(KisPaintDeviceSP src, KisPaintDeviceSP dst, - KisFilterConfiguration* /*config*/, const QRect& rect) -{ - Q_ASSERT(src != 0); - Q_ASSERT(dst != 0); - - KisRectIteratorPixel srcIt = src->createRectIterator(rect.x(), rect.y(), rect.width(), rect.height(), false); <co id="invert1" /> - KisRectIteratorPixel dstIt = dst->createRectIterator(rect.x(), rect.y(), rect.width(), rect.height(), true ); <co id="invert2" /> - - int pixelsProcessed = 0; - setProgressTotalSteps(rect.width() * rect.height()); - - KisColorSpace * cs = src->colorSpace(); - Q_INT32 psize = cs->pixelSize(); - - while( ! srcIt.isDone() ) - { - if(srcIt.isSelected()) <co id="invert3" /> - { - memcpy(dstIt.rawData(), srcIt.oldRawData(), psize); <co id="invert4" /> - - cs->invertColor( dstIt.rawData(), 1); <co id="invert5" /> - } - setProgress(++pixelsProcessed); - ++srcIt; - ++dstIt; - } - setProgressDone(); // Must be called even if you don't really support progression -} -</programlisting> - -<calloutlist> -<callout arearefs="invert1"> -<para>This creates an iterator to read the existing pixels. Krita has three -types of iterators: horizontal, vertical and rectangular. The rect iterator -takes the most efficient path through the image data, but does not guarantee -anything about the location of the next pixel it returns. That means that you -cannot be sure that the pixel you will retrieve next will be adjacent to the -pixel you just got. The horizontal and vertical line iterators do guarantee -the location of the pixels they return. -</para></callout> -<callout arearefs="invert2"><para> -(2) We create the destination iterator with the <literal>write</literal> -setting to <literal>true</literal>. This means that if the destination paint -device is smaller than the rect we write, it will automatically be enlarged to -fit every pixel we iterate over. Note that we have got a potential bug here: -if <varname>dst</varname> and <varname>src</varname> are not the same device, -then it is quite possible that the pixels returned by the iterators do not -correspond. For every position in the iterator, <varname>src</varname> may be, -for example, at 165,200, while <varname>dst</varname> could be at 20,8 — -and therefore the copy we perform below may distort the image... -</para></callout> -<callout arearefs="invert3"><para> -Want to know if a pixel is selected? That is easy — use the -<methodname>isSelected</methodname> method. But selectedness is not a binary -property of a pixel, a pixel can be half selected, barely selected or almost -completely selected. That value you can also got from the iterator. Selections -are actually a mask paint device with a range between 0 and 255, where 0 is -completely unselected and 255 completely selected. The iterator has two -methods: <methodname>isSelected()</methodname> and -<methodname>selectedNess()</methodname>. The first returns true if a pixel is -selected to any extent (i.e., the mask value is greater than 1), the other -returns the maskvalue. -</para></callout> -<callout arearefs="invert4"><para> -As noted above, this <literal>memcpy</literal> is a big bad bug... -<methodname>rawData()</methodname> returns the array of bytes which is the -current state of the pixel; <methodname>oldRawData()</methodname> returns the -array of bytes as it was before we created the iterator. However, we may be -copying the wrong pixel here. In actual practice, that will not happen too -often, unless <varname>dst</varname> already exists and is not aligned with -<varname>src</varname>. -</para></callout> -<callout arearefs="invert5"><para> -But this is correct: instead of figuring out which byte represents which -channel, we use a function supplied by all colorspaces to invert the current -pixel. The colorspaces have a lot of pixel operations you can make use of. -</para></callout> -</calloutlist> - -<para> -This is not all there is to creating a filter. Filters have two other -important components: a configuration object and a configuration widget. The -two interact closely. The configuration widget creates a configuration object, -but can also be filled from a pre-existing configuration object. Configuration -objects can represtent themselves as XML and can be created from XML. That is -what makes adjustment layers possible. -</para> - -<sect3 id="developers-plugins-filters-iterators"> -<title>Iterators</title> - -<para> -There are three types of iterators: -</para> - -<itemizedlist> -<listitem><para>Horizontal lines</para></listitem> -<listitem><para>Vertical lines</para></listitem> -<listitem><para>Rectangular iterors</para></listitem> -</itemizedlist> - -<para> -The horizontal and vertical line iterators have a method to move the iterator -to the next row or column: <methodname>nextRow()</methodname> and -<methodname>nextCol()</methodname>. Using these is much faster than creating a -new iterator for every line or column. -</para><para> -Iterators are thread-safe in &krita;, so it is possible to divide the work -over multiple threads. However, future versions of &krita; will use the -<methodname>supportsThreading()</methodname> method to determine whether your -filter can be applied to chunks of the image (&ie;, all pixels modified -independently, instead of changed by some value determined from an examination -of all pixels in the image) and automatically thread the execution your -filter. -</para> -</sect3> - -<sect3 id="developers-plugins-filters-kisfilterconfiguration"> -<title><classname>KisFilterConfiguration</classname></title> - -<para> -<classname>KisFilterConfiguration</classname> is a structure that is used to -save filter settings to disk, for instance for adjustment layers. The -scripting plugin uses the property map that’s at the back of -<classname>KisFilterConfigaration</classname> to make it possible to script -filters. Filters can provide a custom widget that &krita; will show in the -filters gallery, the filter preview dialog or the tool option tab of the -paint-with-filters tool. -</para> -<para> -An example, taken from the oilpaint effect filter: -</para> -<programlisting> -class KisOilPaintFilterConfiguration : public KisFilterConfiguration -{ - -public: - - KisOilPaintFilterConfiguration(Q_UINT32 brushSize, Q_UINT32 smooth) - : KisFilterConfiguration( "oilpaint", 1 ) - { - setProperty("brushSize", brushSize); - setProperty("smooth", smooth); - }; -public: - - inline Q_UINT32 brushSize() { return getInt("brushSize"); }; - inline Q_UINT32 smooth() {return getInt("smooth"); }; - -}; -</programlisting> -</sect3> - -<sect3 id="developers-plugins-filters-kisfilterconfigurationwidget"> -<title><classname>KisFilterConfigurationWidget</classname></title> - -<para> -Most filters can be tweaked by the user. You can create a configuration widget -that Krita will use where-ever your filter is used. An example: -</para> - -<para> -<screenshot> -<screeninfo>The <guilabel>Oilpaint</guilabel> dialog</screeninfo> -<mediaobject> -<imageobject> -<imagedata fileref="dialogs-oilpaint.png" format="PNG" /> -</imageobject> -<textobject> -<phrase>The <guilabel>Oilpaint</guilabel> dialog</phrase> -</textobject> -<caption><para>The <guilabel>Oilpaint</guilabel> dialog</para></caption> -</mediaobject> -</screenshot> -</para> - -<para> -Note that only the left-hand side of this dialog is your responsibility: -&krita; takes care of the rest. There are three ways of going about creating -an option widget: -</para> - -<itemizedlist> -<listitem><para>Use &Qt; Designer to create a widget base, and subclass it for -your filter</para></listitem> -<listitem><para>Use one of the simple widgets that show a number of sliders -for lists of integers, doubles or bools. These are useful if, like the above -screenshot, your filter can be configured by a number of integers, doubles or -bools. See the API dox for <classname>KisMultiIntegerFilterWidget</classname>, -<classname>KisMultiDoubleFilterWidget</classname> and -<classname>KisMultiBoolFilterWidget</classname>.</para></listitem> -<listitem><para>Hand-code a widget. This is not recommended, and if you do so -and want your filter to become part of &krita;’s official release, then I’ll ask -you to replate your hand-coded widget with a &Qt; Designer -widget.</para></listitem> -</itemizedlist> - -<para> -The oilpaint filter uses the multi integer widget: -</para> - -<programlisting> -KisFilterConfigWidget * KisOilPaintFilter::createConfigurationWidget(QWidget* parent, KisPaintDeviceSP /*dev*/) -{ - vKisIntegerWidgetParam param; - param.push_back( KisIntegerWidgetParam( 1, 5, 1, i18n("Brush size"), "brushSize" ) ); - param.push_back( KisIntegerWidgetParam( 10, 255, 30, i18n("Smooth"), "smooth" ) ); - return new KisMultiIntegerFilterWidget(parent, id().id().ascii(), id().id().ascii(), param ); -} - -KisFilterConfiguration* KisOilPaintFilter::configuration(QWidget* nwidget) -{ - KisMultiIntegerFilterWidget* widget = (KisMultiIntegerFilterWidget*) nwidget; - if( widget == 0 ) - { - return new KisOilPaintFilterConfiguration( 1, 30); - } else { - return new KisOilPaintFilterConfiguration( widget->valueAt( 0 ), widget->valueAt( 1 ) ); - } -} - -std::list<KisFilterConfiguration*> KisOilPaintFilter::listOfExamplesConfiguration(KisPaintDeviceSP ) -{ - std::list<KisFilterConfiguration*> list; - list.insert(list.begin(), new KisOilPaintFilterConfiguration( 1, 30)); - return list; -} -</programlisting> - -<para> -You can see how it works: fill a vector with your integer parameters and -create the widget. The <methodname>configuration()</methodname> method -inspects the widget and creates the right filter configuration object, in this -case, of course, <classname>KisOilPaintFilterConfiguration</classname>. The -<methodname>listOfExamplesConfiguration</methodname> method (which should be -renamed to correct English...) returns a list with example configuration -objects for the filters gallery dialog. -</para> -</sect3> - -<sect3 id="developers-plugins-filters-conclusion"> -<title>Filters conclusion</title> - -<para> -There’s more to coding interesting filters, of course, but with this -explanation, the API documentation and access to our source code, you should -be able to get started. Don’t hesitate to contact the &krita; developers on -IRC or on the mailing list. -</para> -</sect3> - -</sect2> - -<sect2 id="developers-plugins-tools"> -<title>Tools</title> - -<para> -Tools appear in &krita;’s toolbox. This means that there is limited space for -new tools — think carefully whether a paint operation isn’t enough for -your purposes. Tools can use the mouse/tablet and keyboard in complex ways, -which paint operations cannot. This is the reason that Duplicate is a tool, -but airbrush a paint operation. -</para><para> -Be careful with static data in your tool: a new instance of your tool is -created for every input device: mouse, stylus, eraser, airbrush — whatever. -Tools come divided into logical groups: -</para> -<itemizedlist> -<listitem><para>shape drawing tools (circle, rect)</para></listitem> -<listitem><para>freehand drawing tools (brush)</para></listitem> -<listitem><para>transform tools that mess up the geometry of a -layer</para></listitem> -<listitem><para>fill tools (like bucket fill or gradient)</para></listitem> -<listitem><para>view tools (that don’t change pixels, but alter the way you -view the canvas, such as zoom)</para></listitem> -<listitem><para>select tools (that change the selection -mask)</para></listitem> -</itemizedlist> - -<para> -The tool interface is described in the API documentation for -<classname>KisTool</classname>. There are three subclasses: -<classname>KisToolPaint</classname>, <classname>KisToolNonPaint</classname> -and <classname>KisToolShape</classname> (which is actually a subclass of -<classname>KisToolPaint</classname>) that specialize -<classname>KisTool</classname> for painting tasks (i.e., changing pixels) , -non-painting tasks and shape painting tasks. -</para><para> -A tool has an option widget, just like filters. Currently, the option widgets -are shown in a tab in a dock window. We may change that to a strip under the -main menu (which then replaces the toolbar) for &krita; 2.0, but for now, -design your option widget to fit in a tab. As always, it’s best to use &Qt; -Designer for the design of the option widget. -</para><para> -A good example of a tool is the star tool: -</para> - -<screen> -kis_tool_star.cc Makefile.am tool_star_cursor.png wdg_tool_star.ui -kis_tool_star.h Makefile.in tool_star.h -kritatoolstar.desktop tool_star.cc tool_star.png -</screen> - -<para> -As you see, you need two images: one for the cursor and one for the toolbox. -<filename>tool_star.cc</filename> is just the plugin loader, similar to what -we have seen above. The real meat is in the implementation: -</para> - -<programlisting> -KisToolStar::KisToolStar() - : KisToolShape(i18n("Star")), - m_dragging (false), - m_currentImage (0) -{ - setName("tool_star"); - setCursor(KisCursor::load("tool_star_cursor.png", 6, 6)); - m_innerOuterRatio=40; - m_vertices=5; -} -</programlisting> - -<para> -The constructor sets the internal name — which is not translated -— and the call to the superclass sets the visible name. We also load the -cursor image and set a number of variables. -</para> - -<programlisting> -void KisToolStar::update (KisCanvasSubject *subject) -{ - KisToolShape::update (subject); - if (m_subject) - m_currentImage = m_subject->currentImg(); -} -</programlisting> - -<para> -The <methodname>update()</methodname> method is called when the tool is -selected. This is not a <classname>KisTool</classname> method, but a -<classname>KisCanvasObserver</classname> method. Canvas observers are notified -whenever something changes in the view, which can be useful for tools. -</para><para> -The following methods (<methodname>buttonPress</methodname>, -<methodname>move</methodname> and <methodname>buttonRelease</methodname>) are -called by &krita; when the input device (mouse, stylus, eraser etc.) is -pressed down, moved or released. Note that you also get move events if the -mouse button isn’t pressed. The events are not the regular &Qt; events, but -synthetic &krita; events because we make use of low-level trickery to get -enough events to draw a smooth line. By default, toolkits like &Qt; (and GTK) -drop events if they are too busy to handle them, and we want them all. -</para> - -<programlisting> -void KisToolStar::buttonPress(KisButtonPressEvent *event) -{ - if (m_currentImage && event->button() == LeftButton) { - m_dragging = true; - m_dragStart = event->pos(); - m_dragEnd = event->pos(); - m_vertices = m_optWidget->verticesSpinBox->value(); - m_innerOuterRatio = m_optWidget->ratioSpinBox->value(); - } -} - -void KisToolStar::move(KisMoveEvent *event) -{ - if (m_dragging) { - // erase old lines on canvas - draw(m_dragStart, m_dragEnd); - // move (alt) or resize star - if (event->state() & Qt::AltButton) { - KisPoint trans = event->pos() - m_dragEnd; - m_dragStart += trans; - m_dragEnd += trans; - } else { - m_dragEnd = event->pos(); - } - // draw new lines on canvas - draw(m_dragStart, m_dragEnd); - } -} - -void KisToolStar::buttonRelease(KisButtonReleaseEvent *event) -{ - if (!m_subject || !m_currentImage) - return; - - if (m_dragging && event->button() == LeftButton) { - // erase old lines on canvas - draw(m_dragStart, m_dragEnd); - m_dragging = false; - - if (m_dragStart == m_dragEnd) - return; - - if (!m_currentImage) - return; - - if (!m_currentImage->activeDevice()) - return; - - KisPaintDeviceSP device = m_currentImage->activeDevice ();; - KisPainter painter (device); - if (m_currentImage->undo()) painter.beginTransaction (i18n("Star")); - - painter.setPaintColor(m_subject->fgColor()); - painter.setBackgroundColor(m_subject->bgColor()); - painter.setFillStyle(fillStyle()); - painter.setBrush(m_subject->currentBrush()); - painter.setPattern(m_subject->currentPattern()); - painter.setOpacity(m_opacity); - painter.setCompositeOp(m_compositeOp); - KisPaintOp * op = - KisPaintOpRegistry::instance()->paintOp(m_subject->currentPaintop(), m_subject->currentPaintopSettings(), &painter); - painter.setPaintOp(op); // Painter takes ownership - - vKisPoint coord = starCoordinates(m_vertices, m_dragStart.x(), m_dragStart.y(), m_dragEnd.x(), m_dragEnd.y()); - - painter.paintPolygon(coord); - - device->setDirty( painter.dirtyRect() ); - notifyModified(); - - if (m_currentImage->undo()) { - m_currentImage->undoAdapter()->addCommand(painter.endTransaction()); - } - } -} -</programlisting> - -<para> -The <methodname>draw()</methodname> method is an internal method of -<classname>KisToolStar</classname> and draws the outline of the star. We call -this from the <methodname>move()</methodname> method to give the user feedback -of the size and shape of their star. Note that we use the -<varname>Qt::NotROP</varname> raster operation, which means that calling -<methodname>draw()</methodname> a second time with the same start and end -point the previously drawn star will be deleted. -</para> - -<programlisting> -void KisToolStar::draw(const KisPoint& start, const KisPoint& end ) -{ - if (!m_subject || !m_currentImage) - return; - - KisCanvasController *controller = m_subject->canvasController(); - KisCanvas *canvas = controller->kiscanvas(); - KisCanvasPainter p (canvas); - QPen pen(Qt::SolidLine); - - KisPoint startPos; - KisPoint endPos; - startPos = controller->windowToView(start); - endPos = controller->windowToView(end); - - p.setRasterOp(Qt::NotROP); - - vKisPoint points = starCoordinates(m_vertices, startPos.x(), startPos.y(), endPos.x(), endPos.y()); - - for (uint i = 0; i < points.count() - 1; i++) { - p.drawLine(points[i].floorQPoint(), points[i + 1].floorQPoint()); - } - p.drawLine(points[points.count() - 1].floorQPoint(), points[0].floorQPoint()); - - p.end (); -} -</programlisting> - -<para> -The <methodname>setup()</methodname> method is essential: here we create the -action that will be plugged into the toolbox so users can actually select the -tool. We also assign a shortcut key. Note that there’s some hackery going on: -remember that we create an instance of the tool for every input device. This -also means that we call <methodname>setup()</methodname> for every input -device and that means that an action with the same name is added several times -to the action collection. However, everything seems to work, so why worry? -</para> - -<programlisting> -void KisToolStar::setup(KActionCollection *collection) -{ - m_action = static_cast<KRadioAction *>(collection->action(name())); - - if (m_action == 0) { - KShortcut shortcut(Qt::Key_Plus); - shortcut.append(KShortcut(Qt::Key_F9)); - m_action = new KRadioAction(i18n("&Star"), - "tool_star", - shortcut, - this, - SLOT(activate()), - collection, - name()); - Q_CHECK_PTR(m_action); - - m_action->setToolTip(i18n("Draw a star")); - m_action->setExclusiveGroup("tools"); - m_ownAction = true; - } -} -</programlisting> - -<para> -The <methodname>starCoordinates()</methodname> method contains some funky math -— but is not too interesting for the discussion of how to create a tool -plugins. -</para> - -<programlisting> -KisPoint KisToolStar::starCoordinates(int N, double mx, double my, double x, double y) -{ - double R=0, r=0; - Q_INT32 n=0; - double angle; - - vKisPoint starCoordinatesArray(2*N); - - // the radius of the outer edges - R=sqrt((x-mx)*(x-mx)+(y-my)*(y-my)); - - // the radius of the inner edges - r=R*m_innerOuterRatio/100.0; - - // the angle - angle=-atan2((x-mx),(y-my)); - - //set outer edges - for(n=0;n<N;n++){ - starCoordinatesArray[2*n] = KisPoint(mx+R*cos(n * 2.0 * M_PI / N + angle),my+R*sin(n *2.0 * M_PI / N+angle)); - } - - //set inner edges - for(n=0;n<N;n++){ - starCoordinatesArray[2*n+1] = KisPoint(mx+r*cos((n + 0.5) * 2.0 * M_PI / N + angle),my+r*sin((n +0.5) * 2.0 * M_PI / N + angle)); - } - - return starCoordinatesArray; -} -</programlisting> - -<para> -The <methodname>createOptionWidget()</methodname> method is called to create -the option widget that &krita; will show in the tab. Since there is a tool per -input device per view, the state of a tool can be kept in the tool. This -method is only called once: the option widget is stored and retrieved the next -time the tool is activated. -</para> - -<programlisting> -QWidget* KisToolStar::createOptionWidget(QWidget* parent) -{ - QWidget *widget = KisToolShape::createOptionWidget(parent); - - m_optWidget = new WdgToolStar(widget); - Q_CHECK_PTR(m_optWidget); - - m_optWidget->ratioSpinBox->setValue(m_innerOuterRatio); - - QGridLayout *optionLayout = new QGridLayout(widget, 1, 1); - super::addOptionWidgetLayout(optionLayout); - - optionLayout->addWidget(m_optWidget, 0, 0); - - return widget; -} -</programlisting> - -<sect3 id="developers-plugins-tools-conclusions"> -<title>Tool Conclusions</title> - -<para> -Tools are relatively simple plugins to create. You need to combine the -<classname>KisTool</classname> and <classname>KisCanvasObserver</classname> -interfaces in order to effectively create a tool. -</para> - -</sect3> - -</sect2> - -<sect2 id="developers-plugins-paintoperations"> -<title>Paint operations</title> - -<para> -PaintOps are one of the more innovative types of plugins in Krita (together -with pluggable colorspaces). A paint operation defines how tools change the -pixels they touch. Airbrush, aliased pencil or antialiased pixel brush: these -are all paint operations. But you could — with a lot of work — -create a paintop that reads Corel Painter XML brush definitions and uses those -to determine how painting is done. -</para><para> -Paint operations are instantiated when a paint tool receives a -<literal>mouseDown</literal> event and are deleted when the mouseUp event is -received by a paint tool. In between, the paintop can keep track of previous -positions and other data, such as pressure levels if the user uses a tablet. -</para><para> -The basic operation of a paint operation is to change pixels at the cursor -position of a paint tool. That can be done only once, or the paint op can -demand to be run at regular intervals, using a timer. The first would be -useful for a pencil-type paint op, the second, of course, for an -airbrush-type paintop. -</para><para> -Paintops can have a small configuration widget which is placed in a toolbar. -Thus, paintop configuration widgets need to have a horizontal layout of -widgets that are not higher than a toolbar button. Otherwise, &krita; will -look very funny. -</para><para> -Let’s look at a simple paintop plugin, one that shows a little bit of -programmatic intelligence. First, in the header file, there’s a factory -defined. This factory creates a paintop when the active tool needs one: -</para> - -<programlisting> -public: - KisSmearyOpFactory() {} - virtual ~KisSmearyOpFactory() {} - - virtual KisPaintOp * createOp(const KisPaintOpSettings *settings, KisPainter * painter); - virtual KisID id() { return KisID("paintSmeary", i18n("Smeary Brush")); } - virtual bool userVisible(KisColorSpace * ) { return false; } - virtual QString pixmap() { return ""; } - -}; -</programlisting> - -<para> -The factory also contains the <classname>KisID</classname> with the public and -private name for the paintop — make sure your paintop’s private name -does not clash with another paintop! — and may optionally return a -pixmap. &krita; can then show the pixmap together with the name for visual -identifcation of your paintop. For instance, a painter’s knife paintop would -have the image of such an implement. -</para><para> -The implementation of a paintop is very straightforward: -</para> - -<programlisting> -KisSmearyOp::KisSmearyOp(KisPainter * painter) - : KisPaintOp(painter) -{ -} - -KisSmearyOp::~KisSmearyOp() -{ -} -void KisSmearyOp::paintAt(const KisPoint &pos, const KisPaintInformation& info) -{ -</programlisting> - -<para> -The <methodname>paintAt()</methodname> method really is where it’s at, with -paintops. This method receives two parameters: the current position (which is -in floats, not in whole pixels) and a -<classname>KisPaintInformation</classname> object. which contains the -pressure, x and y tilt, and movement vector, and may in the future be extended -with other information. -</para> - -<programlisting> - if (!m_painter->device()) return; - - KisBrush *brush = m_painter->brush(); -</programlisting> - -<para> -A <classname>KisBrush</classname> is the representation of a Gimp brush file: -that is a mask, either a single mask or a series of masks. Actually, we don’t -use the brush here, except to determine the <quote>hotspot</quote> under the -cursor. -</para> - -<programlisting> - Q_ASSERT(brush); - - if (!brush) return; - - if (! brush->canPaintFor(info) ) - return; - - KisPaintDeviceSP device = m_painter->device(); - KisColorSpace * colorSpace = device->colorSpace(); - KisColor kc = m_painter->paintColor(); - kc.convertTo(colorSpace); - - KisPoint hotSpot = brush->hotSpot(info); - KisPoint pt = pos - hotSpot; - - // Split the coordinates into integer plus fractional parts. The integer - // is where the dab will be positioned and the fractional part determines - // the sub-pixel positioning. - Q_INT32 x, y; - double xFraction, yFraction; - - splitCoordinate(pt.x(), &x, &xFraction); - splitCoordinate(pt.y(), &y, &yFraction); - - KisPaintDeviceSP dab = new KisPaintDevice(colorSpace, "smeary dab"); - Q_CHECK_PTR(dab); -</programlisting> - -<para> -We don’t change the pixels of a paint device directly: instead we create a -small paint device, a dab, and composite that onto the current paint device. -</para> - -<programlisting> - m_painter->setPressure(info.pressure); -</programlisting> - -<para> -As the comments say, the next bit code does some programmatic work to create -the actual dab. In this case, we draw a number of lines. When I am done with -this paintop, the length, position and thickness of the lines will be -dependent on pressure and paint load, and we’ll have create a stiff, smeary -oilpaint brush. But I haven’t had time to finish this yet. -</para> - -<programlisting> - // Compute the position of the tufts. The tufts are arranged in a line - // perpendicular to the motion of the brush, i.e, the straight line between - // the current position and the previous position. - // The tufts are spread out through the pressure - - KisPoint previousPoint = info.movement.toKisPoint(); - KisVector2D brushVector(-previousPoint.y(), previousPoint.x()); - KisVector2D currentPointVector = KisVector2D(pos); - brushVector.normalize(); - - KisVector2D vl, vr; - - for (int i = 0; i < (NUMBER_OF_TUFTS / 2); ++i) { - // Compute the positions on the new vector. - vl = currentPointVector + i * brushVector; - KisPoint pl = vl.toKisPoint(); - dab->setPixel(pl.roundX(), pl.roundY(), kc); - - vr = currentPointVector - i * brushVector; - KisPoint pr = vr.toKisPoint(); - dab->setPixel(pr.roundX(), pr.roundY(), kc); - } - - vr = vr - vl; - vr.normalize(); -</programlisting> - -<para> -Finally we blt the dab onto the original paint device and tell the painter -that we’ve dirtied a small rectangle of the paint device. -</para> - -<programlisting> - if (m_source->hasSelection()) { - m_painter->bltSelection(x - 32, y - 32, m_painter->compositeOp(), dab.data(), - m_source->selection(), m_painter->opacity(), x - 32, y -32, 64, 64); - } - else { - m_painter->bitBlt(x - 32, y - 32, m_painter->compositeOp(), dab.data(), m_painter->opacity(), x - 32, y -32, 64, 64); - } - - m_painter->addDirtyRect(QRect(x -32, y -32, 64, 64)); -} - - -KisPaintOp * KisSmearyOpFactory::createOp(const KisPaintOpSettings */*settings*/, KisPainter * painter) -{ - KisPaintOp * op = new KisSmearyOp(painter); - Q_CHECK_PTR(op); - return op; -} -</programlisting> - -<para> -That’s all: paintops are easy and fun! -</para> - -</sect2> - -<sect2 id="developers-plugins-viewplugins"> -<title>View plugins</title> - -<para> -View plugins are the weirdest of the bunch: a view plugin is an ordinary KPart -that can provide a bit of user interface and some functionality. For instance, -the histogram tab is a view plugin, as is the rotate dialog. -</para> - -</sect2> - -<sect2 id="developers-plugins-importexport"> -<title>Import/Export filters</title> - -<para> -&krita; works with the ordinary &koffice; file filter architecture. There is a -tutorial, a bit old, but still useful, at: <ulink -url="http://koffice.org/developer/filters/oldfaq.php" />. It is probably best -to cooperate with the &krita; team when developing file filters and do the -development in the &koffice; filter tree. Note that you can test your filters -without running &krita; using the <command>koconverter</command> utility. -</para><para> -Filters have two sides: importing and exporting. These are usually two -different plugins that may share some code. -</para><para> -The important <filename>Makefile.am</filename> entries are: -</para> - -<programlisting> -service_DATA = krita_XXX_import.desktop krita_XXX_export.desktop -servicedir = $(kde_servicesdir) -kdelnk_DATA = krita_XXX.desktop -kdelnkdir = $(kde_appsdir)/Office -libkritaXXXimport_la_SOURCES = XXXimport.cpp -libkritaXXXexport_la_SOURCES = XXXexport.cpp -METASOURCES = AUTO -</programlisting> - -<para> -Whether you are building an import filter or an export filter, your work always -boils down to implementing the following function: -</para> - -<programlisting> -virtual KoFilter::ConversionStatus convert(const QCString& from, const QCString& to); -</programlisting> - -<para> -It is the settings in the <literal role="extension">.desktop</literal> files -that determine which way a filter converts: -</para><para> -Import: -</para> - -<programlisting> -X-KDE-Export=application/x-krita -X-KDE-Import=image/x-xcf-gimp -X-KDE-Weight=1 -X-KDE-Library=libkritaXXXimport -ServiceTypes=KOfficeFilter -</programlisting> - -<para> -Export: -</para> - -<programlisting> -X-KDE-Export=image/x-xcf-gimp -X-KDE-Import=application/x-krita -ServiceTypes=KOfficeFilter -Type=Service -X-KDE-Weight=1 -X-KDE-Library=libkritaXXXexport -</programlisting> - -<para> -And yes, the mimetype chosen for the example is a hint. Please, pretty please, -implement an xcf filter? -</para> - -<sect3 id="plugins-developers-importexport-import"> -<title>Import</title> - -<para> -The big problem with import filters is of course your code to read the data on -disk. The boilerplate for calling that code is fairly simple: -</para> - -<note><para>Note: we really, really should find a way to enable &krita; to keep -a file open and only read data on a as-needed basis, instead of copying the -entire contents to the internal paint device representation. But that would -mean datamanager backends that know about tiff files and so on, and is not -currently implemented. It would be ideal if some file filters could implement -a class provisionally named <classname>KisFileDataManager</classname>, create -an object of that instance with the current file and pass that to KisDoc. But -&krita; handles storage per layer, not per document, so this would be a hard -refactor to do.</para></note> - -<programlisting> -KoFilter::ConversionStatus XXXImport::convert(const QCString&, const QCString& to) -{ - if (to != "application/x-krita") <co id="import1" /> - return KoFilter::BadMimeType; - - KisDoc * doc = dynamic_cast<KisDoc*>(m_chain -> outputDocument()); <co id="import2" /> - KisView * view = static_cast<KisView*>(doc -> views().getFirst()); <co id="import3" /> - - QString filename = m_chain -> inputFile(); <co id="import4" /> - - if (!doc) - return KoFilter::CreationError; - - doc -> prepareForImport(); <co id="import5" /> - - if (!filename.isEmpty()) { - - KURL url(filename); - - if (url.isEmpty()) - return KoFilter::FileNotFound; - - KisImageXXXConverter ib(doc, doc -> undoAdapter()); <co id="import6" /> - - if (view != 0) - view -> canvasSubject() -> progressDisplay() -> setSubject(&ib, false, true); - - switch (ib.buildImage(url)) <co id="import7" /> { - case KisImageBuilder_RESULT_UNSUPPORTED: - return KoFilter::NotImplemented; - break; - case KisImageBuilder_RESULT_INVALID_ARG: - return KoFilter::BadMimeType; - break; - case KisImageBuilder_RESULT_NO_URI: - case KisImageBuilder_RESULT_NOT_LOCAL: - return KoFilter::FileNotFound; - break; - case KisImageBuilder_RESULT_BAD_FETCH: - case KisImageBuilder_RESULT_EMPTY: - return KoFilter::ParsingError; - break; - case KisImageBuilder_RESULT_FAILURE: - return KoFilter::InternalError; - break; - case KisImageBuilder_RESULT_OK: - doc -> setCurrentImage( ib.image()); <co id="import8" /> - return KoFilter::OK; - default: - break; - } - - } - return KoFilter::StorageCreationError; -} -</programlisting> - -<calloutlist> -<callout arearefs="import1"><para>This is supposed to be an importfilter, so -if it is not called to convert to a &krita; image, then something is -wrong.</para></callout> -<callout arearefs="import2"><para>The filter chain already has created an -output document for us. We need to cast it to <classname>KisDocM</classname>, -because &krita; documents need special treatment. It would not, actually, be -all that bad an idea to check whether the result of the cast is not 0, because -if it is, importing will fail.</para></callout> -<callout arearefs="import3"><para>If we call this filter from the GUI, we try -to get the view. If there is a view, the conversion code can try to update the -progressbar.</para></callout> -<callout arearefs="import4"><para>The filter has the filename for our input -file for us.</para></callout> -<callout arearefs="import5"><para><classname>KisDoc</classname> needs to be -prepared for import. Certain settings are initialized and undo is disabled. -Otherwise you could undo the adding of layers performed by the import filter -and that is weird behaviour.</para></callout> -<callout arearefs="import6"><para>I have chosed to implement the actual -importing code in a separate class that I instantiate here. You can also put -all your code right in this method, but that would be a bit -messy.</para></callout> -<callout arearefs="import7"><para>My importer returns a statuscode that I -can then use to set the status of the import filter. &koffice; takes care of -showing error messages.</para></callout> -<callout arearefs="import8"><para>If creating the -<classname>KisImage</classname> has succeeded we set the document's current -image to our newly created image. Then we are done: <literal>return -KoFilter::OK;</literal>.</para></callout> -</calloutlist> - -</sect3> - -</sect2> - -</sect1> diff --git a/doc/krita/developers-scripting.docbook b/doc/krita/developers-scripting.docbook deleted file mode 100644 index b4ee3a53..00000000 --- a/doc/krita/developers-scripting.docbook +++ /dev/null @@ -1,534 +0,0 @@ -<sect1 id="developers-scripting"> -<title>Scripting</title> - -<para> -In &krita;, you can write scripts in Ruby or Python (the availability of the -interpreters might depend on what your distributions or the administrator of -your machine did install). Here you will find a description of the scripting -API. -</para><para> -Some examples are distributed with &krita;, and you might find them in -<filename>/usr/share/apps/krita/scripts</filename> (or -<filename>/opt/kde/share/apps/krita/scripts</filename>). -</para> - -<sect2 id="developers-scripting-variables"> -<title>Variables in the <classname>Krosskritacore</classname> module</title> - -<itemizedlist> -<listitem><para><varname>KritaDocument</varname> returns a -<classname>Document</classname> object</para></listitem> -<listitem><para><varname>KritaScript</varname> returns a -<classname>ScriptProgress</classname> object</para></listitem> -</itemizedlist> - -<para> -You can retrieve an object using the <function>get</function> function of the -<classname>Krosskritacore</classname> module, in Ruby you will have to write something like that: -<programlisting> -doc = Krosskritacore::get("KritaDocument") -script = Krosskritacore::get("KritaScript") -</programlisting> -</para> - -</sect2> - -<sect2 id="developers-scripting-functions"> -<title>Functions in the <classname>Krosskritacore</classname> module</title> - -<itemizedlist> -<listitem><para>Function: <function>getBrush</function></para><para> -This function returns a <classname>Brush</classname> taken from the list of -&krita; resources. It takes one argument: the name of the brush. -For example (in Ruby): -<programlisting> -Krosskritacore::getBrush("Circle (05)") -</programlisting></para></listitem> - -<listitem><para>Function: <function>getFilter</function></para><para> -This function returns a <classname>Filter</classname> taken from the list of -&krita; resources. It takes one argument: the name of the filter. -For example (in Ruby): -<programlisting> -Krosskritacore::getFilter("invert") -</programlisting></para></listitem> - -<listitem><para>Function: <function>getPattern</function></para><para> -This function returns a <classname>Pattern</classname> taken from the list of -&krita; resources. It takes one argument: the name of the pattern. -For example (in Ruby): -<programlisting> -Krosskritacore::getPattern("Bricks") -</programlisting></para></listitem> - -<listitem><para>Function: <function>loadBrush</function></para><para> -This function loads a <classname>Brush</classname> and then returns it. -It takes one argument: the filename of the brush.</para></listitem> - -<listitem><para>Function: <function>loadPattern</function></para><para> -This function loads a <classname>Pattern</classname> and then returns it. -It takes one argument: the filename of the pattern.</para></listitem> - -<listitem><para>Function: <function>newCircleBrush</function></para><para> -This function returns a <classname>Brush</classname> with a circular shape. It -takes at least two arguments: width and height. It can take two other -arguments: width of the shading, and height of the shading. If the shading -is not specified, no shading will be used. -For example (in Ruby): -<programlisting> -Krosskritacore::newCircleBrush(10,20) # create a plain circle -Krosskritacore::newCircleBrush(10,20,5,10) # create a gradient -</programlisting></para></listitem> - -<listitem><para>Function: <function>newHSVColor</function></para><para> -This function returns a new <classname>Color</classname> with the given HSV -triplet. It takes three arguments: hue component (0 to 255), saturation -component (0 to 255), value component (0 to 255). - -For example (in Ruby): -<programlisting> -Krosskritacore::newHSVColor(255,125,0) -</programlisting></para></listitem> - -<listitem><para>Function: <function>newImage</function></para><para> -This function returns a new <classname>Image</classname>. It takes four arguments: -width, height, colorspace id, name of the image. And in return you get an -<classname>Image</classname> object. -For example (in Ruby): -<programlisting> -Krosskritacore::newImage(10,20, "RGBA", "kikoo") -</programlisting></para></listitem> - -<listitem><para>Function: <function>newRectBrush</function></para><para> -This function returns a <classname>Brush</classname> with a rectangular shape. -It takes at least two arguments: width and height. It can take two other -arguments: width of the shading and height of the shading. If the shading is -not specified, no shading will be used. -For example (in Ruby): -<programlisting> - Krosskritacore::newRectBrush(10,20) # create a plain rectangle - Krosskritacore::newRectBrush(10,20,5,10) # create a gradient -</programlisting></para></listitem> - -<listitem><para>Function: <function>newRGBColor</function></para><para> -This function returns a new <classname>Color</classname> with the given RGB -triplet. It takes three arguments: red component (0 to 255), blue component (0 to -255), green component (0 to 255). -For example (in Ruby): -<programlisting> -Krosskritacore::newRGBColor(255,0,0) # create a red color -Krosskritacore::newRGBColor(255,255,255) # create a white color -</programlisting></para></listitem> -</itemizedlist> -</sect2> - -<sect2 id="developers-scripting-objects"> -<title>Descriptions and function lists for various objects in -<classname>Krosskritacore</classname></title> - -<itemizedlist> -<listitem><para>Object: PaintLayer</para> - -<itemizedlist> -<listitem><para>Function: <function>beginPainting</function></para></listitem> - -<listitem><para>Function: <function>convertToColorspace</function></para><para> -Convert the image to a colorspace. This function takes one argument: the name -of the destination colorspace. -For example (in Ruby): -<programlisting> -image.convertToColorspace("CMYK") -</programlisting></para></listitem> - -<listitem><para>Function: <function>createHistogram</function></para><para> -This function creates a Histogram for this layer. It takes two arguments: -the type of the histogram ("RGB8HISTO"), and 0 if the histogram is linear, or -1 if it is logarithmic.</para></listitem> - -<listitem><para>Function: <function>createHLineIterator</function></para><para> -Create an iterator over a layer, it will iterate on a row. This function takes three arguments: -<varname>x</varname> (start in the row), <varname>y</varname> (vertical -position of the row), width of the row.</para></listitem> - -<listitem><para>Function: <function>createPainter</function></para><para> -This function creates a <classname>Painter</classname> which will allow you to -paint on the layer. </para></listitem> - -<listitem><para>Function: <function>createRectIterator</function></para><para> -Create an iterator over a layer, it will iterate on a rectangular area. This -function takes four arguments: <varname>x</varname>, <varname>y</varname>, -width of the rectangle, height of the rectangle.</para></listitem> - -<listitem><para>Function: <function>createVLineIterator</function></para><para> -Create an iterator over a layer, it will iterate on a column. This function -takes three arguments: <varname>x</varname> (horizontal position of the -column), <varname>y</varname> (start in the column), height of the column.</para></listitem> - -<listitem><para>Function: <function>endPainting</function></para><para> -This function closes the current undo entry and adds it to the history.</para></listitem> - -<listitem><para>Function: <function>fastWaveletTransformation</function></para><para> -Returns the fast wavelet transformation of the layer.</para></listitem> - -<listitem><para>Function: <function>fastWaveletUntransformation</function></para><para> -Untransforms a fast wavelet into this layer. It takes one argument: a wavelet -object. -For example (in Ruby): -<programlisting> -wavelet = layer.fastWaveletTransformation() -layer.fastWaveletUntransformation(wavelet) -</programlisting></para></listitem> - -<listitem><para>Function: <function>getHeight</function></para><para> -Return the height of the layer.</para></listitem> - -<listitem><para>Function: <function>getWidth</function></para><para> -Return the width of the layer.</para></listitem> -</itemizedlist> -</listitem> - -<listitem><para>Object: <classname>Filter</classname></para> -<itemizedlist> - -<listitem><para>Function: <function>getFilterConfiguration</function></para><para> -This function returns the <classname>FilterConfiguration</classname> -associated with this filter.</para></listitem> - -<listitem><para>Function: <function>process</function></para><para> -This function will apply the filter. It takes at least one argument: the -source layer. You can also use these four aguments: <varname>x</varname>, -<varname>y</varname>, <varname>width</varname>, <varname>height</varname>. -(<varname>x</varname>,<varname>y</varname>,<varname>width</varname>,<varname>height</varname>) -defines the rectangular area on which the filter -will be computed. If the rectangle is not defined, then the filter will be -applied on the entire source layer. -For example (in Ruby) -<programlisting> -doc = Krosskritacore::get("KritaDocument") -image = doc.getImage() -layer = image.getActivePaintLayer() -width = layer.getWidth() -height = layer.getHeight() -filter = Krosskritacore::getFilter("invert") -filter.process(layer, layer) -filter.process(layer, layer, 10, 10, 20, 20 ) -</programlisting></para></listitem> -</itemizedlist></listitem> - -<listitem><para>Object: <classname>FilterConfiguration</classname></para> -<itemizedlist> - -<listitem><para>Function: <function>getProperty</function></para><para> -This function returns the value of a parameter of the associated -<classname>Filter</classname>. It takes one argument: the name of the -parameter.</para></listitem> - -<listitem><para>Function: <function>setProperty</function></para><para> -This function defines a parameter of the associated -<classname>Filter</classname>. It takes two arguments: the name of the -parameter and the value, whose type depends on the -<classname>Filter</classname>.</para></listitem> -</itemizedlist> -</listitem> - -<listitem><para>Object: <classname>Histogram</classname></para> - -<para>This class allows you to access the histogram of a -<classname>PaintLayer</classname>. -Example (in Ruby): -<programlisting> - doc = krosskritacore::get("KritaDocument") - image = doc.getImage() - layer = image.getActiveLayer() - histo = layer.createHistogram("RGB8HISTO",0) - min = layer.getMin() * 255 - max = layer.getMax() * 255 - for i in min..max - print layer.getValue(i) - print "\n" - end -</programlisting> -</para> - -<itemizedlist> -<listitem><para>Function: <function>getChannel</function></para><para> -Return the selected channel.</para></listitem> - -<listitem><para>Function: <function>getCount</function></para><para> -This function returns the number of pixels used by the histogram.</para></listitem> - -<listitem><para>Function: <function>getHighest</function></para><para> -This function returns the highest value of the histogram.</para></listitem> - -<listitem><para>Function: <function>getLowest</function></para><para> -This function returns the lowest value of the histogram.</para></listitem> - -<listitem><para>Function: <function>getMax</function></para><para> -This function returns the maximum bound of the histogram (values at greater -position than the maximum are null). The value is in the range 0.0 – 1.0.</para></listitem> - -<listitem><para>Function: <function>getMean</function></para><para> -This function returns the mean of the histogram.</para></listitem> - -<listitem><para>Function: <function>getMin</function></para><para> -This function returns the minimum bound of the histogram (values at smaller -position than the minimum are null). The value is in the range 0.0 – 1.0.</para></listitem> - -<listitem><para>Function: <function>getNumberOfBins</function></para><para> -Return the number of bins of this histogram. </para></listitem> - -<listitem><para>Function: <function>getTotal</function></para><para> -This function returns the sum of all values of the histogram.</para></listitem> - -<listitem><para>Function: <function>getValue</function></para><para> -Return the value of a bin of the histogram. This function takes one argument: -index, in the range [0..255].</para></listitem> - -<listitem><para>Function: <function>setChannel</function></para><para> -Select the channel of the layer on which to get the result of the histogram. -This function takes one argument: the channel number.</para></listitem> -</itemizedlist> -</listitem> - -<listitem><para>Object: <classname>ScriptProgress</classname></para> -<para><classname>ScriptProgress</classname> is used to manage the progress bar -of the status bar in &krita;. -For example (in Ruby): -<programlisting> -script = Krosskritacore::get("KritaScript") -script.setProgressTotalSteps(1000) -script.setProgressStage("progressive", 0) -for i in 1..900 - script.incProgress() -end -script.setProgressStage("brutal", 1000) -</programlisting></para> - -<itemizedlist> -<listitem><para>Function: <function>incProgress</function></para><para> -This function increments the progress by one step.</para></listitem> - -<listitem><para>Function: <function>setProgress</function></para><para> -This function sets the value of the progress. It takes one argument: -the value of the progress.</para></listitem> - -<listitem><para>Function: <function>setProgressStage</function></para><para> -This function sets the value of the progress and displays the text.</para></listitem> - -<listitem><para>Function: <function>setProgressTotalSteps</function></para><para> -This function set the number of steps that the script will require. It takes -one argument: the maximum value of the progress</para></listitem> -</itemizedlist> -</listitem> - -<listitem><para>Object: <classname>Wavelet</classname></para><para> -This object holds the coefficients of a wavelet transformation of a -<classname>PaintLayer</classname>.</para> -<itemizedlist> - -<listitem><para>Function: <function>getDepth</function></para><para> -Returns the depth of the layer.</para></listitem> - -<listitem><para>Function: <function>getNCoeff</function></para><para> -Returns the value of the Nth coefficient. The function takes one argument: the -index of the coefficient.</para></listitem> - -<listitem><para>Function: <function>getNumCoeffs</function></para><para> -Returns the number of coefficients in this wavelet (= size * size * depth).</para></listitem> - -<listitem><para>Function: <function>getSize</function></para><para> -Returns the size of the wavelet (size = width = height).</para></listitem> - -<listitem><para>Function: <function>getXYCoeff</function></para><para> -Returns the value of a coefficient. The function takes two arguments: -<varname>x</varname> and <varname>y</varname>.</para></listitem> - -<listitem><para>Function: <function>setNCoeff</function></para><para> -Set the value of the Nth coefficient. The function takes two arguments: the -index of the coefficient and the new value of the coefficient.</para></listitem> - -<listitem><para>Function: <function>setXYCoeff</function></para><para> -Set the value of a coefficient. The function takes three arguments: -<varname>x</varname>, <varname>y</varname>, and the new value of the -coefficient.</para></listitem> -</itemizedlist> -</listitem> - -<listitem><para>Object: <classname>Painter</classname></para> -<itemizedlist> - -<listitem><para>Function: <function>convolve</function></para><para> -This function applies a convolution kernel to an image. It takes at least three arguments: -a list of kernels (all lists need to have the same size), -factor, and offset. -</para><para> -The value of a pixel will be given by the following function: K * P / factor + offset, -where K is the kernel and P is the neighbourhood. -</para><para> -It can take the following optional arguments: <varname>borderOp</varname> -(control how to convolve the pixels on the border of an image: 0 = use the -default color, 1 = use the pixel on the opposite side of the image, 2 = use -the border pixel, 3 = avoid border pixels), <varname>channel</varname> (1 for -color, 2 for alpha, 3 for both), <varname>x</varname>, <varname>y</varname>, -<varname>width</varname>, <varname>height</varname>.</para></listitem> - -<listitem><para>Function: <function>setFillThreshold</function></para><para> -Sets the fill threshold. It takes one argument: the threshold.</para></listitem> - -<listitem><para>Function: <function>fillColor</function></para><para> -Starts filling with a color. It takes two arguments: <varname>x</varname> and -<varname>y</varname>.</para></listitem> - -<listitem><para>Function: <function>fillPattern</function></para><para> -Starts filling with a pattern. It takes two arguments: <varname>x</varname> -and <varname>y</varname>.</para></listitem> - -<listitem><para>Function: <function>paintPolyline</function></para><para> -This function will paint a polyline. It takes two arguments: a list of x -positions, and a list of y positions.</para></listitem> - -<listitem><para>Function: <function>paintLine</function></para><para> -This function will paint a line. It takes five arguments: -<varname>x1</varname>, <varname>y1</varname>, <varname>x2</varname>, -<varname>y2</varname>, and <varname>pressure</varname>. -</para></listitem> - -<listitem><para>Function: <function>paintBezierCurve</function></para><para> -This function will paint a Bezier curve. It takes ten arguments: -<varname>x1</varname>, <varname>y1</varname>, <varname>p1</varname>, -<varname>cx1</varname>, <varname>cy1</varname>, <varname>cx2</varname>, -<varname>cx2</varname>, <varname>x2</varname>, <varname>y2</varname>, -<varname>p2</varname>, where (<varname>x1</varname>,<varname>y1</varname>) is -the start position, <varname>p1</varname> is the pressure at the start, -(<varname>x2</varname>,<varname>y2</varname>) is the end position, -<varname>p2</varname> is the pressure at the end. -(<varname>cx1</varname>,<varname>cy1</varname>) and -(<varname>cx2</varname>,<varname>cy2</varname>) are the positions of the -control points.</para></listitem> - -<listitem><para>Function: <function>paintEllipse</function></para><para> -This function will paint an ellipse. It takes five arguments: -<varname>x1</varname>, <varname>y1</varname>, <varname>x2</varname>, -<varname>y2</varname>, <varname>pressure</varname>, where -(<varname>x1</varname>,<varname>y1</varname>) and -(<varname>x2</varname>,<varname>y2</varname>) are the positions of the two -centers.</para></listitem> - -<listitem><para>Function: <function>paintPolygon</function></para><para> -This function will paint a polygon. It takes two arguments: a list of x -positions and a list of y positions.</para></listitem> - -<listitem><para>Function: <function>paintRect</function></para><para> -This function will paint a rectangle. It takes five arguments: -<varname>x</varname>, <varname>y</varname>, <varname>width</varname> -<varname>height</varname>, <varname>pressure</varname>.</para></listitem> - -<listitem><para>Function: <function>paintAt</function></para><para> -This function will paint at a given position. -It takes three arguments: <varname>x</varname>, <varname>y</varname>, -<varname>pressure</varname>.</para></listitem> - -<listitem><para>Function: <function>setPaintColor</function></para><para> -This function sets the paint color (also called foreground color). It takes -one argument: a <classname>Color</classname>.</para></listitem> - -<listitem><para>Function: <function>setBackgroundColor</function></para><para> -This function sets the background color. It takes one argument: a -<classname>Color</classname>.</para></listitem> - -<listitem><para>Function: <function>setPattern</function></para><para> -This function sets the pattern used for filling. It takes one argument: a -<classname>Pattern</classname> object.</para></listitem> - -<listitem><para>Function: <function>setBrush</function></para><para> -This function sets the brush used for painting. It takes one argument: a -<classname>Brush</classname> object.</para></listitem> - -<listitem><para>Function: <function>setPaintOp</function></para><para> -This function defines the paint operation. It takes one argument: the name of -the paint operation.</para></listitem> - -<listitem><para>Function: <function>setDuplicateOffset</function></para><para> -This function defines the duplicate offset. It takes two arguments: the -horizontal offset and the vertical offset.</para></listitem> - -<listitem><para>Function: <function>setOpacity</function></para><para> -This function set the opacity of the painting. It takes one argument: the -opacity, in the range 0 to 255.</para></listitem> - -<listitem><para>Function: <function>setStrokeStyle</function></para><para> -This function sets the style of the stroke. It takes one argument: 0 for none, -or 1 for brush.</para></listitem> - -<listitem><para>Function: <function>setFillStyle</function></para><para> -This function sets the fill style of the <classname>Painter</classname>. -It takes one argument: 0 for none, 1 for fill with foreground color, 2 for -fill with background color, 3 for fill with pattern.</para></listitem> -</itemizedlist> -</listitem> - -<listitem><para>Object: <classname>Iterator</classname></para><para> -This object allows you to change pixel values one by one. -The name of some functions depends on the colorspace, for instance, if the -colorspace of the layer is RGB, you will have <function>setR</function>, -<function>setG</function> and <function>setB</function>, and for -CMYK: <function>setC</function>, <function>setM</function>, -<function>setY</function> and <function>setK</function>. In the documentation -below we will assume that the colorspace is called ABC, with three channels: -A, B and C.</para> - -<itemizedlist> -<listitem><para>Functions: <function>setA</function>, -<function>setB</function>, <function>setC</function></para><para> -Those functions take one argument: the new value of one of the channels of -this pixel.</para></listitem> - -<listitem><para>Function: <function>setABC</function></para><para> -Set the value of all channels. This function takes one argument: an array with -the new values for all channels.</para></listitem> - -<listitem><para>Functions: <function>getA</function>, -<function>getB</function>, <function>getC</function></para><para> -Return the value of one of the channels of this pixel.</para></listitem> - -<listitem><para>Function: <function>getABC</function></para><para> -Return an array with the values of all channels.</para></listitem> - -<listitem><para>Function: <function>darken</function></para><para> -Darken a pixel. This function takes at least one argument: -<varname>shade</varname> (amount used to darken all color channels). This -function can take the following optional argument: -<varname>compensation</varname> (to limit the darkening).</para></listitem> - -<listitem><para>Function: <function>invertColor</function></para><para> -Invert the color of a pixel.</para></listitem> - -<listitem><para>Function: <function>next</function></para><para> -Increment the position, go to the next pixel.</para></listitem> - -<listitem><para>Function: <function>isDone</function></para><para> -Return true if the iterator is at the end (no more pixels are -available).</para></listitem> -</itemizedlist> -</listitem> -</itemizedlist> - -</sect2> - -<sect2 id="developers-scripting-resources"> -<title>Resources</title> - -<para> -Here are hints or partial lists of resources for &krita;. -</para><para> -For <classname>Brush</classname> and <classname>Pattern</classname>: You can get -the name and the associated brush or pattern from the selector in &krita;'s -toolbar. -</para><para> -A list of ids for colorspaces in &krita;: LABA, RGBA, RGBA16, RGBAF32, -RGBAF16HALF, LMSAF32, GRAYA, GRAYA16, CMYK, CMYKA16. -</para> -</sect2> - -</sect1> - diff --git a/doc/krita/developers.docbook b/doc/krita/developers.docbook deleted file mode 100644 index 27549530..00000000 --- a/doc/krita/developers.docbook +++ /dev/null @@ -1,13 +0,0 @@ -<chapter id="developers"> -<title>Developer's information</title> - -<para> -This chapter contains information for developers or other enthousiasts who -want to get more out of &krita;. -</para> - -&developers-scripting; -&developers-plugins; - -</chapter> - diff --git a/doc/krita/dialogs-addpalette.png b/doc/krita/dialogs-addpalette.png Binary files differdeleted file mode 100644 index 6f249d96..00000000 --- a/doc/krita/dialogs-addpalette.png +++ /dev/null diff --git a/doc/krita/dialogs-blur.png b/doc/krita/dialogs-blur.png Binary files differdeleted file mode 100644 index 3318d844..00000000 --- a/doc/krita/dialogs-blur.png +++ /dev/null diff --git a/doc/krita/dialogs-brightnesscontrast.png b/doc/krita/dialogs-brightnesscontrast.png Binary files differdeleted file mode 100644 index 39d8c652..00000000 --- a/doc/krita/dialogs-brightnesscontrast.png +++ /dev/null diff --git a/doc/krita/dialogs-bumpmap.png b/doc/krita/dialogs-bumpmap.png Binary files differdeleted file mode 100644 index 5c20347f..00000000 --- a/doc/krita/dialogs-bumpmap.png +++ /dev/null diff --git a/doc/krita/dialogs-coloradjustment.png b/doc/krita/dialogs-coloradjustment.png Binary files differdeleted file mode 100644 index b18a8023..00000000 --- a/doc/krita/dialogs-coloradjustment.png +++ /dev/null diff --git a/doc/krita/dialogs-colorrange.png b/doc/krita/dialogs-colorrange.png Binary files differdeleted file mode 100644 index 6f11b374..00000000 --- a/doc/krita/dialogs-colorrange.png +++ /dev/null diff --git a/doc/krita/dialogs-colortoalpha.png b/doc/krita/dialogs-colortoalpha.png Binary files differdeleted file mode 100644 index bc99c3e8..00000000 --- a/doc/krita/dialogs-colortoalpha.png +++ /dev/null diff --git a/doc/krita/dialogs-colortransfer.png b/doc/krita/dialogs-colortransfer.png Binary files differdeleted file mode 100644 index 00d86095..00000000 --- a/doc/krita/dialogs-colortransfer.png +++ /dev/null diff --git a/doc/krita/dialogs-convertimagetype.png b/doc/krita/dialogs-convertimagetype.png Binary files differdeleted file mode 100644 index 3df33c65..00000000 --- a/doc/krita/dialogs-convertimagetype.png +++ /dev/null diff --git a/doc/krita/dialogs-convertlayertype.png b/doc/krita/dialogs-convertlayertype.png Binary files differdeleted file mode 100644 index 85f6977c..00000000 --- a/doc/krita/dialogs-convertlayertype.png +++ /dev/null diff --git a/doc/krita/dialogs-cubism.png b/doc/krita/dialogs-cubism.png Binary files differdeleted file mode 100644 index b2e3b741..00000000 --- a/doc/krita/dialogs-cubism.png +++ /dev/null diff --git a/doc/krita/dialogs-customconvolution.png b/doc/krita/dialogs-customconvolution.png Binary files differdeleted file mode 100644 index ee15631b..00000000 --- a/doc/krita/dialogs-customconvolution.png +++ /dev/null diff --git a/doc/krita/dialogs-documentinformation.png b/doc/krita/dialogs-documentinformation.png Binary files differdeleted file mode 100644 index 2462853f..00000000 --- a/doc/krita/dialogs-documentinformation.png +++ /dev/null diff --git a/doc/krita/dialogs-dropshadow.png b/doc/krita/dialogs-dropshadow.png Binary files differdeleted file mode 100644 index c2e0b15f..00000000 --- a/doc/krita/dialogs-dropshadow.png +++ /dev/null diff --git a/doc/krita/dialogs-emboss.png b/doc/krita/dialogs-emboss.png Binary files differdeleted file mode 100644 index 552d4676..00000000 --- a/doc/krita/dialogs-emboss.png +++ /dev/null diff --git a/doc/krita/dialogs-filtersgallery.png b/doc/krita/dialogs-filtersgallery.png Binary files differdeleted file mode 100644 index 492a506b..00000000 --- a/doc/krita/dialogs-filtersgallery.png +++ /dev/null diff --git a/doc/krita/dialogs-gaussiannoise.png b/doc/krita/dialogs-gaussiannoise.png Binary files differdeleted file mode 100644 index 3de3ace9..00000000 --- a/doc/krita/dialogs-gaussiannoise.png +++ /dev/null diff --git a/doc/krita/dialogs-histogram.png b/doc/krita/dialogs-histogram.png Binary files differdeleted file mode 100644 index 252e3a31..00000000 --- a/doc/krita/dialogs-histogram.png +++ /dev/null diff --git a/doc/krita/dialogs-imageproperties.png b/doc/krita/dialogs-imageproperties.png Binary files differdeleted file mode 100644 index 893cf95d..00000000 --- a/doc/krita/dialogs-imageproperties.png +++ /dev/null diff --git a/doc/krita/dialogs-imagerestoration.png b/doc/krita/dialogs-imagerestoration.png Binary files differdeleted file mode 100644 index 16b1ae2c..00000000 --- a/doc/krita/dialogs-imagerestoration.png +++ /dev/null diff --git a/doc/krita/dialogs-imagesize.png b/doc/krita/dialogs-imagesize.png Binary files differdeleted file mode 100644 index 5028a38e..00000000 --- a/doc/krita/dialogs-imagesize.png +++ /dev/null diff --git a/doc/krita/dialogs-layerproperties.png b/doc/krita/dialogs-layerproperties.png Binary files differdeleted file mode 100644 index 83c6738d..00000000 --- a/doc/krita/dialogs-layerproperties.png +++ /dev/null diff --git a/doc/krita/dialogs-layersize.png b/doc/krita/dialogs-layersize.png Binary files differdeleted file mode 100644 index afab719f..00000000 --- a/doc/krita/dialogs-layersize.png +++ /dev/null diff --git a/doc/krita/dialogs-lenscorrection.png b/doc/krita/dialogs-lenscorrection.png Binary files differdeleted file mode 100644 index c550758c..00000000 --- a/doc/krita/dialogs-lenscorrection.png +++ /dev/null diff --git a/doc/krita/dialogs-newadjustmentlayer.png b/doc/krita/dialogs-newadjustmentlayer.png Binary files differdeleted file mode 100644 index 67ff729b..00000000 --- a/doc/krita/dialogs-newadjustmentlayer.png +++ /dev/null diff --git a/doc/krita/dialogs-newlayer.png b/doc/krita/dialogs-newlayer.png Binary files differdeleted file mode 100644 index acb22f10..00000000 --- a/doc/krita/dialogs-newlayer.png +++ /dev/null diff --git a/doc/krita/dialogs-oilpaint.png b/doc/krita/dialogs-oilpaint.png Binary files differdeleted file mode 100644 index 71d277cd..00000000 --- a/doc/krita/dialogs-oilpaint.png +++ /dev/null diff --git a/doc/krita/dialogs-pixelize.png b/doc/krita/dialogs-pixelize.png Binary files differdeleted file mode 100644 index 6ae16526..00000000 --- a/doc/krita/dialogs-pixelize.png +++ /dev/null diff --git a/doc/krita/dialogs-raindrops.png b/doc/krita/dialogs-raindrops.png Binary files differdeleted file mode 100644 index 65e462aa..00000000 --- a/doc/krita/dialogs-raindrops.png +++ /dev/null diff --git a/doc/krita/dialogs-randomnoise.png b/doc/krita/dialogs-randomnoise.png Binary files differdeleted file mode 100644 index 405d4313..00000000 --- a/doc/krita/dialogs-randomnoise.png +++ /dev/null diff --git a/doc/krita/dialogs-randompick.png b/doc/krita/dialogs-randompick.png Binary files differdeleted file mode 100644 index 8eb4f47d..00000000 --- a/doc/krita/dialogs-randompick.png +++ /dev/null diff --git a/doc/krita/dialogs-rotateimage.png b/doc/krita/dialogs-rotateimage.png Binary files differdeleted file mode 100644 index 2f18b18e..00000000 --- a/doc/krita/dialogs-rotateimage.png +++ /dev/null diff --git a/doc/krita/dialogs-rotatelayer.png b/doc/krita/dialogs-rotatelayer.png Binary files differdeleted file mode 100644 index ebbdfc0b..00000000 --- a/doc/krita/dialogs-rotatelayer.png +++ /dev/null diff --git a/doc/krita/dialogs-roundcorners.png b/doc/krita/dialogs-roundcorners.png Binary files differdeleted file mode 100644 index 141ed039..00000000 --- a/doc/krita/dialogs-roundcorners.png +++ /dev/null diff --git a/doc/krita/dialogs-separateimage.png b/doc/krita/dialogs-separateimage.png Binary files differdeleted file mode 100644 index 9e807a44..00000000 --- a/doc/krita/dialogs-separateimage.png +++ /dev/null diff --git a/doc/krita/dialogs-shearimage.png b/doc/krita/dialogs-shearimage.png Binary files differdeleted file mode 100644 index 384486b7..00000000 --- a/doc/krita/dialogs-shearimage.png +++ /dev/null diff --git a/doc/krita/dialogs-shearlayer.png b/doc/krita/dialogs-shearlayer.png Binary files differdeleted file mode 100644 index bf6903c8..00000000 --- a/doc/krita/dialogs-shearlayer.png +++ /dev/null diff --git a/doc/krita/dialogs-smalltiles.png b/doc/krita/dialogs-smalltiles.png Binary files differdeleted file mode 100644 index 5581d6a3..00000000 --- a/doc/krita/dialogs-smalltiles.png +++ /dev/null diff --git a/doc/krita/dialogs-sobel.png b/doc/krita/dialogs-sobel.png Binary files differdeleted file mode 100644 index b2a8e0e4..00000000 --- a/doc/krita/dialogs-sobel.png +++ /dev/null diff --git a/doc/krita/dialogs-substrate.png b/doc/krita/dialogs-substrate.png Binary files differdeleted file mode 100644 index e9fbf0fa..00000000 --- a/doc/krita/dialogs-substrate.png +++ /dev/null diff --git a/doc/krita/dialogs-unsharpmask.png b/doc/krita/dialogs-unsharpmask.png Binary files differdeleted file mode 100644 index 882faf39..00000000 --- a/doc/krita/dialogs-unsharpmask.png +++ /dev/null diff --git a/doc/krita/dialogs-wave.png b/doc/krita/dialogs-wave.png Binary files differdeleted file mode 100644 index ab1559be..00000000 --- a/doc/krita/dialogs-wave.png +++ /dev/null diff --git a/doc/krita/dialogs-waveletnoise.png b/doc/krita/dialogs-waveletnoise.png Binary files differdeleted file mode 100644 index d126eff5..00000000 --- a/doc/krita/dialogs-waveletnoise.png +++ /dev/null diff --git a/doc/krita/faq.docbook b/doc/krita/faq.docbook deleted file mode 100644 index 91ac0b1e..00000000 --- a/doc/krita/faq.docbook +++ /dev/null @@ -1,51 +0,0 @@ -<chapter id="faq"> -<title>Questions and Answers</title> - -<para> -Sometimes, stuff does not work as one would like. &krita; can crash — not all -that often, these days, but still. So you might need some help. The first thing -to do is trying to determine what was going on, exactly. Try to reproduce the -problem and write down what you did before the problem occurred. -</para><para> -Then you can create a bug report: go to the <guimenu>Help</guimenu> menu and select -<guimenuitem>Report Bug</guimenuitem>. That way, we know exactly which version of -&krita; you are using. Please try to make reasonably sure that your problem has -not been reported already! Also, please try to be as complete as possible in -describing your problem. -</para><para> -You can also, if it is just that you cannot figure out how to do something -that you can do using Photoshop (or any other drawing program) using &krita;, -or if you have some other question, e-mail the &krita; developers at our -mailing list <email>[email protected]</email>, or e-mail the program or -documentation maintainer directly at <email>[email protected]</email> or -<email>[email protected]</email>, respectively. -</para> - -<!-- TODO Add a set of Q&As? --> - -&reporting.bugs; -&updating.documentation; - -<!-- <qandaset id="faqlist"> -<qandaentry> -<question> -<para>My Mouse doesn't work. How do I quit &kmyapplication;?</para> -</question> -<answer> -<para>You silly goose! Check out the <link linkend="commands">Commands -Section</link> for the answer.</para> -</answer> -</qandaentry> -<qandaentry> -<question> -<para>Why can't I twiddle my documents?</para> -</question> -<answer> -<para>You can only twiddle your documents if you have the foobar.lib -installed.</para> -</answer> -</qandaentry> -</qandaset> --> - -</chapter> - diff --git a/doc/krita/index.docbook b/doc/krita/index.docbook deleted file mode 100644 index b5ef3c1b..00000000 --- a/doc/krita/index.docbook +++ /dev/null @@ -1,137 +0,0 @@ -<?xml version="1.0" ?> -<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [ - <!ENTITY kappname "&krita;"> - <!ENTITY package "koffice"> - <!ENTITY % addindex "IGNORE"> - <!ENTITY % English "INCLUDE"> - <!ENTITY introduction SYSTEM "introduction.docbook"> - <!ENTITY tutorial SYSTEM "tutorial.docbook"> - <!ENTITY tutorial-starting SYSTEM "tutorial-starting.docbook"> - <!ENTITY tutorial-select-layer SYSTEM "tutorial-select-layer.docbook"> - <!ENTITY tutorial-quick-starts SYSTEM "tutorial-quick-starts.docbook"> - <!ENTITY tutorial-tablet SYSTEM "tutorial-tablet.docbook"> - <!ENTITY images SYSTEM "using-images.docbook"> - <!ENTITY views SYSTEM "using-views.docbook"> - <!ENTITY layers SYSTEM "using-layers.docbook"> - <!ENTITY selections SYSTEM "using-selections.docbook"> - <!ENTITY filters SYSTEM "using-filters.docbook"> - <!ENTITY colorspaces SYSTEM "using-colorspaces.docbook"> - <!ENTITY commands SYSTEM "commands.docbook"> - <!ENTITY commands-toolbars SYSTEM "commands-toolbars.docbook"> - <!ENTITY commands-palettes SYSTEM "commands-palettes.docbook"> - <!ENTITY commands-menus SYSTEM "commands-menus.docbook"> - <!ENTITY commands-dialogs SYSTEM "commands-dialogs.docbook"> - <!ENTITY settings SYSTEM "settings.docbook"> - <!ENTITY developers SYSTEM "developers.docbook"> - <!ENTITY developers-scripting SYSTEM "developers-scripting.docbook"> - <!ENTITY developers-plugins SYSTEM "developers-plugins.docbook"> - <!ENTITY faq SYSTEM "faq.docbook"> - <!ENTITY credits SYSTEM "credits.docbook"> - <!ENTITY installation SYSTEM "installation.docbook"> -]> - -<book lang="&language;"> - -<bookinfo> -<title>The &krita; Handbook</title> - -<authorgroup> -<author> -<personname> -<firstname>Boudewijn</firstname> -<surname>Rempt</surname> -</personname> -<email>[email protected]</email> -</author> -<author> -<personname> -<firstname>Casper</firstname> -<surname>Boemann</surname> -</personname> -<email>[email protected]</email> -</author> -<author> -<personname> -<firstname>Cyrille</firstname> -<surname>Berger</surname> -</personname> -<email>[email protected]</email> -</author> -<author> -<personname> -<firstname>Sander</firstname> -<surname>Koning</surname> -</personname> -<email>[email protected]</email> -</author> -<!-- TRANS:ROLES_OF_TRANSLATORS --> -</authorgroup> - -<copyright> -<year>2005-2006</year> -<holder>Boudewijn Rempt</holder> -<holder>Casper Boemann</holder> -<holder>Cyrille Berger</holder> -<holder>Sander Koning</holder> -</copyright> - -<legalnotice>&FDLNotice;</legalnotice> - -<!-- Date and version information of the documentation --> - -<date>2006-09-13</date> -<releaseinfo>1.6</releaseinfo> - -<!-- Abstract about this handbook --> - -<abstract> -<para> -&krita; is part of the &koffice; package. &krita; is a photo retouching, image -editing application, but above all, a paint application that will allow you to -create original art on your computer as if you were working with paint and -brushes, pencils, pen and ink — or, at least, it will one day. We are -continually working on extending &krita; and making it better in every respect. -</para> -</abstract> - -<keywordset> -<keyword>KDE</keyword> -<keyword>koffice</keyword> -<keyword>Krita</keyword> -<keyword>image manipulation</keyword> -<keyword>graphics</keyword> -<keyword>painting</keyword> -</keywordset> - -</bookinfo> - -&introduction; -&tutorial; -&images; -&views; -&layers; -&selections; -&filters; -&colorspaces; -&commands; -&settings; -&developers; -&faq; -&credits; -&installation; - -&documentation.index; -</book> - -<!-- -Local Variables: -mode: xml -sgml-minimize-attributes:nil -sgml-general-insert-case:lower -sgml-indent-step:0 -sgml-indent-data:nil -End: - -vim:tabstop=2:shiftwidth=2:expandtab -kate: space-indent on; indent-width 2; tab-width 2; indent-mode none; ---> diff --git a/doc/krita/installation.docbook b/doc/krita/installation.docbook deleted file mode 100644 index 83158a74..00000000 --- a/doc/krita/installation.docbook +++ /dev/null @@ -1,73 +0,0 @@ -<appendix id="installation"> -<title>Installation</title> - -<sect1 id="getting-kapp"> -<title>How to obtain &krita;</title> - -<!-- This first entity contains boiler plate for applications that are -part of KDE CVS. You should remove it if you are releasing your -application --> - -&install.intro.documentation; - -</sect1> - -<sect1 id="requirements"> -<title>Requirements</title> - -<!-- -List any special requirements for your application here. This should include: -.Libraries or other software that is not included in kdesupport, -kdelibs, or kdebase. -.Hardware requirements like amount of RAM, disk space, graphics card -capabilities, screen resolution, special expansion cards, etc. -.Operating systems the app will run on. If your app is designed only for a -specific OS, (you wrote a graphical LILO configurator for example) put this -information here. ---> - -<para> -&krita; depends on the following libraries, apart from what &koffice; needs -itself: -</para> -<itemizedlist> -<listitem><para><ulink url="http://www.imagemagick.org/">Image -Magick</ulink> — X11 Image Processing and Display -Package</para></listitem> -<listitem><para><ulink url="http://www.littlecms.com/">Little CMS</ulink> -— A free color management system in 100K</para></listitem> -<listitem><para><ulink -url="http://www.openexr.com/">OpenEXR</ulink></para></listitem> -</itemizedlist> - -<!-- For a list of updates, you may refer to the application web site -or the ChangeLog file, or ... --> -<para> -You can find a list of changes in the <filename>ChangeLog</filename> file or on -<ulink url="http://koffice.org/krita/">&krita;'s website</ulink>. -</para> -</sect1> - -<sect1 id="compilation"> -<title>Compilation and Installation</title> - -<!-- This entity contains the boilerplate text for standard --> -<!-- compilation instructions. If your application requires any --> -<!-- special handling, remove it, and replace with your own text. --> - -&install.compile.documentation; - -</sect1> - -<!-- -<sect1 id="configuration"> -<title>Configuration</title> - -<para>Don't forget to tell your system to start the <filename>dtd</filename> -dicer-toaster daemon first, or &kmyapplication; won't work !</para> - -</sect1> ---> - -</appendix> - diff --git a/doc/krita/introduction.docbook b/doc/krita/introduction.docbook deleted file mode 100644 index 7441f80d..00000000 --- a/doc/krita/introduction.docbook +++ /dev/null @@ -1,153 +0,0 @@ -<chapter id="introduction"> -<title>Introduction</title> - -<sect1 id="introduction-krita"> -<title>What is &krita;?</title> -<para> -&krita;, part of &koffice;, can do everything you want with images — or -it will be able to one day. Everything from photo retouching, image editing, -and last but not least creating original art on your computer as if you were -working with real paint and brushes, pencils, pen and ink. Every day -&krita; becomes a little better, a little more useful. We are working on it, -anyway. We, that is, Adrian, Bart, Boudewijn, Casper, Cyrille, Michael and Sven. -It could be you, too — whether you would like to help with some artwork -for the user interface, cool ideas for the todo, helpful bug reports, usability -reviews or even actual code, you will not be snubbed by us. -</para> -<para> -&krita; is as much yours as it is ours. It should be fun, innovative, and -experimental — first and foremost a pleasure to use and to hack on. -</para> -</sect1> - -<sect1 id="introduction-keyfeatures"> -<title>Key features</title> - -<para>The most important features &krita; currently has to offer, are:</para> -<itemizedlist> - -<listitem><para>Plugins: Krita is extensible through plugins. There are tools, -colorspaces, paint operations, filters and kpart-based user interface plugins. -</para></listitem> - -<listitem><para>Scriptable: &krita; is scriptable in Python and Ruby using -Kross, the cross language scripting engine that originated in Kexi. The -scripting is compatible with PyQt/KDE and Korundum for adding GUI -items, such as dialog boxes.</para></listitem> - -<listitem><para>Color models: &krita; uses lcms for a dependable color -workflow using icc profiles for importing, exporting, selecting paint colors, -printing, cutting and pasting. 8, 16, and 32 bit colorspaces are available -(RGB, CMYK, L*a*b*, ...) and colors can be selected from a color wheel, rgb or -grayscale sliders or with a palette.</para></listitem> - -<listitem><para>Editing and viewing: Unlimited undo and redo are available. -You can cut, copy and paste between lagers and images, with conversion through -icc profiles if this is necessary. OpenGL is supported for display. The view -can be made fullscreen and can be split. Rulers are available, the -image can be zoomed, and for maximizing the workspace all palette windows can -be hidden in one go. Also a histogram palette is available.</para></listitem> - -<listitem><para>Images and layers: Layers and entire images can be mirrored, -sheared, rotated and scaled, converted between colorspaces, and layers in -different colorspaces can be merged. An image can be separated into colorspace -channels.</para></listitem> - -<listitem><para>Layers: Layers can be added, removed, grouped, locked, made -(in)visible, and re-ordered. Adjustment layers (layers which perform a filter -function) can be added as well. A layer can be saved as a separate image and -its colorspace can be changed.</para></listitem> - -<listitem><para>Tools: Through the innovative paintOp plugin system, all -painting tools (brush, ellipse, line, etc.) can paint aliased, anti-aliased, -erase, airbrush and more.</para></listitem> - -<listitem><para>Filters: &krita; can multithread the operation of some -filters. Filters can be previewed in the filter gallery. Available filters -include color adjustment, sharpen or blur, emboss, raindrops, and -more.</para></listitem> - -<listitem><para>Brushes: The GIMP brush shapes can be used, both colored and -grayscale brushes and pipe brushes. Custom brushes can be created, even from -entire layers or images. Colored brushes can also be used as -masks.</para></listitem> - -</itemizedlist> - -<sect2 id="introduction-keyfeatures-colormanagement"> -<title>Color management</title> -<para> -One of the most distinguishing features in &krita; is its color management. -If you put two screens side to side, you will notice that there is often a lot -of difference in the way they display colors. Even white, especially white, is -often not the same thing at all. On one screen it can be a dirty yellow, on -another screen a sickly bluish. Very seldom is it a creamy milk-white. The same -holds, unfortunately, for scanners, printers and digital cameras. So, if you -want to see the right colors on screen and on paper, being the colors that you -saw when taking your snapshot, you will have to compensate. -</para><para> -&krita; can do this for you: in &krita;, a color is (almost) never just a set of -numbers, one for each color channel; it is a set of numbers with information -attached. And that extra information is contained in a profile: your image has a -profile, your scanner has a profile, your camera should have a profile and your -screen has a profile. When passing information from your image to your screen, -the profiles are checked and the correct color is computed. This may cause a -little slowness, now and then, but the result is that you can work with colors, -instead of almost meaningless RGB triplets. -</para><para> -Available colorspaces are: 8 bit/channel RGB, CMYK, grayscale and wet -watercolors, 16 bit/channel RGB, CMYK, grayscale and L*a*b*, <quote>half</quote> -RGB, and 32 bit float RGB (HDR) and LMS. -</para> -</sect2> - -<sect2 id="introduction-keyfeatures-imageformats"> -<title>Image formats</title> -<para> -&krita; currently supports the following image formats, both for importing and -exporting, apart from its own: PNG, TIFF, JPEG, Dicom, XCF, PSD, GIF, BMP, -XPM, Targa, RGB, and OpenEXR. Additionally, &krita; can import -ICO files. PSD (the Photoshop file format) is only supported up to version 6, -from version 7 on, the Photoshop file format is closed. -</para><para> -Embedded icc profiles and exif information are preserved on export to -supporting file formats. &krita;'s native file format stores icc and exif -information. -</para> -</sect2> - -</sect1> - -<sect1 id="introduction-manual"> -<title>About this manual</title> -<para> -We are assuming you have got a good working knowledge of &kde; and of your -operating system. The first chapter will give you a quick tour of &krita;'s -cool features; the other chapters will expand on that information. -</para> -<note><para> -This manual is not complete. The invitation to join us and help out extends to -the manual, too! -</para></note> -<para> -Should you have any questions, comments or suggestions, please contact the -documentation maintainer at <email>[email protected]</email>. -</para> -</sect1> - -<sect1 id="introduction-maintainer"> -<title>About the application maintainer</title> -<para> -Hi! I'm Boudewijn Rempt — the current maintainer of &krita;. I was -educated as a linguist, retrained as a database developer, work as a Java -hacker, study theology and I have always liked to paint and sketch a little. -Conspiciously absent in my life have been two important things for a developer -of an image app: mathematics and experience with graphic design. That means that -I am probably not the best person to explain the niceties of using an image -editor or a paint application to you. If you catch me in an error, please don't -hesitate to mail me: <email>[email protected]</email>. -</para> -</sect1> - -</chapter> - diff --git a/doc/krita/mainscreen.png b/doc/krita/mainscreen.png Binary files differdeleted file mode 100644 index cce13569..00000000 --- a/doc/krita/mainscreen.png +++ /dev/null diff --git a/doc/krita/mountains-burn.png b/doc/krita/mountains-burn.png Binary files differdeleted file mode 100644 index 812c89d2..00000000 --- a/doc/krita/mountains-burn.png +++ /dev/null diff --git a/doc/krita/mountains-color.png b/doc/krita/mountains-color.png Binary files differdeleted file mode 100644 index aa34bece..00000000 --- a/doc/krita/mountains-color.png +++ /dev/null diff --git a/doc/krita/mountains-darken.png b/doc/krita/mountains-darken.png Binary files differdeleted file mode 100644 index 3b1ba616..00000000 --- a/doc/krita/mountains-darken.png +++ /dev/null diff --git a/doc/krita/mountains-divide.png b/doc/krita/mountains-divide.png Binary files differdeleted file mode 100644 index b2778f65..00000000 --- a/doc/krita/mountains-divide.png +++ /dev/null diff --git a/doc/krita/mountains-dodge.png b/doc/krita/mountains-dodge.png Binary files differdeleted file mode 100644 index 47f198a9..00000000 --- a/doc/krita/mountains-dodge.png +++ /dev/null diff --git a/doc/krita/mountains-hue.png b/doc/krita/mountains-hue.png Binary files differdeleted file mode 100644 index 09adb913..00000000 --- a/doc/krita/mountains-hue.png +++ /dev/null diff --git a/doc/krita/mountains-lighten.png b/doc/krita/mountains-lighten.png Binary files differdeleted file mode 100644 index 8149ef33..00000000 --- a/doc/krita/mountains-lighten.png +++ /dev/null diff --git a/doc/krita/mountains-multiply.png b/doc/krita/mountains-multiply.png Binary files differdeleted file mode 100644 index a8769394..00000000 --- a/doc/krita/mountains-multiply.png +++ /dev/null diff --git a/doc/krita/mountains-normal.png b/doc/krita/mountains-normal.png Binary files differdeleted file mode 100644 index 675eb53b..00000000 --- a/doc/krita/mountains-normal.png +++ /dev/null diff --git a/doc/krita/mountains-original.png b/doc/krita/mountains-original.png Binary files differdeleted file mode 100644 index 1927e618..00000000 --- a/doc/krita/mountains-original.png +++ /dev/null diff --git a/doc/krita/mountains-overlay.png b/doc/krita/mountains-overlay.png Binary files differdeleted file mode 100644 index 4351c1b6..00000000 --- a/doc/krita/mountains-overlay.png +++ /dev/null diff --git a/doc/krita/mountains-saturation.png b/doc/krita/mountains-saturation.png Binary files differdeleted file mode 100644 index 2893ed9e..00000000 --- a/doc/krita/mountains-saturation.png +++ /dev/null diff --git a/doc/krita/mountains-screen.png b/doc/krita/mountains-screen.png Binary files differdeleted file mode 100644 index 4d0f9223..00000000 --- a/doc/krita/mountains-screen.png +++ /dev/null diff --git a/doc/krita/mountains-value.png b/doc/krita/mountains-value.png Binary files differdeleted file mode 100644 index 29714b93..00000000 --- a/doc/krita/mountains-value.png +++ /dev/null diff --git a/doc/krita/mountains.png b/doc/krita/mountains.png Binary files differdeleted file mode 100644 index 78c9ca86..00000000 --- a/doc/krita/mountains.png +++ /dev/null diff --git a/doc/krita/newimage.png b/doc/krita/newimage.png Binary files differdeleted file mode 100644 index 210f0912..00000000 --- a/doc/krita/newimage.png +++ /dev/null diff --git a/doc/krita/palettes-colors-gray.png b/doc/krita/palettes-colors-gray.png Binary files differdeleted file mode 100644 index 23bd973a..00000000 --- a/doc/krita/palettes-colors-gray.png +++ /dev/null diff --git a/doc/krita/palettes-colors-hsv.png b/doc/krita/palettes-colors-hsv.png Binary files differdeleted file mode 100644 index 2ff42357..00000000 --- a/doc/krita/palettes-colors-hsv.png +++ /dev/null diff --git a/doc/krita/palettes-colors-palettes.png b/doc/krita/palettes-colors-palettes.png Binary files differdeleted file mode 100644 index 4f0b379a..00000000 --- a/doc/krita/palettes-colors-palettes.png +++ /dev/null diff --git a/doc/krita/palettes-colors-rgb.png b/doc/krita/palettes-colors-rgb.png Binary files differdeleted file mode 100644 index bbf64883..00000000 --- a/doc/krita/palettes-colors-rgb.png +++ /dev/null diff --git a/doc/krita/palettes-colors-watercolors.png b/doc/krita/palettes-colors-watercolors.png Binary files differdeleted file mode 100644 index 63fae210..00000000 --- a/doc/krita/palettes-colors-watercolors.png +++ /dev/null diff --git a/doc/krita/palettes-controlbox-bezier.png b/doc/krita/palettes-controlbox-bezier.png Binary files differdeleted file mode 100644 index 4e42caee..00000000 --- a/doc/krita/palettes-controlbox-bezier.png +++ /dev/null diff --git a/doc/krita/palettes-controlbox-brush.png b/doc/krita/palettes-controlbox-brush.png Binary files differdeleted file mode 100644 index c3c3ed08..00000000 --- a/doc/krita/palettes-controlbox-brush.png +++ /dev/null diff --git a/doc/krita/palettes-controlbox-colorpicker.png b/doc/krita/palettes-controlbox-colorpicker.png Binary files differdeleted file mode 100644 index 7733c18d..00000000 --- a/doc/krita/palettes-controlbox-colorpicker.png +++ /dev/null diff --git a/doc/krita/palettes-controlbox-contiguousfill.png b/doc/krita/palettes-controlbox-contiguousfill.png Binary files differdeleted file mode 100644 index 57777af9..00000000 --- a/doc/krita/palettes-controlbox-contiguousfill.png +++ /dev/null diff --git a/doc/krita/palettes-controlbox-crop.png b/doc/krita/palettes-controlbox-crop.png Binary files differdeleted file mode 100644 index 79091134..00000000 --- a/doc/krita/palettes-controlbox-crop.png +++ /dev/null diff --git a/doc/krita/palettes-controlbox-duplicate.png b/doc/krita/palettes-controlbox-duplicate.png Binary files differdeleted file mode 100644 index 74ec92e4..00000000 --- a/doc/krita/palettes-controlbox-duplicate.png +++ /dev/null diff --git a/doc/krita/palettes-controlbox-ellipse.png b/doc/krita/palettes-controlbox-ellipse.png Binary files differdeleted file mode 100644 index 14ab3733..00000000 --- a/doc/krita/palettes-controlbox-ellipse.png +++ /dev/null diff --git a/doc/krita/palettes-controlbox-fill.png b/doc/krita/palettes-controlbox-fill.png Binary files differdeleted file mode 100644 index 1120d06b..00000000 --- a/doc/krita/palettes-controlbox-fill.png +++ /dev/null diff --git a/doc/krita/palettes-controlbox-gradient.png b/doc/krita/palettes-controlbox-gradient.png Binary files differdeleted file mode 100644 index 857824c3..00000000 --- a/doc/krita/palettes-controlbox-gradient.png +++ /dev/null diff --git a/doc/krita/palettes-controlbox-histogram.png b/doc/krita/palettes-controlbox-histogram.png Binary files differdeleted file mode 100644 index 1dccaecd..00000000 --- a/doc/krita/palettes-controlbox-histogram.png +++ /dev/null diff --git a/doc/krita/palettes-controlbox-line.png b/doc/krita/palettes-controlbox-line.png Binary files differdeleted file mode 100644 index c0671204..00000000 --- a/doc/krita/palettes-controlbox-line.png +++ /dev/null diff --git a/doc/krita/palettes-controlbox-overview.png b/doc/krita/palettes-controlbox-overview.png Binary files differdeleted file mode 100644 index 483e3ec3..00000000 --- a/doc/krita/palettes-controlbox-overview.png +++ /dev/null diff --git a/doc/krita/palettes-controlbox-paintwithfilters.png b/doc/krita/palettes-controlbox-paintwithfilters.png Binary files differdeleted file mode 100644 index 2a0ca8ef..00000000 --- a/doc/krita/palettes-controlbox-paintwithfilters.png +++ /dev/null diff --git a/doc/krita/palettes-controlbox-polygon.png b/doc/krita/palettes-controlbox-polygon.png Binary files differdeleted file mode 100644 index 47cfbbc1..00000000 --- a/doc/krita/palettes-controlbox-polygon.png +++ /dev/null diff --git a/doc/krita/palettes-controlbox-polyline.png b/doc/krita/palettes-controlbox-polyline.png Binary files differdeleted file mode 100644 index c0671204..00000000 --- a/doc/krita/palettes-controlbox-polyline.png +++ /dev/null diff --git a/doc/krita/palettes-controlbox-rectangle.png b/doc/krita/palettes-controlbox-rectangle.png Binary files differdeleted file mode 100644 index 14ab3733..00000000 --- a/doc/krita/palettes-controlbox-rectangle.png +++ /dev/null diff --git a/doc/krita/palettes-controlbox-select.png b/doc/krita/palettes-controlbox-select.png Binary files differdeleted file mode 100644 index 0d5e0010..00000000 --- a/doc/krita/palettes-controlbox-select.png +++ /dev/null diff --git a/doc/krita/palettes-controlbox-selectcontiguous.png b/doc/krita/palettes-controlbox-selectcontiguous.png Binary files differdeleted file mode 100644 index 591c8096..00000000 --- a/doc/krita/palettes-controlbox-selectcontiguous.png +++ /dev/null diff --git a/doc/krita/palettes-controlbox-selectmagnetic.png b/doc/krita/palettes-controlbox-selectmagnetic.png Binary files differdeleted file mode 100644 index 4fb3ac1b..00000000 --- a/doc/krita/palettes-controlbox-selectmagnetic.png +++ /dev/null diff --git a/doc/krita/palettes-controlbox-selectsimilar.png b/doc/krita/palettes-controlbox-selectsimilar.png Binary files differdeleted file mode 100644 index 8eb14a9e..00000000 --- a/doc/krita/palettes-controlbox-selectsimilar.png +++ /dev/null diff --git a/doc/krita/palettes-controlbox-star.png b/doc/krita/palettes-controlbox-star.png Binary files differdeleted file mode 100644 index a14f709e..00000000 --- a/doc/krita/palettes-controlbox-star.png +++ /dev/null diff --git a/doc/krita/palettes-controlbox-text.png b/doc/krita/palettes-controlbox-text.png Binary files differdeleted file mode 100644 index 98691950..00000000 --- a/doc/krita/palettes-controlbox-text.png +++ /dev/null diff --git a/doc/krita/palettes-controlbox-transform.png b/doc/krita/palettes-controlbox-transform.png Binary files differdeleted file mode 100644 index 19ff42ba..00000000 --- a/doc/krita/palettes-controlbox-transform.png +++ /dev/null diff --git a/doc/krita/palettes-layers-layers.png b/doc/krita/palettes-layers-layers.png Binary files differdeleted file mode 100644 index 06e20ff6..00000000 --- a/doc/krita/palettes-layers-layers.png +++ /dev/null diff --git a/doc/krita/palettes-layers-scriptsmanager.png b/doc/krita/palettes-layers-scriptsmanager.png Binary files differdeleted file mode 100644 index 07cea20e..00000000 --- a/doc/krita/palettes-layers-scriptsmanager.png +++ /dev/null diff --git a/doc/krita/preferences-color.png b/doc/krita/preferences-color.png Binary files differdeleted file mode 100644 index 77cc9b86..00000000 --- a/doc/krita/preferences-color.png +++ /dev/null diff --git a/doc/krita/preferences-display.png b/doc/krita/preferences-display.png Binary files differdeleted file mode 100644 index 7c4dfa36..00000000 --- a/doc/krita/preferences-display.png +++ /dev/null diff --git a/doc/krita/preferences-general.png b/doc/krita/preferences-general.png Binary files differdeleted file mode 100644 index 38232182..00000000 --- a/doc/krita/preferences-general.png +++ /dev/null diff --git a/doc/krita/preferences-grid.png b/doc/krita/preferences-grid.png Binary files differdeleted file mode 100644 index 48a9376a..00000000 --- a/doc/krita/preferences-grid.png +++ /dev/null diff --git a/doc/krita/preferences-performance.png b/doc/krita/preferences-performance.png Binary files differdeleted file mode 100644 index 045f3585..00000000 --- a/doc/krita/preferences-performance.png +++ /dev/null diff --git a/doc/krita/preferences-sidebar.png b/doc/krita/preferences-sidebar.png Binary files differdeleted file mode 100644 index cc72e177..00000000 --- a/doc/krita/preferences-sidebar.png +++ /dev/null diff --git a/doc/krita/preferences-tablet.png b/doc/krita/preferences-tablet.png Binary files differdeleted file mode 100644 index 366a46d4..00000000 --- a/doc/krita/preferences-tablet.png +++ /dev/null diff --git a/doc/krita/settings.docbook b/doc/krita/settings.docbook deleted file mode 100644 index fd72d68d..00000000 --- a/doc/krita/settings.docbook +++ /dev/null @@ -1,229 +0,0 @@ -<chapter id="settings"> - -<title>Settings</title> - -<para>This chapter describes the various settings that affect the way &krita; -functions and looks.</para> - -<sect1 id="settings-preferences"> -<title>The <guilabel>Preferences</guilabel> dialog</title> - -<para> -A number of options to configure &krita; are available via the -<guilabel>Preferences</guilabel> dialog, which is available via -<menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure -&krita;...</guimenuitem></menuchoice>. The dialog is divided into several -sections, which you can open via the sidebar at the left, shown below. -</para> - -<para> -<screenshot> -<screeninfo>The available <guilabel>Preferences</guilabel> sections</screeninfo> -<mediaobject> -<imageobject> -<imagedata fileref="preferences-sidebar.png" format="PNG" /> -</imageobject> -<textobject> -<phrase>The available <guilabel>Preferences</guilabel> sections</phrase> -</textobject> -<caption><para>The available <guilabel>Preferences</guilabel> sections</para></caption> -</mediaobject> -</screenshot> -</para> - -<sect2 id="settings-preferences-general"> -<title>The <guilabel>General</guilabel> section</title> - -<para> -<screenshot> -<screeninfo>The <guilabel>General</guilabel> section</screeninfo> -<mediaobject> -<imageobject> -<imagedata fileref="preferences-general.png" format="PNG" /> -</imageobject> -<textobject> -<phrase>The <guilabel>General</guilabel> section</phrase> -</textobject> -<caption><para>The <guilabel>General</guilabel> section</para></caption> -</mediaobject> -</screenshot> -</para> - -<para> -This section offers three options. First of all, the setting in the -<guilabel>Cursor shape:</guilabel> dropdown box determines what the drawing -cursor looks like. You can choose between a cursor resembling the actual tool -you are working with, a normal cursor, a crosshair, and a brush-shaped cursor. -Then you can select the <guilabel>Palette Behavior</guilabel>. You can set -here when palettes may be <quote>docked</quote> (set aside at a window -border): always (<guilabel>Allow docking</guilabel>), never -(<guilabel>Allow only floating</guilabel>), or when there is enough space -(<guilabel>Allow docking only on large screens</guilabel>). The last option is -<guilabel>Palette font size:</guilabel> which determines the text size used in -the palettes. Set this to a larger value if you have trouble reading the text, -with the side effect that the palettes will take more space. -</para> - -</sect2> - -<sect2 id="settings-preferences-display"> -<title>The <guilabel>Display</guilabel> section</title> - -<para> -<screenshot> -<screeninfo>The <guilabel>Display</guilabel> section</screeninfo> -<mediaobject> -<imageobject> -<imagedata fileref="preferences-display.png" format="PNG" /> -</imageobject> -<textobject> -<phrase>The <guilabel>Display</guilabel> section</phrase> -</textobject> -<caption><para>The <guilabel>Display</guilabel> section</para></caption> -</mediaobject> -</screenshot> -</para> - -<para> -This section contains just one option. If your graphics card and driver have -OpenGL support, you can enable it here to make drawing faster (the -processor of yor graphics card will take over part of the calculations). Be -warned, though: there are a few cases where enabling OpenGL is known to -introduce erratic behavior. -</para> - -</sect2> - -<sect2 id="settings-preferences-colormanagement"> -<title>The <guilabel>Color Management</guilabel> section</title> - -<para> -<screenshot> -<screeninfo>The <guilabel>Color Management</guilabel> section</screeninfo> -<mediaobject> -<imageobject> -<imagedata fileref="preferences-color.png" format="PNG" /> -</imageobject> -<textobject> -<phrase>The <guilabel>Color Management</guilabel> section</phrase> -</textobject> -<caption><para>The <guilabel>Color Management</guilabel> section</para></caption> -</mediaobject> -</screenshot> -</para> - -<para> -Here you can set various options related to colorspaces in rendering, editing -and printing of images. The topmost option can be used to set the default -color model for creating new images (useful if you usually want to create CMYK -images, for instance). Use the <guilabel>Display</guilabel> options to let -&krita; know what color profile your monitor uses, and how rendering should be -done. Under <guilabel>Printing</guilabel>, you can set the color model and -profile for your printer. The next option determines what &krita; should do -when you paste an image into it that was copied from another application. If -<guilabel>Use Blackpoint compensation</guilabel> is checked, whenever a -colorspace conversion is needed, the black points of the source and -destination colorspaces are matched. -</para> - -</sect2> - -<sect2 id="settings-preferences-performance"> -<title>The <guilabel>Performance</guilabel> section</title> - -<para> -<screenshot> -<screeninfo>The <guilabel>Performance</guilabel> section</screeninfo> -<mediaobject> -<imageobject> -<imagedata fileref="preferences-performance.png" format="PNG" /> -</imageobject> -<textobject> -<phrase>The <guilabel>Performance</guilabel> section</phrase> -</textobject> -<caption><para>The <guilabel>Performance</guilabel> section</para></caption> -</mediaobject> -</screenshot> -</para> - -<para> -Two options are available here. The <guilabel>Maximum number of tiles kept in -memory</guilabel> setting indicates how many tiles (image subparts) &krita; -will keep in memory. The default setting should be reasonable, if you are low -or very high on memory, you may want to decrease or increase this option, -respectively. The <guilabel>Swappiness:</guilabel> option determines how eager -&krita; will be to swap to disk. -</para> - -</sect2> - -<sect2 id="settings-preferences-tablet"> -<title>The <guilabel>Tablet</guilabel> section</title> - -<para> -<screenshot> -<screeninfo>The <guilabel>Tablet</guilabel> section</screeninfo> -<mediaobject> -<imageobject> -<imagedata fileref="preferences-tablet.png" format="PNG" /> -</imageobject> -<textobject> -<phrase>The <guilabel>Tablet</guilabel> section</phrase> -</textobject> -<caption><para>The <guilabel>Tablet</guilabel> section</para></caption> -</mediaobject> -</screenshot> -</para> - -<para> -If you have a tablet device attached, you can enable it and set its pressure -sensitivity in this section. -</para><para> -You need to activate the tablet devices you want to use with &krita;. There -are three supported devices: the cursor, the eraser and the stylus. You can -activate them using the tablet sections. Only use the configuration options of -a device if you use a non-Wacom tablet, and if the behavior of the tablet is -unexpected, like moving when you press on the tablet for instance. In this -situation, you can use the dialog to make sure you have a correct interaction: -values (position, pressure, tilt...) are sent from the tablet to the computer -in a given order, it might happen that some tablets do not use the default -order. You can set this in the configuration options of a device. -</para> - -</sect2> - -<sect2 id="settings-preferences-grid"> -<title>The <guilabel>Grid</guilabel> section</title> - -<para> -<screenshot> -<screeninfo>The <guilabel>Grid</guilabel> section</screeninfo> -<mediaobject> -<imageobject> -<imagedata fileref="preferences-grid.png" format="PNG" /> -</imageobject> -<textobject> -<phrase>The <guilabel>Grid</guilabel> section</phrase> -</textobject> -<caption><para>The <guilabel>Grid</guilabel> section</para></caption> -</mediaobject> -</screenshot> -</para> - -<para> -In this section, you can fine-tune &krita;'s grid. The line styles for the -grid can be set in the <guilabel>Styles</guilabel> option set. -<guilabel>Colors</guilabel> allows you to choose the line colors for the grid. -The horizontal and vertical spacing between the main lines can be set under -<guilabel>Spacing</guilabel>, as well as the amount of subdivisions (in how -many smaller parts a grid section is subdivided). Furthermore you can set the -<guilabel>Offset</guilabel>: usually the grid is painted starting at the top -left corner, if you want the first main grid lines not to start there, you can -enter an offset (displacement) here. -</para> - -</sect2> - -</sect1> - -</chapter> diff --git a/doc/krita/tool-bezier-example.png b/doc/krita/tool-bezier-example.png Binary files differdeleted file mode 100644 index 111ac2fc..00000000 --- a/doc/krita/tool-bezier-example.png +++ /dev/null diff --git a/doc/krita/tool-bezier-example2.png b/doc/krita/tool-bezier-example2.png Binary files differdeleted file mode 100644 index 607ef541..00000000 --- a/doc/krita/tool-bezier-example2.png +++ /dev/null diff --git a/doc/krita/tool-bezier-example3.png b/doc/krita/tool-bezier-example3.png Binary files differdeleted file mode 100644 index 7bbc917e..00000000 --- a/doc/krita/tool-bezier-example3.png +++ /dev/null diff --git a/doc/krita/tool-bezier.png b/doc/krita/tool-bezier.png Binary files differdeleted file mode 100644 index 357cfa80..00000000 --- a/doc/krita/tool-bezier.png +++ /dev/null diff --git a/doc/krita/tool-brush.png b/doc/krita/tool-brush.png Binary files differdeleted file mode 100644 index 9b6c79c3..00000000 --- a/doc/krita/tool-brush.png +++ /dev/null diff --git a/doc/krita/tool-colorpicker.png b/doc/krita/tool-colorpicker.png Binary files differdeleted file mode 100644 index daf5a94e..00000000 --- a/doc/krita/tool-colorpicker.png +++ /dev/null diff --git a/doc/krita/tool-contiguousfill.png b/doc/krita/tool-contiguousfill.png Binary files differdeleted file mode 100644 index ddd1b6b1..00000000 --- a/doc/krita/tool-contiguousfill.png +++ /dev/null diff --git a/doc/krita/tool-crop.png b/doc/krita/tool-crop.png Binary files differdeleted file mode 100644 index 829727dd..00000000 --- a/doc/krita/tool-crop.png +++ /dev/null diff --git a/doc/krita/tool-duplicate.png b/doc/krita/tool-duplicate.png Binary files differdeleted file mode 100644 index 968e7961..00000000 --- a/doc/krita/tool-duplicate.png +++ /dev/null diff --git a/doc/krita/tool-ellipse.png b/doc/krita/tool-ellipse.png Binary files differdeleted file mode 100644 index ba945656..00000000 --- a/doc/krita/tool-ellipse.png +++ /dev/null diff --git a/doc/krita/tool-eraseselection.png b/doc/krita/tool-eraseselection.png Binary files differdeleted file mode 100644 index f26b0f62..00000000 --- a/doc/krita/tool-eraseselection.png +++ /dev/null diff --git a/doc/krita/tool-gradient.png b/doc/krita/tool-gradient.png Binary files differdeleted file mode 100644 index 22239a52..00000000 --- a/doc/krita/tool-gradient.png +++ /dev/null diff --git a/doc/krita/tool-line.png b/doc/krita/tool-line.png Binary files differdeleted file mode 100644 index 3efd3608..00000000 --- a/doc/krita/tool-line.png +++ /dev/null diff --git a/doc/krita/tool-move.png b/doc/krita/tool-move.png Binary files differdeleted file mode 100644 index 7a588bbe..00000000 --- a/doc/krita/tool-move.png +++ /dev/null diff --git a/doc/krita/tool-paintselection.png b/doc/krita/tool-paintselection.png Binary files differdeleted file mode 100644 index 654bfbd9..00000000 --- a/doc/krita/tool-paintselection.png +++ /dev/null diff --git a/doc/krita/tool-paintwithfilters-example.png b/doc/krita/tool-paintwithfilters-example.png Binary files differdeleted file mode 100644 index 7e10f5d1..00000000 --- a/doc/krita/tool-paintwithfilters-example.png +++ /dev/null diff --git a/doc/krita/tool-paintwithfilters.png b/doc/krita/tool-paintwithfilters.png Binary files differdeleted file mode 100644 index 9eb5a824..00000000 --- a/doc/krita/tool-paintwithfilters.png +++ /dev/null diff --git a/doc/krita/tool-pan.png b/doc/krita/tool-pan.png Binary files differdeleted file mode 100644 index 63adf1c5..00000000 --- a/doc/krita/tool-pan.png +++ /dev/null diff --git a/doc/krita/tool-perspectivegrid.png b/doc/krita/tool-perspectivegrid.png Binary files differdeleted file mode 100644 index 30d671fe..00000000 --- a/doc/krita/tool-perspectivegrid.png +++ /dev/null diff --git a/doc/krita/tool-perspectivetransform.png b/doc/krita/tool-perspectivetransform.png Binary files differdeleted file mode 100644 index 611947f6..00000000 --- a/doc/krita/tool-perspectivetransform.png +++ /dev/null diff --git a/doc/krita/tool-polygon.png b/doc/krita/tool-polygon.png Binary files differdeleted file mode 100644 index b4fabae1..00000000 --- a/doc/krita/tool-polygon.png +++ /dev/null diff --git a/doc/krita/tool-polyline.png b/doc/krita/tool-polyline.png Binary files differdeleted file mode 100644 index f59b09bf..00000000 --- a/doc/krita/tool-polyline.png +++ /dev/null diff --git a/doc/krita/tool-rectangle.png b/doc/krita/tool-rectangle.png Binary files differdeleted file mode 100644 index 83ddd599..00000000 --- a/doc/krita/tool-rectangle.png +++ /dev/null diff --git a/doc/krita/tool-selectbezier.png b/doc/krita/tool-selectbezier.png Binary files differdeleted file mode 100644 index 33690580..00000000 --- a/doc/krita/tool-selectbezier.png +++ /dev/null diff --git a/doc/krita/tool-selectcontiguous.png b/doc/krita/tool-selectcontiguous.png Binary files differdeleted file mode 100644 index acf04cd3..00000000 --- a/doc/krita/tool-selectcontiguous.png +++ /dev/null diff --git a/doc/krita/tool-selectelliptical.png b/doc/krita/tool-selectelliptical.png Binary files differdeleted file mode 100644 index e7cba67f..00000000 --- a/doc/krita/tool-selectelliptical.png +++ /dev/null diff --git a/doc/krita/tool-selectmagnetic.png b/doc/krita/tool-selectmagnetic.png Binary files differdeleted file mode 100644 index 63489bcd..00000000 --- a/doc/krita/tool-selectmagnetic.png +++ /dev/null diff --git a/doc/krita/tool-selectoutline.png b/doc/krita/tool-selectoutline.png Binary files differdeleted file mode 100644 index 5646f6b1..00000000 --- a/doc/krita/tool-selectoutline.png +++ /dev/null diff --git a/doc/krita/tool-selectpolygonal.png b/doc/krita/tool-selectpolygonal.png Binary files differdeleted file mode 100644 index dded2a46..00000000 --- a/doc/krita/tool-selectpolygonal.png +++ /dev/null diff --git a/doc/krita/tool-selectrectangular.png b/doc/krita/tool-selectrectangular.png Binary files differdeleted file mode 100644 index 217f6b5d..00000000 --- a/doc/krita/tool-selectrectangular.png +++ /dev/null diff --git a/doc/krita/tool-selectsimilar.png b/doc/krita/tool-selectsimilar.png Binary files differdeleted file mode 100644 index 4177294b..00000000 --- a/doc/krita/tool-selectsimilar.png +++ /dev/null diff --git a/doc/krita/tool-star.png b/doc/krita/tool-star.png Binary files differdeleted file mode 100644 index 72a68a21..00000000 --- a/doc/krita/tool-star.png +++ /dev/null diff --git a/doc/krita/tool-text.png b/doc/krita/tool-text.png Binary files differdeleted file mode 100644 index b1ac269d..00000000 --- a/doc/krita/tool-text.png +++ /dev/null diff --git a/doc/krita/tool-transform.png b/doc/krita/tool-transform.png Binary files differdeleted file mode 100644 index c00eeebb..00000000 --- a/doc/krita/tool-transform.png +++ /dev/null diff --git a/doc/krita/tool-zoom.png b/doc/krita/tool-zoom.png Binary files differdeleted file mode 100644 index 99eb7496..00000000 --- a/doc/krita/tool-zoom.png +++ /dev/null diff --git a/doc/krita/toolbar-brushes-brushshapes-autobrush.png b/doc/krita/toolbar-brushes-brushshapes-autobrush.png Binary files differdeleted file mode 100644 index c39cacad..00000000 --- a/doc/krita/toolbar-brushes-brushshapes-autobrush.png +++ /dev/null diff --git a/doc/krita/toolbar-brushes-brushshapes-custombrush.png b/doc/krita/toolbar-brushes-brushshapes-custombrush.png Binary files differdeleted file mode 100644 index bd57d6e9..00000000 --- a/doc/krita/toolbar-brushes-brushshapes-custombrush.png +++ /dev/null diff --git a/doc/krita/toolbar-brushes-brushshapes-predefined.png b/doc/krita/toolbar-brushes-brushshapes-predefined.png Binary files differdeleted file mode 100644 index 677d0e27..00000000 --- a/doc/krita/toolbar-brushes-brushshapes-predefined.png +++ /dev/null diff --git a/doc/krita/toolbar-brushes-gradients.png b/doc/krita/toolbar-brushes-gradients.png Binary files differdeleted file mode 100644 index 89ae348e..00000000 --- a/doc/krita/toolbar-brushes-gradients.png +++ /dev/null diff --git a/doc/krita/toolbar-brushes-patterns-custompattern.png b/doc/krita/toolbar-brushes-patterns-custompattern.png Binary files differdeleted file mode 100644 index 29d0fe1c..00000000 --- a/doc/krita/toolbar-brushes-patterns-custompattern.png +++ /dev/null diff --git a/doc/krita/toolbar-brushes-patterns.png b/doc/krita/toolbar-brushes-patterns.png Binary files differdeleted file mode 100644 index 367fa3ef..00000000 --- a/doc/krita/toolbar-brushes-patterns.png +++ /dev/null diff --git a/doc/krita/toolbar-brushesandstuff.png b/doc/krita/toolbar-brushesandstuff.png Binary files differdeleted file mode 100644 index e37d1a83..00000000 --- a/doc/krita/toolbar-brushesandstuff.png +++ /dev/null diff --git a/doc/krita/toolbar-edit.png b/doc/krita/toolbar-edit.png Binary files differdeleted file mode 100644 index c65c1969..00000000 --- a/doc/krita/toolbar-edit.png +++ /dev/null diff --git a/doc/krita/toolbar-file.png b/doc/krita/toolbar-file.png Binary files differdeleted file mode 100644 index 5b8293bd..00000000 --- a/doc/krita/toolbar-file.png +++ /dev/null diff --git a/doc/krita/toolbar-krita.png b/doc/krita/toolbar-krita.png Binary files differdeleted file mode 100644 index e39c6777..00000000 --- a/doc/krita/toolbar-krita.png +++ /dev/null diff --git a/doc/krita/toolbar-navigation.png b/doc/krita/toolbar-navigation.png Binary files differdeleted file mode 100644 index 6fd40b6a..00000000 --- a/doc/krita/toolbar-navigation.png +++ /dev/null diff --git a/doc/krita/toolbar-transformationtools.png b/doc/krita/toolbar-transformationtools.png Binary files differdeleted file mode 100644 index 07e41208..00000000 --- a/doc/krita/toolbar-transformationtools.png +++ /dev/null diff --git a/doc/krita/toolbars-button-zoomin.png b/doc/krita/toolbars-button-zoomin.png Binary files differdeleted file mode 100644 index 896f1c12..00000000 --- a/doc/krita/toolbars-button-zoomin.png +++ /dev/null diff --git a/doc/krita/toolbars-button-zoomout.png b/doc/krita/toolbars-button-zoomout.png Binary files differdeleted file mode 100644 index 124ab6fb..00000000 --- a/doc/krita/toolbars-button-zoomout.png +++ /dev/null diff --git a/doc/krita/tutorial-quick-starts.docbook b/doc/krita/tutorial-quick-starts.docbook deleted file mode 100644 index 05f36729..00000000 --- a/doc/krita/tutorial-quick-starts.docbook +++ /dev/null @@ -1,183 +0,0 @@ -<sect1 id="tutorial-quickstarts"> -<title>Quick start guides</title> -<sect2 id="tutorial-quickstarts-cropimage"> -<title>Crop an area and save it</title> - -<para>Aim: from a picture, crop an area and save that area in a new file</para> - -<para>Open &krita; with the original picture.</para> - -<screenshot> -<screeninfo>The original picture</screeninfo> -<mediaobject> -<imageobject> -<imagedata fileref="tutorial-quick-starts1.png" format="PNG"/> -</imageobject> -<textobject><phrase>The original picture</phrase></textobject> -</mediaobject> -</screenshot> - -<para>Select the <guiicon>Select Rectangular</guiicon> tool in the -&krita; toolbar.</para> - -<screenshot> -<screeninfo>The Select a rectangular area tool</screeninfo> -<mediaobject> -<imageobject> -<imagedata fileref="tutorial-quick-starts2.png" format="PNG"/> -</imageobject> -<textobject><phrase>The Select a rectangular area tool</phrase></textobject> -</mediaobject> -</screenshot> - -<para>Select the area you want to make a new picture with. &krita; makes the -outside area grey.</para> - -<screenshot> -<screeninfo>The selected area</screeninfo> -<mediaobject> -<imageobject> -<imagedata fileref="tutorial-quick-starts3.png" format="PNG"/> -</imageobject> -<textobject><phrase>The selected area</phrase></textobject> -</mediaobject> -</screenshot> - -<para>Then use the -<menuchoice><guimenu>Edit</guimenu><guimenuitem>Copy</guimenuitem></menuchoice> -menu item or <keycombo action="simul">&Ctrl;<keycap>C</keycap></keycombo> to -copy the selected area.</para> - -<para>Click again on the <guimenu>Edit</guimenu> menu.</para> -<para>Use the <guimenuitem>Paste into new image</guimenuitem> item.</para> - -<screenshot> -<screeninfo>The <guimenu>Edit</guimenu> menu</screeninfo> -<mediaobject> -<imageobject> -<imagedata fileref="tutorial-quick-starts4.png" format="PNG"/> -</imageobject> -<textobject><phrase>The <guimenu>Edit</guimenu> menu</phrase></textobject> -</mediaobject> -</screenshot> - -<para>&krita; opens a new window with the selected area as new image.</para> - -<screenshot> -<screeninfo>The new image</screeninfo> -<mediaobject> -<imageobject> -<imagedata fileref="tutorial-quick-starts5.png" format="PNG"/> -</imageobject> -<textobject><phrase>The new image</phrase></textobject> -</mediaobject> -</screenshot> - -<para>Save the new image.</para> - -</sect2> -<sect2 id="tutorial-quickstarts-drawrectangle"> -<title>Draw a rectangle on your picture</title> - -<para>Aim: draw a coloured rectangle on your picture</para> - -<para>Open &krita; with the original picture. My picture consists of a view of -a toolbar in which I want to point an icon by putting a red rectangle around -it.</para> - -<screenshot> -<screeninfo>The original picture</screeninfo> -<mediaobject> -<imageobject> -<imagedata fileref="tutorial-quick-starts6.png" format="PNG"/> -</imageobject> -<textobject><phrase>The original picture</phrase></textobject> -</mediaobject> -</screenshot> - -<para>Enable the <guilabel>Brushes and Stuff</guilabel> toolbar using -<menuchoice><guimenu>Settings</guimenu><guimenuitem>Toolbars</guimenuitem></menuchoice> -menu.</para> -<para>Also make sure the palettes are viewed. If not, use the -<menuchoice><guimenu>View</guimenu><guimenuitem>Palettes</guimenuitem></menuchoice> -menu.</para> - -<screenshot> -<screeninfo>&krita; view</screeninfo> -<mediaobject> -<imageobject> -<imagedata fileref="tutorial-quick-starts7.png" format="PNG"/> -</imageobject> -<textobject><phrase>&krita; view</phrase></textobject> -</mediaobject> -</screenshot> - -<para>Click on the <guiicon>Brush Shapes</guiicon> icon in the -<guilabel>Brushes and Stuff</guilabel> toolbar.</para> - -<screenshot> -<screeninfo>The <guiicon>Brush Shapes</guiicon> icon</screeninfo> -<mediaobject> -<imageobject> -<imagedata fileref="tutorial-quick-starts8.png" format="PNG"/> -</imageobject> -<textobject><phrase>The <guiicon>Brush Shapes</guiicon> icon</phrase></textobject> -</mediaobject> -</screenshot> - -<para>Select which brush shape you want to use among the predefined -brushes.</para> - -<screenshot> -<screeninfo>Selecting a brush shape</screeninfo> -<mediaobject> -<imageobject> -<imagedata fileref="tutorial-quick-starts9.png" format="PNG"/> -</imageobject> -<textobject><phrase>Selecting a brush shape</phrase></textobject> -</mediaobject> -</screenshot> - -<para>Select the drawing shape on the &krita; toolbar. I choose a -rectangle.</para> - -<screenshot> -<screeninfo>Selecting the <guiicon>Rectangle</guiicon> icon</screeninfo> -<mediaobject> -<imageobject> -<imagedata fileref="tutorial-quick-starts10.png" format="PNG"/> -</imageobject> -<textobject><phrase>Selecting the <guiicon>Rectangle</guiicon> icon</phrase></textobject> -</mediaobject> -</screenshot> - -<para>In the <guilabel>Colors</guilabel> palette, select the color you want by clicking on one of the -tabs and then choosing the color.</para> - -<screenshot> -<screeninfo>Choosing the color</screeninfo> -<mediaobject> -<imageobject> -<imagedata fileref="tutorial-quick-starts11.png" format="PNG"/> -</imageobject> -<textobject><phrase>Choosing the color</phrase></textobject> -</mediaobject> -</screenshot> - -<para>Finally draw your shape on your picture and save the new picture!</para> - -<screenshot> -<screeninfo>Drawing</screeninfo> -<mediaobject> -<imageobject> -<imagedata fileref="tutorial-quick-starts12.png" format="PNG"/> -</imageobject> -<textobject><phrase>Drawing</phrase></textobject> -</mediaobject> -</screenshot> - -<para>Thanks go to Anne-Marie Mahfouf for providing this tutorial.</para> - -</sect2> - -</sect1> diff --git a/doc/krita/tutorial-quick-starts1.png b/doc/krita/tutorial-quick-starts1.png Binary files differdeleted file mode 100644 index 562e1595..00000000 --- a/doc/krita/tutorial-quick-starts1.png +++ /dev/null diff --git a/doc/krita/tutorial-quick-starts10.png b/doc/krita/tutorial-quick-starts10.png Binary files differdeleted file mode 100644 index fc76f188..00000000 --- a/doc/krita/tutorial-quick-starts10.png +++ /dev/null diff --git a/doc/krita/tutorial-quick-starts11.png b/doc/krita/tutorial-quick-starts11.png Binary files differdeleted file mode 100644 index 7cd5f601..00000000 --- a/doc/krita/tutorial-quick-starts11.png +++ /dev/null diff --git a/doc/krita/tutorial-quick-starts12.png b/doc/krita/tutorial-quick-starts12.png Binary files differdeleted file mode 100644 index a74ea54f..00000000 --- a/doc/krita/tutorial-quick-starts12.png +++ /dev/null diff --git a/doc/krita/tutorial-quick-starts2.png b/doc/krita/tutorial-quick-starts2.png Binary files differdeleted file mode 100644 index fe54bf6a..00000000 --- a/doc/krita/tutorial-quick-starts2.png +++ /dev/null diff --git a/doc/krita/tutorial-quick-starts3.png b/doc/krita/tutorial-quick-starts3.png Binary files differdeleted file mode 100644 index b1f4223b..00000000 --- a/doc/krita/tutorial-quick-starts3.png +++ /dev/null diff --git a/doc/krita/tutorial-quick-starts4.png b/doc/krita/tutorial-quick-starts4.png Binary files differdeleted file mode 100644 index 1d6fcacb..00000000 --- a/doc/krita/tutorial-quick-starts4.png +++ /dev/null diff --git a/doc/krita/tutorial-quick-starts5.png b/doc/krita/tutorial-quick-starts5.png Binary files differdeleted file mode 100644 index ceb18de9..00000000 --- a/doc/krita/tutorial-quick-starts5.png +++ /dev/null diff --git a/doc/krita/tutorial-quick-starts6.png b/doc/krita/tutorial-quick-starts6.png Binary files differdeleted file mode 100644 index 69176011..00000000 --- a/doc/krita/tutorial-quick-starts6.png +++ /dev/null diff --git a/doc/krita/tutorial-quick-starts7.png b/doc/krita/tutorial-quick-starts7.png Binary files differdeleted file mode 100644 index 92c6ab18..00000000 --- a/doc/krita/tutorial-quick-starts7.png +++ /dev/null diff --git a/doc/krita/tutorial-quick-starts8.png b/doc/krita/tutorial-quick-starts8.png Binary files differdeleted file mode 100644 index fb2bed36..00000000 --- a/doc/krita/tutorial-quick-starts8.png +++ /dev/null diff --git a/doc/krita/tutorial-quick-starts9.png b/doc/krita/tutorial-quick-starts9.png Binary files differdeleted file mode 100644 index db763b6c..00000000 --- a/doc/krita/tutorial-quick-starts9.png +++ /dev/null diff --git a/doc/krita/tutorial-select-layer-1.png b/doc/krita/tutorial-select-layer-1.png Binary files differdeleted file mode 100644 index 29f8b0bf..00000000 --- a/doc/krita/tutorial-select-layer-1.png +++ /dev/null diff --git a/doc/krita/tutorial-select-layer-10.png b/doc/krita/tutorial-select-layer-10.png Binary files differdeleted file mode 100644 index a2d92fc6..00000000 --- a/doc/krita/tutorial-select-layer-10.png +++ /dev/null diff --git a/doc/krita/tutorial-select-layer-11.png b/doc/krita/tutorial-select-layer-11.png Binary files differdeleted file mode 100644 index 75a6c10c..00000000 --- a/doc/krita/tutorial-select-layer-11.png +++ /dev/null diff --git a/doc/krita/tutorial-select-layer-12.png b/doc/krita/tutorial-select-layer-12.png Binary files differdeleted file mode 100644 index 95487fa7..00000000 --- a/doc/krita/tutorial-select-layer-12.png +++ /dev/null diff --git a/doc/krita/tutorial-select-layer-13.png b/doc/krita/tutorial-select-layer-13.png Binary files differdeleted file mode 100644 index 449ec903..00000000 --- a/doc/krita/tutorial-select-layer-13.png +++ /dev/null diff --git a/doc/krita/tutorial-select-layer-2.png b/doc/krita/tutorial-select-layer-2.png Binary files differdeleted file mode 100644 index 4552f0af..00000000 --- a/doc/krita/tutorial-select-layer-2.png +++ /dev/null diff --git a/doc/krita/tutorial-select-layer-3.png b/doc/krita/tutorial-select-layer-3.png Binary files differdeleted file mode 100644 index a9a7a9bd..00000000 --- a/doc/krita/tutorial-select-layer-3.png +++ /dev/null diff --git a/doc/krita/tutorial-select-layer-4.png b/doc/krita/tutorial-select-layer-4.png Binary files differdeleted file mode 100644 index a3506440..00000000 --- a/doc/krita/tutorial-select-layer-4.png +++ /dev/null diff --git a/doc/krita/tutorial-select-layer-5.png b/doc/krita/tutorial-select-layer-5.png Binary files differdeleted file mode 100644 index f0e88e46..00000000 --- a/doc/krita/tutorial-select-layer-5.png +++ /dev/null diff --git a/doc/krita/tutorial-select-layer-6.png b/doc/krita/tutorial-select-layer-6.png Binary files differdeleted file mode 100644 index eac0b247..00000000 --- a/doc/krita/tutorial-select-layer-6.png +++ /dev/null diff --git a/doc/krita/tutorial-select-layer-7.png b/doc/krita/tutorial-select-layer-7.png Binary files differdeleted file mode 100644 index 6580b54b..00000000 --- a/doc/krita/tutorial-select-layer-7.png +++ /dev/null diff --git a/doc/krita/tutorial-select-layer-8.png b/doc/krita/tutorial-select-layer-8.png Binary files differdeleted file mode 100644 index 503c0223..00000000 --- a/doc/krita/tutorial-select-layer-8.png +++ /dev/null diff --git a/doc/krita/tutorial-select-layer-9.png b/doc/krita/tutorial-select-layer-9.png Binary files differdeleted file mode 100644 index cebfde39..00000000 --- a/doc/krita/tutorial-select-layer-9.png +++ /dev/null diff --git a/doc/krita/tutorial-select-layer-sample.png b/doc/krita/tutorial-select-layer-sample.png Binary files differdeleted file mode 100644 index 4def7ed3..00000000 --- a/doc/krita/tutorial-select-layer-sample.png +++ /dev/null diff --git a/doc/krita/tutorial-select-layer.docbook b/doc/krita/tutorial-select-layer.docbook deleted file mode 100644 index 3e60bc88..00000000 --- a/doc/krita/tutorial-select-layer.docbook +++ /dev/null @@ -1,263 +0,0 @@ -<sect1 id="tutorial-select-layer"> -<title>A Small selections and layers tutorial</title> - -<!-- Does someone know a better way to do this? --> -<screenshot> -<screeninfo>The starting image</screeninfo> -<mediaobject> -<imageobject> -<imagedata fileref="tutorial-select-layer-sample.png" format="PNG" /> -</imageobject> -<textobject> -<phrase>The starting image</phrase> -</textobject> -<caption><para>The starting image</para></caption> -</mediaobject> -</screenshot> - -<para> -The image above is the image we will work with. Start krita with this -image (in the documentation folder -<filename>$<envar>KDEDIR</envar>/share/doc/HTML/en/krita/tutorial-select-layer-sample.png</filename>) -and save it to your Home folder (by choosing <guilabel>Save Image As...</guilabel>). - -Then open it in &krita; — your screen will look a bit like this (we have -zoomed in): -</para> - -<screenshot> -<screeninfo>Krita with the starting image</screeninfo> -<mediaobject> -<imageobject> -<imagedata fileref="tutorial-select-layer-1.png" format="PNG" /> -</imageobject> -<textobject> -<phrase>The starting image</phrase> -</textobject> -<caption><para>The starting image</para></caption> -</mediaobject> -</screenshot> - -<para> -Now try to select the outline of the head with the <guilabel>Select Outline</guilabel> tool: -</para> - -<screenshot> -<screeninfo>The <guilabel>Select Outline</guilabel> tool</screeninfo> -<mediaobject> -<imageobject> -<imagedata fileref="tutorial-select-layer-2.png" format="PNG" /> -</imageobject> -<textobject> -<phrase>The <guilabel>Select Outline</guilabel> tool</phrase> -</textobject> -<caption><para>The <guilabel>Select Outline</guilabel> tool</para></caption> -</mediaobject> -</screenshot> - -<para> -After you select it, it should look a bit like this picture: -</para> - -<screenshot> -<screeninfo>The picture after selecting the head</screeninfo> -<mediaobject> -<imageobject> -<imagedata fileref="tutorial-select-layer-3.png" format="PNG" /> -</imageobject> -<textobject> -<phrase>The picture after selecting the head</phrase> -</textobject> -<caption><para>The picture after selecting the head</para></caption> -</mediaobject> -</screenshot> - -<para> -If you accidently select too much, you can cut that part easily off by switching the tool to <guilabel>Subtract</guilabel> mode: -</para> - -<screenshot> -<screeninfo>The <guilabel>Subtract</guilabel> mode</screeninfo> -<mediaobject> -<imageobject> -<imagedata fileref="tutorial-select-layer-4.png" format="PNG" /> -</imageobject> -<textobject> -<phrase>The <guilabel>Subtract</guilabel> mode</phrase> -</textobject> -<caption><para>The <guilabel>Subtract</guilabel> mode</para></caption> -</mediaobject> -</screenshot> - -<para> -Now it's time to make the edges of the selection a bit fuzzy. This can be done by applying <guilabel>Feather</guilabel> to the selection. -</para> - -<screenshot> -<screeninfo><guilabel>Feather</guilabel> selection</screeninfo> -<mediaobject> -<imageobject> -<imagedata fileref="tutorial-select-layer-5.png" format="PNG" /> -</imageobject> -<textobject> -<phrase><guilabel>Feather</guilabel> selection</phrase> -</textobject> -<caption><para><guilabel>Feather</guilabel> selection</para></caption> -</mediaobject> -</screenshot> - -<para> -Now cut the selection, using -<menuchoice><guimenu>Edit</guimenu><guimenuitem>Cut</guimenuitem></menuchoice>. -Delete the current layer with -<menuchoice><guimenu>Layer</guimenu><guimenuitem>Remove -Layer</guimenuitem></menuchoice>. Paste your selection, with -<menuchoice><guimenu>Edit</guimenu><guimenuitem>Paste</guimenuitem></menuchoice>. -Now we give ourselves a bit more room to work in by resizing the image a bit. -Use the <menuchoice><guimenu>Image</guimenu><guimenuitem>Change Image -Size...</guimenuitem></menuchoice> dialog for this. -</para> - -<screenshot> -<screeninfo>The <guilabel>Image Size</guilabel> dialog</screeninfo> -<mediaobject> -<imageobject> -<imagedata fileref="tutorial-select-layer-6.png" format="PNG" /> -</imageobject> -<textobject> -<phrase>The <guilabel>Image Size</guilabel> dialog</phrase> -</textobject> -<caption><para>The <guilabel>Image Size</guilabel> dialog</para></caption> -</mediaobject> -</screenshot> - -<para> -Add a new layer, and place it below the old layer. You do this by selecting -the new layer in the layerbox, and then pressing the little 'down' arrow at the bottom. -Now we are going to select the area around the head with a contiguous select -(the tool has a selection-with-bucketfill icon at the border). -</para> - -<screenshot> -<screeninfo>The <guilabel>Select Contiguous</guilabel> tool</screeninfo> -<mediaobject> -<imageobject> -<imagedata fileref="tutorial-select-layer-7.png" format="PNG" /> -</imageobject> -<textobject> -<phrase>The <guilabel>Select Contiguous</guilabel> tool</phrase> -</textobject> -<caption><para>The <guilabel>Select Contiguous</guilabel> tool</para></caption> -</mediaobject> -</screenshot> - -<para> -Make sure to select <guilabel>Sample merged</guilabel> in the tool options: -</para> - -<screenshot> -<screeninfo>The <guilabel>Sample merged</guilabel> option</screeninfo> -<mediaobject> -<imageobject> -<imagedata fileref="tutorial-select-layer-8.png" format="PNG" /> -</imageobject> -<textobject> -<phrase>The <guilabel>Sample merged</guilabel> option</phrase> -</textobject> -<caption><para>The <guilabel>Sample merged</guilabel> option</para></caption> -</mediaobject> -</screenshot> - -<para> -Feather the selection again, and invert it. -Select the <guilabel>Contiguous Fill</guilabel> tool (this is a different tool than -the <guilabel>Contiguous Select</guilabel> tool) and use it on the layer. -</para> - -<screenshot> -<screeninfo>The <guilabel>Contiguous Fill</guilabel> tool</screeninfo> -<mediaobject> -<imageobject> -<imagedata fileref="tutorial-select-layer-9.png" format="PNG" /> -</imageobject> -<textobject> -<phrase>The <guilabel>Contiguous Fill</guilabel> tool</phrase> -</textobject> -<caption><para>The <guilabel>Contiguous Fill</guilabel> tool</para></caption> -</mediaobject> -</screenshot> - -<para> -Deselect with <menuchoice><guimenu>Select</guimenu><guimenuitem>Deselect</guimenuitem></menuchoice>. -You'll notice some artefacts of the feathering at the sides. You can select them easily with a rectangular selection and then cut them. -</para> - -<screenshot> -<screeninfo>The <guilabel>Select Rectangular</guilabel> tool</screeninfo> -<mediaobject> -<imageobject> -<imagedata fileref="tutorial-select-layer-10.png" format="PNG" /> -</imageobject> -<textobject> -<phrase>The <guilabel>Select Rectangular</guilabel> tool</phrase> -</textobject> -<caption><para>The <guilabel>Select Rectangular</guilabel> tool</para></caption> -</mediaobject> -</screenshot> - -<para> -Move the shadow layer a bit down and to the right to make it look nice. -</para> - -<screenshot> -<screeninfo>Moving the shadow layer</screeninfo> -<mediaobject> -<imageobject> -<imagedata fileref="tutorial-select-layer-11.png" format="PNG" /> -</imageobject> -<textobject> -<phrase>Moving the shadow layer</phrase> -</textobject> -<caption><para>Moving the shadow layer</para></caption> -</mediaobject> -</screenshot> - -<para> -Now you can use the <guilabel>Crop</guilabel> tool to make the image better fit around the head. -</para> - -<screenshot> -<screeninfo>The <guilabel>Crop</guilabel> tool</screeninfo> -<mediaobject> -<imageobject> -<imagedata fileref="tutorial-select-layer-12.png" format="PNG" /> -</imageobject> -<textobject> -<phrase>The <guilabel>Crop</guilabel> tool</phrase> -</textobject> -<caption><para>The <guilabel>Crop</guilabel> tool</para></caption> -</mediaobject> -</screenshot> - -<para> -Save the image, and you're done :-) -</para> - -<screenshot> -<screeninfo>The resulting image</screeninfo> -<mediaobject> -<imageobject> -<imagedata fileref="tutorial-select-layer-13.png" format="PNG" /> -</imageobject> -<textobject> -<phrase>The resulting image</phrase> -</textobject> -<caption><para>The resulting image</para></caption> -</mediaobject> -</screenshot> - -<para> -Thanks go to Bart Coppens for providing this tutorial. The original is available at <ulink url="http://www.bartcoppens.be/krita/hackergotchi.html">http://www.bartcoppens.be/krita/hackergotchi.html</ulink>. -</para> - -</sect1> diff --git a/doc/krita/tutorial-starting.docbook b/doc/krita/tutorial-starting.docbook deleted file mode 100644 index f720a88c..00000000 --- a/doc/krita/tutorial-starting.docbook +++ /dev/null @@ -1,117 +0,0 @@ -<sect1 id="tutorial-starting"> -<title>Starting to know &krita;</title> - -<para> -So, let's show you all the niceties. You can start &krita; either on its own -or from the &koffice; shell. In your &kde; menus, &krita; should be placed -either under Graphics or under Office — it depends a bit on who packaged -&koffice; for you. Or do what I do: press -<keycombo action="simul">&Alt;<keycap>F2</keycap></keycombo> (which opens the -minicli), type <userinput><command>krita</command></userinput> and -press <guibutton>OK</guibutton>. -</para> - -<para> -A little later, you'll be greeted by a dialog: -</para> - -<para> -<screenshot> -<screeninfo>The <guilabel>Create Document</guilabel> dialog</screeninfo> -<mediaobject> -<imageobject> -<imagedata fileref="createdocument.png" format="PNG" /> -</imageobject> -<textobject> -<phrase>The <guilabel>Create Document</guilabel> dialog</phrase> -</textobject> -<caption><para>The <guilabel>Create Document</guilabel> dialog</para></caption> -</mediaobject> -</screenshot> -</para> - -<para> -This is standard for &koffice;: you can create a new document, choose a -document from among your files or select a document you had opened in an earlier -session. We have got a bunch of templates here, ordered by color model. &krita; -is a very flexible application and can handle many different types of images: -<acronym>CMYK</acronym> images for printers, <acronym>RGB</acronym> images for -the web, <acronym>RGB</acronym> images with high channel depths for -photographers, watercolor images for painters — and more. For now, choose -<guilabel>Custom Document</guilabel>. That will allow -us to see the <guilabel>New Image</guilabel> dialog box: -</para> - -<para> -<screenshot> -<screeninfo>The <guilabel>New Image</guilabel> dialog</screeninfo> -<mediaobject> -<imageobject> -<imagedata fileref="newimage.png" format="PNG" /> -</imageobject> -<textobject> -<phrase>The <guilabel>New Image</guilabel> dialog</phrase> -</textobject> -<caption><para>The <guilabel>New Image</guilabel> dialog</para></caption> -</mediaobject> -</screenshot> -</para> - -<para> -Here you can give your document a name, determine the dimensions and the -resolution. The combination of width/height and resolution determines how big -your image will be on screen or on paper: if your image has a resolution of -100x100 dpi, and your image is 1000x1000 pixels big, then, if everything is -configured correctly, your image will be exactly 10 inches long and 10 inches -wide if you check with a ruler, no matter the resolution of your screen or of -your printer — if shown at 100%. However, life is seldom so well-regulated -that this actually works out. For now, just think pixels, not inches. -</para> - -<para> -The next group of options is a lot more interesting than resolution: &krita; -is an enormously flexible application and you can work with many kinds of -images. For this tutorial, just select <guilabel>RGB (8 -bits/channel)</guilabel>. You can also select a profile. For now, we leave this -at the default setting of <guilabel>sRGB built-in - (lcms internal)</guilabel>. -</para> - -<para> -In the third option group, you can select the initial canvas color and the -amount of opacity/transparency of this color. Furthermore you can -add a description of the contents. We leave these options at their default -settings as well, so click <guibutton>Create</guibutton> to actually create the new -image. -</para> - -<para> -You will now see the main &krita; screen. -</para> - -<para> -<screenshot> -<screeninfo>&krita;'s main screen</screeninfo> -<mediaobject> -<imageobject> -<imagedata fileref="mainscreen.png" format="PNG" /> -</imageobject> -<textobject> -<phrase>&krita;'s main screen</phrase> -</textobject> -<caption><para>&krita;'s main screen</para></caption> -</mediaobject> -</screenshot> -</para> - -<para> -On the left hand side and on the top, there are toolbars which offer you access -to tools for painting, editing, and selecting. -You can find a more detailed description of these toolbars <link -linkend="commands-toolbars">here</link>. The actual painting area is in the -middle. On the right side of your screen, there are various palettes, which you -can read more about in <link linkend="commands-palettes">this section</link>. -Finally, there is a menu bar at the top of the screen, as usually. Read more -about it <link linkend="commands-menus">here</link>. -</para> - -</sect1> diff --git a/doc/krita/tutorial-tablet-1.png b/doc/krita/tutorial-tablet-1.png Binary files differdeleted file mode 100644 index 5ab3d648..00000000 --- a/doc/krita/tutorial-tablet-1.png +++ /dev/null diff --git a/doc/krita/tutorial-tablet-2.png b/doc/krita/tutorial-tablet-2.png Binary files differdeleted file mode 100644 index a2cf0023..00000000 --- a/doc/krita/tutorial-tablet-2.png +++ /dev/null diff --git a/doc/krita/tutorial-tablet-3.png b/doc/krita/tutorial-tablet-3.png Binary files differdeleted file mode 100644 index 4986cbde..00000000 --- a/doc/krita/tutorial-tablet-3.png +++ /dev/null diff --git a/doc/krita/tutorial-tablet.docbook b/doc/krita/tutorial-tablet.docbook deleted file mode 100644 index 2e5e6184..00000000 --- a/doc/krita/tutorial-tablet.docbook +++ /dev/null @@ -1,141 +0,0 @@ -<sect1 id="tutorial-tablet"> -<title>Working with tablets</title> - -<para>This tutorial is intended to describe you the first steps with working -with a tablet with &krita;. The tutorial assumes you are using &Linux;.</para> - -<sect2 id="tutorial-tablet-configuring"> -<title>Configuring it</title> - -<para> -As any hardware it nearly works out of the box. &Linux; should recognize it -fine, but you might have to configure the X11 server by hand. The best way to -do this is to follow the instruction on the Wacom &Linux; howto: <ulink -url="http://linuxwacom.sourceforge.net/index.php/howto/main" />. -</para><para> -Then, in &krita;, you need to enable the various tools (in the -<guilabel>Tablet</guilabel> section of the -<menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure -&krita;...</guimenuitem></menuchoice> dialog) — you can find more -information in the <link linkend="settings-preferences-tablet">tablet settings -section</link>. -</para> - -</sect2> - -<sect2 id="tutorial-tablet-firstcontact"> -<title>First contact with the tablet</title> - -<para> -There are three devices of your tablet that you can use with &krita;: -</para> - -<itemizedlist> -<listitem><para>the cursor, the mouse that was shipped with the Wacom -tablet</para></listitem> -<listitem><para>the eraser, the round part on the top of the pen</para></listitem> -<listitem><para>the stylus, the thin point on the bottom of the pen</para></listitem> -</itemizedlist> - -<para> -By default, when you use the stylus or the cursor on the tablet, the Brush -tool and the pixel brush painting operation will get selected. The eraser -device is associated to the <quote>pixel eraser</quote> painting operation. -But if you select a different tool or a different painting operation with one -device, &krita; will remember the association when you switch between devices. -</para> - -</sect2> - -<sect2 id="tutorial-tablet-outlines"> -<title>Outlines of a flower</title> - -<para> -Even if you knew how to draw before you started with a tablet, you will need -to adapt to the tablet. It doesn't feel the same. So I suggest to start with -something simple, like a flower, and to use a picture as a model: -</para> - -<para> -<screenshot> -<screeninfo>A flower</screeninfo> -<mediaobject> -<imageobject> -<imagedata fileref="tutorial-tablet-1.png" format="PNG" /> -</imageobject> -<textobject> -<phrase>A flower</phrase> -</textobject> -<caption><para>A flower</para></caption> -</mediaobject> -</screenshot> -</para> - -<para> -First, you will need to create a new layer for the outline. I advise you to -lock the layer with the picture, it will prevent you from making mistakes. -</para><para> -Drawing the outline of the flower seems pretty easy, but for your first -experience you will have a great difficulty to precisely follow the line on -the screen while your hand has to move on the tablet. Eventually you will get -something like this: -</para> - -<para> -<screenshot> -<screeninfo>The outline of the flower</screeninfo> -<mediaobject> -<imageobject> -<imagedata fileref="tutorial-tablet-2.png" format="PNG" /> -</imageobject> -<textobject> -<phrase>The outline of the flower</phrase> -</textobject> -<caption><para>The outline of the flower</para></caption> -</mediaobject> -</screenshot> -</para> - -</sect2> - -<sect2 id="tutorial-tablet-colorization"> -<title>Colorization</title> - -<para> -For the colorization, you will need to create a third layer. You will -have to move it below the layer with the outlines, and do not forget to lock -the outline layer. -</para><para> -It's mostly easier than the outline part, just select the color you want to -use (either with the color selector or with the color picker), then for most -of the work you can use the fill tool: with the mouse, click on the part you -want to fill, as by default the fill tool will take the outline into -consideration. On the following image, the different colors of the heart of -the flower are not seperated by outlines, to do them I just completed the -missing outline with a yellow or brown line to create the separation between -the different colors. -</para> - -<para> -<screenshot> -<screeninfo>The colored flower</screeninfo> -<mediaobject> -<imageobject> -<imagedata fileref="tutorial-tablet-3.png" format="PNG" /> -</imageobject> -<textobject> -<phrase>The colored flower</phrase> -</textobject> -<caption><para>The colored flower</para></caption> -</mediaobject> -</screenshot> -</para> - -<para> -The resulting image looks and feels like old fashion clipart, mostly because -it lacks shadows and illumination, which are not covered by this tutorial. -</para> - -</sect2> - -</sect1> diff --git a/doc/krita/tutorial.docbook b/doc/krita/tutorial.docbook deleted file mode 100644 index 078b1886..00000000 --- a/doc/krita/tutorial.docbook +++ /dev/null @@ -1,14 +0,0 @@ -<chapter id="tutorial"> -<title>Tutorial</title> - -<note><para> -The toolbars and palettes shown in these tutorials may not match your -installation of &krita;. Our apologies for this inconvenience. -</para></note> - -&tutorial-starting; -&tutorial-select-layer; -&tutorial-quick-starts; -&tutorial-tablet; - -</chapter> diff --git a/doc/krita/using-colorspaces.docbook b/doc/krita/using-colorspaces.docbook deleted file mode 100644 index 0222e8d3..00000000 --- a/doc/krita/using-colorspaces.docbook +++ /dev/null @@ -1,149 +0,0 @@ -<chapter id="colorspaces"> -<title>Colorspaces</title> - -<para> -This chapter gives information on what colorspaces are, which colorspaces -&krita; offers, and what you should keep in mind when using them. -</para> - -<sect1 id="colorspaces-intro"> -<title>Introduction to colorspaces</title> - -<sect2 id="colorspaces-intro-whatis"> -<title>What is a colorspace?</title> - -<para> -In short, a colorspace is a way to represent colors by specifying a number of -parameters. As parameters, one can choose for example the amounts of red, -green and blue light needed for the color. This results in the commonly known -RGB colorspace. One can visualize this as a three-dimensional space, with each -of the red, green, and blue light components being an axis in the colorspace. -A color then corresponds to a certain point in this colorspace, defined by its -coordinates on the three axes. -</para> -<note><para> -To be more precise, a colorspace is a combination of a color model (indicating -which axes are present) and a mapping function (indicating which values -correspond to which colors). -</para></note> -<para> -Not every color can be represented in every colorspace. Some colorspaces -define more, or different, colors than others. The set of colors that can be -represented in a certain colorspace is called its gamut. Because gamuts -can differ widely, it is not guaranteed that images in a certain colorspace -can be converted to another colorspace without having to substitute certain -colors for others, even if they are based on the same color model. -</para> - -</sect2> - -</sect1> - -<sect1 id="colorspaces-list"> -<title>Available colorspaces</title> - -<para> -&krita; offers colorspaces based on RGB, CMYK, Lab, LMS, YCbCr, and Gray -color models. These are shortly discussed in this section. -</para> - -<sect2 id="colorspaces-list-rgb"> -<title>The RGB color models</title> - -<para> -The abbreviation RGB stands for Red, Green, Blue, and the color model with -this name refers to the three light components that are emitted in displays -(televisions, computer monitors, etcetera) to create a certain color. This -color model is used by default in virtually any standard painting application. -</para><para> -When defining a color in the RGB model, its red, green and blue components are -specified. If all components are absent (each component is emitted at 0 -percent intensity, so no light at all), the color is pure black. If all -components are fully present (100 percent intensity), the color is pure white. -If one component is present at full intensity and the other two are absent, -the pure respective color is obtained. -</para><para> -Two more examples: if both red and green are emitted at 100 percent and blue -is not emitted, pure yellow is obtained. A color with all three components at -the same intensity is a shade of gray. -</para><para> -There are various colorspaces that implement the RGB model. For example, the -so-called RGB8 colorspace represents each color with 8 bits per component. -Since 8 bits allow for 256 distinct values, the total number of different -colors that can be specified in this colorspace is 256 (red) * 256 (green) * -256 (blue), or about 16.7 million colors. In &krita;, a couple of RGB -colorspaces are available, for example RGB32, which is able to distinguish -between 4.2 billion values per component. -</para> - -</sect2> - -<sect2 id="colorspaces-list-cmyk"> -<title>The CMYK color model</title> - -<para> -CMYK is the abbreviation for Cyan, Magenta, Yellow, blacK (although officially -the K stands for Key, black is much more commonly used). This color model is -based on ink: a color is specified by the amount of ink needed for a point -to be perceived as having that color. -</para><para> -Since CMYK colors are used by printers while RGB colors are used on-screen, -one often wants to convert RGB colors to CMYK colors. As this cannot always be -done correctly, printed images may turn out to look quite different than what -is perceived on-screen. -</para> - -</sect2> - -<sect2 id="colorspaces-list-lab"> -<title>The L*a*b* color model</title> - -<para> -This color model uses three parameters for a color: its -luminance or lightness (L*, which lies between 0 for black and -100 for white), its position between absolute red and absolute green (a*, -which is negative for colors closer to green and positive for colors closer to -red), and its position between yellow and blue (b*, which is negative for -colors closer to blue and positive for colors closer to yellow). -</para> - -</sect2> - -<sect2 id="colorspaces-list-LMS"> -<title>The LMS color model</title> - -<para> -This model is based on the contribution of actual light wave lengths to the -color. The human eye is sensitive to three types of light waves, distinguished -by their wave lengths: long (L), middle (M) and short (S) waves. The eye's -sensitivity for a certain color on these three wavelengths can be expressed in -L, M and S coordinates. -</para> - -</sect2> - -<sect2 id="colorspaces-list-YCbCr"> -<title>The YCbCr color model</title> - -<para> -The YCbCr model is often used for video systems. The Y parameter indicates the -luminance or lightness of the color (which can be seen as a gray-tone), the Cb -and Cr parameters indicate the chrominance (color tone): Cb places the color -on a scale between blue and yellow, Cr indicates the place of the color -between red and green. -</para> - -</sect2> - -<sect2 id="colorspaces-list-Gray"><title>The Gray color model</title> - -<para> -The Gray color model simply represents colors as shades of gray (with black -and white being the extremes). -</para> - -</sect2> - -</sect1> - -</chapter> diff --git a/doc/krita/using-filters.docbook b/doc/krita/using-filters.docbook deleted file mode 100644 index 3dd686c4..00000000 --- a/doc/krita/using-filters.docbook +++ /dev/null @@ -1,923 +0,0 @@ -<chapter id="filters"> -<title>Filters</title> - -<para> -&krita; comes with a number of filters. These can be used to enhance or -otherwise modify the image, either in whole or in part. Some filters are -applied directly, others are customizable, meaning that you are presented with -a dialog in which you can tune the result to your liking before the filter is -applied. If a selection is active, a filter is applied on the selected part of -the image. If no selection is active, the entire image is modified. -</para><para> -This chapter describes the available filters in detail. To make comparing the -filters easier, each filter has been applied to the same image and each description -contains a comparison image, showing the result of applying the filter described. -The original image (with thanks to the photographer, Christian Peper) is shown -below at half the original size. The sample images demonstrating the -results of applying the filters, with the original image at the left and the -modified image at the right, are shown at 25% of the original size. -</para> -<note><para>Some filters yield reasonable results for most images. For -other filters though, quite some tweaking needs to be done before the desired -outcome is achieved. If a filter does not do what you want, it might need -more or less customising. The examples in this chapter are exaggerated to -give a good impression of the filters. You will usually want to have more -<quote>gentle</quote> modifications.</para></note> -<para> -Tip: If you want to apply a filter to everything except a certain part of your -image (for example, you want to desaturate your image except for the centre), -select the part you do not want to apply the filter to, use the -<menuchoice><guimenu>Select</guimenu><guimenuitem>Invert</guimenuitem></menuchoice> -menu option, and then apply the filter. -</para> -<para> -See the <link linkend="commands-dialogs-filters">Dialogs for working with -filters</link> section for descriptions of the settings available for the -customizable filters. -</para> - -<screenshot> -<screeninfo>The original image</screeninfo> -<mediaobject> -<imageobject> -<imagedata fileref="crocusses.png" format="PNG" /> -</imageobject> -<textobject> -<phrase>The original image</phrase> -</textobject> -<caption><para>The original image</para></caption> -</mediaobject> -</screenshot> - -<sect1 id="filters-autocontrast"> -<title>The Auto Contrast filter</title> -<para> -The Auto Contrast filter changes the contrast of your image to what should be -the best settings. Usually this works out fine, but in some cases (for example -photos taken under unusual lighting circumstances), the filter will not yield -satisfying results. -</para> -<para> -You can find the Auto Contrast filter in the <menuchoice><guimenu>Filter</guimenu> -<guisubmenu>Adjust</guisubmenu></menuchoice> menu. This filter is not customizable. -</para> -<screenshot> -<screeninfo>The image with the Auto Contrast filter applied to it</screeninfo> -<mediaobject> -<imageobject> -<imagedata fileref="crocusses-autocontrast.png" format="PNG" /> -</imageobject> -<textobject> -<phrase>The image with the Auto Contrast filter applied to it</phrase> -</textobject> -<caption><para>The image with the Auto Contrast filter applied to it</para></caption> -</mediaobject> -</screenshot> -</sect1> - -<sect1 id="filters-blur"> -<title>The Blur filter</title> -<para> -You can use the Blur filter to blur your image (give it a fuzzy look). -</para> -<para> -You can find the filter in the <menuchoice><guimenu>Filter</guimenu> -<guisubmenu>Blur</guisubmenu></menuchoice> menu. -See the section on <link linkend="commands-dialogs-filters-blur">the -<guilabel>Blur</guilabel> dialog</link> -for more information on its settings. -</para> -<screenshot> -<screeninfo>The image with the Blur filter applied to it</screeninfo> -<mediaobject> -<imageobject> -<imagedata fileref="crocusses-blur.png" format="PNG" /> -</imageobject> -<textobject> -<phrase>The image with the Blur filter applied to it</phrase> -</textobject> -<caption><para>The image with the Blur filter applied to it</para></caption> -</mediaobject> -</screenshot> -</sect1> - -<sect1 id="filters-brightnesscontrast"> -<title>The Brightness / Contrast filter</title> -<para> -With this filter, you can adjust the brightness and contrast of your image. -</para> -<para> -You can find the filter in the <menuchoice><guimenu>Filter</guimenu> -<guisubmenu>Adjust</guisubmenu></menuchoice> menu. -See the section on <link -linkend="commands-dialogs-filters-brightnesscontrast">the -<guilabel>Brightness / Contrast</guilabel> dialog</link> -for more information on its settings. -</para> -<screenshot> -<screeninfo>The image with the Brightness / Contrast filter applied to it</screeninfo> -<mediaobject> -<imageobject> -<imagedata fileref="crocusses-brightnesscontrast.png" format="PNG" /> -</imageobject> -<textobject> -<phrase>The image with the Brightness / Contrast filter applied to it</phrase> -</textobject> -<caption><para>The image with the Brightness / Contrast filter applied to it</para></caption> -</mediaobject> -</screenshot> -</sect1> - -<sect1 id="filters-bumpmap"> -<title>The Bumpmap filter</title> -<para> -The Bumpmap filter takes two layers and uses one of these to convert the other -one so that it will give an illusion of depth. The object layer (the layer to be -transformed) is the actual layer that should receive the three-dimensional -looks. The bumpmap layer is a grayscale layer, which is read and used to -determine the height for each point of the object layer. Alternatively, the -same layer can be used as both object layer and bumpmap layer. -</para> -<para> -You can find the filter in the <menuchoice><guimenu>Filter</guimenu> -<guisubmenu>Map</guisubmenu></menuchoice> menu. -See the section on <link -linkend="commands-dialogs-filters-bumpmap">the -<guilabel>Bumpmap</guilabel> dialog</link> for more information on its -settings. -</para> -<screenshot> -<screeninfo>The image with the Bumpmap filter applied to it</screeninfo> -<mediaobject> -<imageobject> -<imagedata fileref="crocusses-bumpmap.png" format="PNG" /> -</imageobject> -<textobject> -<phrase>The image with the Bumpmap filter applied to it</phrase> -</textobject> -<caption><para>The image with the Bumpmap filter applied to it</para></caption> -</mediaobject> -</screenshot> -</sect1> - -<sect1 id="filters-cimg"> -<title>The CImg Image Restoration filter</title> -<para> -With this filter, you can perform minor enhancements to your image, for -example removing small scratches or adding a slight blur. The difference -between our sample original image and the result of applying this filter with -standard settings is virtually none. -</para> -<para> -You can find the filter in the <menuchoice><guimenu>Filter</guimenu> -<guisubmenu>Enhance</guisubmenu></menuchoice> menu. -See the section on <link -linkend="commands-dialogs-filters-imagerestoration">the -<guilabel>Image Restoration</guilabel> dialog</link> -for more information on its settings. -</para> -</sect1> - -<sect1 id="filters-coloradjustment"> -<title>The Color Adjustment filter</title> -<para> -This filter allows you to change the looks of your image by increasing or -decreasing the abundance of certain colors. -</para> -<para> -You can find the filter in the <menuchoice><guimenu>Filter</guimenu> -<guisubmenu>Adjust</guisubmenu></menuchoice> menu. -See the section on <link -linkend="commands-dialogs-filters-coloradjustment">the -<guilabel>Color Adjustment</guilabel> dialog</link> -for more information on its settings. -</para> -<screenshot> -<screeninfo>The image with the Color Adjustment filter applied to it</screeninfo> -<mediaobject> -<imageobject> -<imagedata fileref="crocusses-coloradjustment.png" format="PNG" /> -</imageobject> -<textobject> -<phrase>The image with the Color Adjustment filter applied to it</phrase> -</textobject> -<caption><para>The image with the Color Adjustment filter applied to it</para></caption> -</mediaobject> -</screenshot> -</sect1> - -<sect1 id="filters-colortoalpha"> -<title>The Color to Alpha filter</title> -<para> -This filter changes a color or color range in your image to become -transparent, effectively clearing regions with those colors. -</para> -<para> -You can find the filter in the <menuchoice><guimenu>Filter</guimenu> -<guisubmenu>Colors</guisubmenu></menuchoice> menu. -See the section on <link -linkend="commands-dialogs-filters-colortoalpha">the -<guilabel>Color to Alpha</guilabel> dialog</link> -for more information on its settings. -</para> -<screenshot> -<screeninfo>The image with the Color to Alpha filter applied to it</screeninfo> -<mediaobject> -<imageobject> -<imagedata fileref="crocusses-colortoalpha.png" format="PNG" /> -</imageobject> -<textobject> -<phrase>The image with the Color to Alpha filter applied to it</phrase> -</textobject> -<caption><para>The image with the Color to Alpha filter applied to it</para></caption> -</mediaobject> -</screenshot> -</sect1> - -<sect1 id="filters-colortransfer"> -<title>The Color Transfer filter</title> -<para> -With this filter, you can re-color an image using the colors from another -image. Each color in your current image will be replaced by the most alike -color used in the other image. -</para> -<para> -You can find the filter in the <menuchoice><guimenu>Filter</guimenu> -<guisubmenu>Colors</guisubmenu></menuchoice> menu. -See the section on <link -linkend="commands-dialogs-filters-colortransfer">the -<guilabel>Color Transfer</guilabel> dialog</link> -for more information on its settings. -</para> -<screenshot> -<screeninfo>The image with the Color Transfer filter applied to it</screeninfo> -<mediaobject> -<imageobject> -<imagedata fileref="crocusses-colortransfer.png" format="PNG" /> -</imageobject> -<textobject> -<phrase>The image with the Color Transfer filter applied to it</phrase> -</textobject> -<caption><para>The image with the Color Transfer filter applied to it</para></caption> -</mediaobject> -</screenshot> -</sect1> - -<sect1 id="filters-customconvolution"> -<title>The Custom Convolution filter</title> -<para> -This filter allows you to distort your image by setting a number of -parameters. -</para> -<para> -You can find the filter in the <menuchoice><guimenu>Filter</guimenu> -<guisubmenu>Enhance</guisubmenu></menuchoice> menu. -See the section on <link -linkend="commands-dialogs-filters-customconvolution">the -<guilabel>Custom Convolution</guilabel> dialog</link> -for more information on its settings. -</para> -<screenshot> -<screeninfo>The image with the Custom Convolution filter applied to it</screeninfo> -<mediaobject> -<imageobject> -<imagedata fileref="crocusses-customconvolution.png" format="PNG" /> -</imageobject> -<textobject> -<phrase>The image with the Custom Convolution filter applied to it</phrase> -</textobject> -<caption><para>The image with the Custom Convolution filter applied to it</para></caption> -</mediaobject> -</screenshot> -</sect1> - -<sect1 id="filters-desaturate"> -<title>The Desaturate filter</title> -<para> -This filter converts your image to grayscale by setting the saturation of each -pixel's color to zero. -</para> -<para> -You can find the filter in the <menuchoice><guimenu>Filter</guimenu> -<guisubmenu>Adjust</guisubmenu></menuchoice> menu. -This filter is not customizable. -</para> -<screenshot> -<screeninfo>The image with the Desaturate filter applied to it</screeninfo> -<mediaobject> -<imageobject> -<imagedata fileref="crocusses-desaturate.png" format="PNG" /> -</imageobject> -<textobject> -<phrase>The image with the Desaturate filter applied to it</phrase> -</textobject> -<caption><para>The image with the Desaturate filter applied to it</para></caption> -</mediaobject> -</screenshot> -</sect1> - -<sect1 id="filters-edgedetection"> -<title>The Edge Detection filters</title> -<para> -These filters try to detect <quote>edges</quote> (boundaries) in the picture -and modify the image such that only these edges retain their respective colors, -while the rest of the image is turned gray. Through the use of lighting the -image will then get a three-dimensional look. -</para><para> -There are four edge detection filters available. Each of these detects edges -from a different side (possibly considering other parts of the image as being -edges) and will therefore obtain a different resulting image. -</para> -<para> -You can find the filters in the <menuchoice><guimenu>Filter</guimenu> -<guisubmenu>Edge Detection</guisubmenu></menuchoice> menu. -These filters are not customizable. -</para> -<screenshot> -<screeninfo>The image with the Bottom Edge Detection filter applied to -it</screeninfo> -<mediaobject> -<imageobject> -<imagedata fileref="crocusses-edgebottom.png" format="PNG" /> -</imageobject> -<textobject> -<phrase>The image with the Bottom Edge Detection filter applied to it</phrase> -</textobject> -<caption><para>The image with the Bottom Edge Detection filter applied to -it</para></caption> -</mediaobject> -</screenshot> -</sect1> - -<sect1 id="filters-emboss"> -<title>The Emboss filters</title> -<para> -Emboss filters work somewhat like edge detection filters, with the difference -that embossed images are entirely gray. Areas in the picture are detected and -are given a certain <quote>height level</quote>, which is made visible by using -grayscale borders, making the image look like it is three-dimensional. -</para> -<para> -You can find the filters in the <menuchoice><guimenu>Filter</guimenu> -<guisubmenu>Emboss</guisubmenu></menuchoice> menu. -Except for the Emboss with Variable Depth filter, these filters are not -customizable. See the section on <link -linkend="commands-dialogs-filters-emboss">the -<guilabel>Emboss</guilabel> dialog</link> -for more information on the settings of the Emboss with Variable Depth filter. -</para> -<screenshot> -<screeninfo>The image with the Emboss in All Directions filter applied to it</screeninfo> -<mediaobject> -<imageobject> -<imagedata fileref="crocusses-embossall.png" format="PNG" /> -</imageobject> -<textobject> -<phrase>The image with the Emboss in All Directions filter applied to it</phrase> -</textobject> -<caption><para>The image with the Emboss in All Directions filter applied to -it</para></caption> -</mediaobject> -</screenshot> -<screenshot> -<screeninfo>The image with the Emboss with Variable depth filter applied to -it</screeninfo> -<mediaobject> -<imageobject> -<imagedata fileref="crocusses-embossvariable.png" format="PNG" /> -</imageobject> -<textobject> -<phrase>The image with the Emboss with Variable depth filter applied to it</phrase> -</textobject> -<caption><para>The image with the Emboss with Variable depth filter applied to -it</para></caption> -</mediaobject> -</screenshot> -</sect1> - -<sect1 id="filters-gaussianblur"> -<title>The Gaussian Blur filter</title> -<para> -This filter makes the image a little fuzzy by blurring it in a pseudo-random -way. A gaussian algorithm is used for finding the extent to which each part of -the image should be blurred. -</para> -<para> -You can find the filter in the <menuchoice><guimenu>Filter</guimenu> -<guisubmenu>Blur</guisubmenu></menuchoice> menu. -This filter is not customizable. -</para> -<screenshot> -<screeninfo>The image with the Gaussian Blur filter applied to it</screeninfo> -<mediaobject> -<imageobject> -<imagedata fileref="crocusses-gaussianblur.png" format="PNG" /> -</imageobject> -<textobject> -<phrase>The image with the Gaussian Blur filter applied to it</phrase> -</textobject> -<caption><para>The image with the Gaussian Blur filter applied to -it</para></caption> -</mediaobject> -</screenshot> -</sect1> - -<sect1 id="filters-gaussiannoise"> -<title>The Gaussian Noise Reduction filter</title> -<para> -With this filter, you can remove noise from your image. -</para> -<para> -You can find the filter in the <menuchoice><guimenu>Filter</guimenu> -<guisubmenu>Enhance</guisubmenu></menuchoice> menu. -See the section on <link -linkend="commands-dialogs-filters-gaussiannoise">the -<guilabel>Gaussian Noise Reduction</guilabel> dialog</link> -for more information on its settings. -</para> -<screenshot> -<screeninfo>The image with the Gaussian Noise Reduction filter applied to it</screeninfo> -<mediaobject> -<imageobject> -<imagedata fileref="crocusses-gaussiannoise.png" format="PNG" /> -</imageobject> -<textobject> -<phrase>The image with the Gaussian Noise Reduction filter applied to it</phrase> -</textobject> -<caption><para>The image with the Gaussian Noise Reduction filter applied to it</para></caption> -</mediaobject> -</screenshot> -</sect1> - -<sect1 id="filters-invert"> -<title>The Invert filter</title> -<para> -This filter inverts all colors. The Red, Green and Blue component of each pixel -are taken and subtracted from 255. This means that red becomes cyan, green -becomes purple, and blue becomes yellow. The resulting values form the new -pixel color. -</para> -<para> -You can find the filter in the <menuchoice><guimenu>Filter</guimenu> -<guisubmenu>Adjust</guisubmenu></menuchoice> menu. -This filter is not customizable. -</para> -<screenshot> -<screeninfo>The image with the Invert filter applied to it</screeninfo> -<mediaobject> -<imageobject> -<imagedata fileref="crocusses-invert.png" format="PNG" /> -</imageobject> -<textobject> -<phrase>The image with the Invert filter applied to it</phrase> -</textobject> -<caption><para>The image with the Invert filter applied to it</para></caption> -</mediaobject> -</screenshot> -</sect1> - -<sect1 id="filters-lenscorrection"> -<title>The Lens Correction filter</title> -<para> -This filter can fix distortions in your image resulting from for example -<quote>pincushion</quote> lens effects, and modify some lighting. -</para> -<para> -You can find the filter in the <menuchoice><guimenu>Filter</guimenu> -<guisubmenu>Other</guisubmenu></menuchoice> menu. -See the section on <link -linkend="commands-dialogs-filters-lenscorrection">the -<guilabel>Lens Correction</guilabel> dialog</link> -for more information on its settings. -</para> -<screenshot> -<screeninfo>The image with the Lens Correction filter applied to it</screeninfo> -<mediaobject> -<imageobject> -<imagedata fileref="crocusses-lenscorrection.png" format="PNG" /> -</imageobject> -<textobject> -<phrase>The image with the Lens Correction filter applied to it</phrase> -</textobject> -<caption><para>The image with the Lens Correction filter applied to it</para></caption> -</mediaobject> -</screenshot> -</sect1> - -<sect1 id="filters-maximizechannel"> -<title>The Maximize Channel filter</title> -<para> -This filter gives each pixel in your image a new color: only the color channel -that contributes the most to the color of a pixel is retained (except for -gray pixels, which are kept gray). -</para> -<para> -You can find the filter in the <menuchoice><guimenu>Filter</guimenu> -<guisubmenu>Colors</guisubmenu></menuchoice> menu. -This filter is not customizable. -</para> -<screenshot> -<screeninfo>The image with the Maximize Channel filter applied to it</screeninfo> -<mediaobject> -<imageobject> -<imagedata fileref="crocusses-maximizechannel.png" format="PNG" /> -</imageobject> -<textobject> -<phrase>The image with the Maximize Channel filter applied to it</phrase> -</textobject> -<caption><para>The image with the Maximize Channel filter applied to it</para></caption> -</mediaobject> -</screenshot> -</sect1> - -<sect1 id="filters-meanremoval"> -<title>The Mean Removal filter</title> -<para> -This filter sharpens the image by changing the colors of neighboring pixels -with approximately the same color, so that small differences are evened out. -</para> -<para> -You can find the filter in the <menuchoice><guimenu>Filter</guimenu> -<guisubmenu>Enhance</guisubmenu></menuchoice> menu. -This filter is not customizable. -</para> -<screenshot> -<screeninfo>The image with the Mean Removal filter applied to it</screeninfo> -<mediaobject> -<imageobject> -<imagedata fileref="crocusses-meanremoval.png" format="PNG" /> -</imageobject> -<textobject> -<phrase>The image with the Mean Removal filter applied to it</phrase> -</textobject> -<caption><para>The image with the Mean Removal filter applied to -it</para></caption> -</mediaobject> -</screenshot> -</sect1> - -<sect1 id="filters-minimizechannel"> -<title>The Minimize Channel filter</title> -<para> -This filter gives each pixel in your image a new color: the color channel -that contributes the most to the color of a pixel is removed (except for -gray pixels, which are kept gray). -</para> -<para> -You can find the filter in the <menuchoice><guimenu>Filter</guimenu> -<guisubmenu>Colors</guisubmenu></menuchoice> menu. -This filter is not customizable. -</para> -<screenshot> -<screeninfo>The image with the Minimize Channel filter applied to it</screeninfo> -<mediaobject> -<imageobject> -<imagedata fileref="crocusses-minimizechannel.png" format="PNG" /> -</imageobject> -<textobject> -<phrase>The image with the Minimize Channel filter applied to it</phrase> -</textobject> -<caption><para>The image with the Minimize Channel filter applied to it</para></caption> -</mediaobject> -</screenshot> -</sect1> - -<sect1 id="filters-oilpaint"> -<title>The Oilpaint filter</title> -<para> -An oilpaint effect is given to the image by creating patch-shaped areas in which -the most important color is applied to the entire area. -</para> -<para> -You can find the filter in the <menuchoice><guimenu>Filter</guimenu> -<guisubmenu>Artistic</guisubmenu></menuchoice> menu. -See the section on <link -linkend="commands-dialogs-filters-oilpaint">the -<guilabel>Oilpaint</guilabel> dialog</link> -for more information on its settings. -</para> -<screenshot> -<screeninfo>The image with the Oilpaint filter applied to it</screeninfo> -<mediaobject> -<imageobject> -<imagedata fileref="crocusses-oilpaint.png" format="PNG" /> -</imageobject> -<textobject> -<phrase>The image with the Oilpaint filter applied to it</phrase> -</textobject> -<caption><para>The image with the Oilpaint filter applied to -it</para></caption> -</mediaobject> -</screenshot> -</sect1> - -<sect1 id="filters-pixelize"> -<title>The Pixelize filter</title> -<para> -The image is pixelated by taking a square area and giving it the mean color -value of the pixels it contains. -</para> -<para> -You can find the filter in the <menuchoice><guimenu>Filter</guimenu> -<guisubmenu>Artistic</guisubmenu></menuchoice> menu. -See the section on <link -linkend="commands-dialogs-filters-pixelize">the -<guilabel>Pixelize</guilabel> dialog</link> -for more information on its settings. -</para> -<screenshot> -<screeninfo>The image with the Pixelize filter applied to it</screeninfo> -<mediaobject> -<imageobject> -<imagedata fileref="crocusses-pixelize.png" format="PNG" /> -</imageobject> -<textobject> -<phrase>The image with the Pixelize filter applied to it</phrase> -</textobject> -<caption><para>The image with the Pixelize filter applied to -it</para></caption> -</mediaobject> -</screenshot> -</sect1> - -<sect1 id="filters-raindrops"> -<title>The Raindrops filter</title> -<para> -This filter makes it look like raindrops have fallen on the image by distorting -drop-shaped areas with a lens-like effect as one would see when looking -at the image through a real raindrop. Some raindrops will have a fish-eye lens -effect. -</para> -<para> -You can find the filter in the <menuchoice><guimenu>Filter</guimenu> -<guisubmenu>Artistic</guisubmenu></menuchoice> menu. -See the section on <link -linkend="commands-dialogs-filters-raindrops">the -<guilabel>Raindrops</guilabel> dialog</link> -for more information on its settings. -</para> -<screenshot> -<screeninfo>The image with the Raindrops filter applied to it</screeninfo> -<mediaobject> -<imageobject> -<imagedata fileref="crocusses-raindrops.png" format="PNG" /> -</imageobject> -<textobject> -<phrase>The image with the Raindrops filter applied to it</phrase> -</textobject> -<caption><para>The image with the Raindrops filter applied to -it</para></caption> -</mediaobject> -</screenshot> -</sect1> - -<sect1 id="filters-randomnoise"> -<title>The Random Noise filter</title> -<para> -With this filter, random noise can be added to your image. -</para> -<para> -You can find the filter in the <menuchoice><guimenu>Filter</guimenu> -<guisubmenu>Other</guisubmenu></menuchoice> menu. -See the section on <link -linkend="commands-dialogs-filters-randomnoise">the -<guilabel>Random Noise</guilabel> dialog</link> -for more information on its settings. -</para> -<screenshot> -<screeninfo>The image with the Random Noise filter applied to it</screeninfo> -<mediaobject> -<imageobject> -<imagedata fileref="crocusses-randomnoise.png" format="PNG" /> -</imageobject> -<textobject> -<phrase>The image with the Random Noise filter applied to it</phrase> -</textobject> -<caption><para>The image with the Random Noise filter applied to it</para></caption> -</mediaobject> -</screenshot> -</sect1> - -<sect1 id="filters-randompick"> -<title>The Random Pick filter</title> -<para> -This filter distorts the image by interchanging pixels. -</para> -<para> -You can find the filter in the <menuchoice><guimenu>Filter</guimenu> -<guisubmenu>Other</guisubmenu></menuchoice> menu. -See the section on <link -linkend="commands-dialogs-filters-randompick">the -<guilabel>Random Pick</guilabel> dialog</link> -for more information on its settings. -</para> -<screenshot> -<screeninfo>The image with the Random Pick filter applied to it</screeninfo> -<mediaobject> -<imageobject> -<imagedata fileref="crocusses-randompick.png" format="PNG" /> -</imageobject> -<textobject> -<phrase>The image with the Random Pick filter applied to it</phrase> -</textobject> -<caption><para>The image with the Random Pick filter applied to it</para></caption> -</mediaobject> -</screenshot> -</sect1> - -<sect1 id="filters-roundcorners"> -<title>The Round Corners filter</title> -<para> -This filter just rounds off the corners of the image. This is done by making -the outside of the rounded corner transparent. -</para> -<para> -You can find the filter in the <menuchoice><guimenu>Filter</guimenu> -<guisubmenu>Map</guisubmenu></menuchoice> menu. -See the section on <link -linkend="commands-dialogs-filters-roundcorners">the -<guilabel>Round Corners</guilabel> dialog</link> -for more information on its settings. -</para> -<screenshot> -<screeninfo>The image with the Round Corners filter applied to it</screeninfo> -<mediaobject> -<imageobject> -<imagedata fileref="crocusses-roundcorners.png" format="PNG" /> -</imageobject> -<textobject> -<phrase>The image with the Round Corners filter applied to it</phrase> -</textobject> -<caption><para>The image with the Round Corners filter applied to -it</para></caption> -</mediaobject> -</screenshot> -</sect1> - -<sect1 id="filters-sharpen"> -<title>The Sharpen filter</title> -<para> -This filter sharpens the image. -</para> -<para> -You can find the filter in the <menuchoice><guimenu>Filter</guimenu> -<guisubmenu>Enhance</guisubmenu></menuchoice> menu. -This filter is not customizable. -</para> -<screenshot> -<screeninfo>The image with the Sharpen filter applied to it</screeninfo> -<mediaobject> -<imageobject> -<imagedata fileref="crocusses-sharpen.png" format="PNG" /> -</imageobject> -<textobject> -<phrase>The image with the Sharpen filter applied to it</phrase> -</textobject> -<caption><para>The image with the Sharpen filter applied to it</para></caption> -</mediaobject> -</screenshot> -</sect1> - -<sect1 id="filters-smalltiles"> -<title>The Small Tiles filter</title> -<para> -The picture is reduced in size and repeated multiple times. -</para> -<para> -You can find the filter in the <menuchoice><guimenu>Filter</guimenu> -<guisubmenu>Map</guisubmenu></menuchoice> menu. -See the section on <link -linkend="commands-dialogs-filters-smalltiles">the -<guilabel>Small Tiles</guilabel> dialog</link> -for more information on its settings. -</para> -<screenshot> -<screeninfo>The image with the Small Tiles filter applied to it</screeninfo> -<mediaobject> -<imageobject> -<imagedata fileref="crocusses-smalltiles.png" format="PNG" /> -</imageobject> -<textobject> -<phrase>The image with the Small Tiles filter applied to it</phrase> -</textobject> -<caption><para>The image with the Small Tiles filter applied to -it</para></caption> -</mediaobject> -</screenshot> -</sect1> - -<sect1 id="filters-sobel"> -<title>The Sobel filter</title> -<para> -This is a more enhanced edge detection filter. -</para> -<para> -You can find the filter in the <menuchoice><guimenu>Filter</guimenu> -<guisubmenu>Edge Detection</guisubmenu></menuchoice> menu. -See the section on <link -linkend="commands-dialogs-filters-sobel">the -<guilabel>Sobel</guilabel> dialog</link> -for more information on its settings. -</para> -<screenshot> -<screeninfo>The image with the Sobel filter applied to it</screeninfo> -<mediaobject> -<imageobject> -<imagedata fileref="crocusses-sobel.png" format="PNG" /> -</imageobject> -<textobject> -<phrase>The image with the Sobel filter applied to it</phrase> -</textobject> -<caption><para>The image with the Sobel filter applied to it</para></caption> -</mediaobject> -</screenshot> -</sect1> - -<sect1 id="filters-unsharpmask"> -<title>The Unsharp Mask filter</title> -<para> -This filter sharpens part of your image. (The name <quote>unsharp</quote> is -historical: parts would be masked off while the rest would be made less sharp.) -</para> -<para> -You can find the filter in the <menuchoice><guimenu>Filter</guimenu> -<guisubmenu>Enhance</guisubmenu></menuchoice> menu. -See the section on <link -linkend="commands-dialogs-filters-unsharpmask">the -<guilabel>Unsharp Mask</guilabel> dialog</link> -for more information on its settings. -</para> -<screenshot> -<screeninfo>The image with the Unsharp Mask filter applied to it</screeninfo> -<mediaobject> -<imageobject> -<imagedata fileref="crocusses-unsharpmask.png" format="PNG" /> -</imageobject> -<textobject> -<phrase>The image with the Unsharp Mask filter applied to it</phrase> -</textobject> -<caption><para>The image with the Unsharp Mask filter applied to it</para></caption> -</mediaobject> -</screenshot> -</sect1> - -<sect1 id="filters-wave"> -<title>The Wave filter</title> -<para> -This filter transforms your image into a wave shape. -</para> -<para> -You can find the filter in the <menuchoice><guimenu>Filter</guimenu> -<guisubmenu>Other</guisubmenu></menuchoice> menu. -See the section on <link -linkend="commands-dialogs-filters-wave">the -<guilabel>Wave</guilabel> dialog</link> -for more information on its settings. -</para> -<screenshot> -<screeninfo>The image with the Wave filter applied to it</screeninfo> -<mediaobject> -<imageobject> -<imagedata fileref="crocusses-wave.png" format="PNG" /> -</imageobject> -<textobject> -<phrase>The image with the Wave filter applied to it</phrase> -</textobject> -<caption><para>The image with the Wave filter applied to it</para></caption> -</mediaobject> -</screenshot> -</sect1> - -<sect1 id="filters-waveletnoise"> -<title>The Wavelet Noise Reduction filter</title> -<para> -This filter reduces noise in the image by giving loose pixels a color close to -the surrounding area. This causes small details to be lost, but can enhance the -general view of the image when this is hampered by too many unnecessary details. -</para> -<para> -You can find the filter in the <menuchoice><guimenu>Filter</guimenu> -<guisubmenu>Enhance</guisubmenu></menuchoice> menu. -See the section on <link -linkend="commands-dialogs-filters-waveletnoise">the -<guilabel>Wavelet Noise Reduction</guilabel> dialog</link> -for more information on its settings. -</para> -<screenshot> -<screeninfo>The image with the Wavelet Noise Reduction filter applied to -it</screeninfo> -<mediaobject> -<imageobject> -<imagedata fileref="crocusses-waveletnoise.png" format="PNG" /> -</imageobject> -<textobject> -<phrase>The image with the Wavelet Noise Reduction filter applied to it</phrase> -</textobject> -<caption><para>The image with the Wavelet Noise Reduction filter applied to -it</para></caption> -</mediaobject> -</screenshot> -</sect1> - - -</chapter> diff --git a/doc/krita/using-images.docbook b/doc/krita/using-images.docbook deleted file mode 100644 index e3b1f239..00000000 --- a/doc/krita/using-images.docbook +++ /dev/null @@ -1,66 +0,0 @@ -<chapter id="images"> -<title>Images</title> - -<para> -Creating and modifying images is one of &krita;'s core functionalities. While -most of the other chapters in this manual focus on the things you can do when -painting or editing, this chapter shows you what you can do with respect to -the images themselves. -</para> - -<sect1 id="images-files"> -<title>Working with files</title> - -<para> -Unless you are doing some quick sketching, working with &krita; will most -likely involve files. You can open existing images — &krita; can work -with a large number of file formats, see <link -linkend="introduction-keyfeatures-imageformats">Image formats</link> — -or start &krita; to create a new one. When you are done or if you want to -continue at a later time, you can easily save your work. -</para> - -<variablelist> - -<varlistentry><term>Opening existing files</term> -<listitem><para>When you start &krita;, you can open an existing image with -the <guibutton>Open Existing Document</guibutton> button at the lower left of -the opening dialog. You can also use the -<menuchoice><guimenu>File</guimenu><guimenuitem>Open</guimenuitem></menuchoice> -menu option (<keycombo action="simul">&Ctrl;<keycap>O</keycap></keycombo>). -This will bring up the <guilabel>Open Document</guilabel> dialog in which you -can choose an image to open. The opening dialog and the -<guimenu>File</guimenu> menu also contain a list of the most recently used -files for quick access.</para></listitem> -</varlistentry> - -<varlistentry><term>Saving your work in progress</term> -<listitem><para>With the -<menuchoice><guimenu>File</guimenu><guimenuitem>Save</guimenuitem></menuchoice> -and <menuchoice><guimenu>File</guimenu><guimenuitem>Save As...</guimenuitem></menuchoice> -menu options (or their respective shortcuts <keycombo -action="simul">&Ctrl;<keycap>S</keycap></keycombo> and <keycombo -action="simul">&Ctrl;&Shift;<keycap>S</keycap></keycombo>), you can save your -work. The former option will save the modifications to the current image, the -latter option will show the <guilabel>Save Document</guilabel> dialog in which -you can give a new file name for the image. If this is the first time you save -the image, <guimenuitem>Save</guimenuitem> will ask for a file name as well. -</para></listitem> -</varlistentry> - -<varlistentry><term>Creating a new image</term> -<listitem><para>From the opening dialog (available via the -<menuchoice><guimenu>File</guimenu><guimenuitem>New</guimenuitem></menuchoice> -menu option or the <keycombo -action="simul">&Ctrl;<keycap>N</keycap></keycombo> keys), you can create a -fully custom document or choose one of the image templates. These templates -offer a quick way of creating a new image. See the <link -linkend="tutorial-starting">Starting to know &krita;</link> tutorial. -</para></listitem> -</varlistentry> - -</variablelist> - -</sect1> - -</chapter> diff --git a/doc/krita/using-layers.docbook b/doc/krita/using-layers.docbook deleted file mode 100644 index 8cb574f6..00000000 --- a/doc/krita/using-layers.docbook +++ /dev/null @@ -1,620 +0,0 @@ -<chapter id="layers"> -<title>Layers</title> - -<para> -This chapter gives an overview of how layers work in &krita;. -</para> - -<sect1 id="layers-background"> -<title>Background information on layers</title> - -<para> -Extensive use of &krita; will almost require you to have some knowledge of -layers. Using layers, you can work on one part of the image without touching -the rest of it, and most effects are best applied on a layer, instead of on -the whole image. Of course, if you do want to apply an effect to an entire -image, &krita; does offer you that possibility, and there is nothing against -it. -</para><para> -The idea behind layers is quite simple. As the name suggests, layers lie on -top of each other, and together form the layer stack. The final resulting -image is that what you see when looking through the stack from top to bottom. -This means that usually the upper layers of your image will have more or less -transparency, since you cannot look through a layer which has no transparency. -(&krita; works with opaqueness instead of transparency. A layer that is 100 -percent opaque is 0 percent transparent, and vice versa.) A layer higher in -the stack gets applied later than one lower in the stack. For example, if your -image contains four layers, numbered from 1 (lowest) to 4 (highest), the -effect that layer number 4 adds to the image, is applied to the result from -applying layers 1 through 3. -</para><para> -Every image you edit in &krita; contains layers. When you create a new image, -the layer box (usually shown at the bottom right of your screen, see <link -linkend="commands-palettes-layers-layers">this section</link>) will contain -one layer. The painting and editing you do is then applied to that layer. Once -you add more layers, you can choose on which part of the image you want to -work, by selecting the respective layer. All further painting is then applied -to that layer, until you select another one. -</para><para> -Layers are also an excellent way to check whether adding certain effects (or -applying certain image modifications) come out right. Add a layer which -contains what you want to try out, and show or hide it with the eye icon in -the layer box. You can especially profit from this method if you have multiple -effects to check out: show and hide them in any combination, and decide which -you like best. And since you can move the layers around, you can also -experiment with the order in which the effects are applied. -</para><para> -See the <link linkend="tutorial-select-layer">Selections and layers -tutorial</link> for a small hands-on introduction. -</para> -</sect1> - -<sect1 id="layers-layerbox"> -<title>The layer box</title> - -<para>The layer box is the instrument you will use most to work with layers. It -gives an overview of the layers that are present in your image, and using it -you can manage layers by adding, removing, reordering or modifying them. -</para><para> -The layer box consists of three parts. The middle part gives an overview of the -layers in the image. At the top, you can set some properties for the current -layer. At the bottom, a couple of layer management options can be found. The -next sections describe these three parts in more detail. -</para> - -<sect2 id="layers-layerbox-overview"> -<title>Layer overview</title> - -<para>This part shows you which layers are present in your image. In a tree-like -structure, the layer group hierarchy is shown: layers that are contained within -a layer group are displayed a bit to the right to indicate their belonging to -that group. -</para><para> -For each layer, a thumbnail preview and its name are shown. The layer name -is preceded by a folder icon if it is a group layer. Furthermore, two -indicators are present: the eye icon shows whether the layer is currently -visible (an open eye indicates that the layer is visible, a closed eye -indicates that it is not), and the lock icon shows whether the layer is -locked. No changes can be made to a locked layer. -</para><para> -When you click on a layer's eye icon, its visibility is switched from on to -off or vice versa. Clicking on the lock icon enables or disables editing of -that layer. You can click on the name of the current layer to rename it. -Note that to rename a layer, it has to be the current one. You do not need to -activate a layer in order to make it (in)visible or (un)locked via the eye and -lock icons, respectively: these work directly. -</para><para> -Doubleclick on a layer entry in the list to open the <link -linkend="commands-dialogs-layers-layerproperties"><guilabel>Layer -Properties</guilabel></link> dialog. This dialog shows a layer's colorspace and -profile. You can also change its name, opacity and composite mode here. -</para> -</sect2> - -<sect2 id="layers-layerbox-options"> -<title>Layer options</title> -<para> -The top of the layer box contains two controls for setting properties of the -currently selected layer. The list box at the left allows you to quickly set -the layer's composite mode. The spin field and slider at the right can be used -to change the layer's opacity. -</para><para> -At the bottom of the layer box, there are five buttons. From left to right, -these are as follows. The <guibutton>New Layer</guibutton> icon brings up a -submenu from which you can choose which type of layer you want to add. This -menu can also be opened by clicking with the &RMB; on the layer box. The -<guibutton>Move Layer Down</guibutton> and <guibutton>Move Layer Up</guibutton> -buttons move the current layer one level down and up, respectively, within the -current layer group. If the layer is already the last or first within the -layer group, trying to move it further will move it out of the layer group. -The <guibutton>Layer Properties</guibutton> button opens the <link -linkend="commands-dialogs-layers-layerproperties"><guilabel>Layer -Properties</guilabel></link> dialog, just as when you would have doubleclicked -on the layer. The <guibutton>Delete Layer</guibutton> button deletes the -current layer. -</para> -</sect2> - -</sect1> - -<sect1 id="layers-working"> -<title>Working with layers</title> - -<para> -Because layers are quite important when extensively using &krita;, you can -perform a lot of operations on them. These are all available via the <link -linkend="commands-menus-layer"><guimenu>Layer</guimenu> menu</link>. Some of -the possibilities: -</para> - -<variablelist> -<varlistentry><term></term><listitem><para>Add, remove, and duplicate layers;</para></listitem></varlistentry> -<varlistentry><term></term><listitem><para>Create and edit layer masks;</para></listitem></varlistentry> -<varlistentry><term></term><listitem><para>Flip, rotate, scale and shear layers;</para></listitem></varlistentry> -<varlistentry><term></term><listitem><para>Convert layers between colorspaces;</para></listitem></varlistentry> -<varlistentry><term></term><listitem><para>Save layers as images;</para></listitem></varlistentry> -<varlistentry><term></term><listitem><para>View layer histograms.</para></listitem></varlistentry> -</variablelist> - -</sect1> - -<sect1 id="layers-adjustment"> -<title>Adjustment Layers</title> - -<para>Adjustment layers are layers that consist of a filter and an optional -selection. The filter effect is applied to the composite image of all -layers under the adjustment layer in the current layer group. The big -thing is, adjustment layers apply these effects non-destructively. The -original image data is not modified. -</para><para> -Almost all &krita; filters are suitable for use in adjustment -layers -- even filters that would downgrade the image quality. For instance, -the raindrops filter converts to 8-bit RGB before working its magic. If you -would try to use this filter directly on a 16-bit L*a*b* layer, &krita; would -warn you about the conversion to RGB and back again this filter would cause. -Not so with adjustment layers: the original data isn't touched, so applying -the filter is safe. -</para><para> -What about the colorspace of an adjustment layer then? In order to examine -this issue, you need to know what happens when &krita; renders an adjustment -layer. -</para> - -<sect2 id="layers-adjustment-selections"> -<title>Adjustment layers and selections</title> - -<para>If the currently active layer has an active selection, then that selection -will be copied and used as a mask for the adjustment layer. If there is no -active selection, then there will be no mask and the adjustment will apply to -the entire extent of the layers under the adjustment layer in the current -group. There is <emphasis>no</emphasis> way of adding a mask to an existing -adjustment layer. -</para><para> -If there is a mask in the adjustment layer, you can edit the mask using the -ordinary painting tools and painting operations. -</para> - -</sect2> - -<sect2 id="layers-adjustment-projection"> -<title>A note on projections</title> - -<para> -&krita; composites the layers bottom to top, within each layer group. The -aggregate -- or the projection as it is also called -- is then filtered by -the adjustment layer. If there are layers on top of the adjustment layer, -those are composited onto the projection. &krita; converts all layer data before -compositing, so if the bottom-most layer in an image is grayscale, all layers -are converted to grayscale before compositing -- and that means that the -adjustment layer projection will be grayscale, too. -</para><para> -With this knowledge you'll understand why &krita; can often offer better -performance working with layers on top of an adjustment layer which is on top -of a complex layer structure: &krita; uses the projection and doesn't even look -anymore at the layers under the adjustment layer. Unless, of course, you -change one of them. -</para> -</sect2> - -</sect1> - -<sect1 id="layers-composite"> -<title>Compositing modes</title> - -<para> -Layers can be composited in various ways, each yielding a different effect. -This section describes the available compositing modes. Each description is -accompanied by an example: on top of an original image (see below), a rainbow -gradient is added. -</para> - -<para> -<screenshot> -<screeninfo>The original image</screeninfo> -<mediaobject> -<imageobject> -<imagedata fileref="mountains-original.png" format="PNG" /> -</imageobject> -<textobject> -<phrase>The original image</phrase> -</textobject> -<caption><para>The original image</para></caption> -</mediaobject> -</screenshot> -</para> - -<sect2 id="layers-composite-normal"> -<title><guilabel>Normal</guilabel></title> - -<para> -The <guilabel>Normal</guilabel> mode does nothing special. It adds the layer -to the image, and if no other special effects like opacity are changed, the -underlying layers will only be visible at places where the new layer is -itself transparent. -</para> - -<para> -<screenshot> -<screeninfo>The gradient applied with the <guilabel>Normal</guilabel> compositing -mode</screeninfo> -<mediaobject> -<imageobject> -<imagedata fileref="mountains-normal.png" format="PNG" /> -</imageobject> -<textobject> -<phrase>The gradient applied with the <guilabel>Normal</guilabel> compositing -mode</phrase> -</textobject> -<caption><para>The gradient applied with the <guilabel>Normal</guilabel> compositing -mode</para></caption> -</mediaobject> -</screenshot> -</para> - -</sect2> - -<sect2 id="layers-composite-multiply"> -<title><guilabel>Multiply</guilabel></title> - -<para> -The <guilabel>Multiply</guilabel> mode blends the two layers so that the -bottom layer gets <quote>colorized</quote> by the new layer. The resulting -image is generally quite dark. -</para> - -<para> -<screenshot> -<screeninfo>The gradient applied with the <guilabel>Multiply</guilabel> compositing -mode</screeninfo> -<mediaobject> -<imageobject> -<imagedata fileref="mountains-multiply.png" format="PNG" /> -</imageobject> -<textobject> -<phrase>The gradient applied with the <guilabel>Multiply</guilabel> compositing -mode</phrase> -</textobject> -<caption><para>The gradient applied with the <guilabel>Multiply</guilabel> compositing -mode</para></caption> -</mediaobject> -</screenshot> -</para> - -</sect2> - -<sect2 id="layers-composite-burn"> -<title><guilabel>Burn</guilabel>, <guilabel>Dodge</guilabel>, -<guilabel>Divide</guilabel> and <guilabel>Screen</guilabel></title> - -<para> -The <guilabel>Burn</guilabel>, <guilabel>Dodge</guilabel>, -<guilabel>Divide</guilabel> and <guilabel>Screen</guilabel> modes all add an -extra <quote>burning</quote> effect by following contours instead of using -straight lines. In addition, <guilabel>Burn</guilabel> and -<guilabel>Divide</guilabel> use the inverted colors instead of the actual -colors of the composited layer. -</para> - -<para> -<screenshot> -<screeninfo>The gradient applied with the <guilabel>Burn</guilabel> compositing -mode</screeninfo> -<mediaobject> -<imageobject> -<imagedata fileref="mountains-burn.png" format="PNG" /> -</imageobject> -<textobject> -<phrase>The gradient applied with the <guilabel>Burn</guilabel> compositing -mode</phrase> -</textobject> -<caption><para>The gradient applied with the <guilabel>Burn</guilabel> compositing -mode</para></caption> -</mediaobject> -</screenshot> -</para> - -<para> -<screenshot> -<screeninfo>The gradient applied with the <guilabel>Dodge</guilabel> compositing -mode</screeninfo> -<mediaobject> -<imageobject> -<imagedata fileref="mountains-dodge.png" format="PNG" /> -</imageobject> -<textobject> -<phrase>The gradient applied with the <guilabel>Dodge</guilabel> compositing -mode</phrase> -</textobject> -<caption><para>The gradient applied with the <guilabel>Dodge</guilabel> compositing -mode</para></caption> -</mediaobject> -</screenshot> -</para> - -<para> -<screenshot> -<screeninfo>The gradient applied with the <guilabel>Divide</guilabel> compositing -mode</screeninfo> -<mediaobject> -<imageobject> -<imagedata fileref="mountains-divide.png" format="PNG" /> -</imageobject> -<textobject> -<phrase>The gradient applied with the <guilabel>Divide</guilabel> compositing -mode</phrase> -</textobject> -<caption><para>The gradient applied with the <guilabel>Divide</guilabel> compositing -mode</para></caption> -</mediaobject> -</screenshot> -</para> - -<para> -<screenshot> -<screeninfo>The gradient applied with the <guilabel>Screen</guilabel> compositing -mode</screeninfo> -<mediaobject> -<imageobject> -<imagedata fileref="mountains-screen.png" format="PNG" /> -</imageobject> -<textobject> -<phrase>The gradient applied with the <guilabel>Screen</guilabel> compositing -mode</phrase> -</textobject> -<caption><para>The gradient applied with the <guilabel>Screen</guilabel> compositing -mode</para></caption> -</mediaobject> -</screenshot> -</para> - -</sect2> - -<sect2 id="layers-composite-overlay"> -<title><guilabel>Overlay</guilabel></title> - -<para> -Like <guilabel>Multiply</guilabel>, the <guilabel>Overlay</guilabel> mode -colorizes the underlying layer. The resulting image is about as light as -the original layer. -</para> - -<para> -<screenshot> -<screeninfo>The gradient applied with the <guilabel>Overlay</guilabel> compositing -mode</screeninfo> -<mediaobject> -<imageobject> -<imagedata fileref="mountains-overlay.png" format="PNG" /> -</imageobject> -<textobject> -<phrase>The gradient applied with the <guilabel>Overlay</guilabel> compositing -mode</phrase> -</textobject> -<caption><para>The gradient applied with the <guilabel>Overlay</guilabel> compositing -mode</para></caption> -</mediaobject> -</screenshot> -</para> - -</sect2> - -<sect2 id="layers-composite-darken"> -<title><guilabel>Darken</guilabel></title> - -<para> -The <guilabel>Darken</guilabel> mode darkens the underlying layer while -colorizing it to match the colors in the composited layer. -</para> - -<para> -<screenshot> -<screeninfo>The gradient applied with the <guilabel>Darken</guilabel> compositing -mode</screeninfo> -<mediaobject> -<imageobject> -<imagedata fileref="mountains-darken.png" format="PNG" /> -</imageobject> -<textobject> -<phrase>The gradient applied with the <guilabel>Darken</guilabel> compositing -mode</phrase> -</textobject> -<caption><para>The gradient applied with the <guilabel>Darken</guilabel> compositing -mode</para></caption> -</mediaobject> -</screenshot> -</para> - -</sect2> - -<sect2 id="layers-composite-lighten"> -<title><guilabel>Lighten</guilabel></title> - -<para> -The <guilabel>Lighten</guilabel> mode lightens the underlying layer while -colorizing it to match the colors in the composited layer. -</para> - -<para> -<screenshot> -<screeninfo>The gradient applied with the <guilabel>Lighten</guilabel> compositing -mode</screeninfo> -<mediaobject> -<imageobject> -<imagedata fileref="mountains-lighten.png" format="PNG" /> -</imageobject> -<textobject> -<phrase>The gradient applied with the <guilabel>Lighten</guilabel> compositing -mode</phrase> -</textobject> -<caption><para>The gradient applied with the <guilabel>Lighten</guilabel> compositing -mode</para></caption> -</mediaobject> -</screenshot> -</para> - -</sect2> - -<sect2 id="layers-composite-hue"> -<title><guilabel>Hue</guilabel>, <guilabel>Saturation</guilabel> and -<guilabel>Value</guilabel></title> - -<para> -The <guilabel>Hue</guilabel>, <guilabel>Saturation</guilabel> and -<guilabel>Value</guilabel> modes respectively apply the hue, saturation and -value components of the composited layer to the underlying layer. -</para> - -<para> -<screenshot> -<screeninfo>The gradient applied with the <guilabel>Hue</guilabel> compositing -mode</screeninfo> -<mediaobject> -<imageobject> -<imagedata fileref="mountains-hue.png" format="PNG" /> -</imageobject> -<textobject> -<phrase>The gradient applied with the <guilabel>Hue</guilabel> compositing -mode</phrase> -</textobject> -<caption><para>The gradient applied with the <guilabel>Hue</guilabel> compositing -mode</para></caption> -</mediaobject> -</screenshot> -</para> - -<para> -<screenshot> -<screeninfo>The gradient applied with the <guilabel>Saturation</guilabel> compositing -mode</screeninfo> -<mediaobject> -<imageobject> -<imagedata fileref="mountains-saturation.png" format="PNG" /> -</imageobject> -<textobject> -<phrase>The gradient applied with the <guilabel>Saturation</guilabel> compositing -mode</phrase> -</textobject> -<caption><para>The gradient applied with the <guilabel>Saturation</guilabel> compositing -mode</para></caption> -</mediaobject> -</screenshot> -</para> - -<para> -<screenshot> -<screeninfo>The gradient applied with the <guilabel>Value</guilabel> compositing -mode</screeninfo> -<mediaobject> -<imageobject> -<imagedata fileref="mountains-value.png" format="PNG" /> -</imageobject> -<textobject> -<phrase>The gradient applied with the <guilabel>Value</guilabel> compositing -mode</phrase> -</textobject> -<caption><para>The gradient applied with the <guilabel>Value</guilabel> compositing -mode</para></caption> -</mediaobject> -</screenshot> -</para> - -</sect2> - -<sect2 id="layers-composite-color"> -<title><guilabel>Color</guilabel></title> - -<para> -The <guilabel>Color</guilabel> mode colorizes the underlying layer, yielding -very strong colors. -</para> - -<para> -<screenshot> -<screeninfo>The gradient applied with the <guilabel>Color</guilabel> compositing -mode</screeninfo> -<mediaobject> -<imageobject> -<imagedata fileref="mountains-color.png" format="PNG" /> -</imageobject> -<textobject> -<phrase>The gradient applied with the <guilabel>Color</guilabel> compositing -mode</phrase> -</textobject> -<caption><para>The gradient applied with the <guilabel>Color</guilabel> compositing -mode</para></caption> -</mediaobject> -</screenshot> -</para> - -</sect2> - -</sect1> - -<sect1 id="layers-masks"> -<title>Layer Masks</title> - -<para> -Basically, a layer mask is a mask that you place on your paint layer. This -will literally mask areas of the layer, so that the content underneath shows -through. You can paint on it with greyscale colors: the more black the color, -the less the layer under it will shine through, the more white, the less the -layer under it will be shown. So complete white will let nothing through, -complete black will let everything through. Basically, it is a bit like -selecting a piece of your image, and then cutting it, so that the selected -bits go away. So what is the use for a mask here? The big advantage is that it -is non-destructive: if you decide that you masked out the wrong part of your -layer, you can easily remove the mask and start anew, something a lot harder -(not to say near impossible, especially in between sessions) with regular -selection-cutting. -</para><para> -So, how to create a mask? There are 2 ways: -</para> - -<itemizedlist> -<listitem><para> -Start from scratch. -<menuchoice><guimenu>Layer</guimenu><guisubmenu>Mask</guisubmenu><guimenuitem>Create -Mask</guimenuitem></menuchoice>. The mask starts with everything being -retained, that is, a complete white mask. Basically you will not see any -changes as long as you do not paint on it. -</para></listitem> -<listitem><para> -Start from the current selection. -<menuchoice><guimenu>Layer</guimenu><guisubmenu>Mask</guisubmenu><guimenuitem>Mask -From Selection</guimenuitem></menuchoice>. The selectedness will be converted -to whiteness. This means that fully selected area will be visible, fully -unselected areas will be invisible, and the rest will be partially visible, -depending on how much the area was selected. -</para></listitem> -</itemizedlist> - -<sect2 id="layers-masks-editing"> -<title>Editing the mask</title> - -<para> -First, make sure you are editing the mask, not the layer, by making sure -<menuchoice><guimenu>Layer</guimenu><guisubmenu>Mask</guisubmenu><guimenuitem>Edit -Mask</guimenuitem></menuchoice> is checked. (This is checked by default.) Then -you can paint on the layer just like before, only now you are -painting on the mask, instead of on the layer itself. To stop painting on the -mask, you can uncheck the <guilabel>Edit Mask</guilabel> checkbox. There's -also the option to show the mask, through checking -<menuchoice><guimenu>Layer</guimenu><guisubmenu>Mask</guisubmenu><guimenuitem>Show -Mask</guimenuitem></menuchoice>. (This is not checked by -default). This option will render the entire layer as a visual representation -of the mask in greyscale, instead of the actual layer. This can be handy to -see where your mask is, but it might be not as handy when you want to edit it, -since you cannot look at the actual layer. -</para><para> -Other actions: you can also remove the mask if you are not satisfied with it, -and want to start over again, or just want to remove it, with -<menuchoice><guimenu>Layer</guimenu><guisubmenu>Mask</guisubmenu><guimenuitem>Remove -Mask</guimenuitem></menuchoice>. You can also <quote>apply</quote> the mask, -meaning that the mask will be made permanently. This means that the mask is -removed, but that its effect of transparency will be committed to the layer. -</para> - -</sect2> -</sect1> - -</chapter> diff --git a/doc/krita/using-selections-1.png b/doc/krita/using-selections-1.png Binary files differdeleted file mode 100644 index 3efc76bb..00000000 --- a/doc/krita/using-selections-1.png +++ /dev/null diff --git a/doc/krita/using-selections-2.png b/doc/krita/using-selections-2.png Binary files differdeleted file mode 100644 index f2e3febc..00000000 --- a/doc/krita/using-selections-2.png +++ /dev/null diff --git a/doc/krita/using-selections-3.png b/doc/krita/using-selections-3.png Binary files differdeleted file mode 100644 index 059d2983..00000000 --- a/doc/krita/using-selections-3.png +++ /dev/null diff --git a/doc/krita/using-selections-4.png b/doc/krita/using-selections-4.png Binary files differdeleted file mode 100644 index 0cfec2cb..00000000 --- a/doc/krita/using-selections-4.png +++ /dev/null diff --git a/doc/krita/using-selections-5.png b/doc/krita/using-selections-5.png Binary files differdeleted file mode 100644 index c220306d..00000000 --- a/doc/krita/using-selections-5.png +++ /dev/null diff --git a/doc/krita/using-selections-6.png b/doc/krita/using-selections-6.png Binary files differdeleted file mode 100644 index 7c99accd..00000000 --- a/doc/krita/using-selections-6.png +++ /dev/null diff --git a/doc/krita/using-selections.docbook b/doc/krita/using-selections.docbook deleted file mode 100644 index 5465b8a6..00000000 --- a/doc/krita/using-selections.docbook +++ /dev/null @@ -1,200 +0,0 @@ -<chapter id="selections"> -<title>Selections</title> - -<para> -This chapter gives a short introduction on selections. -</para><para> -You can select a part of an image masking off the rest. This is handy when -you want to cut, copy or just modify a part of the image without affecting -the rest. For processing selected objects &krita; applies a mask. Each pixel of -the selection is processed based on a value of its mask, or the <quote>level -of the selection</quote>, that can range from 0 (unselected) to 255 -(selected). Yes, that is right, you can have fractionally selected pixels. -And by working on individual pixels you can <quote>paint</quote> your selection. -</para><para> -The selection mask is visualized with unselected pixels having a blueish -tint, and selected pixels looking like normal. Fractionally selected pixels -are shown as something in between. Additionally a red border is drawn around -the selected areas. Fractionally selected pixels are inside the border, so -even inside the red border you can possibly see the blueish tint on some pixels. -</para> - -<sect1 id="selections-making"> -<title>Making a selection</title> -<para> -A whole range of tools exist to make selections. From rectangles, ellipses -and freehand to the more exotic like color range select. When you make -several selections they add up. So a rectangle select followed by an -ellipse select select both areas. Later on, you can subtract areas from -the selection by using, for example, the <guilabel>Erase Selection</guilabel> tool. -</para><para> -To get back to normal (no active selection), choose -<menuchoice><guimenu>Select</guimenu><guimenuitem>Deselect</guimenuitem> -</menuchoice>. To select all pixels, choose -<menuchoice><guimenu>Select</guimenu><guimenuitem>Select All</guimenuitem> -</menuchoice>. -</para><para> -You may think that those two actions give the same result, but it -is much more efficient to have no active selection than to have selected -everything. -</para><para> -After having deselected you can bring your selection back by choosing -<menuchoice><guimenu>Select</guimenu><guimenuitem>Reselect</guimenuitem> -</menuchoice>. -</para> -</sect1> - -<sect1 id="selections-painting"> -<title>Painting your selection</title> -<para> -As said above you can essentially paint your selection, and just like -when you paint normally you can choose to paint your selection freehand or -guided with rectangles, ellipses, &etc;. You also have the choice of different -paint tools like pen, brush, airbrush, &etc;. Choose the guide tool, and the -paint tool in the toolbox, and go ahead and <quote>paint</quote> your -selection. -</para><para> -The guide tools work just like you may be used to from other applications. So -holding down shift while drawing a rectangle or an ellipse still forces them to -be a square or a circle respectively. -</para> - -<screenshot> -<screeninfo>Painting a selection</screeninfo> -<mediaobject> -<imageobject> -<imagedata fileref="using-selections-1.png" format="PNG" /> -</imageobject> -<textobject> -<phrase>Painting a selection</phrase> -</textobject> -<caption><para>Painting a selection</para></caption> -</mediaobject> -</screenshot> -<screenshot> -<screeninfo>Painting a selection</screeninfo> -<mediaobject> -<imageobject> -<imagedata fileref="using-selections-2.png" format="PNG" /> -</imageobject> -<textobject> -<phrase>Painting a selection</phrase> -</textobject> -<caption><para>Painting a selection</para></caption> -</mediaobject> -</screenshot> - -</sect1> - -<sect1 id="selections-unselecting"> -<title>Unselecting</title> -<para> -All the selection paint tools have an option to add or subtract from the -selection. This means that you can use all your familiar tools to both select -and unselect. There is also a true selection eraser among the selection paint -tools. -</para> - -<screenshot> -<screeninfo>Unselecting</screeninfo> -<mediaobject> -<imageobject> -<imagedata fileref="using-selections-3.png" format="PNG" /> -</imageobject> -<textobject> -<phrase>Unselecting</phrase> -</textobject> -<caption><para>Unselecting</para></caption> -</mediaobject> -</screenshot> -</sect1> - -<sect1 id="selections-making-new"> -<title>Making a new selection</title> -<para> -When you want to make a new selection, replacing the currently active one, you -first need to deselect the active selection. Choose -<menuchoice><guimenu>Select</guimenu><guimenuitem>Deselect</guimenuitem> -</menuchoice>. -</para> -</sect1> - -<sect1 id="selections-contigious"> -<title>Selecting a contiguous area (magic wand)</title> -<para> -To follow the analogy of painting your selection &krita; also provides an -equivalent to filling a contiguous area. Some paint applications call this -selection tool the magic wand tool. What it does is select the nearby -pixels as long as they have nearly the same color as the pixel you click -on. The selection floods out from the point you click on. In the fuzziness -option you can set how different the colors are allowed to be before the -flooding stops. -</para> - -<screenshot> -<screeninfo>Before the magic wand</screeninfo> -<mediaobject> -<imageobject> -<imagedata fileref="using-selections-4.png" format="PNG" /> -</imageobject> -<textobject> -<phrase>Before the magic wand</phrase> -</textobject> -<caption><para>Before the magic wand</para></caption> -</mediaobject> -</screenshot> - -<screenshot> -<screeninfo>A magic wand selection</screeninfo> -<mediaobject> -<imageobject> -<imagedata fileref="using-selections-5.png" format="PNG" /> -</imageobject> -<textobject> -<phrase>A magic wand selection</phrase> -</textobject> -<caption><para>A magic wand selection</para></caption> -</mediaobject> -</screenshot> - -</sect1> - -<sect1 id="selections-similar"> -<title>Selecting similar colors</title> -<para> -The <guilabel>Select Similar</guilabel> tool lets you pick a pixel and then select all pixels that -have a similar color. Picking a color in one corner of the image may select a -pixel in another corner if they have similar color. -With the <guilabel>Fuzziness</guilabel> option you can set how similar the colors must be to become -selected. -</para> - -<screenshot> -<screeninfo>Selecting similar colors</screeninfo> -<mediaobject> -<imageobject> -<imagedata fileref="using-selections-6.png" format="PNG" /> -</imageobject> -<textobject> -<phrase>Selecting similar colors</phrase> -</textobject> -<caption><para>Selecting similar colors</para></caption> -</mediaobject> -</screenshot> -</sect1> - -<sect1 id="selections-inverting"> -<title>Inverting the selection</title> -<para> -In some cases it is easier to specify your selection the other way around. That -is, first you select the parts that ultimately should not be selected and then -then you choose -<menuchoice><guimenu>Select</guimenu><guimenuitem>Invert</guimenuitem> -</menuchoice>. -What invert does, is that for every pixel it flips the selection level so to -speak, by setting it to 256 minus the current selection level. Thus what was -selected becomes unselected and vice versa. -</para> -</sect1> - -</chapter> diff --git a/doc/krita/using-views.docbook b/doc/krita/using-views.docbook deleted file mode 100644 index 6760209e..00000000 --- a/doc/krita/using-views.docbook +++ /dev/null @@ -1,167 +0,0 @@ -<chapter id="views"> -<title>Views</title> - -<para> -One of the most important things you need to know when working with a painting -or image editing application, is how to adapt the view of your image to your -(changing) needs. This chapter describes the various possibilities &krita; -offers. -</para> - -<sect1 id="views-zooming"> -<title>Zooming</title> - -<para> -By zooming, you can view your images at various levels of detail. Zooming out -will show a larger part of the image, but with less detail. &krita; offers a -couple of options that affect which part of the image is shown: -</para> - -<variablelist> - -<varlistentry><term>Zooming in</term> -<listitem><para>Zooming in allows you to see more details, but you will only -see a smaller part of the image. You can zoom in by choosing the -<menuchoice><guimenu>View</guimenu><guimenuitem>Zoom -in</guimenuitem></menuchoice> menu item, by clicking the -<inlinemediaobject><imageobject><imagedata -fileref="toolbars-button-zoomin.png" format="PNG"/> -</imageobject></inlinemediaobject> <guilabel>Zoom in</guilabel> button on the -toolbar, or by pressing the <keycombo -action="simul">&Ctrl;<keycap>+</keycap></keycombo> keys. -You can zoom in up to 1600% (a 16:1 ratio) via a number of fixed zoom levels. -</para></listitem> -</varlistentry> - -<varlistentry><term>Zooming out</term> -<listitem><para>Zooming out allows you to see a larger part of the image while -losing some detail. Zooming out can be done by choosing the -<menuchoice><guimenu>View</guimenu><guimenuitem>Zoom -out</guimenuitem></menuchoice> menu item, by clicking the -<inlinemediaobject><imageobject><imagedata -fileref="toolbars-button-zoomout.png" format="PNG"/> -</imageobject></inlinemediaobject> <guilabel>Zoom out</guilabel> button on the -toolbar, or by pressing the <keycombo -action="simul">&Ctrl;<keycap>-</keycap></keycombo> keys. -You can zoom out up to 0.2% (a 1:500 ratio) via a number of fixed zoom levels. -</para></listitem> -</varlistentry> - -<varlistentry><term>Going back to 100%</term> -<listitem><para>As viewing your image at its real size is quite handy at -times, you can do so via the -<menuchoice><guimenu>View</guimenu><guimenuitem>Actual -pixels</guimenuitem></menuchoice> menu item or by pressing <keycombo -action="simul">&Ctrl;<keycap>0</keycap></keycombo>. -</para></listitem> -</varlistentry> - -<varlistentry><term>Zooming in and out from the <guilabel>Overview</guilabel> -tab</term> -<listitem><para>The <guilabel>Overview</guilabel> tab of the control box -(usually found at the right hand side of the &krita; window) also allows you -to change the zoom level by using the slider or the spinbox. Slightly -different zoom levels are available here, so if zooming in or out as described -above does not produce a view you want, you can try using this option. The -<guibutton>1:1</guibutton> button offers another way of getting back to a 100% -zoom.</para></listitem> -</varlistentry> - -<varlistentry><term>Special zooms</term> -<listitem><para>There are two more special ways of zooming. The -<menuchoice><guimenu>View</guimenu><guimenuitem>Fit to -Page</guimenuitem></menuchoice> menu item zooms your image such that it is -as large as possible while remaining entirely visible. The -<menuchoice><guimenu>View</guimenu><guimenuitem>Full Screen -Mode</guimenuitem></menuchoice> menu item (pressing <keycombo -action="simul">&Ctrl;&Shift;<keycap>F</keycap></keycombo> will also activate -this mode) enlarges the &krita; window to fill your entire screen, removing -the title bar as well. Although this is not a <quote>real</quote> way of -zooming, it can help you by showing just that little bit more of your -image.</para></listitem> -</varlistentry> - -</variablelist> - -</sect1> - -<sect1 id="views-views"> -<title>Working with views</title> - -<para> -Apart from changing the zoom level of your view, you can also open different -views for the same image. This way, you can for example look at two different -parts of your image that would not fit on your screen together otherwise. -</para> - -<variablelist> - -<varlistentry><term>New view windows</term> -<listitem><para>You can open a new &krita; window for your image by choosing -<menuchoice><guimenu>View</guimenu><guimenuitem>New -View</guimenuitem></menuchoice> Both windows are independent from each other -(so you can select different tools, view different parts of your image, -&etc;), but changes you make to the image in one window are immediately -visible in the other. To close a window, use the normal window closing button. -There is also an option <menuchoice><guimenu>View</guimenu><guimenuitem>Close -All Views</guimenuitem></menuchoice>, which closes all newly created views and -leaves only the original window open.</para></listitem> -</varlistentry> - -<varlistentry><term>Splitting views</term> -<listitem><para>You can also split a window into two views. Like a new window, -one view of a split window has its own settings for brushes, zoom levels and -the like, but both views are shown in the same window. To split your window, -choose <menuchoice><guimenu>View</guimenu><guimenuitem>Split -View</guimenuitem></menuchoice>. The viewing area of the &krita; window will -then be divided into two halves. You can switch between horizontal and -vertical division with the -<menuchoice><guimenu>View</guimenu><guisubmenu>Splitter -Orientation</guisubmenu></menuchoice> menu, and get back to one view by -choosing <menuchoice><guimenu>View</guimenu><guimenuitem>Remove -View</guimenuitem></menuchoice>.</para></listitem> -</varlistentry> - -</variablelist> - -</sect1> - -<sect1 id="views-miscellaneous"> -<title>Miscellaneous view options</title> - -<para> -&krita; also offers two options that can help you with knowing where you are. -</para> - -<variablelist> - -<varlistentry><term>Rulers</term> -<listitem><para>You can have &krita; show rulers along the sides of your -image, indicating x and y coordinates. To do so, choose -<menuchoice><guimenu>View</guimenu><guimenuitem>Show -Rulers</guimenuitem></menuchoice> or press <keycombo -action="simul">&Ctrl;<keycap>R</keycap></keycombo>. The rulers will -automatically adapt to your zoom level to show a proper amount of -subdivisions. To remove the rulers, choose the same menu option (now called -<guimenuitem>Hide Rulers</guimenuitem>) or press <keycombo -action="simul">&Ctrl;<keycap>R</keycap></keycombo> again. </para></listitem> -</varlistentry> - -<varlistentry><term>Grid</term> -<listitem><para>In order to see grid lines, choose -<menuchoice><guimenu>View</guimenu><guimenuitem>Show -Grid</guimenuitem></menuchoice>. You can set the distance between grid lines -with <menuchoice><guimenu>View</guimenu><guisubmenu>Grid -Spacing</guisubmenu></menuchoice> and you can choose different colours for the -lines in the <menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure -&krita;...</guimenuitem></menuchoice> dialog (see <link -linkend="settings-preferences-grid">the Grid section of the Settings -chapter</link>). -</para></listitem> -</varlistentry> - -</variablelist> - -</sect1> - -</chapter> |
