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/kcoloredit/index.docbook | 468 +++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 468 insertions(+) create mode 100644 doc/kcoloredit/index.docbook (limited to 'doc/kcoloredit/index.docbook') diff --git a/doc/kcoloredit/index.docbook b/doc/kcoloredit/index.docbook new file mode 100644 index 00000000..8599cdf4 --- /dev/null +++ b/doc/kcoloredit/index.docbook @@ -0,0 +1,468 @@ + +KColorEdit"> + + + + +] +> + + + + The &kcoloredit; Handbook + + +Artur +Rataj + +
&Artur.Rataj.mail;
+ + + + + + + +2000 +&Artur.Rataj; + + +&FDLNotice; + +2005-12-10 +3.5.0 + + +&kcoloredit; is a palette files editor. It can be used for editing +color palettes and for color choosing and naming. + + + +KDE +graphics +palette + + + + +Introduction + +&kcoloredit; is a palette files editor. It can be used for +editing color palettes and for color choosing and naming. + + + + +File operations + + +About palette files + + +The palette files installed by &kde; can be either system-wide or the +user ones. The latter are in you private &kde; configuration +folders, and they are named Custom Colors and +Recent Colors. + + + +In &kcoloredit;, you may open all of these palettes, as well as +palettes in arbitrary files. + + + + + +Opening a file + +In the Open File dialog, you may choose from a +list of installed palettes, or browse folders for files. + + + + + + +Editing + + +Cursor + +The cursor is visible as a line in the palette view. It can be +moved by clicking on an area beside a color. + +The cursor has the following functions: + + + + +It points to the color after it. The color, if any, is described below +the palette view. You may edit its name there. + + + + +It can be used to make a selection. A selection can be made by +clicking on an area beside a color, so to move the cursor there, and +by moving the mouse then with the left mouse button pressed. + + + +If the At cursor check-box near the +Add Color button is checked, a color from the +color chooser is put at the cursor. The color is either inserted +or it overwrites another one, depending on whether the +Overwrite mode is chosen. The mode can be chosen +by checking the Overwrite check-box, that is next +to the At cursor one. + + + + + + +Selection + +A selection, that can be made as it was written in the previous +section, can be used with the copy, cut and paste operations. + + + + +Clipboard format + +&kcoloredit; uses the following format for clipboard data: for each +color three numbers for red, green and blue components, respectively, +and an optional color name, followed by a new line character if there +is another color. Therefore, if for example three numbers are in the +clipboard, they can be pasted by &kcoloredit; as a color. + + + + + + +Selecting a color from an RGB space + + +A color can be selected from an RGB space in &kcoloredit; in the +following ways: + + + +By editing the HSV or RGB components. + + + + +By selecting a color from color gradient panels. In the left one, two +from HSV components can be selected, and in the right one, the third +one. The third component can be chosen by clicking on one of the +buttons labeled H:, S: and +V:. The one component panel display colors with +the other two components equal to these selected in the two components +panel. The two components panel may display colors with the third +component fixed, or, if the Variable check-box is +set, with a value equal to the one selected in the one component +panel. In the Replace mode, the color selected in +panels replaces the output one instantly, and in the +Change: mode it modifies the output color after +each click, or a mouse move while a mouse button is +pressed. Therefore, in the latter mode the color selected in the +gradient panels may be different from the output color. To synchronize +the colors, the Synchronize button can be used. + + + + + + + + + + +Drag and drop + +The palette colors and the color selection output color can be dragged +with a mouse. + + + + +Menu Reference + + +The <guimenu>File</guimenu> Menu + + + + +&Ctrl; +N +File +New + + +Start a new palette in the current window. + + + + + +File +New Window + + +Open a new window + + + + + +&Ctrl; +O +File +Open + + +Open a saved palette. + + + + + +File +Open Recent + + +Reopen a palette that you have recently been +editing. + + + + + +&Ctrl; +S +File +Save + + +Save the currently open palette. + + + + + +File +Save As... + + +Save the currently open palette with a new +name. + + + + + +&Ctrl; +W +File +Close + + +Close the current &kcoloredit; window + + + + + +&Ctrl; +Q +File +Quit + + +Quit &kcoloredit;. + + + + + + + +The <guimenu>Edit</guimenu> Menu + + + + +&Ctrl; +X +Edit +Cut + + +Cut the currently selected color to the +clipboard. + + + + + +&Ctrl; +C +Edit +Copy + + +Copy the currently selected color to the +clipboard. + + + + + +&Ctrl; +V +Edit +Paste + + +Paste a color from the clipboard. + + + + + + + +The <guimenu>Color</guimenu> Menu + + + + +Color +From Palette + + +Find the color currently selected in the palette, in the +color selector on the left. + + + + + +Color +From Screen + + +Pick a color from anywhere on the screen, and find it +in the color selector on the left. + + + + + + + +The <guimenu>Settings</guimenu> Menu + + + + +Settings +Hide/Show Toolbar + + +Toggle on and off the toolbar icons. + + + + + +Settings +Hide/Show Statusbar + + +Toggle on and off the status bar. + + + + + +Settings +Hide/Show Color Names + + +If the currently open palette has color name, display +them alongside the colors. + + + + + +Settings +Configure Shortcuts... + + +Configure the keyboard keys you use to access the +different actions. + + + + + +Settings +Configure Toolbars... + + +Configure the items you want to put in the toolbar + + + + + + + + + +The <guimenu>Help</guimenu> Menu + +&help.menu.documentation; + + + + + + +Credits and Licenses + +&kcoloredit; copyright 2000 &Artur.Rataj; + +Documentation copyright 2000 &Artur.Rataj; + + + +&underFDL; +&underGPL; + + + +Installation + +&install.intro.documentation; + +&install.compile.documentation; + + + + + + -- cgit v1.2.1