# Command Reference

## &kapp; Menus

### The File Menu

Ctrl n New

- Creates a new pattern, using the default values set in the pattern properties dialog.

Ctrl o Open

- Opens an existing pattern

Ctrl r Open Recent

- Open a recently used pattern

Ctrl s Save

- Saves the pattern

Ctrl a Save As

- Saves the document under a new name

Ctrl p Print

- Print the pattern

Insert Background Image

- Insert an image as a background for tracing.

Clear Background Image

- Clears the current background image.

File Properties

- Display / Edit the document properties

Import Image File

- Import a graphics file

Scan Image

- Scan an image

Ctrl w Close

- Close the pattern

Ctrl q Quit

- Quits &kapp;

### The Edit Menu

Ctrl z Undo

- Undo the last stitching action

Ctrl Shift z Redo

- Redo the last operation undone

Ctrl c Copy

- Copy the selected area to the clipboard

Ctrl v Paste

- Paste the selected area

Stitch Selection Mask

- Limit selections to the currently selected stitch type

Colour Selection Mask

- Limit selections to the currently selected colour

Exclude Backstitches

- Exclude backstitches from the selection

Exclude Knots

- Exclude Knots from the selection

Mirror / Rotate makes copies

- If set, the mirror and rotate functions will make a copy of the selection, otherwise the selected area is moved

Mirror selection vertically

- Mirrors the selected area vertically, i.e. flipped from top to bottom

Mirror selection horizontally

- Mirror the selected area horizontally, i.e. flipped from left to right

Rotate selection 90 degrees

- Rotate the selected area anti clockwise 90 degrees

Rotate selection 180 degrees

- Rotate the selected area anti clockwise 180 degrees

Rotate selection 270 degrees

- Rotate the selected area anti clockwise 270 degrees

#### Cut, Copy and Paste

Cutting and copying areas of the pattern can make use of stitch and colour masks and the exclusion of backstitches and knots to limit the selection.

The paste operation in &kapp; allows you to press and hold the &LMB; down roughly in the position that the paste data is to go which will provide an image of the paste data to allow accurate positioning before releasing the mouse button to finalise the position. This technique is also used for the mirroring and rotate functions.

A note about the clipboard. As well as supplying stitch information that can be pasted into any instance of &kapp;, it also provides data in several image formats suitable for pasting into other Qt based applications.

### The View Menu

Fit To Page

- Zoom the view so that the whole pattern fits within the visible area

Fit To Page Width

- Zoom the view so that the patterns width fits within the visible area

Fit To Page Height

- Zoom the view so that the patterns height fits within the visible area

Ctrl Shift + Zoom In

- Zoom in on the editor view

Ctrl Shift - Zoom Out

- Zoom out on the editor view

### The Stitch Menu

These items select the stitch to be used for painting on the canvas.

Full

- Full Stitch

Left to Right Half Stitch

- Half Stitch

Right to Left Half Stitch

- Half Stitch

Bottom Left 1/4 Stitch

- Quarter Stitch

Bottom Right 1/4 Stitch

- Quarter Stitch

Top Left 1/4 Stitch

- Quarter Stitch

Top Right 1/4 Stitch

- Quarter Stitch

Bottom Left 3/4 Stitch

- Three Quarter Stitch

Bottom Right 3/4 Stitch

- Three Quarter Stitch

Top Left 3/4 Stitch

- Three Quarter Stitch

Top Right 3/4 Stitch

- Three Quarter Stitch

French Knot

- French Knot Stitch

### The Tool Menu

Paint

- Paint stitches onto the canvas - Press down the &LMB; and drag around the window. Stitches will be added to each cell passed over. Release the mouse button to stop painting.

Draw

- Draw a line of stitches onto the canvas - Press down the &LMB; at the start of the line, drag to the required end point of the line and release the mouse button. Stitches will be added to each cell that the line passes through.

Erase

- Erase stitches - Press down the &LMB; and drag over the stitches to be deleted. All stitches within the cells passed over will be removed. Release the mouse button to stop erasing. To erase backstitches hold down the CTRL key and left click in the start or end point of the backstitch, if there is more than one backstitch at the digitised point this method will erase the first one found. To delete a specific backstitch, click and 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.

Outline Rectangle

- Draw a rectangle - Press down the &LMB; at one corner of the rectangle and drag to the opposite corner. Release the mouse button and an unfilled rectangle of stitches will be added to the canvas.

Filled Rectangle

- Draw a filled rectangle - Press down the &LMB; at one corner of the rectangle and drag to the opposite corner. Release the mouse button and a filled rectangle of stitches will be added to the canvas.

Outline Ellipse

- Draw an ellipse - Press down the &LMB; at one corner of the ellipse and drag to the opposite corner. Release the mouse button and an unfilled ellipse of stitches will be added to the canvas.

Filled Ellipse

- Draw a filled ellipse - Press down the &LMB; at one corner of the ellipse and drag to the opposite corner. Release the mouse button and a filled ellipse of stitches will be added to the canvas.

Filled Polyline

- Draw a filled polyline - Click on each cell marking the vertices of the polyline, click and drag to create more complex curves. The starting point will be indicated by a red circle. Each of the other vertices are marked by a green circle with a black line joining them. To close the polyline click on the starting cell again. You can use the backspace key to remove the last point, or the Esc key to remove all vertices.

Insert Text

- Insert text in stitches. This invokes the text dialog. Select the font required and the size, enter the text and click OK. Press the &LMB; roughly where you would like the text, move the mouse to position the text accuratly and then release the mouse button. This is the same as the paste funtion.

Select Rectangle

- Select a rectangular region - Press down the &LMB; at one corner of the rectangle, drag to the opposite corner and release the button. A marching ant boundary line will show the selected area.

Backstitching

- Add backstitching to the canvas - Press down the &LMB; at the start of the backstitch, it will snap to the closest of 9 points in the cell, drag to the end point of the backstitch and release the mouse button, again this will snap to the nearest of 9 points in the cell.

### The Palette Menu

Palette Manager

- Add and remove colours to the current palette. Assign symbols and the number of strands for the stitching and backstitching.

Show Symbols

- Show the symbols associated with each colour

Pick Colour

- Select colour from palette that matches a selection from the canvas - Click the mouse button in a cell to select the colour in the palette that matches the stitch in the cell. If there is more than one type of stitch in a cell, preference is given to the currently selected stitch type if one exists in this cell.

Save Palette

- Saves the current palette to a seperate file. This allows several patterns to be created based on a common palette without having to recreate it each time. In the dialog, just enter the name you want to use for the new palette.

Load Palette

- Load a previously saved palette. This includes the default palettes, DMC for example. Be aware that for large palettes, at this time there are not enough symbols for all the flosses.

Create Palette

- Create a new palette from scratch. Enter a name for the new palette, then use the Add colours dialog with the New colour button to add colours.

Clear Unused

- Clear the unused colours from the current palette.

Swap Colours

- The next colour selected will be swapped with the currently select colour. If you select the eye dropper tool, you can choose the colour to be swapped with directly from the pattern.

Replace Colour

- The next colour selected will replace the currently selected colour. As with swap colours, you can use the eye dropper tool to select the colour from the pattern.

Calibrate Colours

- Show the calibrate colours dialog and allows modifications to the colour values.

### The Pattern Menu

Extend Pattern

- Extend the pattern top, left, right and bottom

Center Pattern

- Center the pattern in the canvas

Crop Canvas To Pattern

- Crop the canvas to the extents of the pattern

Crop Canvas To Selection

- Crop the canvas to the extents of the current selection

Fit Background To Selection

- Resize the background image to fit in the selection area. As any background image is normally scaled to cover the entire canvas, this may be used to resize and position the background image just where you want it.

### The Library Menu

Create Library Pattern

- Create a new library pattern from the current selection

Insert Library Pattern

- Select a pattern from the libraries and insert it into the current pattern. Insertion of the library pattern is the same as pasting from the clipboard.

Export Library Patterns

- Add individual patterns or sections of the library tree to an export list. Then export the selections to an external file that can be imported to another installation of KXStitch.

Import Library Patterns

- Import an external library file. The patterns in the file will be merged with the current library tree.

### The Settings Menu

Show Toolbar

- Show / Hide the main toolbar.

Show Status Bar

- Show / Hide the status bar.

Show Stitch Toolbar

- Show / Hide the stitch toolbar.

Show Tool Toolbar

- Show / Hide the Tools toolbar.

Configure &kapp;

- Allow changes to the configuration of &kapp;, in addition to the set as default options on some dialogs.

Format Scales As

- Change the scale display format to Stitches, CM or Inches.

### The Help Menu

&kapp; Handbook

- Display this help.

What's This.

- Display help on a particular feature.

Report Bug.

- Fill out a bug report.

About &kapp;

- Display some information about &kapp;.

About KDE

- Display some information about KDE.