THE GARDENER

Introduction.

     This program runs only in High Resolution.

     The purpose of this program is to provide a database of plants that
     have been put in your garden, to show where they were planted
     pictorially and make notes about things to be done in connection
     with that plant.

     The following files consist the program:-

 BEDMARK.DAT - contains the coordinates of the beds.

 DATBEDS.DAT - contains the coordinates of the plants.

 DATBEDS.NDX - Index file for the above.


 GARDEN.CFG - Holds the page settings for the printer.


 GARDEN.PRG - This application.


 GARDEN1.PI3 - Drawing of Bed number 1.


 GARDEN2.PI3 - Drawing of Bed number 2.


 GARDEN3.PI3 - Drawing of Bed number 3.


 GARDEN4.PI3 - Drawing of Bed number 4.


 GARDEN5.PI3 - Drawing of Bed number 5.


 GARDEN6.PI3 - Drawing of Bed number 6.


 GARDMENU.RSC - Resource file for this application.


 LABEL.DAT - Database of Plant Labels.


 LABEL.NDX - Index file for above.


 LAYOUT.PI3 - Drawing of garden layout.


 TITLE.PI3 - Title drawing for this application.


 Preparation.


     Using one of the already prepared pictures supplied with this
     program, draw the layout of your garden so that any of the beds may
     be selected by superimposing a rectangle.  This usually means a
     birds-eye view of the garden.  An Art package program may be used
     providing the picture format can be saved as a *.PI3 (Degas Elite) or
     use the drawing tools provided to edit the supplied picture.

     Save this picture of the layout of your garden as a file named
     "LAYOUT.PI3"

     Now divide the garden into 6 beds and draw each of them as a single
     picture.  Save each of these to files "GARDEN1.PI3" thro
     "GARDEN6.PI3".

     All picture files must be in the same path as the program files.

 The menus.

 File

  Quit.

     Clicking on "Quit" quits the program.

 Garden.

  Define Beds.

  Starting for the first time.

     With all the picture files available, run the application.
     If no fault occurs while loading the layout of your garden should
     appear on the screen.  The first task is to tell the application
     where the coordinates of your beds are.

     Select "Garden" from the menu.  Select "Define Beds".  A dialog
     will appear.  Select "BED 1" by moving the mouse over the button
     marked "BED 1" and clicking on it with the left mouse button and
     then click on "OK".  A dialog will appear, select "OK".  Move the
     mouse to the top left corner of the bed to be defined as Bed 1 and
     press the left button and hold it down whilst moving the mouse to
     the bottom right corner of the Bed 1 area.  Repeat for all six bed
     areas.
     Finish by clicking on "Yes" in the "Save bed definitions?" dialog.


  Select Beds.

     Having defined where the beds are located on the layout you may
     select the picture that corresponds to that bed.  Click on "Select
     Beds" from the "Garden" menu.  Move the mouse to the bed to be
     selected and click left mouse button.  The layout will be replaced
     by the selected bed.


 Landscaping.

     To select the drawing mode, click on "Landscape" in the "Garden" menu.
     Any picture may be changed by using the elementary drawing tools
     provided by this application.  Pressing the Undo key while in the
     selected mode will erase all the current action and return the
     picture to what it was.
     The following functions are available from the "Tools" menu:-

  Draw.

     Use the mouse as a pencil by placing the arrow where the drawing is
     to start and hold the left button down while moving the mouse to
     draw.  Releasing the mouse button lifts the pencil off the paper.


  Polygon.

     A polygon can be drawn by placing the arrow where the polygon is to
     be drawn. Press the left mouse button.  Move the mouse to the next
     point on the desired polygon and press and release the left mouse
     button.  A line will now be drawn between the start point and the
     current mouse position.  If the line is in the correct position, press
     and release the right mouse button to fix it.  If not, the line may
     be repositioned by moving the mouse to the corrected position and
     clicking the left button again. Click the right button to fix it.
     Move the mouse to the next point of the polygon and click the left
     button.  Click the right button to fix it.  Continue to do this until
     the desired polygon has been drawn.  Pressing and releasing the
     right button twice completes the polygon.


  Circles.

     Position the arrow at the desired centre of the circle.  Press and
     hold the left mouse button and move the mouse until the desired
     diameter has been achieved.  If the centre is to be repositioned,
     press and hold the Control key while holding the left mouse button
     and move the mouse.  Press and release the right mouse button to
     fix the circle.


  Fills.

     Selecting Fill will present a dialog showing the fill patterns
     available.  The default is solid black.  Click the mouse on the
     square above the fill required and select "OK".  The dialog is
     removed and the mouse may be moved to the area to be filled.
     Click the left mouse button to fill the selected area.


  Text.

     Select "Text" from the menu.  A dialog will appear from which the
     size of text may be selected.  Click on "OK" .  Point the mouse
     where the text is to begin.  A text cursor will appear and you may
     type in text from the keyboard.  To erase text either backspace or
     use the erase function described next.


  Eraser.

     Select the size of eraser from the dialog.  Move the cursor to
     the point to erase and press and hold the left mouse button.
     Moving the mouse will erase the area within the cursor.
     Release the left mouse button when erasing is not required.


  Finished.

     When the drawing is complete, select "Finish" and "Yes" from the
     dialog asking if you wish to save the drawing.  If "No" is
     selected, the modified drawing will not be saved at the end of the
     session.



 Functions available from the "Garden" menu when displaying a bed
 picture.


  Show Plants

     Click the left mouse button on the "*" of the plant mark whose
     label you wish to view.  The label will be displayed and may be
     edited if required.



  Plant.

     Select "Plant" from the "Garden" menu.  A dialog will appear showing
     the various types of plant that may be selected.  Click on the type
     of plant and then on "OK".  A dialog will appear asking you to click
     on the spot where the plant has been put in the bed.  Click on "OK",
     the dialog will disappear and the mouse will appear.  Click on the
     spot and it will be marked by a "*" and the initial character of the
     plant type.  Next a dialog will appear, type in the name and colour
     of the plant.  If the name and colour correspond to a plant already in
     the database then the label will be replaced by the label of that plant.
     At this point you may edit the information held in the database but
     this will apply to every plant of this type, name and colour.  If no
     match is found in the datatbase, then a label with only the name and
     colour will return and you may then fill in any further information
     you wish.  Click on "OK" to add the label to the database.  The program
     returns you to the 'Type selection' dialog.  Either caryy on planting
     or select "Cancel" to finish.
     To return to the layout drawing, click on "Layout" in the "Garden" menu.


  Weed.

     Select "Weed" from the menu.  Click on the plant to be weeded.
     The label of the plant to be weeded will appear.  If this is the plant
     to be weeded then pressing "Weed" in the dialog will erase the mark
     from the bed and delete the bed coordinates of that plant
     from the database.  The label will NOT be deleted from the label
     database.
     If this is not the plant to be weeded pressing "Cancel" returns you to
     the main program without deleting the plant.


 Labels.


  Browse.

     If the layout picture is displayed, selecting "Browse" from the
     "Label" menu prints the entire contents of the Label file to the
     screen.  The sort mode may be selected before or during "Browse"
     and will change the way the list is presented.

     If a bed picture is displayed only the plants in that bed will be
     listed.


  Add/Edit.

     Only allowed if the layout is displayed.
     Selecting this option enables you to add more labels to the label
     database.  Choose the type of plant from the dialog, Click on "OK"
     and enter the Name and Colour/Type.  If this label already exists
     it will be presented and the label may be edited, if it is a new
     label enter the data as required.


  Search.

     Only allowed if layout is displayed.
     Choose type from the type selector displayed.  Click on "OK".
     Enter the name and color in the label dialog displayed and click on
     "OK".
     The dialog presented shows how many of the selected plants have been
     planted in total and per bed.

  Print.

     If the layout is displayed, selecting this will print out the
     entire contents of the Label database.  If a bed is displayed, only
     those plants in that bed will be listed.

  Sorting.

     Selecting this function allows you to choose the way the Browse
     list or the Print list is presented.  Click on your choice and
     Click on "OK".


  Reindexing.

     This function has been included in case the index becomes garbled
     due to the computer crashing.


 Setup.

  Printer.

     The printed page configuration may be set by typing in the number
     of lines to Insert as a top of the page margin, the number of lines
     to print on the first page (some printers start several lines down
     from the top of the first page, this allows you to compensate for
     that) and the number of lines per page.