From 47d455dd55be855e4cc691c32f687f723d9247ee Mon Sep 17 00:00:00 2001 From: toma Date: Wed, 25 Nov 2009 17:56:58 +0000 Subject: Copy the KDE 3.5 branch to branches/trinity for new KDE 3.5 features. BUG:215923 git-svn-id: svn://anonsvn.kde.org/home/kde/branches/trinity/kdegraphics@1054174 283d02a7-25f6-0310-bc7c-ecb5cbfe19da --- doc/kolourpaint/Makefile.am | 2 + doc/kolourpaint/brush_shapes.png | Bin 0 -> 475 bytes doc/kolourpaint/color_box.png | Bin 0 -> 2417 bytes doc/kolourpaint/eraser_shapes.png | Bin 0 -> 362 bytes doc/kolourpaint/fcc_std_text.png | Bin 0 -> 10072 bytes doc/kolourpaint/fcc_trans_text.png | Bin 0 -> 11702 bytes doc/kolourpaint/fill_color_similarity.png | Bin 0 -> 17540 bytes doc/kolourpaint/fill_style.png | Bin 0 -> 342 bytes doc/kolourpaint/image_balance.png | Bin 0 -> 35978 bytes doc/kolourpaint/image_emboss.png | Bin 0 -> 51537 bytes doc/kolourpaint/image_flatten.png | Bin 0 -> 25398 bytes doc/kolourpaint/image_flip.png | Bin 0 -> 10004 bytes doc/kolourpaint/image_invert.png | Bin 0 -> 27542 bytes doc/kolourpaint/image_reduce_colors.png | Bin 0 -> 25313 bytes doc/kolourpaint/image_resize_scale.png | Bin 0 -> 36298 bytes doc/kolourpaint/image_rotate.png | Bin 0 -> 32499 bytes doc/kolourpaint/image_skew.png | Bin 0 -> 25028 bytes doc/kolourpaint/image_soften_sharpen.png | Bin 0 -> 46238 bytes doc/kolourpaint/index.docbook | 1501 +++++++++++++++++++++ doc/kolourpaint/kolourpaint-main.png | Bin 0 -> 35385 bytes doc/kolourpaint/line_width.png | Bin 0 -> 307 bytes doc/kolourpaint/lines_30_45_deg.png | Bin 0 -> 1382 bytes doc/kolourpaint/lines_30_deg.png | Bin 0 -> 1062 bytes doc/kolourpaint/lines_45_deg.png | Bin 0 -> 853 bytes doc/kolourpaint/rotate_image_30.png | Bin 0 -> 2026 bytes doc/kolourpaint/rotate_selection_30.png | Bin 0 -> 2898 bytes doc/kolourpaint/selections_opaque_transparent.png | Bin 0 -> 1176 bytes doc/kolourpaint/spraycan_patterns.png | Bin 0 -> 829 bytes doc/kolourpaint/text_zoom_grid.png | Bin 0 -> 451 bytes doc/kolourpaint/tool_brush.png | Bin 0 -> 675 bytes doc/kolourpaint/tool_color_picker.png | Bin 0 -> 656 bytes doc/kolourpaint/tool_color_washer.png | Bin 0 -> 1010 bytes doc/kolourpaint/tool_curve.png | Bin 0 -> 483 bytes doc/kolourpaint/tool_ellipse.png | Bin 0 -> 837 bytes doc/kolourpaint/tool_elliptical_selection.png | Bin 0 -> 906 bytes doc/kolourpaint/tool_eraser.png | Bin 0 -> 806 bytes doc/kolourpaint/tool_flood_fill.png | Bin 0 -> 638 bytes doc/kolourpaint/tool_free_form_selection.png | Bin 0 -> 855 bytes doc/kolourpaint/tool_line.png | Bin 0 -> 439 bytes doc/kolourpaint/tool_pen.png | Bin 0 -> 579 bytes doc/kolourpaint/tool_polygon.png | Bin 0 -> 907 bytes doc/kolourpaint/tool_polyline.png | Bin 0 -> 543 bytes doc/kolourpaint/tool_polystar.png | Bin 0 -> 1365 bytes doc/kolourpaint/tool_rect_selection.png | Bin 0 -> 921 bytes doc/kolourpaint/tool_rectangle.png | Bin 0 -> 557 bytes doc/kolourpaint/tool_rectangles.png | Bin 0 -> 824 bytes doc/kolourpaint/tool_rounded_rectangle.png | Bin 0 -> 729 bytes doc/kolourpaint/tool_selections.png | Bin 0 -> 1831 bytes doc/kolourpaint/tool_spraycan.png | Bin 0 -> 784 bytes doc/kolourpaint/tool_text.png | Bin 0 -> 401 bytes doc/kolourpaint/view_thumbnails.png | Bin 0 -> 42197 bytes 51 files changed, 1503 insertions(+) create mode 100644 doc/kolourpaint/Makefile.am create mode 100644 doc/kolourpaint/brush_shapes.png create mode 100644 doc/kolourpaint/color_box.png create mode 100644 doc/kolourpaint/eraser_shapes.png create mode 100644 doc/kolourpaint/fcc_std_text.png create mode 100644 doc/kolourpaint/fcc_trans_text.png create mode 100644 doc/kolourpaint/fill_color_similarity.png create mode 100644 doc/kolourpaint/fill_style.png create mode 100644 doc/kolourpaint/image_balance.png create mode 100644 doc/kolourpaint/image_emboss.png create mode 100644 doc/kolourpaint/image_flatten.png create mode 100644 doc/kolourpaint/image_flip.png create mode 100644 doc/kolourpaint/image_invert.png create mode 100644 doc/kolourpaint/image_reduce_colors.png create mode 100644 doc/kolourpaint/image_resize_scale.png create mode 100644 doc/kolourpaint/image_rotate.png create mode 100644 doc/kolourpaint/image_skew.png create mode 100644 doc/kolourpaint/image_soften_sharpen.png create mode 100644 doc/kolourpaint/index.docbook create mode 100644 doc/kolourpaint/kolourpaint-main.png create mode 100644 doc/kolourpaint/line_width.png create mode 100644 doc/kolourpaint/lines_30_45_deg.png create mode 100644 doc/kolourpaint/lines_30_deg.png create mode 100644 doc/kolourpaint/lines_45_deg.png create mode 100644 doc/kolourpaint/rotate_image_30.png create mode 100644 doc/kolourpaint/rotate_selection_30.png create mode 100644 doc/kolourpaint/selections_opaque_transparent.png create mode 100644 doc/kolourpaint/spraycan_patterns.png create mode 100644 doc/kolourpaint/text_zoom_grid.png create mode 100644 doc/kolourpaint/tool_brush.png create mode 100644 doc/kolourpaint/tool_color_picker.png create mode 100644 doc/kolourpaint/tool_color_washer.png create mode 100644 doc/kolourpaint/tool_curve.png create mode 100644 doc/kolourpaint/tool_ellipse.png create mode 100644 doc/kolourpaint/tool_elliptical_selection.png create mode 100644 doc/kolourpaint/tool_eraser.png create mode 100644 doc/kolourpaint/tool_flood_fill.png create mode 100644 doc/kolourpaint/tool_free_form_selection.png create mode 100644 doc/kolourpaint/tool_line.png create mode 100644 doc/kolourpaint/tool_pen.png create mode 100644 doc/kolourpaint/tool_polygon.png create mode 100644 doc/kolourpaint/tool_polyline.png create mode 100644 doc/kolourpaint/tool_polystar.png create mode 100644 doc/kolourpaint/tool_rect_selection.png create mode 100644 doc/kolourpaint/tool_rectangle.png create mode 100644 doc/kolourpaint/tool_rectangles.png create mode 100644 doc/kolourpaint/tool_rounded_rectangle.png create mode 100644 doc/kolourpaint/tool_selections.png create mode 100644 doc/kolourpaint/tool_spraycan.png create mode 100644 doc/kolourpaint/tool_text.png create mode 100644 doc/kolourpaint/view_thumbnails.png (limited to 'doc/kolourpaint') diff --git a/doc/kolourpaint/Makefile.am b/doc/kolourpaint/Makefile.am new file mode 100644 index 00000000..171f575c --- /dev/null +++ b/doc/kolourpaint/Makefile.am @@ -0,0 +1,2 @@ +KDE_LANG = en +KDE_DOCS = AUTO diff --git a/doc/kolourpaint/brush_shapes.png b/doc/kolourpaint/brush_shapes.png new file mode 100644 index 00000000..ee02cc21 Binary files /dev/null and b/doc/kolourpaint/brush_shapes.png differ diff --git a/doc/kolourpaint/color_box.png b/doc/kolourpaint/color_box.png new file mode 100644 index 00000000..97d7b458 Binary files /dev/null and b/doc/kolourpaint/color_box.png differ diff --git a/doc/kolourpaint/eraser_shapes.png b/doc/kolourpaint/eraser_shapes.png new file mode 100644 index 00000000..43c1f788 Binary files /dev/null and b/doc/kolourpaint/eraser_shapes.png differ diff --git a/doc/kolourpaint/fcc_std_text.png b/doc/kolourpaint/fcc_std_text.png new file mode 100644 index 00000000..6d74b00f Binary files /dev/null and b/doc/kolourpaint/fcc_std_text.png differ diff --git a/doc/kolourpaint/fcc_trans_text.png b/doc/kolourpaint/fcc_trans_text.png new file mode 100644 index 00000000..c85f07d6 Binary files /dev/null and b/doc/kolourpaint/fcc_trans_text.png differ diff --git a/doc/kolourpaint/fill_color_similarity.png b/doc/kolourpaint/fill_color_similarity.png new file mode 100644 index 00000000..2fce4156 Binary files /dev/null and b/doc/kolourpaint/fill_color_similarity.png differ diff --git a/doc/kolourpaint/fill_style.png b/doc/kolourpaint/fill_style.png new file mode 100644 index 00000000..6ced3249 Binary files /dev/null and b/doc/kolourpaint/fill_style.png differ diff --git a/doc/kolourpaint/image_balance.png b/doc/kolourpaint/image_balance.png new file mode 100644 index 00000000..96eadb9c Binary files /dev/null and b/doc/kolourpaint/image_balance.png differ diff --git a/doc/kolourpaint/image_emboss.png b/doc/kolourpaint/image_emboss.png new file mode 100644 index 00000000..093b25e3 Binary files /dev/null and b/doc/kolourpaint/image_emboss.png differ diff --git a/doc/kolourpaint/image_flatten.png b/doc/kolourpaint/image_flatten.png new file mode 100644 index 00000000..8095c62e Binary files /dev/null and b/doc/kolourpaint/image_flatten.png differ diff --git a/doc/kolourpaint/image_flip.png b/doc/kolourpaint/image_flip.png new file mode 100644 index 00000000..0e87243d Binary files /dev/null and b/doc/kolourpaint/image_flip.png differ diff --git a/doc/kolourpaint/image_invert.png b/doc/kolourpaint/image_invert.png new file mode 100644 index 00000000..64be7174 Binary files /dev/null and b/doc/kolourpaint/image_invert.png differ diff --git a/doc/kolourpaint/image_reduce_colors.png b/doc/kolourpaint/image_reduce_colors.png new file mode 100644 index 00000000..a8cd5884 Binary files /dev/null and b/doc/kolourpaint/image_reduce_colors.png differ diff --git a/doc/kolourpaint/image_resize_scale.png b/doc/kolourpaint/image_resize_scale.png new file mode 100644 index 00000000..43014039 Binary files /dev/null and b/doc/kolourpaint/image_resize_scale.png differ diff --git a/doc/kolourpaint/image_rotate.png b/doc/kolourpaint/image_rotate.png new file mode 100644 index 00000000..0db94613 Binary files /dev/null and b/doc/kolourpaint/image_rotate.png differ diff --git a/doc/kolourpaint/image_skew.png b/doc/kolourpaint/image_skew.png new file mode 100644 index 00000000..81f2afb4 Binary files /dev/null and b/doc/kolourpaint/image_skew.png differ diff --git a/doc/kolourpaint/image_soften_sharpen.png b/doc/kolourpaint/image_soften_sharpen.png new file mode 100644 index 00000000..ba7d94d7 Binary files /dev/null and b/doc/kolourpaint/image_soften_sharpen.png differ diff --git a/doc/kolourpaint/index.docbook b/doc/kolourpaint/index.docbook new file mode 100644 index 00000000..c80f7011 --- /dev/null +++ b/doc/kolourpaint/index.docbook @@ -0,0 +1,1501 @@ + + + ClarenceDang"> + dang@kde.org"> + ThurstonDang"> + thurston_dang@users.sourceforge.net"> + + + +]> + + + + +The &kolourpaint; Handbook + + + + +Thurston +Dang + +thurston_dang@users.sourceforge.net + + + + +Clarence +Dang + + + + +&Lauri.Watts; + + + + + +2004 +2005 +Thurston Dang + + + +&FDLNotice; + +2005-12-29 +1.4_relight + + + +&kolourpaint; is a free, easy-to-use paint program for &kde;. + + + + +kolourpaint +kdegraphics + + + + + +Introduction +&kolourpaint; is a free, easy-to-use paint program for &kde;. It's +perfect for everyday tasks such as: + + + +Painting - drawing diagrams and finger painting + + +Image Manipulation - editing screenshots and photos; applying +effects + + +Icon Editing - drawing clipart and logos with transparency + + + + + +Using &kolourpaint; + +Click on the following links to explore &kolourpaint;'s +capabilities: + + + +Tools + + +Working with Color + + +View Options + + +Image Effects + + + + + +Tools + + +Tool Reference + + +A quick way to select a tool in &kolourpaint; is to press the single key shortcut associated with it, +documented below and in the Tool Box tooltips. You can also hold +&Alt;&Shift; while pressing the key, which is necessary when you are +writing text (as the single key shortcuts will be disabled). For example, to select the brush, press +&Alt;&Shift;B or just B (when not writing text). + + + + + + + +Brush (B) + + + + + + + + +Color Eraser (O) + + + + + + + + + +Color Picker (C) + + + + + + + + + + + + +Connected Lines (N) + + + + + + + + + + + +Curve (V) + + + + + + + + + + + + +Ellipse (E) + + + + + + + + + + + + +Eraser (A) + + + + + + + + + + + + +Flood Fill (F) + + + + + + + + + + + + +Line (L) + + + + + + + + + + + + +Pen (P) + + + + + + + + + + + + +Polygon (G) + + + + + + + + + + + + +Rectangle (R) + + + + + + + + + + + + +Rounded Rectangle (U) + + + + + + + + + + + + +Selection (Elliptical) (I) + + + + + + + + + + + + +Selection (Free-Form) (M) + + + + + + + + + + + + +Selection (Rectangular) (S) + + + + + + + + + + + + +Spraycan (Y) + + + + + + + + + + + + +Text (T) + + + + + + + +Brush +<inlinemediaobject> +<imageobject> +<imagedata fileref="tool_brush.png" format="PNG"/> +</imageobject> +</inlinemediaobject> + + +Click or click and drag with the brush to draw. + + + + + + + + + + + + + + + + +Click on one of the shapes to select the brush shape. You can use a +circular, square, slash or backslash brush shape. + + + + + + +The &LMB; draws in the foreground color. The &RMB; draws in the +background color. + + + +Color Picker <inlinemediaobject> +<imageobject> +<imagedata fileref="tool_color_picker.png" format="PNG"/> +</imageobject> +</inlinemediaobject> + + +To set the foreground color, left click on +a pixel. To set the background color, right click on a pixel. +&kolourpaint; will then return to the previously selected tool. + + + + +Connected Lines and Polygon +<inlinemediaobject> +<imageobject> +<imagedata fileref="tool_polystar.png" format="PNG"/> +</imageobject> +</inlinemediaobject> + + +Click and drag to draw connected lines. The polygon tool is used in +the same way, however, the start and end points are automatically connected +to form a polygon. + +The &LMB; draws in the foreground color. The &RMB; draws in the +background color, and will also reverse the fill color for polygons. + +You can set the line width. For +polygons, you can also set the fill +style. + + + + +Curve <inlinemediaobject> +<imageobject> +<imagedata fileref="tool_curve.png" format="PNG"/> +</imageobject> +</inlinemediaobject> + + +Click and drag to draw a line - this sets the start and end +points. You can set up to two control points by dragging. To finish the +curve without using both or any control points, click the other mouse +button. The curve tool draws a Cubic Bezier. + +The &LMB; draws in the foreground color. The &RMB; draws in the +background color. + +You can also set the line +width. + + + + +Ellipse <inlinemediaobject> +<imageobject> +<imagedata fileref="tool_ellipse.png" format="PNG"/> +</imageobject> +</inlinemediaobject> + + +Click and drag to draw an ellipse. + +The &LMB; draws in the foreground color. The &RMB; draws in the +background color, and will reverse the fill color. + +You can also set the line width and fill +style. + +For additional functionality, use the modifier keys: + + + +Hold &Shift; and drag to draw a circle. + + +To draw an ellipse with a center point of your choice, hold &Ctrl;, +click on the center point, and drag until the ellipse is the correct size +and shape. + + +To draw a circle with a center point of your choice, hold &Ctrl; and +&Shift;, click on the center point, and drag until the circle is the correct +size. + + + + + + +Erasers + + +Eraser +<inlinemediaobject> +<imageobject> +<imagedata fileref="tool_eraser.png" format="PNG"/> +</imageobject> +</inlinemediaobject> + + +Click and drag with the eraser to rub out mistakes. + + +Unlike other tools, the erasers draw in the background color. To draw +in the foreground color, use the &RMB;. + + +The eraser only has square +shapes. To draw with other shapes such as circles use the Brush and the &RMB;. + + +Double-click on the Eraser icon to clear the entire image. This is +equivalent to using the Clear option on +the Image menu. + + + + + +Color Eraser +<inlinemediaobject> +<imageobject> +<imagedata fileref="tool_color_washer.png" format="PNG"/> +</imageobject> +</inlinemediaobject> + + +Click and drag to replace pixels of the foreground color with the +background color. To replace all pixels similar (but not necessarily exactly +equal) to the foreground color, such as in dithered images and photos, use a +Color Similarity setting other than +Exact. + + +Unlike other tools, the erasers draw in the background color. To +replace pixels of the background color with the foreground color, use the +&RMB;. + + +You can configure the eraser +size. + + +Double-click on the Color Eraser icon to apply it to the entire image. + + + + + + +Flood Fill +<inlinemediaobject> +<imageobject> +<imagedata fileref="tool_flood_fill.png" format="PNG"/> +</imageobject> +</inlinemediaobject> + + +Click to fill a region. To fill a dithered region, use a Color Similarity setting other than Exact. + +The &LMB; fills in the foreground color. The &RMB; fills in the +background color. + + + + +Line +<inlinemediaobject> +<imageobject> +<imagedata fileref="tool_line.png" format="PNG"/> +</imageobject> +</inlinemediaobject> + + +Click and drag to draw a line. + +The &LMB; draws in the foreground color. The &RMB; draws in the +background color. + +You can also set the line +width. + + + + + + + + + + + + + + + + + + + + + +Hold &Ctrl; to draw lines angled at the nearest multiple of 30 degrees +- these are the lines in the red diagram. + + +Hold &Shift; to draw lines angled at the nearest multiple of 45 +degrees - these are the lines in the blue diagram. + + +Hold &Ctrl; and &Shift; to draw lines angled at the nearest multiple +of 30 or 45 degrees - these are the lines in the green diagram. + + + + + + +Pen +<inlinemediaobject> +<imageobject> +<imagedata fileref="tool_pen.png" format="PNG"/> +</imageobject> +</inlinemediaobject> + + +Click to draw a dot or click and drag to draw a freehand line. + +The &LMB; draws in the foreground color. The &RMB; draws in the +background color. + + + + +Rectangles +<inlinemediaobject> +<imageobject> +<imagedata fileref="tool_rectangles.png" format="PNG"/> +</imageobject> +</inlinemediaobject> + + +Click and drag to draw a rectangle. The Rounded Rectangle is a Rectangle with rounded +corners. + +The &LMB; draws in the foreground color. The &RMB; draws in the background color, +and will reverse the fill color. + +You can also set the line width and fill +style. + + For additional functionality, use the modifier keys: + + + +Hold &Shift; and drag to draw a square. + + +To draw a rectangle with a center point of your choice, hold &Ctrl;, +click on the center point, and drag until the rectangle is the correct size +and shape. + + +To draw a square with a center point of your choice, hold &Ctrl; and &Shift;, +click on the center point, and drag until the square is the correct size. + + + + + + +Selections +<inlinemediaobject> +<imageobject> +<imagedata fileref="tool_selections.png" format="PNG"/> +</imageobject> +</inlinemediaobject> + + +Use the selection tools to draw out the boundary of a +selection. + +To move the selection, click and drag on it. The main view will scroll as required to allow you to move the selection to part of the image that is not currently displayed. + + +You can free-form Resize the entire image or +Smooth Scale the selection using the corresponding handles. +Hold &Shift; while free-form scaling the selection to maintain aspect ratio. +The &RMB; invokes a context menu with common Edit commands and Image Effects. + + + +You can use the cursor keys while drawing out the boundary of the +selection or while moving it. + + + +If you hold &Ctrl; before moving the selection, then you will move a +copy of it. The selection will be smeared when moving it while &Shift; is held. + + + + + + + + + + + + + + +There are two selection modes: Opaque (default) and Transparent. If +you use the Transparent selection mode, all pixels of the background color +will be transparent (background subtraction). This allows you to paste a +selection without the background. To perform background subtraction on a +dithered image, use a Color Similarity +setting other than Exact. + + + + + + +You can apply Image Effects to a selection - see the Image Effects section for more +information. + + + +Spraycan +<inlinemediaobject> +<imageobject> +<imagedata fileref="tool_spraycan.png" format="PNG"/> +</imageobject> +</inlinemediaobject> + + +Click and drag to spray graffiti. Hold down the mouse button for a +more concentrated spray. + + + + + + + + + + + + + +Click on one of the shapes to select the spray size. You can select +from spray sizes of 9x9, 17x17 and 29x29. + + + + + + +The &LMB; draws in the foreground color. The &RMB; draws in the +background color. + + + + +Text +<inlinemediaobject> +<imageobject> +<imagedata fileref="tool_text.png" format="PNG"/> +</imageobject> +</inlinemediaobject> + + + +Click and drag an area in which to write text. Click and drag +on the border to move it. You can resize the text box by dragging on the +handles or by using the Resize dialog. + + + +If you have deselected a text box you can use Undo to edit the text +again. + + + +Using the Transparent Color + + + + + + + + +The left picture shows the example image. The right picture shows the addition of text +with opaque foreground and background colors. + + + + + + + + + + +The left picture shows the addition of text with opaque foreground +colors and a transparent background color. The right picture shows the +addition of text with a transparent foreground color and opaque background +color. + + + + +Common Tool Options + + + + + + + + + + + + + +Click on one of the squares to select the eraser size. You can select +from squares of side length 2, 3, 5, 9, 17 and 29 pixels. + +The eraser size setting affects the Erasers. + + + + + + + + + + + +Click on one of the lines to select the line width. You can select +from line widths of 1, 2, 3, 5 and 8 pixel(s). + +The line width setting affects the Connected Lines, Curve, Ellipse, Line, Polygon, Rectangle and Rounded Rectangle tools. + + + + + + + + + + + +Click on one of the rectangles to select the fill style. You can +select from No Fill, Fill with Background Color and Fill with Foreground +Color. The fill style setting affects the Ellipse, Polygon, Rectangle and Rounded Rectangle tools. + + + + + + + + + + + +Working with Color + + +The Color Box + + + + + + + +Color Box + + + + +The Color Box has 3 main sections: the Color Tablet, the Color Palette +and the Color Similarity Selector. + +The Color Tablet shows the current foreground color as a square on top +of another square representing the current background color. When drawing +with the &LMB;, the foreground color is used, and when drawing with the +&RMB; the background color is used (except for the Erasers). You can click on the double-ended +arrow to swap the foreground and background colors. + +The Color Palette shows a selection of colors for you to choose +from. The translucent pyramid represents the transparent color. Left-click +on a color to set the foreground color and right-click on a color to set the +background color. You can also drag and drop any opaque color into the Color +Tablet squares. To edit a color in the Color Tablet or Palette, double-click +on it. The Color Picker tool allows +you to select a color from the image. + +Color Similarity allows you to work more effectively with dithered +images and photos, in a comparable manner to the Magic Wand feature of other paint programs. It applies to transparent selections, as well as the +Flood Fill, Color Eraser and Autocrop / Remove Internal Border tools. Double-click on the Color +Similarity Selector to choose how similar colors must be to be considered +identical. When using selections in Transparent mode, any color in the +selection that is similar to the background color will also be made +transparent. + + + + + + + + + + +The left picture shows the example image. The right pictures demonstrate the use of a flood fill, with Color Similarity settings of 5%, 15% and 30%. In this example, with a Color Similarity setting of Exact, a flood fill at (80, 100) would only fill one pixel, as the surrounding pixels are similar but not identical. As Color Similarity is increased, more pixels that are similar in color are considered identical, hence the fill extends further. + + + + + + +View Options + + +View Options Reference + +Zoom incorporating the Grid +Thumbnail + + + + +Zoom incorporating the Grid +Increase the zoom level to edit images with more precision, or reduce it to see more of the image. + + + +At zoom levels that aren't multiples of 100%, parts of the image may appear to move when the user interacts with it. Other minor redraw glitches may also occur at such zoom levels. + + + +At zoom levels of 600% or greater that are also multiples of 100%, you can Show Grid to more accurately edit individual pixels. + + + + + + + + + + + + + + + +The first picture shows the Text tool icon, while the latter shows it at 600% zoom with the grid on. + + + +Another way of zooming when not drawing is to scroll the wheel while holding &Ctrl;. + + + + + + +Thumbnail + + + + + + + + +If Zoomed Thumbnail Mode is selected, the entire image is displayed, scaled as required to fit the thumbnail window (top-right picture). + + +Otherwise, the thumbnail displays as much of the image as possible, starting from the top-left of the main view (bottom-right picture). + + + + + + +Image Effects + + +Image Effects Reference +Autocrop / Remove Internal Border +Balance +Clear +Emboss +Flatten +Flip +Invert +Reduce Colors +Reduce to Grayscale +Reduce to Monochrome (Dithered) +Resize / Scale +Rotate +Set as Image (Crop) +Skew +Soften & Sharpen +More Effects +Notes + + + +Autocrop / Remove Internal Border + +This automatically removes the border of an image or selection. Use +Autocrop if you have a figure that does not fill the entire image or selection and you +wish to remove the excess whitespace. To use this feature with a dithered +image border, you will also need to use Color +Similarity. + + + + +Balance + + +This feature is accessible from the More Effects dialog. + + + + + + + + + +This allows you to set the brightness, contrast and gamma of the image or selection. + + + + +The more common measure of gamma (a decimal from 0.10 to 10.00) is located between the +Gamma spinbox and the Reset button. + + + + + +Clear + +This fills the entire image or selection with the background +color. + + +Double-click on the Eraser +icon to clear the entire image. + + + + + +Emboss + + +This feature is accessible from the More Effects dialog. + + + + + + + + + + +Check Enable to apply the Emboss effect. This emphasises the edges and gives the +image or selection an "engraved look". + + + + +Flatten + + +This feature is accessible from the More Effects dialog. + + + + + + + + + + +This recolors the image with varying shades of the two selected colors. + + + + +Flip + + + + + + + + + +This flips the entire image or selection horizontally or +vertically. + + + + +Invert + + +This feature is accessible from the More Effects dialog. + + + + + + + + + +This allows you to invert one or more RGB channels in the image or selection. Select All to change a photo into a negative and vice versa. This generally looks quite funny. + + +To quickly invert all channels, you do not need to use this dialog. You can instead +access the Invert Colors item in the Image or +Selection menu. + + + + + + +Reduce Colors + + +This feature is accessible from the More Effects dialog. + + + + + + + + + + +This reduces the number of colors used by the image or selection, with or without dithering. + + + +Dithering generally provides better quality results, however, you may wish to disable it for artistic effects; +e.g. using Monochrome instead of +Monochrome (Dithered) gives a silhouette effect. + + + +Another important distinction is that while Monochrome (Dithered) will always reduce the entire image or selection to black and white, Monochrome will do this only if the image or selection contains more than 2 colors. + + + +For a quick, dithered monochrome image or selection, use the Reduce to Monochrome (Dithered) item of the Image or Selection menu. + + + + + +Changing the number of colors here has no effect on the color depth of the file format. If you want to +change the color depth, you should select it in the file saving dialogs. Note that, confusingly, changing +the color depth also changes the number of colors. + + + + + +Reduce to Grayscale + + This reduces the entire image or selection to grayscale. + + + + +Reduce to Monochrome (Dithered) + +This reduces the entire image or selection to black and white. + + + +If you do not want the image or selection to be dithered, use the +Reduce Colors dialog. + + + + + +Resize / Scale + + + + + + + + + +Resizing the image changes the dimensions of the image without +applying a transformation to the existing contents. Scaling the image will +stretch the existing contents to the new dimensions. Smooth Scale +generally provides better quality results than Scaling, by blending neighbouring colors. + +You can express the new dimensions in pixels, or as a percentage of +the original size. If you select Keep aspect ratio, the +width and height will be scaled by the same percentage. + + + +You can free-form Resize the entire image or Smooth Scale the selection using the corresponding handles. + + + + +Only scaling is supported for selections, and only resizing is +supported for text boxes. See Notes for +additional details about applying these effects. + + + + +Rotate + + + + + + + + + +This rotates the image. You can specify the angle and direction of +rotation. + + +You can reverse the direction of rotation by specifying a negative +custom angle. + + + +See Notes for details about +applying this effect to a selection. + + + + + +Set as Image (Crop) + +This will set the selection as the image. + + +This is only available when you have an active selection. + + + + +Skew + + + + + + + + + +This skews the entire image or selection horizontally and/or +vertically. + + +See Notes for details about +applying this effect to a selection. + + + + +Soften & Sharpen + + +This feature is accessible from the More Effects dialog. + + + + + + + + + + +Use this effect to soften or sharpen the image. + + + + + +More Effects + + +This dialog contains the Balance, +Emboss, Flatten, +Invert, Reduce Colors +and Soften & Sharpen features. + + + + +Notes + +Resizing / Scaling, Rotating and Skewing may change the dimensions of the +image. You can view the new dimensions in the dialog. + +If you apply these effects to an image, the image will be resized if +necessary. However, if you apply these effects to a selection, the image +will not be resized, even if the transformed selection does not fit. + + + + + + + + + + +The left image has been rotated 30 degrees clockwise to form the right image. &kolourpaint; has +automatically enlarged the image to accommodate the larger contents. + + + + + + + + + + + +The left selection has been rotated 30 degrees clockwise to form the right +selection. The image size has remained the same, hence parts of the selection will not be visible +without Resizing the image. + + + + + + +Credits and License + +Carl Tucker + +It might not be concise documentation; it might not be complete documentation; but it is +honest documentation. + + + + +&kolourpaint; + +Program Copyright © 2003, 2004, 2005 &Clarence.Dang; &Clarence.Dang.mail; + + +&kolourpaint;-specific icons Copyright © 2004, 2005 +Kristof Borrey borrey@kde.org, +Nuno Pinheiro nf.pinheiro@gmail.com, +Danny Allen dannya40uk@yahoo.co.uk + + +Documentation and additional documentation artwork Copyright © 2004, 2005 +&Thurston.Dang; &Thurston.Dang.mail; + +Portions reproduced with permission from . + +&underFDL; + +This program is licensed as follows: + +Copyright © 2003, 2004, 2005 &Clarence.Dang; &Clarence.Dang.mail; + + +All rights reserved. + + +Redistribution and use in source and binary forms, with or without +modification, are permitted provided that the following conditions +are met: + +1. Redistributions of source code must retain the above copyright + notice, this list of conditions and the following disclaimer. + +2. Redistributions in binary form must reproduce the above copyright + notice, this list of conditions and the following disclaimer in the + documentation and/or other materials provided with the distribution. + + +THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR +IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES +OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. +IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, +INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT +NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, +DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY +THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF +THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + + + + +Installation + +How to obtain &kolourpaint; + +&install.intro.documentation; + +More frequent releases with support for previous versions of &kde; are +available at http://kolourpaint.sourceforge.net/. + + + + +Requirements + + &kolourpaint; 1.4_relight requires &kde; 3.5. + + + +Compilation and Installation + + + +If you are reading this help in the &khelpcenter;, then &kolourpaint; has already been +installed on this system and you do not need to follow these generic instructions. + + + +&install.compile.documentation; + + + + +Configuration + +&kolourpaint; should run without any additional configuration. + + + + +&documentation.index; + + + diff --git a/doc/kolourpaint/kolourpaint-main.png b/doc/kolourpaint/kolourpaint-main.png new file mode 100644 index 00000000..abab73d8 Binary files /dev/null and b/doc/kolourpaint/kolourpaint-main.png differ diff --git a/doc/kolourpaint/line_width.png b/doc/kolourpaint/line_width.png new file mode 100644 index 00000000..0477b6e1 Binary files /dev/null and b/doc/kolourpaint/line_width.png differ diff --git a/doc/kolourpaint/lines_30_45_deg.png b/doc/kolourpaint/lines_30_45_deg.png new file mode 100644 index 00000000..315499e5 Binary files /dev/null and b/doc/kolourpaint/lines_30_45_deg.png differ diff --git a/doc/kolourpaint/lines_30_deg.png b/doc/kolourpaint/lines_30_deg.png new file mode 100644 index 00000000..9519df52 Binary files /dev/null and b/doc/kolourpaint/lines_30_deg.png differ diff --git a/doc/kolourpaint/lines_45_deg.png b/doc/kolourpaint/lines_45_deg.png new file mode 100644 index 00000000..870cd464 Binary files /dev/null and b/doc/kolourpaint/lines_45_deg.png differ diff --git a/doc/kolourpaint/rotate_image_30.png b/doc/kolourpaint/rotate_image_30.png new file mode 100644 index 00000000..ebf00431 Binary files /dev/null and b/doc/kolourpaint/rotate_image_30.png differ diff --git a/doc/kolourpaint/rotate_selection_30.png b/doc/kolourpaint/rotate_selection_30.png new file mode 100644 index 00000000..23567ef8 Binary files /dev/null and b/doc/kolourpaint/rotate_selection_30.png differ diff --git a/doc/kolourpaint/selections_opaque_transparent.png b/doc/kolourpaint/selections_opaque_transparent.png new file mode 100644 index 00000000..627e5fee Binary files /dev/null and b/doc/kolourpaint/selections_opaque_transparent.png differ diff --git a/doc/kolourpaint/spraycan_patterns.png b/doc/kolourpaint/spraycan_patterns.png new file mode 100644 index 00000000..6505311a Binary files /dev/null and b/doc/kolourpaint/spraycan_patterns.png differ diff --git a/doc/kolourpaint/text_zoom_grid.png b/doc/kolourpaint/text_zoom_grid.png new file mode 100644 index 00000000..4fa85435 Binary files /dev/null and b/doc/kolourpaint/text_zoom_grid.png differ diff --git a/doc/kolourpaint/tool_brush.png b/doc/kolourpaint/tool_brush.png new file mode 100644 index 00000000..32a23881 Binary files /dev/null and b/doc/kolourpaint/tool_brush.png differ diff --git a/doc/kolourpaint/tool_color_picker.png b/doc/kolourpaint/tool_color_picker.png new file mode 100644 index 00000000..569171e6 Binary files /dev/null and b/doc/kolourpaint/tool_color_picker.png differ diff --git a/doc/kolourpaint/tool_color_washer.png b/doc/kolourpaint/tool_color_washer.png new file mode 100644 index 00000000..97193458 Binary files /dev/null and b/doc/kolourpaint/tool_color_washer.png differ diff --git a/doc/kolourpaint/tool_curve.png b/doc/kolourpaint/tool_curve.png new file mode 100644 index 00000000..b86c96fb Binary files /dev/null and b/doc/kolourpaint/tool_curve.png differ diff --git a/doc/kolourpaint/tool_ellipse.png b/doc/kolourpaint/tool_ellipse.png new file mode 100644 index 00000000..608d40b7 Binary files /dev/null and b/doc/kolourpaint/tool_ellipse.png differ diff --git a/doc/kolourpaint/tool_elliptical_selection.png b/doc/kolourpaint/tool_elliptical_selection.png new file mode 100644 index 00000000..70edc438 Binary files /dev/null and b/doc/kolourpaint/tool_elliptical_selection.png differ diff --git a/doc/kolourpaint/tool_eraser.png b/doc/kolourpaint/tool_eraser.png new file mode 100644 index 00000000..459d28a2 Binary files /dev/null and b/doc/kolourpaint/tool_eraser.png differ diff --git a/doc/kolourpaint/tool_flood_fill.png b/doc/kolourpaint/tool_flood_fill.png new file mode 100644 index 00000000..746ede5b Binary files /dev/null and b/doc/kolourpaint/tool_flood_fill.png differ diff --git a/doc/kolourpaint/tool_free_form_selection.png b/doc/kolourpaint/tool_free_form_selection.png new file mode 100644 index 00000000..ed03ba39 Binary files /dev/null and b/doc/kolourpaint/tool_free_form_selection.png differ diff --git a/doc/kolourpaint/tool_line.png b/doc/kolourpaint/tool_line.png new file mode 100644 index 00000000..ce282923 Binary files /dev/null and b/doc/kolourpaint/tool_line.png differ diff --git a/doc/kolourpaint/tool_pen.png b/doc/kolourpaint/tool_pen.png new file mode 100644 index 00000000..ae64f5aa Binary files /dev/null and b/doc/kolourpaint/tool_pen.png differ diff --git a/doc/kolourpaint/tool_polygon.png b/doc/kolourpaint/tool_polygon.png new file mode 100644 index 00000000..a5500d94 Binary files /dev/null and b/doc/kolourpaint/tool_polygon.png differ diff --git a/doc/kolourpaint/tool_polyline.png b/doc/kolourpaint/tool_polyline.png new file mode 100644 index 00000000..1e23ccd9 Binary files /dev/null and b/doc/kolourpaint/tool_polyline.png differ diff --git a/doc/kolourpaint/tool_polystar.png b/doc/kolourpaint/tool_polystar.png new file mode 100644 index 00000000..8eadbcad Binary files /dev/null and b/doc/kolourpaint/tool_polystar.png differ diff --git a/doc/kolourpaint/tool_rect_selection.png b/doc/kolourpaint/tool_rect_selection.png new file mode 100644 index 00000000..a85ef3f8 Binary files /dev/null and b/doc/kolourpaint/tool_rect_selection.png differ diff --git a/doc/kolourpaint/tool_rectangle.png b/doc/kolourpaint/tool_rectangle.png new file mode 100644 index 00000000..a8455de0 Binary files /dev/null and b/doc/kolourpaint/tool_rectangle.png differ diff --git a/doc/kolourpaint/tool_rectangles.png b/doc/kolourpaint/tool_rectangles.png new file mode 100644 index 00000000..851faf71 Binary files /dev/null and b/doc/kolourpaint/tool_rectangles.png differ diff --git a/doc/kolourpaint/tool_rounded_rectangle.png b/doc/kolourpaint/tool_rounded_rectangle.png new file mode 100644 index 00000000..4b5a0617 Binary files /dev/null and b/doc/kolourpaint/tool_rounded_rectangle.png differ diff --git a/doc/kolourpaint/tool_selections.png b/doc/kolourpaint/tool_selections.png new file mode 100644 index 00000000..1b0d09bf Binary files /dev/null and b/doc/kolourpaint/tool_selections.png differ diff --git a/doc/kolourpaint/tool_spraycan.png b/doc/kolourpaint/tool_spraycan.png new file mode 100644 index 00000000..75b7f748 Binary files /dev/null and b/doc/kolourpaint/tool_spraycan.png differ diff --git a/doc/kolourpaint/tool_text.png b/doc/kolourpaint/tool_text.png new file mode 100644 index 00000000..ffaab637 Binary files /dev/null and b/doc/kolourpaint/tool_text.png differ diff --git a/doc/kolourpaint/view_thumbnails.png b/doc/kolourpaint/view_thumbnails.png new file mode 100644 index 00000000..069a0888 Binary files /dev/null and b/doc/kolourpaint/view_thumbnails.png differ -- cgit v1.2.3