Warning, /graphics/kxstitch/doc/commands.docbook is written in an unsupported language. File is not indexed.

0001 <chapter id="commands" >
0002     <title>Command Reference</title>
0003 
0004     <sect1 id="kxstitch-menus" >
0005         <title>&kxstitch; Menus</title>
0006         <sect2>
0007             <title>The File Menu</title>
0008             <para>
0009                 <variablelist>
0010                     <varlistentry>
0011                         <term><menuchoice><shortcut><keycombo action="simul">&Ctrl;<keycap>N</keycap></keycombo></shortcut><guimenuitem>New</guimenuitem></menuchoice></term>
0012                         <listitem><simpara><action>Creates a new pattern, using the default values set in the pattern properties dialog.</action></simpara></listitem>
0013                     </varlistentry>
0014                     <varlistentry>
0015                         <term><menuchoice><shortcut><keycombo action="simul">&Ctrl;<keycap>O</keycap></keycombo></shortcut><guimenuitem>Open</guimenuitem></menuchoice></term>
0016                         <listitem><simpara><action>Opens an existing pattern</action></simpara></listitem>
0017                     </varlistentry>
0018                     <varlistentry>
0019                         <term><menuchoice><guimenuitem>Open Recent</guimenuitem></menuchoice></term>
0020                         <listitem><simpara><action>Open a recently used pattern</action></simpara></listitem>
0021                     </varlistentry>
0022                     <varlistentry>
0023                         <term><menuchoice><shortcut><keycombo action="simul">&Ctrl;<keycap>S</keycap></keycombo></shortcut><guimenuitem>Save</guimenuitem></menuchoice></term>
0024                         <listitem><simpara><action>Saves the pattern</action></simpara></listitem>
0025                     </varlistentry>
0026                     <varlistentry>
0027                         <term><menuchoice><shortcut><keycombo action="simul">&Ctrl;&Shift;<keycap>S</keycap></keycombo></shortcut><guimenuitem>Save As</guimenuitem></menuchoice></term>
0028                         <listitem><simpara><action>Saves the pattern under a new name</action></simpara></listitem>
0029                     </varlistentry>
0030                     <varlistentry>
0031                         <term><menuchoice><guimenuitem>Revert</guimenuitem></menuchoice></term>
0032                         <listitem><simpara><action>Revert the pattern to the last saved state</action></simpara></listitem>
0033                     </varlistentry>
0034                     <varlistentry>
0035                         <term><menuchoice><shortcut><keycombo action="simul">&Ctrl;<keycap>P</keycap></keycombo></shortcut><guimenuitem>Print</guimenuitem></menuchoice></term>
0036                         <listitem><simpara><action>Print the pattern</action></simpara></listitem>
0037                     </varlistentry>
0038                     <varlistentry>
0039                         <term><menuchoice><guimenuitem>Print Setup</guimenuitem></menuchoice></term>
0040                         <listitem><simpara><action>Set up the printing layout</action></simpara></listitem>
0041                     </varlistentry>
0042                     <varlistentry>
0043                         <term><menuchoice><guimenuitem>Import Image</guimenuitem></menuchoice></term>
0044                         <listitem><simpara><action>Import an image file converting it to stitches</action></simpara></listitem>
0045                     </varlistentry>
0046                     <varlistentry>
0047                         <term><menuchoice><guimenuitem>File Properties</guimenuitem></menuchoice></term>
0048                         <listitem><simpara><action>Display / Edit the document properties</action></simpara></listitem>
0049                     </varlistentry>
0050                     <varlistentry>
0051                         <term><menuchoice><guimenuitem>Add Background Image</guimenuitem></menuchoice></term>
0052                         <listitem><simpara><action>Insert an image as a background for tracing.</action></simpara></listitem>
0053                     </varlistentry>
0054                     <varlistentry>
0055                         <term><menuchoice><guimenuitem>Remove Background Image</guimenuitem></menuchoice></term>
0056                         <listitem><simpara><action>Select a background image to remove.  The sub menu for this is populated from the background images previously inserted.</action></simpara></listitem>
0057                     </varlistentry>
0058                     <varlistentry>
0059                         <term><menuchoice><shortcut><keycombo action="simul">&Ctrl;<keycap>W</keycap></keycombo></shortcut><guimenuitem>Close</guimenuitem></menuchoice></term>
0060                         <listitem><simpara><action>Close the pattern</action></simpara></listitem>
0061                     </varlistentry>
0062                     <varlistentry>
0063                         <term><menuchoice><shortcut><keycombo action="simul">&Ctrl;<keycap>Q</keycap></keycombo></shortcut><guimenuitem>Quit</guimenuitem></menuchoice></term>
0064                         <listitem><simpara><action>Quits</action> &kxstitch;</simpara></listitem>
0065                     </varlistentry>
0066                 </variablelist>
0067             </para>
0068         </sect2>
0069 
0070         <sect2>
0071             <title>The Edit Menu</title>
0072             <para>
0073                 <variablelist>
0074                     <varlistentry>
0075                         <term><menuchoice><shortcut><keycombo action="simul">&Ctrl;<keycap>Z</keycap></keycombo></shortcut><guimenuitem>Undo</guimenuitem></menuchoice></term>
0076                         <listitem><simpara><action>Undo the last change. The list of changes are shown in the History window.</action></simpara></listitem>
0077                     </varlistentry>
0078                     <varlistentry>
0079                         <term><menuchoice><shortcut><keycombo action="simul">&Ctrl;&Shift;<keycap>Z</keycap></keycombo></shortcut><guimenuitem>Redo</guimenuitem></menuchoice></term>
0080                         <listitem><simpara><action>Redo the last change undone. The list of changes are shown in the History window.</action></simpara></listitem>
0081                     </varlistentry>
0082                     <varlistentry>
0083                         <term><menuchoice><shortcut><keycombo action="simul">&Ctrl;<keycap>X</keycap></keycombo></shortcut><guimenuitem>Cut</guimenuitem></menuchoice></term>
0084                         <listitem><simpara><action>Cut the selected area to the clipboard</action></simpara></listitem>
0085                     </varlistentry>
0086                     <varlistentry>
0087                         <term><menuchoice><shortcut><keycombo action="simul">&Ctrl;<keycap>C</keycap></keycombo></shortcut><guimenuitem>Copy</guimenuitem></menuchoice></term>
0088                         <listitem><simpara><action>Copy the selected area to the clipboard</action></simpara></listitem>
0089                     </varlistentry>
0090                     <varlistentry>
0091                         <term><menuchoice><shortcut><keycombo action="simul">&Ctrl;<keycap>V</keycap></keycombo></shortcut><guimenuitem>Paste</guimenuitem></menuchoice></term>
0092                         <listitem><simpara><action>Paste the selected area</action></simpara></listitem>
0093                     </varlistentry>
0094                     <varlistentry>
0095                       <term><menuchoice><guisubmenu>Selection Masks</guisubmenu><guimenuitem>Stitch Mask</guimenuitem></menuchoice></term>
0096                         <listitem><simpara><action>Limit selections to the currently selected stitch type</action></simpara></listitem>
0097                     </varlistentry>
0098                     <varlistentry>
0099                         <term><menuchoice><guisubmenu>Selection Masks</guisubmenu><guimenuitem>Color Mask</guimenuitem></menuchoice></term>
0100                         <listitem><simpara><action>Limit selections to the currently selected color</action></simpara></listitem></varlistentry>
0101                     <varlistentry>
0102                         <term><menuchoice><guisubmenu>Selection Masks</guisubmenu><guimenuitem>Exclude Backstitches</guimenuitem></menuchoice></term>
0103                         <listitem><simpara><action>Exclude backstitches from the selection</action></simpara></listitem>
0104                     </varlistentry>
0105                     <varlistentry>
0106                         <term><menuchoice><guisubmenu>Selection Masks</guisubmenu><guimenuitem>Exclude Knots</guimenuitem></menuchoice></term>
0107                         <listitem><simpara><action>Exclude Knots from the selection</action></simpara></listitem>
0108                     </varlistentry>
0109                     <varlistentry>
0110                         <term><menuchoice><guimenuitem>Mirror / Rotate makes copies</guimenuitem></menuchoice></term>
0111                         <listitem><simpara><action>If set, the mirror and rotate functions will make a copy of the selection, otherwise the selected area is moved</action></simpara></listitem>
0112                     </varlistentry>
0113                     <varlistentry>
0114                         <term><menuchoice><guisubmenu>Mirror Selection</guisubmenu><guimenuitem>Horizontally</guimenuitem></menuchoice></term>
0115                         <listitem><simpara><action>Mirror the selected area horizontally, &ie; flipped from left to right</action></simpara></listitem>
0116                     </varlistentry>
0117                     <varlistentry>
0118                         <term><menuchoice><guisubmenu>Mirror Selection</guisubmenu><guimenuitem>Vertically</guimenuitem></menuchoice></term>
0119                         <listitem><simpara><action>Mirrors the selected area vertically, &ie; flipped from top to bottom</action></simpara></listitem>
0120                     </varlistentry>
0121                     <varlistentry>
0122                         <term><menuchoice><guisubmenu>Rotate Selection</guisubmenu><guimenuitem>90 degrees</guimenuitem></menuchoice></term>
0123                         <listitem><simpara><action>Rotate the selected area anti clockwise 90 degrees</action></simpara></listitem>
0124                     </varlistentry>
0125                     <varlistentry>
0126                         <term><menuchoice><guisubmenu>Rotate Selection</guisubmenu><guimenuitem>180 degrees</guimenuitem></menuchoice></term>
0127                         <listitem><simpara><action>Rotate the selected area anti clockwise 180 degrees</action></simpara></listitem>
0128                     </varlistentry>
0129                     <varlistentry>
0130                         <term><menuchoice><guisubmenu>Rotate Selection</guisubmenu><guimenuitem>270 degrees</guimenuitem></menuchoice></term>
0131                         <listitem><simpara><action>Rotate the selected area anti clockwise 270 degrees</action></simpara></listitem>
0132                     </varlistentry>
0133                 </variablelist>
0134             </para>
0135             <sect3>
0136                 <title>Cut, Copy and Paste</title>
0137                 <para>
0138                     Cutting and copying areas of the pattern can make use of stitch and color masks and the exclusion of backstitches and knots
0139                     to limit the selection.
0140                 </para>
0141                 <para>
0142                     The paste operation in &kxstitch; allows you to press and hold the &LMB; down roughly in the position that
0143                     the paste data is to go which will provide an image of the paste data to allow accurate positioning before
0144                     releasing the mouse button to finalize the position.  This technique is also used for the mirroring and
0145                     rotate functions. The cursor keys can also be used to move the pasted pattern around and the &Enter; key
0146                     used to fix the position.
0147                 </para>
0148             </sect3>
0149         </sect2>
0150 
0151         <sect2>
0152             <title>The View Menu</title>
0153             <para>
0154                 <variablelist>
0155                     <varlistentry>
0156                         <term><menuchoice><guimenuitem>Actual Size</guimenuitem></menuchoice></term>
0157                         <listitem><simpara><action>Zoom the view so that the screen size approximates the physical size</action></simpara></listitem>
0158                     </varlistentry>
0159                     <varlistentry>
0160                         <term><menuchoice><guimenuitem>Fit To Page</guimenuitem></menuchoice></term>
0161                         <listitem><simpara><action>Zoom the view so that the whole pattern fits within the visible area</action></simpara></listitem>
0162                     </varlistentry>
0163                     <varlistentry>
0164                         <term><menuchoice><guimenuitem>Fit To Page Width</guimenuitem></menuchoice></term>
0165                         <listitem><simpara><action>Zoom the view so that the patterns width fits within the visible area</action></simpara></listitem>
0166                     </varlistentry>
0167                     <varlistentry>
0168                         <term><menuchoice><guimenuitem>Fit To Page Height</guimenuitem></menuchoice></term>
0169                         <listitem><simpara><action>Zoom the view so that the patterns height fits within the visible area</action></simpara></listitem>
0170                     </varlistentry>
0171                     <varlistentry>
0172                         <term><menuchoice><shortcut><keycombo action="simul">&Ctrl;<keycap>+</keycap></keycombo></shortcut><guimenuitem>Zoom In</guimenuitem></menuchoice></term>
0173                         <listitem><simpara><action>Zoom in on the editor view</action></simpara></listitem>
0174                     </varlistentry>
0175                     <varlistentry>
0176                         <term><menuchoice><shortcut><keycombo action="simul">&Ctrl;<keycap>-</keycap></keycombo></shortcut><guimenuitem>Zoom Out</guimenuitem></menuchoice></term>
0177                         <listitem><simpara><action>Zoom out on the editor view</action></simpara></listitem></varlistentry>
0178                     <varlistentry>
0179                         <term><menuchoice><guimenuitem>Preview</guimenuitem></menuchoice></term>
0180                         <listitem><simpara><action>Show or hide the preview window</action></simpara></listitem>
0181                     </varlistentry>
0182                     <varlistentry>
0183                         <term><menuchoice><guimenuitem>Palette</guimenuitem></menuchoice></term>
0184                         <listitem><simpara><action>Show or hide the palette window</action></simpara></listitem>
0185                     </varlistentry>
0186                     <varlistentry>
0187                         <term><menuchoice><guimenuitem>History</guimenuitem></menuchoice></term>
0188                         <listitem><simpara><action>Show or hide the history window</action></simpara></listitem>
0189                     </varlistentry>
0190                     <varlistentry>
0191                         <term><menuchoice><guimenuitem>Imported Image</guimenuitem></menuchoice></term>
0192                         <listitem><simpara><action>Show or hide the imported image preview window</action></simpara></listitem>
0193                     </varlistentry>
0194                     <varlistentry>
0195                         <term><menuchoice><guimenuitem>Show Background Image</guimenuitem></menuchoice></term>
0196                         <listitem><simpara><action>Show or hide a background image. The list is generated dynamically based on the inserted background images</action></simpara></listitem>
0197                     </varlistentry>
0198                     <varlistentry>
0199                         <term><menuchoice><guimenuitem>Fit Background Image to Selection</guimenuitem></menuchoice></term>
0200                         <listitem><simpara><action>Fit the selected background image to the current selection area</action></simpara></listitem>
0201                     </varlistentry>
0202                 </variablelist>
0203             </para>
0204         </sect2>
0205 
0206         <sect2>
0207             <title>The Stitches Menu</title>
0208             <para>
0209                 <variablelist>
0210                     <varlistentry>
0211                         <term><menuchoice><guimenuitem>Quarter Stitch</guimenuitem></menuchoice></term>
0212                         <listitem><simpara><action>Quarter Stitch, the position is determined by the quadrant of the cell selected</action></simpara></listitem>
0213                     </varlistentry>
0214                     <varlistentry>
0215                         <term><menuchoice><guimenuitem>Half Stitch</guimenuitem></menuchoice></term>
0216                         <listitem><simpara><action>Half Stitch, the direction is determined by the quadrant of the cell selected</action></simpara></listitem>
0217                     </varlistentry>
0218                     <varlistentry>
0219                         <term><menuchoice><guimenuitem>3 Quarter Stitch</guimenuitem></menuchoice></term>
0220                         <listitem>
0221                     <simpara><action>Three Quarter Stitch, the orientation is determined by the quadrant of the cell selected</action></simpara></listitem>
0222                     </varlistentry>
0223                     <varlistentry>
0224                         <term><menuchoice><guimenuitem>Full Stitch</guimenuitem></menuchoice></term>
0225                         <listitem><simpara><action>Full Stitch</action></simpara></listitem>
0226                     </varlistentry>
0227                     <varlistentry>
0228                         <term><menuchoice><guimenuitem>Small Half Stitch</guimenuitem></menuchoice></term>
0229                         <listitem><simpara><action>A small half stitch, the position is determined by the quadrant of the cell selected</action></simpara></listitem>
0230                     </varlistentry>
0231                     <varlistentry>
0232                         <term><menuchoice><guimenuitem>Small Full Stitch</guimenuitem></menuchoice></term>
0233                         <listitem><simpara><action>A small full stitch, the position is determined by the quadrant of the cell selected</action></simpara></listitem>
0234                     </varlistentry>
0235                     <varlistentry>
0236                         <term><menuchoice><guimenuitem>French Knot</guimenuitem></menuchoice></term>
0237                         <listitem><simpara><action>French Knot Stitch</action></simpara></listitem>
0238                     </varlistentry>
0239                 </variablelist>
0240             </para>
0241         </sect2>
0242 
0243         <sect2>
0244             <title>The Tools Menu</title>
0245             <para>
0246                 <variablelist>
0247                     <varlistentry>
0248                         <term><menuchoice><guimenuitem>Paint</guimenuitem></menuchoice></term>
0249                             <listitem><simpara><action>
0250                                 Paint stitches onto the canvas - Press down the &LMB; and drag around the window.
0251                                 Stitches will be added to each cell passed over. Release the mouse button to stop painting.
0252                             </action></simpara></listitem>
0253                         </varlistentry>
0254                     <varlistentry>
0255                         <term><menuchoice><guimenuitem>Draw</guimenuitem></menuchoice></term>
0256                         <listitem><simpara><action>
0257                             Draw a line of stitches onto the canvas - Press down the &LMB; at the start of the line,
0258                             drag to the required end point of the line and release the mouse button. Stitches will be added to
0259                             each cell that the line passes through.
0260                         </action></simpara></listitem>
0261                     </varlistentry>
0262                     <varlistentry>
0263                         <term><menuchoice><guimenuitem>Erase</guimenuitem></menuchoice></term>
0264                         <listitem><simpara><action>
0265                             Erase stitches - Press down the &LMB; and drag over the stitches to be deleted. All stitches
0266                             within the cells passed over will be removed. Release the mouse button to stop erasing.  To erase backstitches
0267                             hold down the &Ctrl; key and left click in the start or end point of the backstitch, if there is more than one backstitch
0268                             at the digitized point this method will erase the first one found.  To delete a specific backstitch, click and
0269                             drag from one end to the other. To erase french knots hold down the &Shift; key and left click on the knot to delete it.
0270                         </action></simpara></listitem>
0271                     </varlistentry>
0272                     <varlistentry>
0273                         <term><menuchoice><guimenuitem>Draw Rectangle</guimenuitem></menuchoice></term>
0274                         <listitem><simpara><action>
0275                             Draw a rectangle - Press down the &LMB; at one corner of the rectangle and drag to the
0276                             opposite corner. Release the mouse button and an unfilled rectangle of stitches will be added to the
0277                             canvas.
0278                         </action></simpara></listitem>
0279                     </varlistentry>
0280                     <varlistentry>
0281                         <term><menuchoice><guimenuitem>Fill Rectangle</guimenuitem></menuchoice></term>
0282                         <listitem><simpara><action>
0283                             Draw a filled rectangle - Press down the &LMB; at one corner of the rectangle and drag to the
0284                             opposite corner. Release the mouse button and a filled rectangle of stitches will be added to the canvas.
0285                         </action></simpara></listitem>
0286                     </varlistentry>
0287                     <varlistentry>
0288                         <term><menuchoice><guimenuitem>Draw Ellipse</guimenuitem></menuchoice></term>
0289                         <listitem><simpara><action>
0290                             Draw an ellipse - Press down the &LMB; at one corner of the ellipse and drag to the
0291                             opposite corner. Release the mouse button and an unfilled ellipse of stitches will be added to the
0292                             canvas.
0293                         </action></simpara></listitem>
0294                     </varlistentry>
0295                     <varlistentry>
0296                         <term><menuchoice><guimenuitem>Fill Ellipse</guimenuitem></menuchoice></term>
0297                         <listitem><simpara><action>
0298                             Draw a filled ellipse - Press down the &LMB; at one corner of the ellipse and drag to the
0299                             opposite corner. Release the mouse button and a filled ellipse of stitches will be added to the canvas.
0300                         </action></simpara></listitem>
0301                     </varlistentry>
0302                     <varlistentry>
0303                         <term><menuchoice><guimenuitem>Fill Polygon</guimenuitem></menuchoice></term>
0304                         <listitem><simpara><action>
0305                             Draw a filled polygon - Click on each cell marking the vertexes of the polygon, click and drag to create more complex
0306                             curves.  Each of the vertexes are marked by a circle with a black line joining them. To close the polygon click on the
0307                             starting cell again.  You can use the &Backspace; key to remove the last point, or the &Esc; key to remove all vertexes and
0308                             cancel the operation.
0309                         </action></simpara></listitem>
0310                     </varlistentry>
0311                     <varlistentry>
0312                         <term><menuchoice><guimenuitem>Text</guimenuitem></menuchoice></term>
0313                         <listitem><simpara><action>
0314                             Insert text in stitches. This invokes the text dialog.  Select the font required and the size, enter the text
0315                             and click <guibutton>OK</guibutton>.  Press the &LMB; roughly where you would like the text, move the mouse to position
0316                             the text accurately and then release the mouse button.  This is the same as the paste function.
0317                         </action></simpara></listitem>
0318                     </varlistentry>
0319                     <varlistentry>
0320                         <term><menuchoice><guimenuitem>Alphabet</guimenuitem></menuchoice></term>
0321                         <listitem><simpara><action>
0322                             Insert patterns from the currently selected library that match the keys pressed.
0323                             This allows the creation of pattern alphabets that can have a key assignment.  After selecting this tool
0324                             and clicking a position on the pattern for the insertion point, each key pressed will be searched for in
0325                             the current library for a matching pattern.  If found this will be inserted at the position on the pattern
0326                             and the insertion position then advanced by the width of the inserted character pattern.  The pattern
0327                             space will be extended right to allow further characters to be entered.  Pressing &Enter; will start a new
0328                             line under the position of the original insertion point, the pattern space will be extended downwards
0329                             to accommodate the new line if insufficient space is available.  &Backspace; will delete the last character entered
0330                             and the <keycap>Space</keycap> key will advance the insertion point by either the width of a space character in the library
0331                             or a predetermined amount if no space character exists. The text will wrap onto the next line if the edge of the
0332                             pattern is reached and the end of a word is detected.
0333                         </action></simpara></listitem>
0334                     </varlistentry>
0335                     <varlistentry>
0336                         <term><menuchoice><guimenuitem>Select</guimenuitem></menuchoice></term>
0337                         <listitem><simpara><action>
0338                             Select a rectangular region - Press down the &LMB; at one corner of the rectangle, drag
0339                             to the opposite corner and release the button. A selection rectangle is shown to indicate the area.
0340                         </action></simpara></listitem>
0341                     </varlistentry>
0342                     <varlistentry>
0343                         <term><menuchoice><guimenuitem>Color picker</guimenuitem></menuchoice></term>
0344                         <listitem><simpara><action>
0345                             Allows the selection of a color from the existing stitches. Hovering over stitches will show a tool tip
0346                             indicating the color under the cursor. Clicking with the &LMB; will select it.
0347                         </action></simpara></listitem>
0348                     </varlistentry>
0349                     <varlistentry>
0350                         <term><menuchoice><guimenuitem>Backstitch</guimenuitem></menuchoice></term>
0351                         <listitem><simpara><action>
0352                             Add backstitching to the canvas - Press down the &LMB; at the start of the backstitch,
0353                             it will snap to the closest of 9 points in the cell, drag to the end point of the backstitch and release
0354                             the mouse button, again this will snap to the nearest of 9 points in the cell.
0355                         </action></simpara></listitem>
0356                     </varlistentry>
0357                 </variablelist>
0358             </para>
0359         </sect2>
0360 
0361         <sect2>
0362             <title>The Palette Menu</title>
0363             <para>
0364                 <variablelist>
0365                     <varlistentry>
0366                         <term><menuchoice><guimenuitem>Palette Manager</guimenuitem></menuchoice></term>
0367                         <listitem><simpara><action>
0368                             Add and remove colors to the current palette.  Assign symbols and the number of strands
0369                             for the stitching and backstitching.
0370                         </action></simpara></listitem>
0371                     </varlistentry>
0372                     <varlistentry>
0373                         <term><menuchoice><guimenuitem>Show Symbols</guimenuitem></menuchoice></term>
0374                         <listitem><simpara><action>Show the symbols associated with each color</action></simpara></listitem></varlistentry>
0375                     <varlistentry>
0376                         <term><menuchoice><guimenuitem>Clear Unused</guimenuitem></menuchoice></term>
0377                         <listitem><simpara><action>Removes the unused colors from the palette.</action></simpara></listitem>
0378                     </varlistentry>
0379                     <varlistentry>
0380                         <term><menuchoice><guimenuitem>Swap Colors</guimenuitem></menuchoice></term>
0381                         <listitem><simpara><action>
0382                             The next color selected will be swapped with the currently selected color. If you select the eye dropper
0383                             tool, you can choose the color to be swapped with directly from the pattern.
0384                         </action></simpara></listitem>
0385                     </varlistentry>
0386                     <varlistentry>
0387                         <term><menuchoice><guimenuitem>Replace Colors</guimenuitem></menuchoice></term>
0388                         <listitem><simpara><action>
0389                             The next color selected will replace the currently selected color. As with swap colors, you can use the
0390                             eye dropper tool to select the color from the pattern.
0391                         </action></simpara></listitem>
0392                     </varlistentry>
0393                 </variablelist>
0394             </para>
0395         </sect2>
0396 
0397         <sect2>
0398             <title>The Library Menu</title>
0399             <para>
0400                 <variablelist>
0401                     <varlistentry>
0402                         <term><menuchoice><guimenuitem>Library Manager</guimenuitem></menuchoice></term>
0403                         <listitem><simpara><action>
0404                             Open the pattern library manager which is a non modal dialog allowing the creation and
0405                             use of libraries of patterns or alphabets.  Drag and drop is available to allow the dragging and
0406                             dropping of patterns from the library to the pattern.  Automatic conversion of flosses to suit the
0407                             current pattern and scaling of the image to the current pattern scale for accurate positioning.
0408                         </action></simpara></listitem>
0409                     </varlistentry>
0410                 </variablelist>
0411             </para>
0412         </sect2>
0413 
0414         <sect2>
0415             <title>The Pattern Menu</title>
0416             <para>
0417                 <variablelist>
0418                     <varlistentry>
0419                         <term><menuchoice><guimenuitem>Extend Pattern</guimenuitem></menuchoice></term>
0420                         <listitem><simpara><action>Extend the pattern top, left, right and bottom</action></simpara></listitem>
0421                     </varlistentry>
0422                     <varlistentry>
0423                         <term><menuchoice><guimenuitem>Center Pattern</guimenuitem></menuchoice></term>
0424                         <listitem><simpara><action>Center the pattern in the canvas</action></simpara></listitem>
0425                     </varlistentry>
0426                     <varlistentry>
0427                         <term><menuchoice><guimenuitem>Crop Canvas To Pattern</guimenuitem></menuchoice></term>
0428                         <listitem><simpara><action>Crop the canvas to the extents of the pattern</action></simpara></listitem>
0429                     </varlistentry>
0430                     <varlistentry>
0431                         <term><menuchoice><guimenuitem>Crop Canvas To Selection</guimenuitem></menuchoice></term>
0432                         <listitem><simpara><action>Crop the canvas to the extents of the current selection</action></simpara></listitem>
0433                     </varlistentry>
0434                     <varlistentry>
0435                         <term><menuchoice><guimenuitem>Insert Rows</guimenuitem></menuchoice></term>
0436                         <listitem><simpara><action>Insert a number of rows represented by a selection area</action></simpara></listitem>
0437                     </varlistentry>
0438                     <varlistentry>
0439                         <term><menuchoice><guimenuitem>Insert Columns</guimenuitem></menuchoice></term>
0440                         <listitem><simpara><action>Insert a number of columns represented by a selection area</action></simpara></listitem>
0441                     </varlistentry>
0442                 </variablelist>
0443             </para>
0444         </sect2>
0445 
0446         <sect2>
0447             <title>The Settings Menu</title>
0448             <para>Apart from the common &kde; Settings menu entries described in the <ulink url="help:/fundamentals/menus.html#menus-settings">
0449             Settings Menu</ulink> chapter of the &kde; Fundamentals &kxstitch; has these application specific menu entries:
0450             </para>
0451             <para>
0452                 <variablelist>
0453                     <varlistentry>
0454                         <term><menuchoice><guimenuitem>Format Scales As</guimenuitem></menuchoice></term>
0455                         <listitem><simpara><action>Change the scale display format to Stitches, CM or Inches.</action></simpara></listitem>
0456                     </varlistentry>
0457                     <varlistentry>
0458                         <term><menuchoice><guimenuitem>Render Stitches As</guimenuitem></menuchoice></term>
0459                         <listitem><simpara><action>Change the way stitches are displayed.</action></simpara></listitem>
0460                     </varlistentry>
0461                     <varlistentry>
0462                         <term><menuchoice><guimenuitem>Render Backstitches As</guimenuitem></menuchoice></term>
0463                         <listitem><simpara><action>Change the way backstitches are displayed.</action></simpara></listitem>
0464                     </varlistentry>
0465                     <varlistentry>
0466                         <term><menuchoice><guimenuitem>Render Knots As</guimenuitem></menuchoice></term>
0467                         <listitem><simpara><action>Change the way knots are displayed.</action></simpara></listitem>
0468                     </varlistentry>
0469                     <varlistentry>
0470                         <term><menuchoice><guimenuitem>Color Highlight</guimenuitem></menuchoice></term>
0471                         <listitem><simpara><action>Enable or disable color highlight mode</action></simpara></listitem>
0472                     </varlistentry>
0473                     <varlistentry>
0474                         <term><menuchoice><guimenuitem>Show Stitches</guimenuitem></menuchoice></term>
0475                         <listitem><simpara><action>Show or hide the stitches</action></simpara></listitem>
0476                     </varlistentry>
0477                     <varlistentry>
0478                         <term><menuchoice><guimenuitem>Show Backstitches</guimenuitem></menuchoice></term>
0479                         <listitem><simpara><action>Show or hide the backstitches</action></simpara></listitem>
0480                     </varlistentry>
0481                     <varlistentry>
0482                         <term><menuchoice><guimenuitem>Show French Knots</guimenuitem></menuchoice></term>
0483                         <listitem><simpara><action>Show or hide the french knots</action></simpara></listitem>
0484                     </varlistentry>
0485                     <varlistentry>
0486                         <term><menuchoice><guimenuitem>Show Grid</guimenuitem></menuchoice></term>
0487                         <listitem><simpara><action>Show or hide the grid</action></simpara></listitem>
0488                     </varlistentry>
0489                     <varlistentry>
0490                         <term><menuchoice><guimenuitem>Show Background Images</guimenuitem></menuchoice></term>
0491                         <listitem><simpara><action>Show or hide all the background images</action></simpara></listitem>
0492                     </varlistentry>
0493                     <varlistentry>
0494                         <term><menuchoice><guimenuitem>Configure &kxstitch;</guimenuitem></menuchoice></term>
0495                         <listitem><simpara><action>Open &kxstitch; <link linkend="ConfigurationDialog">configuration dialog</link>.</action></simpara></listitem>
0496                     </varlistentry>
0497                 </variablelist>
0498             </para>
0499 
0500         </sect2>
0501 
0502         <sect2>
0503             <title>The Help Menu</title>
0504             <para>
0505             Additionally &kxstitch; has the common &kde; Help
0506             menu items, for more information read the section about the <ulink url="help:/fundamentals/menus.html#menus-help">Help Menu</ulink>
0507             of the &kde; Fundamentals.
0508             </para>
0509         </sect2>
0510     </sect1>
0511 </chapter>