3
<sect1 id="AddColorDialog" >
4
<title>The Add Color Dialog</title>
9
<imagedata fileref="addcolor.png" format="PNG" />
15
The displayed list is all the colors that are currently available for the selected scheme.
16
New colors may be added using the 'New Color' button.
19
The colors can be selected singularly with the &LMB;, utilising the <keycap>Ctrl</keycap> key to select
20
multiple seperate colors, or in groups using the <keycap>Shift</keycap> key.
23
If you select a color by accident, you can deselect it using the <keycap>Ctrl</keycap> key and the &LMB;.
27
<sect1 id="NewColorDialog" >
28
<title>The New Color Dialog</title>
33
<imagedata fileref="newcolor.png" format="PNG" />
39
The dialog shows the name of the scheme that the new color will be added to. The color requires a name
40
and a description, which can be anything you want, although color name will usually be defined by the
44
Clicking on the Color button will show a standard KDE color selection dialog. The initial color can be
45
selected and then the parameters can be adjusted to give the correct color.
48
Once added this new color will be available to be included in your patterns palette via the 'Add Color'
49
dialog. It may also be adjusted by using the 'Floss Calibration' dialog.
53
<sect1 id="DeleteColorDialog" >
54
<title>The Delete Color Dialog</title>
59
<imagedata fileref="delcolor.png" format="PNG" />
65
This is essentially the same as the 'Add Color' dialog, although the 'New Color' button is not
66
available. Color selection is the same, but colors that are currently used in the pattern are greyed out
67
and are not available for selection.
71
<sect1 id="CalibrateDialog" >
72
<title>The Floss Calibration Dialog</title>
77
<imagedata fileref="calcolor.png" format="PNG" />
83
This dialog has two parts.
86
On the left, a pick list of the schemes that are currently available along with a list of colors that
87
are in that scheme. The color description will be appended with '(Calibrated)' if the color has been
88
modified by the current invocation of this dialog.
91
On the right, is the name and description of the currently selected color, this will be appended with
92
'(Modified)' if the color has been modified, a preview of the color, and the current RGB values for the color.
95
Also shown is a 'Reset Color' button. This will reset the currently selected color to the value it had
96
when the dialog was first invoked.
99
Pressing the 'OK' button will commit all of the changed colors.
102
Pressing the 'Cancel' button will restore all the changed colors back to thier original values.
106
<sect1 id="ConfigurationDialog" >
107
<title>The Configuration Dialog</title>
112
<imagedata fileref="config.png" format="PNG" />
118
This dialog lets you configure some of the &kapp; display parameters.
121
Most of the options are self explanatory. The check boxes enable or disable the display of various
122
elements. The pick lists allow selection of the required format of those elements.
125
The cell size value is the size of a grid square in screen pixels. The grouping value is the number
126
of squares in a major group, ie between the heavier lines. It may be necessary to change the grid line
127
colors if you work on dark materials and have set the patterns background color accordingly.
130
The scale size is the width of the border in screen pixels. You may need to adjust this if you have
131
large patterns and want to see the full text of the scales.
135
<sect1 id="ImportImageDlg" >
136
<title>The Import Image Dialog</title>
141
<imagedata fileref="import.png" format="PNG" />
147
On the left of the dialog there is a preview of the imported image, based on the parameters on the right.
150
The floss scheme for the finished pattern can be selected, by default this is the same as the 'New
151
Pattern Dialog' defaults. The maximum colors to be used for the pattern can be enabled and changed as
152
required, by default the imported pattern will have as many colors as are defined in the original image
153
that are converted to floss colors.
156
The cloth count value defaults to the 'New Pattern Properties' dialog and the scale is set such that
157
the final size is as close to the 'New Pattern Properties' pattern size as possible. These values can be
161
Clicking 'Import' will convert the image into a pattern.
165
<sect1 id="PatternPropertiesDialog" >
166
<title>The Pattern Properties Dialog</title>
171
<imagedata fileref="properties.png" format="PNG" />
177
The pattern size can be defined in units of stitches, centimeters or inches.
178
The width and height values will updated automatically to the equivilent size in the new unit type if
179
the units type is changed.
182
The cloth count is defined in units per centimeter or inches and is dependant on the units of size.
183
ie. if CM is selected for the units then cloth count will be in units per centimeter, similarly for inches.
184
if the Stitches unit is selected then the cloth count units will remain as the last CM or inches value.
187
The Title, Author, Copyright and Fabric fields are free text, so you can enter anything you like
188
here. The fabric color can be set by pressing the color button and selecting the required color. This will
189
then be shown in the editor and preview windows.
192
The floss scheme has a pick list for all the available floss schemes, including any that you have
196
The 'Set as default' checkbox will save the current values which will then be used as defaults
197
for all new patterns.
200
The Instructions tab can be used to enter any specific instructions for sewing the pattern.
204
<sect1 id="PatternLibraryDialog" >
205
<title>The Pattern Library Dialog</title>
210
<imagedata fileref="inslib.png" format="PNG" />
216
The Pattern Library Manager has a hierarchical tree view (more of a forest really) of catagories
217
on the left with an icon view of the selected catagory of patterns on the right.
220
Moving the mouse over one of the pattern icons will pop up a tooltip showing the floss scheme, size
221
and number of colors in the library pattern. Currently it is only possible to incorporate library
222
patterns of the same scheme as the current pattern.
225
Selecting an icon will enable the Insert button, which can then be clicked to insert the library
226
pattern. Alternatively the icon can be double clicked to insert it.
229
When the dialog has closed, press the &LMB; on the editor window roughly where you want
230
the library pattern to be placed. This will show you a preview of the library pattern on the current pattern.
231
Move the mouse to adjust the position of the preview, then release the &LMB; to place the
235
This method is exactly the same as using the Paste command. Similarly, the pasted pattern will overwrite
236
the paste area. Alternatively press the <keycap>Ctrl</keycap> key when releasing the mouse button will merge
237
the library pattern with the current pattern.
240
When creating a new library pattern, the dialog is essentially the same. The differences are that the
241
Insert button has changed to an Add button and the icon view only shows an icon of the pattern being added.
244
Navigate through the tree as required and select the catagory that you want to add the new pattern to.
245
If you want a new catagory, press the &RMB; and select the 'New Catagory' option from the
246
context menu. Fill in the name of the catagory and press OK. If there is no catagory currently selected,
247
the new catagory will be a root level catagory, otherwise it will become a child of the catagory currently
251
After you have selected the required catagory, press 'Add' and the pattern will be added to that catagory.
255
<sect1 id="TextDialog" >
256
<title>The Text Dialog</title>
261
<imagedata fileref="text.png" format="PNG" />
267
The text dialog allows you to select a font and size, then enter the text. Clicking OK closes the
268
dialog and returns you to the &kapp; window. Positioning the text is the same as pasting any other
269
element. Press the &LMB; on the canvas roughly where you want the text, this will show a preview of
270
the text, position the text exactly where you want it, then release the &LMB;
275
<imagedata fileref="text1.png" format="PNG" />
281
<sect1 id="PrinterDialog" >
282
<title>The Printer Dialog</title>
287
<imagedata fileref="print.png" format="PNG" />
293
The standard &kde; print dialog has been extended with a &kapp; specific page that allows
294
the printing of the pattern to be customized to your requirements.
297
The possible elements that can be printed are
299
<listitem><para>Front page</para></listitem>
300
<listitem><para>Instructions</para></listitem>
301
<listitem><para>Floss key</para></listitem>
302
<listitem><para>pattern</para></listitem>
304
Checkboxes in the dialog allow you to turn on or off any of these elements.
307
The front page will show the title of the pattern and the authors name at the top of the page
308
if they have been defined. It will show an image of the design in the centre and a copyright
309
message at the bottom, if it has been defined.
313
<imagedata fileref="front.png" format="PNG" />
319
With the floss key you can additionally specify the printing of the floss usage which will
320
be shown in metres, this will either be a total for all stitches, or the backstitches can be
321
shown as a seperate length, with a with a seperate total. The stitch count for each floss
322
can also be printed, either comprehensively with each stitch type totalled seperately or
323
the fractional stitches can be combined and totalled together.
327
<imagedata fileref="usage.png" format="PNG" />
333
The pattern can be printed on a single sheet, or it will span over as many sheets as
334
required. The Grid Squares per Inch and the Minimum Spill Over values can be adjusted to
335
give some control over the number of sheets. The stitches can be printed in any of the
336
available formats. The backstitches can only be printed as black or coloured lines.
339
For patterns that span multiple sheets, a keyplan will be printed in the top right hand
340
corner of each sheet.
344
<imagedata fileref="map.png" format="PNG" />