    -----------------------
   / Dr GEO version 0.60b /
   -----------------------

                --------------------------------------
              / A free interactive geometry software /
              ---------------------------------------



                                        Copyright Hilaire Fernandes, 1997-98
                                        ------------------------------------




                        +----------------------+
                        |                      |
                        |  DR GEO USER NOTICE  |
                        |                      |
                        +----------------------+


Users of Dr Geo must accept this disclaimer of warranty 
"Dr Geo IS SUPPLIED AS IS.  THE AUTHOR DISCLAIMS ALL WARRANTIES, EXPRESSED OR IMPLIED, INCLUDING, WITHOUT LIMITATION, THE WARRANTIES OF MERCHANTABILITY AND OF FITNESS FOR ANY PURPOSE.
THE AUTHOR ASSUMES NO LIABILITY FOR DAMAGES, DIRECT OR CONSEQUENTIAL, WHICH MAY RESULT FROM THE USE OF Dr Geo OR THE INFORMATION CONTAINED HEREIN."



I)  INTRODUCTION:

Dr  GEO  is an interactive geometry  software. It is *freeware*, so you don't need to pay for it. Dr GEO is freely distributable as long this archive is not changed and I, the author, is informed about a distribution. I could then send you the latest version.
Dr GEO allows the construction of interactive geometric figures. It's  an educational oriented software. So I took care of the design of the Dr GEO user interface. It uses the mouse intensively and allows advanced features such as contextual menu and textual feedback of any geometrical element under the cursor.
Students feel at ease using Dr GEO. I have experimented with its use with students from eleven years old and find that they master the interface very quickly.

This software can be used by mathematics teachers in a class room  to demonstrate a point or with students in a computer class room carrying out their own investigation. Dr GEO can aslo  be used by students helping them to resolve geometric homework. Almost any geometry lover will find it a useful investigational tool .
Dr GEO can handle different national languages. Currently Chinese, English, French and Spanish are supported (See translation scheme).

PS:
Feel free to write to the author if you encounter nasty bugs or for any remarks concerning Dr Geo and its use.

II) USER NOTICE:
II.1 Needs:
   1. A 486DX or better. Dr Geo makes a lot of floating point calculs so an arithmetic coprocessor is required.
   2. Dos, Windows 3.11 or Windows 95.
   3. A Microsoft compatible mouse.
   4. A 32 bits super VGA video card or better.

If you have some problem with the display or the welcome screen doesn't appear try to install a VBE driver.

II.2 Install Dr GEO:
Unarchive the DrGEO zip file with with winzip, pkzip or equivalent in an empty folder (ex. DrGeo). When running unarchive enable the recursive folder option. (with pkzip use the flag -d)
Once installed, the folder structure must be look like this :

\DrGeo-----------
		|
		---\Data
		|
		---\Examples
		|
		---\Font
		|
		---\lang
		|
		---\Mac
		|
		---Cwsdpmi.exe (dos extender)
		|
		---Drgeo.exe (main executable)
		|
		---Drgeo.txt (this file)


The 'Examples' directory contains figures files (geo extension).
The 'lang' directory contains national message for Dr Geo.
The 'Mac' directory contains macro-construction.

Important :
-----------
- Dr Geo is a 32 bits software. So in a DOS environnement the programm CWSDPMI.EXE must be find in the same directory as DR_GEO.EXE.
- It's ok to copy all the files onto a floppy disk and run Dr Geo from it.


II.3 Start with Dr GEO:
From the line command type 'drgeo'.
The following commands line options can be used :
	-lang xx : to start with a specified language. XX is the position of the language, in the list found in the set-up dialog-box, starting with number 0.
	-f filename : to start with a given figure

Command line options:

Term under [] are options, || means OR:
   drgeo [-f geo_file_name || macro_file_name] [-lang language_number] [geo_file_name] [-select] [-help]

-f       : to load geo file or macro file
-lang    : to select a default language
-select  : to choose video mode with the gfx selector
-help    : this help summary


Several macro files can be loaded at start by using a -f command for each file.
The number provides with -lang XX is the position of the language, in the list found in the set-up dialog-box, starting with number 0.

Example: drgeo examples/hexagone.geo -f macro/bissect.mac -f macro/center.mac -lang 2

Under window, by attaching the defaut file type geo to DrGeo it's possible to start automaticly Dr Geo when double clicking on a geo file.
Also, it's possible to attach Dr Geo as an application for Netscape. Allowing automatic start of Dr Geo when clicking on geo file link in a html page under Netscape. 
Read the FAQ on the Dr Geo web site to know more about this.
II.4 Screen mode:
If you come back to DOS or Windows the screen mode hasn't been recognized
by your video card. Then install a VBE driver and try again.


II.5 Use of the mouse:
Dr GEO doesn't have menu or icon in the way we use on IBM PC.
Instead of this it has contextual menu icons and menus. I took this inspiration from the greatest (pesonnal point of view) but quite unknown Acorn RISC OS, as used on Acorn Risc PC station and Acorn Network Computers.
The idea behind this is to make appear the icons or menus only when you need them and at the place where the cursor is placed.

The left button performs an action (ie : creates an object or selects a specified menu). We name it the ACTION BUTTON.
The right button generaly calls up the vertical icons menu.
Passing the cursor over the icon changes their appearance. Pressing the left button opens a horizontal sub-menu. We name it the MENU BUTTON.
From the vertical icons menu you can enter inside 5 sub-menus.


II.6 Creation mode:
Important note:
To create a specified object (ie a line) in a particular position you may need to select some other objects (ie 2 points). When you pass over an object Dr GEO shows a text bubble with its name. The bubble is displayed only if this object can be use for the creation of the new object (ie Dr GEO shows the name of the point you pass over but not the names of line, circle, etc.)
This item is very useful in the creation of an object. Some objects can be created by several different methods but Dr GEO always shows you if a specified object can be use in the creation of another one. If there is more than one possible object that might be selected at a point Dr Geo shows ?? in a bubble. Click on that to see a list of possible objects.
Once you select an object it blinks. If you click over it again you unselect it and it stops blinking.

II.6.1 Point menu:
Within this menu you can create points with various properties. The horizontal menu offers the following options.

II.6.1.a Free point:
A free point can be totally free or free to move on an other object (ie a line, a segment, etc.)
You can create a point by a left click. If the mouse is over an object the point will belong to this object.

II.6.1.b Middle point:
Create the middle of a segment : select a segment.
Create the middle of two points : select two points.

II.6.1.c Intersection point:
Create  one/several points as the instersection of 2 objects: select the two objects for which you want the intersection.

II.6.1.d Coordinate point:
Create a point defined by its coordinates: select 2 numbers to perform this.

II.6.2 Line menu:
From this group of menu you can create lines, half-lines, segments, vectors and circles by selecting two points.

II.6.2.a Line:
Create a line through two selected points.

II.6.2.b Halfline:
The first selected point is the halfline origin. The second point will be on the halfline.

II.6.2.c Segment:
Create a segment defined from two selected points.

II.6.2.d Vector:
Create a vector from two points : the first point is the origin.

II.6.2.e Circle:
Create a circle by :
   selecting two points: the first point is the circle center the second a point of the circle.
   selecting a point and a segment: the point is the circle center, the segment length gives the circle radius.

II.6.2.f Locus:
Create a locus by:
	selecting two points: one point must be a free point on an object (line, half-line, etc.),the second point should be dependent upon the other point to produce an interesting locus. If not the locus will be reduced to the second point.

II.6.3 Transform menu:
From this group of menus you can create parallel & perpendicular lines. Also there are geometric transformations : axial & central symmetry,translation and rotation.

II.6.3.a A parallel:
Create a parallel line by
   selecting a line and a point: the line passes through the selected point and is parallel to the selected line.
   selecting three points: the line is parallel to the line formed by the two first points and passes through the third selected point.

II.6.3.b A perpendicular:
Create a perpendicular line by
   selecting a line and a point: the line passes through the selected point and is perpendicular to the selected line.
   selecting three points: the line is perpendicular to the line formed by the two first points and passes through the third selected point.

II.6.3.c Axial symmetry
Computerize the transformation of a point, line, half line, segment, circle by an axial symmetry by:
   selecting a line and another object (point, line, etc.): the first selected line is always the axial symmetry axis.

II.6.3.d Central symmetry
Computerize the transformation of a point, line, half line, segment, circle by a central symmetry by:
   selecting a point and another object (point, line, etc.): the first selected point is always the central symmetry center.

II.6.3.e Translation transformation:
Computerize the transformation of a point, line, half line, segment, circle by a translation by:
   selecting a vector and another object (point, line, etc.).

II.6.3.f Rotation transformation:
Computerize the transformation of a point, line, half line, segment, circle by a rotation by:
   selecting a point, an angle (geometrical or oriented) and another object (point, line, etc.) : the first selected point is alway the rotation center, the selected angle is the rotation angle.

II.6.4 Number menu:
You can create number:
   - distance between two points, length of segment, norm of a vector,perimeter of a circle, slope of a line, etc.
   - geometric angle between three points, angle between two vectors.
   - coordinates of a point, a vector, equation of a line, a circle.

II.6.5 Macro-construction menu:
A macro-construction can repeat a construction sequence.
It has several input and output objects.
To understand the macro-construction you need to understand what is a proposition figure.
Here an example:


   point A ------+
     |           |
+----+           +- C' middle -------- segment [CC'] ------+
|                |  of [AB]          |                     |
|  point B ------|                   |                     +-G intersection
|                |                 +-+-+                   | of [AA'] & [CC']
|                +- A' middle -----+ | +-- segment [AA'] --+
|                |  of [BC]          | |
|  point C-------+                   | |
|     |                              | |
|     +------------------------------+ |
+--------------------------------------+

This show the creation process of the gravity center of three points.
We call this a construction tree.
After performing this construction we can build a macro-construction.
Such a macro-construction should apply to three points (the input objects) this creation process and output the gravity center (the output object) of the three input points.
Once a macro-construction is recorded, it can be execute, save or delete.
Just read the following section to know how to manipulate macro-construction.

II.6.5.a Features:
Multi input object (memory limited).
Multi output object (memory limited).
Any number of macro-construction in Dr Geo (memory limited).
The macro-construction can be named with up 8 characters.
The macro-construction has a 5*30 text field for information (not appear yet).
The macro-construction can be saved, loaded or deleted in the macro-construction menu.
The macro-construction names and the macro-construction filenames are the same plus mac extension : macro-construction 'Gravity' will be save as 'gravity.mac'.

II.6.5.b Limitations:
Macro-construction can't be constructed if a human decision object appears in the macro-construction tree (moveable point on a line, etc.) however a human decison object can be chosen as an input object.
Also a locus can't be involved in any part of macro-construction.

II.6.5.c How to build a macro-construction:
   1. select the input objects and press enter
   2. select the output objects and press enter
   3. enter the name of the macro-construction. Remember you should use the same name to save the macro-construction

NB: Dr Geo informs you if the macro-construction is invalid. This means that the output object can't be constructed from the input object. May be you have forgotten some input object.

II.6.5.d How to play a macro-construction:
   1. in the list double click on the chosen macro-construction
   2. select the input objects (same order as you created the macro-construction)
   3. the macro-construction executes as soon as you have selected all the parameters

NB: Dr Geo will display info bubble only on interesting object regarding
the macro-construction

II.6.5.e How to save a macro:
   1. in the save menu (save fileselector)
   2. enter the macro name plus 'mac' extension (to save 'center' macro type 'center.mac')
NB : forgetting the 'mac' extension, Dr Geo will save the current figure with a 'geo' extension

II.6.5.f How to load a macro:
    1. in the load menu (load selector)
    2. select a file with the 'mac' extension
    3. the macro with the same filename appears in the play macro menu


II.6.6 Tools menu:

II.6.6.a Move a point:
Move a free point : to give dynamism to the figure.
Move a number or an equation.
Also in this menu an object can be renamed : press a shift key and click on the object.
In the case there is a conflict, the bubble will show '???'. Click with the left mouse button. A menu will appear with selectable objects. Choose the desired object by clicking. Click again to move it.


II.6.6.b Drawing Options
With this menu you can change the appearance of an object.
   1. select an object with the action button.
   2. a set-up window appears with the selected object drawing set-up.
You can change :
      a. the width/size of object : the four straight lines. The first dot line means invisible object.
      b. the color
      c. the point aspect : cross, round or square.
   3. apply the style change by selecting again the object with the menu button. You can also apply this style to other objects.
   4. you can move the set-up window with the move bar on the top.
   5. you can close the window with the close button.

II.6.6.c Set-up option:
With set-up box you can:
   change the screen resolution
   change the languages
   set/unset the background pattern

II.6.6.d Erase an object:
With the action button select the object to delete.
Dr Geo asks you to confirm.

II.6.6.e Save option:
With this option you can save:
   - the current geometric figure as a GEO file: enter the filename with 'GEO' extension. If no 'GEO' extension Dr Geo adds it by default.
   - the current geometric figure as a bitmap PCX file: enter the filename with 'PCX' extension.
   - a macro-construction in memory: enter the macro-construction name with 'MAC' extension.

II.6.6.f Read option:
With this option you can read:
   - a geometric figure: file with 'GEO' extension
   - a macro-construction file: file with 'MAC' extension.

II.6.6.g New figure:
Form there you can start again with a blank figure.
All unsaved objects are be lost.

II.6.6.h Quit Dr Geo.


III) Internationalisation:
Right now Dr Geo can cope with Chinese (classic), English, French and Spanish languages.
All the languages files are located in the Lang folder.
More language can be laoded form the Dr Geo web page.
As I want Dr Geo to cope a maximum of languages (education should not have frontiers, should it ?), I launch via the internet a translation scheme :
If you are a teacher and want to use Dr Geo in your classroom I will help you in technical term to translate the messages in your native language.
The translated message will then be available in my Web page to allow other user to update their version of Dr Geo.
Just send an e-mail to know more.


IV) FUTURE:
Dr GEO is still a beta-version. So it is still subject to change with bug fixed and improvements.

For future versions I want :
	- arc & conic objects
	- more numeric features
	- add some text with figures

IV) HOW TO CONTACT THE AUTHOR:

Email:			hilaire.fernandes@iname.com

www:			http://drgeo.home.ml.org

Snail mail:		Hilaire Fernandes
			Chung Chan North Road
			Section 7, lane 141, No 14
			Taipei
			ROC, Taiwan


V) THANKS:

Thanks to Rita K, Veronica Pimenta, Nicola Scarpel, Paul Blythin and Toby for their contributions to the Dr Geo project.

Thanks go to Charles Sandmannm, DJ Delorie & Elise Zaretskii for djgpp a *free* 32 bits compiler under Ms-Dos.
Special thanks to Shawn Hargreaves and all contributors for 'Allegro' a great *free* graphics library under djgpp.
Thanks also to Robert Hohne for Rhide a *free* IDE for djgpp.
Thanks to all the people who contribuate to djgpp in general.

