+---------------------------------------------------------------------------+
|                            TREEDRAW for Windows                           |
|                                   V 1.1                                   |
|                                 User Guide                                |
|                                                                           |
|      This guide is an extract of the on-line help file TREEDRAW.HLP       |
|                and should be used in conjunction with it.                 |
|                                                                           |
+---------------------------------------------------------------------------+

=============================================================================

CONTENTS  
========   

  1 GETTING STARTED
    
    1.1 Using the Help file
    1.2 Introducing TreeDraw
    1.3 Importing a tree file
    1.4 Formatting a chart
   

  2 TASKS
   
    2.1 File handling
      2.1.1 Starting a new picture
      2.1.2 Opening a picture
      2.1.3 Saving a picture
      2.1.4 Importing a tree
      2.1.5 Auto-updating text when opening a file
      2.1.6 Saving default file settings
      2.1.7 Exiting from TreeDraw
   
    2.2 Editing
      2.2.1 Adding text and simple graphics
      2.2.2 Adding clip-art and photographs
      2.2.3 Selecting picture elements
      2.2.4 Moving picture elements
      2.2.5 Resizing picture elements
      2.2.6 Changing text
      2.2.7 Copying to the clipboard
      2.2.8 Pasting from the clipboard
      2.2.9 Deleting picture elements
      2.2.10 Grouping picture elements together
      2.2.11 Updating text automatically
      2.2.12 Handling objects
      2.2.13 Turning off OLE object display     
      2.2.14 Undoing the previous editing operation
   
    2.3 Formatting
      2.3.1 Setting text font
      2.3.2 Setting text alignment
      2.3.3 Setting word wrapping
      2.3.4 Changing text's link to a tree file
      2.3.5 Setting the line style
      2.3.6 Setting the fill pattern
      2.3.7 Setting colours
   
    2.4 Alignment
      2.4.1 Changing the order of picture elements
      2.4.2 Aligning picture elements horizontally
      2.4.3 Aligning picture elements vertically
      2.4.4 Spacing picture elements evenly
   
    2.5 Printing
      2.5.1 Printing a picture
      2.5.2 Selecting pages to print
      2.5.3 Setting page parameters
      2.5.4 Selecting a printer
   
    2.6 Miscellaneous
      2.6.1 Zooming in and out
      2.6.2 Using the snap-to grid
      2.6.3 Customising imported tree contents
      2.6.4 Auto-replacing text during tree import    
      2.6.5 Setting fonts for imported tree

  3 REFERENCE
    
    3.1 Keyboard / Mouse key assignments
    3.2 Button bar
    3.3 Version information
    3.4 Known incompatibilities
    3.5 Supported GEDCOM data
    3.6 Frequently asked questions  

=============================================================================

Copyright (c) SpanSoft 1994,1995 All rights reserved.

Please see the help file TREEDRAW.HLP for support, registration, licence and
distribution details.

Written by   Nick J Hunter
	   
	     SpanSoft
	     11 Rowan Terrace
	     COWDENBEATH
	     Fife   KY4 9JZ
	     Scotland

Telephone:   National:      (01383) 510597
	     International: +44 1383 510597
			    (voice or fax)
	     (0900 - 1700 GMT/BST Monday - Friday)

E-Mail:      Internet:      nick.hunter@almac.co.uk
	     FidoNet:       NICK HUNTER (2:259/17)
	     CompuServe:    100101,1155
									     
-----------------------------------------------------------------------------

ASSOCIATION OF SHAREWARE PROFESSIONALS

SpanSoft is a member of the Association of Shareware Professionals (ASP). 
ASP wants to make sure that the shareware principle works for you. If you 
are unable to resolve a shareware-related problem with an ASP member by 
contacting the member directly, ASP may be able to help. The ASP 
Ombudsman can help you resolve a dispute or problem with an ASP member, 
but does not provide technical support for members' products.

Please write to the ASP Ombudsman at 545 Grover Road, Muskegon, MI 
49442-9427 USA, FAX 616-788-2765 or send a CompuServe message via 
CompuServe Mail to ASP Ombudsman 70007,3536.

=============================================================================

1 GETTING STARTED
=================

1.1 Using the Help file
-----------------------

To display the "Getting Started" help topic use Help|Getting started from 
the TreeDraw main menu.

The help file is a complete on-line manual for TreeDraw. As well as 
providing context-sensitive help direct from TreeDraw, it contains all the 
technical information about the program and usage tips in an easy-to-use
format.

If you are not familiar with using Windows help files, read the 'help on 
help' information. Do this by clicking the left mouse button on 'Help' in the 
menu above the help file and then on 'How to Use Help' in the pull-down menu.

You can get help by either selecting Help|Contents from the main menu or 
by pressing F1. You can also get specific help on whatever task you are 
carrying out by selecting the Help button in the current dialog.


1.2 Introducing TreeDraw
------------------------

TreeDraw is a specialist graphics editor for creating high quality genealogical 
drop-line charts.

Descendant and ancestral trees may be imported direct from Kith and Kin 
tree files or from PAF GEDCOM files created by other genealogy programs. 
TreeDraw converts these trees into easily edited picture elements which can 
then be re-formatted and re-arranged before storing and printing.

It is now easy to produce perfectly laid out charts and incorporate pictures, 
diagrams and other simple graphics. The charts may be as complex or a 
simple as you wish.

By importing a combination of descendant and ancestral trees from one or 
more tree files, it is possible to build complex charts which can extend in any 
direction.

TreeDraw maintains a link between each chart text element and the source 
field in the original tree file. This means that you can update each text 
element automatically to mirror any changes in the original file. The tree link 
for each text element can also be modified manually. This is a powerful 
feature which gives you control over the content and format of the text in 
the chart.

Additional text elements may be entered manually to provide titles, headings, 
comments, etc.

As well as text, you can place into the chart simple graphics (lines, boxes, 
circles) and OLE objects like pictures, clip-art, diagrams, etc.

TreeDraw lets you control the size, shape, style, colour and alignment of all 
chart elements and supports colour printing.


1.3 Importing a tree file
-------------------------

TreeDraw is designed to produce drop-line charts which are imported into an 
editable picture so that you can re-format them and add extra text and 
graphics.

TreeDraw will import trees from either Kith and Kin tree (.TRE) files or from 
PAF compatible GEDCOM (.GED) files. If your tree data is maintained by a 
genealogy program other than Kith and Kin (eg. Brother's Keeper, Family 
Scrapbook, PAF, etc), you first need to use that program to export your tree 
data into a GEDCOM file (refer to the program's own documentation for 
details).

It is recommended that you have the snap-to-grid option on before 
attempting to import the tree. This will ensure that the tree elements are 
aligned correctly and makes it easier to re-format the tree afterwards. You 
can check to see if the grid is on by pressing and holding the left mouse 
button whilst the cursor is over the grid button on the button bar. Drag the 
cursor away from the button before releasing it if you wish to avoid changing 
the setting.

You can also change various formatting options which will affect the 
appearance of the tree, before importing it. However, the default settings
will be suitable.

To start the import either select the Import command from the File menu and 
then choose a Descendant or Ancestral tree or press the Import Descendant 
or Ancestral tree button on the button bar. This will open a file selection 
dialog where you may enter the name of the tree file to import.
The import will then start (press Esc or the Cancel button   in the lower 
left corner of the main window to abort the import). You will see the 
bargraph display at the bottom of the screen move from left to right.

When the bargraph has reached the right hand side, the tree file has been 
loaded and you will be presented with the import dialog where you must 
choose the person who is to be the root of this chart.

Having pressed the OK button in the import dialog, TreeDraw will ask 
(assuming that you had the snap-to-grid on before importing) if you want the 
program to adjust the grid's vertical granularity to match that of the import 
font. Answer Yes. This will ensure that the vertical spacing of the snap-to-
grid closely matches the line spacing of the font chosen for the names of 
people in the chart.

TreeDraw now draws the picture elements necessary to make up the chart. 
The chart will appear in your picture with small, green squares at the corner 
of each element. These indicate that the entire chart is currently selected
so that you can move it to a new position if you wish. Click the left mouse 
button with the cursor away from any chart element to deselect the chart.

You can now re-arrange the chart to your desired layout and add more text 
or graphics.


1.4 Formatting a chart
----------------------

Once you have imported a chart, you will probably want to start moving the 
various elements around to make a more pleasant layout.

First select a view which will enable you to see as much of the chart as 
necessary.

To move a picture element around (in fact to perform any operation on it), 
you must first select it. Do this by placing the cursor over the chosen 
element and clicking the left mouse button. You will see 2 or 4 small, green 
squares (known as handles) appear around the element indicating that it has 
been selected. Now press and hold the left mouse button over the selected 
element. The cursor shape will change and a dotted outline will appear over 
the element indicating that you have grabbed it. Now simply move the outline 
to the new location using the mouse and release the mouse button to place 
the element there.

You can do the same thing with more than one element at a time simply by 
selecting multiple elements. Hold down the Shift key as you click on each 
element in turn or drag a marquee around the chosen elements to select them 
all.

If you want to modify the format or style of an imported chart element, you 
will probably have to Ungroup the group it belongs to and then select the 
chosen element individually. This may be necessary where (for example) a 
particular line of text is too long and you want to break it onto several
lines using the Word Wrap command.

Once you have arranged the chart to your satisfaction you should save it to 
disk.
=============================================================================

2 TASKS
=======

2.1 File Handling
-----------------

2.1.1 Starting a new picture
----------------------------

From the File menu select New.

This will first check to see if the current picture needs to be saved and
then clear the picture. The snap to grid granularities, page setup attributes 
and Auto Text Update option will be loaded from the file settings file 
TREEDRAW.OP2.


2.1.2 Opening a picture
-----------------------

Either  From the File menu select Open.
or      Select a previous file from the bottom of the File menu.
or      Press the Open button on the button bar.

This will first check to see if the current picture needs to be saved and
then bring up a file selection dialog.

Use File|Open for loading TreeDraw picture (.TDR) files. Opening a picture 
file also sets the snap to grid granularities, page setup attributes and Auto 
Text Update options.


2.1.3 Saving a picture
----------------------

Either  From the File menu select Save.
or      Press F2.
or      Press the Save button on the button bar

The picture will be saved with the name of the file shown in the main 
window title. If the picture has no current filename then the Save As will be 
used instead.


2.1.4 Importing a tree
----------------------

You can create a new tree in your picture from two different sources, either 
a Kith and Kin tree (.TRE) file or a PAF compatible GEDCOM (.GED) file.

First, select the Import command from the File menu and then choose a 
Descendant or Ancestral tree or press the Import Descendant or Ancestral 
tree button on the button bar.

A Descendant tree starts from a chosen (root) person and displays all his/her 
descendants including spouses as a drop-line chart. An Ancestral tree works 
in the opposite direction. From a chosen person, all his/her direct ancestors 
are displayed.

A file selection dialog will open to let you choose the file from which you 
wish to import the tree.

If the tree file you choose to import was the last file to be imported during 
this TreeDraw session, it will still be in memory and you will be asked if
you want to use the version in memory or load the version on disk. This is
useful when importing a large GEDCOM file and you want to experiment by 
importing using different tree formats, fonts, etc. By holding the GEDCOM 
file in memory TreeDraw can immediately access the tree data, making for a 
very fast import. Take care when you have amended a tree file or GEDCOM 
file and saved it to disk. The changes will not be reflected in the version 
stored in TreeDraw's memory. You will have to reload the tree file from disk 
to get the current version.

When the tree has loaded, you may select the root person and various 
options to control the content of the imported tree.

Person selection may be done by either entering a code number (digits only, 
do not enter the P) or selecting from the list of people.

Set Person details if you wish to include dates and places for individuals.
Set Marriage details if you wish to include dates and places for families
(not available in Ancestral trees.
Set Group tree elements if you wish to have associated tree elements (such 
as a person's name and details) automatically grouped together. This is very 
useful later when you will want to move the tree elements around.
Set Add statistics if you wish to have a stamp/statistics box added at the 
bottom of the chart. The statistics include the name of the imported tree
file and number of people, families and generations. The stamp is your 
personalised mark which may be your name and address or whatever 
information you wish. To modify your stamp, alter the text in the file 
STAMP.TXT using Notepad or a word-processor.
Set Flag duplicates if you wish TreeDraw to check for duplicated branches 
(eg. where cousins have married). "*** DUPLICATE ***" will be added to all 
people which appear more than once in the tree. TreeDraw will also truncate 
the tree at the duplicated person except on the first occurrence so that 
branches of the tree are not duplicated.
If you set All Generations, every descendant or ancestor will be included. If 
you require to limit the depth of the tree, clear the All Generations box and 
enter a number in Expand to ... generations. Entering 0 will produce a tree 
with only the root person, 1 will include his/her children or parents 
(depending on the tree type), and so on.
Four formats of Descendant or Ancestral tree are available and the selected 
layout is displayed beside the Extend generations and Align tree options. 
Select Vertically if you wish children to proceed across the page and 
generations from top to bottom and Horizontally for the opposite 
arrangement. Select Left/Top to justify the tree to the left or top
(depending on the Extend Generations option) and Centre to produce a centred
tree.

After pressing the OK button, if you have the snap-to grid option on, you
will be asked if you want the program to adjust the vertical granularity of
the grid to match the Names font size. Replying Yes to this will ensure that
the chart is correctly spaced and easy to modify afterwards.

When the tree has been drawn, all its elements (and only its elements) will
be selected to allow you to move the whole tree to a new location in the 
picture.

TreeDraw maintains a link between each imported text element and the 
file/field it originated from. This allows you to update your tree to match
any textual changes in the original tree file without having to re-import the
tree. You can also modify or lock this link.

See also: Customising imported tree contents (2.6.3)


2.1.5 Auto-updating text when opening a file
--------------------------------------------

You can force TreeDraw to update all the linked text in a picture file, 
immediately that file is opened. To do this, set the Auto text update option
in the Options menu.

This setting is stored with the picture file.
 

2.1.6 Saving default file settings
----------------------------------

TreeDraw saves the current snap to grid granularities, page setup attributes 
and Auto Text Update options with the current picture file (.TDR) when you 
use the Save or Save as commands.

You can save the current settings of these options as defaults so that when 
TreeDraw starts running or you use the File|New command, those settings 
are retrieved.

Set the above options to the values you require and use the Save file
settings command from the File menu.

This command allows you to define what properties you want each new 
picture to have. For example, you may always use Letter sized paper in your 
printer so you would save the file settings with Letter sized paper selected
in the Page setup dialog. That way, every time you start a new picture, the 
page size will automatically be set to Letter.


2.1.7 Exiting from TreeDraw
---------------------------

Either  From the File menu select Exit.
or      Press Alt+F4.

This command will check to see if the current picture needs to be saved 
before exiting the program.


2.2 Editing
-----------

2.2.1 Adding text and simple graphics
-------------------------------------

You must select the appropriate tool before carrying out any actions on 
picture elements. Tools may be selected from the Tools menu or from the 
tool box. Both methods have the same effect. If the tool box is not visible
on the screen, use the Tool box command from the Options menu to make it 
appear.

The tool box may be moved anywhere on the screen.

  Pointer (Ctrl+F10)    Use for selecting, moving and resizing 
			existing picture elements.
  Line                  Use to place a new line onto the picture.
  Ellipse               Use to place a new circle or ellipse onto 
			the picture.
  Round rect            Use to place a new square or rectangle 
			with rounded corners onto the picture.
  Rectangle             Use to place a new square or rectangle 
			onto the picture.
  Text                  Use to place a new text element onto the 
			picture.

Place a new simple graphic onto the picture by first selecting the
appropriate graphic type from either the Tools menu or from the tool box.
Press and hold the left mouse button to anchor one end of the element then
drag the mouse to expand the graphic to the right size and shape. Release
the mouse button.

Add a new text element to the picture by selecting the text tool from the
Tools menu or from the tool box. Click the left mouse button at the position
for the new text. The text editor at the top of the screen will become active
with a flashing vertical line. Key in the text you require, using Ctrl+Return
to insert line breaks. Press Return or click on the OK button to finish
editing. You can click on the Cancel button to cancel the text element.


2.2.2 Adding clip-art and photographs
-------------------------------------

You can easily add clip-art, scanned photographs, bitmaps and other images 
to your TreeDraw picture.

All these items are treated as OLE objects and are handled in basically the 
same way. For instance, to add a clip-art image from the CLIPART.PCX file, 
follow this procedure.

1) Run the Windows Paintbrush application (or another OLE server painting 
program which will accept .PCX files) and use the File|Open command to 
load CLIPART.PCX
2) Select the "cut" tool and drag the marquee around the clip-art image you 
want to use. Now use the Edit|Copy command to copy the image to the 
clipboard. All OLE embedding and linking works via the clipboard in this 
way.
3) Switch to TreeDraw and select the Edit|Paste command or click on the 
Paste button.
4) Move the cursor into the drawing area and click the left mouse button to 
position the clip-art image.

See also:    Handling objects (2.2.12)


2.2.3 Selecting picture elements
--------------------------------

Selecting picture elements allows you move, reformat, align, copy and perform
other operations, on those elements only.

There are 3 ways to select picture elements. First, make sure that you have
the Pointer tool selected.

Method 1 - place the cursor over your chosen element and click the left mouse
button. You will see small, green handles appear to indicate that the element
is now selected. You can now select (or deselect) additional elements by
holding down the shift key while clicking the left mouse button.

Method 2 - Drag a marquee around the element(s) you wish to select. Do this
by positioning the cursor where it is not over any element, press and hold
the left mouse button and drag the mouse so that the expanding rectangular
outline surrounds your chosen elements. Release the mouse button.

Method 3 - You can select all the picture elements at once by using the
Select all command from the Edit menu.


2.2.4 Moving picture elements
-----------------------------

You can move any existing picture element(s) around on the picture by first
selecting them, then holding down the left mouse button (the cursor will
change to crossed arrows) and dragging the mouse to the new location. Release
the mouse button to place the elements.


2.2.5 Resizing picture elements
-------------------------------
 
You can resize any existing picture element (except groups) by first
selecting it, then placing the cursor on one of the green handles which
appear around the element. Press and hold the left mouse button (the cursor
will change to an arrow head) then drag the mouse so that the size and shape
of the element is correct. Release the mouse button.

OLE objects can be forced to preserve their aspect ratio (ie. their size can
be changed but not their shape) by selecting the Keep aspect ratio command
from the Options menu.


2.2.6 Changing text
-------------------

You can change the text in a text element by selecting the single text
element to modify. This makes the current text appear in the text editor at
the top of the screen. Click on the text in the text editor and modify the
text as you would in a normal text box. You can use Ctrl+Return to insert
line breaks. Press Return or click on the  button to finish editing. You
can click on the Cancel button to cancel any changes to the text.

When editing text in the text editor the standard edit commands (undo, cut,
copy, paste, delete, select all) act on the text in the editor only. Picture
elements are not affected.


2.2.7 Copying to the clipboard
------------------------------

Copying only.
Select the picture element(s) which you wish to copy to the clipboard. Use 
the Copy command from the Edit menu or press Ctrl+Ins or press the Copy 
button on the button bar.

The picture elements will be copied to the clipboard in a special format so 
that they can be pasted into the current or other TreeDraw pictures. A 
Windows metafile image of the copied elements will also be copied to the 
clipboard to allow pasting to other applications. If a single text type
element is copied, the text will also be available on the clipboard for
pasting into text-based applications. If a single object type element is
copied, the object itself can then be pasted into other applications.

Copy and cutting.
Select the picture element(s) which you wish to copy to the clipboard. Use 
the Cut command from the Edit menu or press Shift+Del or press the Cut button
on the button bar.
The selected elements will also be deleted from the picture after copying.

If you are editing text in the text edit box, these commands will operate on
the text only.


2.2.8 Pasting from the clipboard
--------------------------------

You can copy various items from the clipboard to a TreeDraw picture. Use 
the Paste command from the Edit menu or press Shift+Ins or press the Paste 
button on the button bar to copy in other TreeDraw picture elements, text 
and to embed OLE objects.

The cursor will change to the paste cursor, position the cursor to where you 
want to place the new element(s) and click the left mouse button.

If you are editing text in the text edit box, this command will operate on
the text only.


Pasting a link from clipboard.
You can link an OLE object into a picture by using the Paste link command 
from the Edit menu.

The cursor will change to the paste cursor, position the cursor to where you 
want to place the new element(s) and click the left mouse button.


2.2.9 Deleting picture elements
-------------------------------

Use the Delete command from the Edit menu or press Del to remove the 
selected element(s) from the picture.

If you are editing text in the text edit box, this command will operate on
the text only.


2.2.10 Grouping picture elements together
-----------------------------------------

You can combine several individual picture elements into a single element 
known as a group. Use the Group command from the Edit menu or press 
Ctrl+G or press the Group button on the button bar. The group can then be 
manipulated in the same way as any individual element, except that the size 
and shape of the group cannot be changed.

You can separate the elements at some future time by using the Ungroup
command from the Edit menu or pressing Ctrl+U or pressing the Ungroup button
on the button bar.


2.2.11 Updating text automatically
----------------------------------

TreeDraw maintains a link between each imported text element and the 
file/field it originated from. This allows you to update your tree to match
any textual changes in the original tree file without having to re-import the
tree. You can also modify or lock this link.

To update the text in your picture, use the Update text command from the 
Edit menu or press F9. This will open the update dialog.

Set All linked text if you wish to update all the text elements in the
picture. If you only want to update the text in the currently selected
elements, set Selected text.
You can also limit the update to text linked to a particular tree file
(instead of all files) by setting Links to single tree and choosing a tree
file from the list.

You can also get the text updated automatically each time the picture file is 
opened.

See also:  Auto-updating text when opening a file (2.1.5)
	   Auto-replacing text during tree import (2.6.4)


2.2.12 Handling objects
-----------------------

You may link or embed one or more objects in your TreeDraw picture. The 
objects may be created, played, edited, deleted and copied to the clipboard.

Using the Paste Link or Paste will insert a new object into the picture.

Embedding objects.
Start the application which contains the object to be embedded. Select the 
object and copy it to the clipboard using the Copy command. Switch to 
TreeDraw and select the Paste command from the Edit menu or press 
Shift+Ins. The cursor will change to the paste cursor.

Linking objects.
Start the application which contains the object to be linked. Select the
object and copy it to the clipboard using the COPY command. Switch to
TreeDraw and select the Paste link command from the Edit menu or press
Shift+Ins. The cursor will change to the paste cursor. If the Paste link
command is not available it probably means that the object's source document
has not been saved or that the source application has not provided the
correct data to the clipboard.

Editing and playing objects.
First select the single object which use wish to operate on. The Object 
command in the Edit menu will be different for each object type. Select the 
object command appropriate to the action which you wish to carry out. The 
commands invariably include Edit and sometimes additional commands such 
as Play (eg. for sound objects) are available.
Double-clicking the left mouse button on an object will perform the default 
action for that particular object type. Normally this is Edit but it will
vary depending on the object type (eg. Play for sound objects).

Copying objects.
Objects can be copied along with other picture elements in the normal way. 
However, you can copy an object to the clipboard where it can be pasted to 
another application, as an object rather than a TreeDraw picture. Select a 
single object from the picture. Select the Copy command from the Edit menu 
or press Ctrl+Ins. This will copy the object to the clipboard. If you want to 
delete the object from the picture at the same time, use the Cut command (or 
press Shift+Del) instead of Copy.

Preserving OLE object aspect ratio.
Most OLE objects may be resized into any size or shape you wish. With some 
objects (such as scanned photos) this may not be appropriate and you may 
want to make sure that the shape of the photo does not change as you resize 
it.

You can achieve this by using the Keep aspect ratio command from the 
Options menu.

When TreeDraw is automatically maintaining the correct aspect ratio of 
objects, you should drag an object handle vertically to change the overall size 
of the object.


See also:   Turning off OLE object display (2.2.13)
	    Known incompatibilities (3.4)


2.2.13 Turning off OLE object display
-------------------------------------

Large OLE objects may take a small but noticeable time to display on your 
screen. This may make operations such as scrolling appear slow and jumpy. 
To avoid this you can get TreeDraw to display a blue, dashed rectangle of 
the correct size for each object, instead of displaying the object itself.

Use the Display objects command from the Options menu.

Turning off object displays will not affect printing or copying to the
clipboard.


2.2.14 Undoing the previous editing operation
---------------------------------------------

TreeDraw remembers your previous editing command so that if you decide 
that was not what you really wanted to do, you can undo it.

Use the Undo command from the Edit menu or press Alt+BkSp or press the 
Undo button on the button bar.

If you are editing text in the text edit box, this command will operate on
the text only.


2.3 Formatting
--------------

2.3.1 Setting text font
-----------------------

Use the Font command from the Format menu to change the font for the 
selected text elements. Text may be single elements or embedded within 
groups. If no elements are selected the default font will be changed.

This will bring up a standard font selection dialog. You can then change the 
typeface, style, size, effects and colour of the font. Note that you are not 
limited to using the listed font sizes.

You can also change a text element's colour by using the colour palette.


2.3.2 Setting text alignment
----------------------------

You can change the alignment of selected text elements by using the Text 
align command from the Format menu. If no text elements are selected the 
default text alignment will be changed.

Text may be ranged left (ragged right), centred or ranged right (ragged left).


2.3.3 Setting word wrapping
---------------------------

You can force the text in text elements to automatically break lines between 
words so that the it fits neatly into a defined rectangle. Use the Word wrap 
command from the Format menu. If no text elements are selected, the 
default word wrapping will be changed.

Once you have made a text element "wrappable" you can adjust the size of 
the rectangle which the text occupies by dragging one of its handles. 
TreeDraw will re-format the lines of text to fit the rectangle.


2.3.4 Changing text's link to a tree file
-----------------------------------------

TreeDraw lets you modify the link between a text element in your picture and 
the file and field it originated from, if it was imported as part of a tree.
You can also use this dialog to create a link between a manually entered text 
element and a tree file.

To change the format of this link first select the single text element you
wish to modify then select Tree link from the Format menu. This opens the
text's Tree link dialog.

Enter the code of the person or family the text is to refer to. Use the
format P<number> for people or F<number> for families.
Select the file name from the file list. The list contains the names of all
files which have been used to import trees to the current picture. If you
wish to add a new filename to the list, press the Select file button.
In the Fields box, enter the format to be used when updating the text. The 
same field identifiers are used both here and in the Import fields dialog.
See "Customise imported tree contents" (2.6.4) for details of how to format
this field. You can add individual fields from the Field Identifiers list
and/or a selection from the current Field Formats by double clicking on an
entry in the Imported Data Types list. The Add Field button will add entries
from either of the pick lists.

Set Locked if you wish to exclude this text element from any future updates.

TreeDraw will now use the modified link format when you update this text 
element.


2.3.5 Setting the line style
----------------------------

The style and weight of line used by simple graphic picture elements can be 
altered by using the Line style command from the Format menu.  If no 
elements are selected, the default line style will be changed.

Several line types and weights from 1 to 1000 are available.

	Dotted
	Dashed
	Dashed & Dotted
	Dashed & 2 Dotted
	Hairline          The thinnest supported line
	Width 1
	Width 2
	Width 4
	Width 6
	Other             User defined width

The colour of the line may be changed by using the colour palette.


2.3.6 Setting the fill pattern
------------------------------

The style of the filled area enclosed by simple graphic picture elements 
ellipse, round-cornered rectangle and rectangle can be altered by using the 
Pattern command from the Format menu.  If no elements are selected, the 
default pattern will be changed.

Several styles are available.

	Back diagonal
	Cross
	Diagonal cross
	Forward diagonal
	Horizontal
	Vertical
	Hollow (no fill)
	Solid

The colour of the pattern (if any) may be changed by using the colour palette.


2.3.7 Setting colours
---------------------

You can activate the colour palette by using the Colour palette command 
from the Options menu.

16 colours are available from the palette to be used for defining the
colour(s) of picture elements.

Click the left mouse button on the colour to be used for lines and text.
Click the right mouse button on the colour to be used for fills and patterns.

The colour palette may be moved anywhere on the screen.


2.4 Alignment
-------------

2.4.1 Changing the order of picture elements
--------------------------------------------

Picture elements are placed onto the picture in the order in which they are 
created, ie. the most recent goes on top and may overlap other elements.

You can make existing elements come to the front of the picture by selecting 
one or more elements and using the Bring to front command from the Align 
menu or pressing Ctrl+F.

You can make existing elements go to the back of the picture by selecting 
one or more elements and using the Send to back command from the Align 
menu or pressing Ctrl+B.


2.4.2 Aligning picture elements horizontally
--------------------------------------------

Select two or more picture elements and use one of the following commands 
from the Align menu.

Left      align elements along their left edges
Centre   (Ctrl+C) align elements along their centres
Right     align elements along their right edges


2.4.3 Aligning picture elements vertically
------------------------------------------

Select two or more picture elements and use one of the following commands 
from the Align menu.

Top       align elements along their top edges
Middle   (Ctrl+M) align elements along their middles
Bottom    align elements along their bottom edges


2.4.4 Spacing picture elements evenly
-------------------------------------

Select three or more picture elements and use one of the following 
commands from the Align menu.

Space horizontal     move elements horizontally so that there is equal space 
		     between each
Space vertical       move elements vertically so that there is equal space 
		     between each


2.5 Printing
------------

2.5.1 Printing a picture
------------------------

Either  Use the Print command from the File menu.
or      Press Ctrl+F8 to print the current tree.

The print will commence immediately (press Esc or the Cancel button   in 
the lower left corner of the main window to abort printing) using the 
currently selected printer, current page setup and will only print the
selected pages.

See also:  Selecting pages to print (2.5.2)


2.5.2 Selecting pages to print
------------------------------

You can display where the pages-breaks will be positioned, by using the Page 
breaks command from the Options menu.

The default print area is the single page in the top left corner of the
picture. You can enlarge this area by moving the cursor to the page where you
want to start printing then pressing and holding the right mouse button while
you drag the cursor to the last page to be printed. Release the mouse button
and the print area will be shown by a solid red border.

You can select the pages to print at any view setting but it is recommended 
that you first set the view to Whole Area. This will allow you to select any 
page(s).

Note that the page breaks do not change when the Scale to Fit Page option is 
selected in the Page Setup dialog


2.5.3 Setting page parameters
-----------------------------

From the File menu select Page setup.

The page setup dialog allows you to format various features of the layout of 
printed pictures. The settings selected here override any similar settings in 
the printer driver when the picture is printed.

Units of measure.
You may specify margins and page sizes in either inches or millimetres. When 
you change from one to the other, the current values will be converted for 
you.

Margins.
Enter the measurement for each of the page margins. Note that problems 
with printouts may be encountered when setting small margins. The printer 
you are using may have a non-printing area around the edge of the physical 
page and this may lead to missing or garbled print. If you have problems like 
this, try increasing the size of the margins.

Page size and orientation.
Select the appropriate paper size from the drop down list. You can specify a 
non-standard size (one not listed), by selecting Custom and entering the 
dimensions of the page in the Width and Height fields. Select the orientation 
you require. Portrait is the normal (tall) orientation, landscape has the
page rotated through 90 degrees (wide).

Print pages.
This determines the order in which pages are printed. Pages are printed from 
the selected print area which may be several pages high and several pages 
wide. If you want to print the first row of pages followed by the second row, 
etc, set Across then down. If you want to print the first column of pages 
followed by the second column, etc, set Down then across.

Set the Scale to fit page option if you want the entire chart squeezed (or 
possibly expanded) into a single page.


2.5.4 Selecting a printer
-------------------------

From the File menu select Print setup.

This will display a list of available printers. Select the required printer
and if you want to change the settings for that printer (paper bin,
resolution, number of copies etc), select the setup button to open the
printer driver's setup dialog. Note that the paper size and orientation are
overridden during printing by the values in the Page Setup dialog.

See Windows or your printer driver documentation for further details of the 
setup dialog for particular printers.


2.6 Miscellaneous
-----------------

2.6.1 Zooming in and out
------------------------

You can zoom in and out of a picture by using the View menu or by clicking 
on the zoom-in or zoom-out button on the button bar.

To view the entire drawing area select Whole area from the View menu.

To zoom in on a particular part of the drawing area, first select a picture 
element. TreeDraw always zooms in to or out from the current selection.

To come back to normal (full-sized) viewing quickly, you can also press F5.


2.6.2 Using the snap-to grid
----------------------------

TreeDraw lets you use a invisible or visible grid to align and place picture 
elements with precision. Use the Snap to grid command in the Options menu 
to alter the properties of the grid.

You can turn the grid on or off by selecting the Grid on check box.  When the 
grid is on any elements that you create, move or resize will snap to the 
nearest grid intersection.

You can make the grid visible by setting the Grid visible check box. Making 
the grid visible will slow down the display of the picture.

You can modify the granularity (coarseness) of the grid in both the
horizontal and vertical direction by entering a new value in the appropriate
box. The higher the value the coarser the grid.

Turning the grid on does not affect the position of existing elements unless 
you move or resize them.

You can also switch the grid on or off quickly by pressing the Grid button on 
the button bar.


2.6.3 Customising imported tree contents
----------------------------------------

Prior to importing a descendant or ancestral tree, you can define which
fields will go where in the chart and what indicators (b., d., m. etc) to use
by selecting Import Fields in the Options menu.

You can also get TreeDraw to automatically replace selected text as the tree 
is imported.

To define the content of the imported tree, use the Import fields command 
from the Options menu.

Each item in the "Imported data type" list represents a component of an 
imported tree:

Name                The name of the root person and spouses
Child's name        The name of any child
Person details      Date of birth, etc
Marriage details    Date and place of marriage, etc
Marriage indicator  Used when marriage details not requested

As TreeDraw imports the tree, it formats it as follows. 

(see TREEDRAW.HLP for diagram)

The example shows a left justified, vertical descendant tree but the text
arrangement is the same for all tree types.

The actual contents of each of these components can be user defined in the 
"Field format" box. Click on an item in the "Imported data type" list and
then edit its contents.
The field format may consist of any static text (including line breaks) plus 
any combination of the following field identifiers, used to represent actual 
fields from the imported tree. Note that christening and burial information
is currently only available from GEDCOM files which support them.

~CODE   Person or family code
~NOTE   Person or family notes
~FNAM   Firstnames
~SNAM   Surname
~DBIR   Date of birth
~PBIR   Place of birth
~DCHR   Date of christening
~PCHR   Place of christening
~DDEA   Date of death
~PDEA   Place of death
~DBUR   Date of burial
~PBUR   Place of burial

~DMAR   Date of marriage
~PMAR   Place of marriage

You can add each of the above identifiers to the end of any text in the Field 
format box, by selecting them from the "Field identifiers" pick list and 
pressing the Add Field button. Alternatively, you may double-click on the 
identifier in the pick list.

You can also enclose parts of a field format within braces "{ }" to indicate 
that the enclosed part will not be used unless at least one of the field 
identifiers within the braces produces non-blank text. This allows you to
stop TreeDraw inserting identifiers like "b." where no birth details actually
exist.

For example:

Say you want to import a descendant tree containing the person Thomas 
GORDON, code [P413], born 20 May 1781 but has no death details...

"Name":              ~CODE ~FNAME ~SNAM
results in:          [P413] Thomas GORDON

"Name":              ~CODE ~FNAME
		     ~SNAM
results in:          [P413] Thomas
		     GORDON

"Name":              ~SNAM, ~FNAM
results in:          GORDON, Thomas

"Person details":    b. ~DBIR ~PBIR
		     d. ~DDEA ~PDEA
results in:          b. 20 May 1781
		     d.

"Person details":    {b. ~DBIR ~PBIR}{
		     d. ~DDEA ~PDEA}
results in:          b. 20 May 1781

Feel free to experiment with different formats. If you want to reset all 
formats back to their original settings, select the Defaults button.

Each field identifier is a ~ (tilde) followed by 4 characters. If you need to use 
a tilde as static text, use ~~ to indicate a single tilde. Similarly, if you
want to use { or } as static text, use {{ and }}.

TreeDraw uses the default line style and colour for the lines in an imported 
tree.

See also:   Setting fonts for imported trees (2.6.5)
	    Setting the line style (2.3.5)
	    Auto-replacing text during tree import (2.6.4)


2.6.4 Auto-replacing text during tree import
--------------------------------------------

TreeDraw has the capability to automatically find and replace selected text
as it is imported from a tree file. This is useful, for instance, where you
may have recurring, long place names in your tree file which you want to
shorten in the TreeDraw chart so as to save space
(eg. replacing "Clackmannanshire" with "Clacks.").

You can maintain a list of text to replace and replacement text by using the 
Import text replace command from the Options menu to open the Replace 
Text on Import Dialog.

When adding find/replace text pairs to the list it is important to decide in 
what order to have items in the Replace list. TreeDraw searches an imported 
text element for all instances of the first item in the Replace list and 
carries out the appropriate replacements. The program then proceeds down
through the Replace list in the same way until all replacements have been
carried out.

If the Replace list contained, say:
	
	replace  "F/B"         with   "Fredericksberg"    and then
	replace  "Frederick"   with   "Fred"

then the imported text "F/B" would be changed first to "Fredericksberg" and 
then to "Fredsberg", clearly not the desired result. Changing the list order
to:
	replace  "Frederick"   with  "Fred"               and then
	replace  "F/B"         with  "Fredericksberg"

produces the replacement "F/B" to "Fredricksberg", the "Frederick" not 
having been found on the first pass.

Click on the Add button to add a new find/replace text pair. This opens the 
Add Replacement Text Dialog. New items added in this way are placed after 
the currently selected item in the Replace list or at the start of the list
if no items are selected.

Click on the Edit button to change the text of the currently selected item or 
double click on the list entry.

Click on the Delete button to remove the currently selected item from the 
Replace list.

If you want the replacements to be carried out at each tree import, set the 
Use at import check box. Similarly, if you want the replacements to be 
carried out at each text update, set the Use at update check box.


The Add/Edit replacement text dialog.

Enter the text to be replaced and the text it will be replaced with.

You may leave the With field blank but you must have an entry in the 
Replace field.

Set the Match case check box to make TreeDraw match exactly the upper 
and lower case letters in the Replace field with the imported text, otherwise 
the case is ignored.


2.6.5 Setting fonts for imported trees
--------------------------------------

You can specify which fonts will be used for the text in imported trees. To 
modify the font used for people's names, use the Names font command from 
the Options menu. Use the Details font command to modify any other details 
included in the tree.

============================================================================

3 REFERENCE
===========

3.1 Keyboard / Mouse key assignments
------------------------------------

Keyboard

F1      Help            Open the TreeDraw help file at the 
			contents topic
Ctrl+F1 Help search     Search for keywords in the TreeDraw 
			help file

F2      Save file       Saves the current picture
Alt+F4  Exit            Exits TreeDraw
F5      Normal view     Zooms to the normal viewing size
F9      Update text     Updates the text in the picture to 
			match that in the original file
F10     Pointer         Selects the pointer tool

Ctrl+A  Select all      Selects all picture elements (or text if 
			editing a text element)
Ctrl+B  Send to back    Moves the selected elements to the 
			back of the picture
Ctrl+C  Centre          Aligns the selected elements 
			horizontally on their centres
Ctrl+F  Bring to front  Moves the selected elements to the 
			front of the picture
Ctrl+G  Group           Groups the selected elements into a 
			single element
Ctrl+M  Middle          Aligns the selected elements 
			vertically on their middles
Ctrl+U  Ungroup         Ungroups a grouped element into its 
			component elements

Alt+BkSp        Undo    Undoes the previous editing operation
Del             Delete  Deletes the selected elements (or text 
			if editing a text element)
Shift+Del       Cut     Copies the selected elements to the 
			clipboard and deletes them from the 
			picture (or text if editing a text 
			element)
Ctrl+Ins        Copy    Copies the selected elements to the 
			clipboard (or text if editing a text 
			element)
Shift+Ins       Paste   Pastes the contents of the clipboard 
			into the current picture (or text if 
			editing a text element)


Mouse

Left            Multi-function          Manipulates picture elements
Double Left     Activate OLE object     If the selected element is an OLE 
					object, it is opened for editing
Right           Select print area       If Page Breaks are visible on the 
					screen, use the right mouse button to 
					select the pages to print


3.2 Button bar
--------------

The button bar is located just below the menu bar at the top of the main 
window.

You can display the function of each button in the status bar by pressing and 
holding the left mouse button and then moving the cursor away from the bar 
before releasing the button.


3.3 Version information
-----------------------

This is a list of new features, enhancements and bug fixes which is updated 
with the release of each new version of TreeDraw. Any last minute bug fixes 
are included here and may not be present in the flyers or readme files.

Version 1.1  May 1995

Upgrade release.
All imported trees can now be justified left or centre.
Imported trees can now extend vertically or horizontally.
Spouses details are now inserted into Descendant charts automatically.
Christening and burial details are now imported from GEDCOM files.
Child and Marriage order is now correctly picked up from GEDCOM files.
TreeDraw will now check, flag and truncate duplicated tree branches, eg. 
where cousins have married.
You can now Format|Font on text within groups without having to ungroup 
them.
Scale to Fit Page is now a Page Setup option. The entire chart can be scaled 
to fit a single page.
TreeDraw was crashing at 000D:0E0B after a text update was carried out on 
text elements within groups within groups. This has been fixed.
TreeDraw was crashing at 0005:4523 when text elements with the Word 
Wrap option were modified to contain no text. This has been fixed.
The TreeDraw help file is now available in text format as TREEDRAW.TXT for 
sending straight to the printer.
No file conversion required. Will read V1.0x files. WARNING: V1.0x will NOT
read V1.1x files.

Version 1.01  May 1995

Bug-fix release.
TreeDraw was occasionally hanging the system during startup on some PCs. 
This has been fixed.

Version 1.0  August 1994

First release.


3.4 Known incompatibilities
---------------------------

OBJECTS

Some applications which produce objects for embedding or linking, do not 
provide a picture image of the object. In these cases TreeDraw will not be 
able to embed or link the object into a picture in the normal way. You can, 
however, use the Windows Object Packager to associate an icon with the 
object. This will then allow TreeDraw to use the object as normal. See the 
on-line help in Object Packager or your Windows documentation for further 
details.


GEDCOM

TreeDraw has problems importing GEDCOM files created by Pedigree. 
Pedigree exports an older style of GEDCOM file which has no space character 
between the cross-reference ids and certain tags. You can overcome this 
problem by editing the GEDCOM file directly using NOTEPAD, a word 
processor or other text editor. Search for the text "@INDI" and "@FAM" and 
replace them with "@ INDI" and "@ FAM" respectively throughout the entire 
GEDCOM file (do not enter the quote marks). Save the file and you will now 
be able to import it into TreeDraw successfully.


3.5 Supported GEDCOM data
-------------------------

TreeDraw supports the PAF (Personal Ancestral File) variation of the 
GEDCOM (Genealogical Data Communication) standard, as used by the 
majority of genealogical programs. There are some quirks in PAF GEDCOM, 
which make it different from the GEDCOM standard proper, and so there are 
no guarantees that TreeDraw will correctly read GEDCOM files not designed 
to be read by PAF.

Fully supported tags: (have corresponding fields in TreeDraw)

Record  Tag     Description
INDI            Person data (individual).
	NAME    Firstnames and surname. If there is more than 
		one NAME tag for a particular person, the last 
		one is regarded as the normal name and prior 
		ones are regarded as aliases.
	SEX     Gender, male or female (male is assumed if 
		missing).
	BIRT    Date and place of birth.
	CHR     Date and place of christening.
	DEAT    Date and place of death.
	BURI    Date and place of burial.
	NOTE    Notes.
	FAMS    Family id of which this person is a parent.
	FAMC    Family id of which this person is a child.

FAM             Family data.
	HUSB    Person id of the father of this family.
	WIFE    Person id of the mother of this family.
	CHIL    Person id of a child of this family.
	MARR    Date and place of marriage.
	NOTE    Notes.


Extra data tags: (are inserted in notes)

Record  Tag     Description
INDI            Person data (individual).
	REFN    Reference number.
	TITL    Title.
	OCCU    Occupation.
	EDUC    Education.
	RELI    Religion.
	NATI    Nationality.
	CAST    Caste.

FAM             Family data.
	REFN    Reference number.
	DIV     Divorced.

Any other tags encountered in a GEDCOM file are ignored but are reported in 
the log file GEDERR.TXT.


3.6 Frequently asked questions
------------------------------

Q   I have tried to change the fill pattern of a simple graphic but nothing 
    seems to have happened.
A   The default fill colour is white so on a white background the pattern 
    will be invisible. Use the colour palette to change the fill colour.

Q   I have selected text from an imported tree to change its font but 
    TreeDraw will only let me modify the default font.
A   Make sure that the text you have selected is not part of a group element.
    You can spot this easily by looking at the Ungroup button on the button
    bar. If the button is enabled the element you have selected is a group. 
    Select the Ungroup button then re-select the text element you want to 
    modify.

Q   I have added a rectangle around my chart but now all I can see is the 
    rectangle; the chart has disappeared.
A   The default fill for simple graphics such as a rectangle is solid white. 
    The rectangle you have added has been placed on top of all the existing 
    picture elements and since it's opaque it has hidden everything else. Use
    the Send to back command to place the rectangle behind the other elements.

Q   I have a chart that spans two pages but when I try to print it only the 
    first page is printed.
A   TreeDraw allows you to choose which pages you want to print. First, turn
    on the Page breaks display then select the required pages using the right 
    mouse button. Now when you print, you will get all the pages you
    requested.

Q   I have selected landscape printing on my printer but TreeDraw still 
    prints portrait.
A   Set landscape printing in the Page setup dialog. Any settings made here
    override those in Printer setup.

Q   I want to edit the death details of someone in an imported tree but when
    I select that text element all I can see in the text edit box is the
    birth details.
A   The death details are in the text edit box but are on the next line.
    Press the cursor down key to move down a line. The text edit box can only
    display one line of text at a time so you need to scroll up and down
    using the cursor keys.

Q   How can I zoom in on a particular part of the drawing area?
A   Before zooming in, first select a picture element to zoom in on. 
    TreeDraw will zoom in and scroll to the selected element.

Q   I want to use a very small font for importing a tree but when I use the 
    Options|Names font command the smallest font size available is 8 point.
A   You are not restricted to the font sizes supplied in the list. These are 
    just the most frequently used sizes, you can actually enter any
    (supported) font size you like , such as 4 point, in the edit portion of
    the size list (click on the edit box at the top of the list).

Q   When I import a large tree extending, say, vertically the data on the 
    right hand side is missing. How can I get all the data into the picture?
A   TreeDraw has a fixed-size drawing area. If you import too large a tree 
    any data which would be placed outside the area is discarded. To make
    sure that all the data is imported you must either reduce the font sizes
    for names and details or import the tree in smaller chunks and connect
    them together afterwards. To do this either start the import from a root
    person one or more generations down the tree (and do this for as many
    people as is required to build the whole tree) or reduce the "Expand to
    ... generations" setting.
  
Q   How can I print out the entire help file?
A   Print the file TREEDRAW.TXT instead.

Q   Why are characters missed out at page breaks when I print to my laser 
    printer?
A   Some printers, lasers in particular, cannot print partial characters and
    so where a character is partially off the page, the printer will discard
    it altogether. You should turn on the Page Breaks display and move all
    the text elements away from the page breaks. This will look better if you
    are going to join pages together later.

Q   Why do some really long lines appear on the screen but are not printed?
A   This is a printer driver problem. Some printer drivers can handle long 
    lines, some cannot. Check to make sure you have the most recent version
    of your printer driver. You may also get around the problem by either
    reducing the output resolution (use File|PrintSetup) or by using two
    shorter lines instead of one long one.

=============================================================================
