# Creating patterns

## Starting &kapp;

When starting &kapp; you will be presented with a blank canvas of the default size. This is also the case when selecting File New. The default sizes can be set in the pattern properties dialog by enabling the set as default checkbox.

If the default size is not suitable for your planned pattern, you can use the File File Properties dialog to change it. Adjust the values as required and after clicking on OK, the pattern will be resized to suit.

Before creating a pattern you will need to add some flosses to the palette using the Palette Palette Manager. This will enable the tools in the Tools menu and toolbar. See the Palette Manager Dialog for further information.

## Importing Images

&kapp; allows you to import an image. A dialog will be displayed that previews the image based on the default import options.

The initial size of the pattern will be based on the default pattern size.

Options for importing allow you to change the floss scheme used and to limit the number of colors. You can also change the scaling to reduce or enlarge the final pattern.

Checking the Use fractionals checkbox will enable the use of fractional stitches to give more detail for any given pattern size.

Checking the Ignore color checkbox will allow the selection of a color within the image which will then be considered as the transparent color and ignored during the import.

After the image has been imported, an additional dock window will be available giving a preview of the original image without any color transitions.

## Background Images

You can insert an image as a background to the editor window. This is useful if importing the image is not desirable or gives poor results.

The image is normally scaled to cover the entire pattern grid. This may not be suitable, therefore you can use the select tool to select an area that you want to cover and then select the View Fit Background Image to Selection. This will rescale the image to fit within the selected area. You can continue doing this until you are happy with the result, even after you have started adding stitches.

There is no limit to the number of background images that can be added. Although practical limits of the menus will determine how many can be added. The background images are stored within the document, so they will be available when the pattern is reloaded.

## Pattern Libraries

The pattern library manager can be used to store patterns for insertion into the working pattern. They can be categorized into a hierarchy of categories and subcategories with multiple root nodes in the library list. The Alphabet tool makes use of these libraries to provide an alphabet of insertable characters that can be assigned an associated key.

The library manager is a non modal dialog and can be left open whilst working on your pattern. You can select different libraries as needed and then drag and drop library patterns onto the working pattern.

Adding new category headings can be done with a &RMB; on either an existing entry, to create a sub category, or on a blank space on the library list, to create a new root entry, and selecting the New Category option. Enter the name of the category and click OK.

Creating a new library pattern is done by selecting an area of your working pattern, copying and pasting to one of the existing categories.

Each library pattern has properties, accessed by its context menu. These properties include size, floss scheme, baseline value and associated key. The baseline value is used by the Alphabet tool to adjust the height of a character above, negative values, or below the insertion point. The associated key is again used by the Alphabet tool to match with the key pressed on the keyboard.