    -----------------------
   / Dr GEO version 0.50b /
   -----------------------

                ----------------------------------
              / A free dynamic geometry software /
              ----------------------------------



                                              By Hilaire Fernandes, 1997
                                              --------------------------




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




I)  INTRODUCTION:

Dr  GEO  is dynamic 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 the author, I, is inform about a distribution. I could then send you the latest version.
It  allows the construction of dynamic  geometric  figure. It's  an educational oriented software. So I took care of the design of the Dr GEO user interface. It use intensively the mouse and allow advanced features as contextual menu and textual feedback of geometrical element under the mouse pointer.
Using Dr GEO, the feeling is very good. I experiment it with student from eleven year old. They master the interface very quickly.

Also Dr GEO can handle differents nationals languages as Chinese, English, French and Spanish (Cf traduction scheme).
This software can be used by mathematic teachers. In a class room to make a show or in a computer class room.
Also Dr GEO can be use by students helping them to resolve geometric home exercices.
Also, geometry lover


II) USER NOTICE:
II.1 Needs:
   1. A 486DX or better. Dr Geo makes a lot of floatting 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 presente screen doesn't appear try to install a VBE drivers.

II.2 Install Dr GEO:
Unarchive the DrGEO zip file with with winzip, pkzip or equivalent in an empty folder (ex. DrGeo). When unarchive enable the recursive folder option. (with pkzip use the flag -d)
Once install, 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.

Importante :
-----------
- 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 on a floppy disk and run Dr Geo from it.


II.3 Start with Dr GEO:
From the line command type 'Ddrgeo'.
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

Example: drgeo -f examples/hexagone.geo -lang 2


II.4 Screen mode:
If you come back to DOS or Windows the screen mode hasn't been recognize
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 unknow Acorn RISC OS, use on Acorn Risc PC station and Acorn Network Computer.
The idea behind is to make appear the icons or menus only when you need them and at the place where is the mouse pointer

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 the vertical icons menu.
Going over the icon changes their aspects. 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:
Importante note:
In the position to create a specified object (ie a line). You need to select some object (ie 2 points). When you pass over an object Dr GEO shows a text bubble with its name. The bubble is display 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 usefull in the creation of an object. Some objects can be create in differents methods but Dr GEO always shows you if a specified object can be use in the creation of another one.
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 point.

II.6.1.a Free point:
A free point can be totaly free or free inside an other object (ie a line, a segment, etc.)
You can create a point by a left clic. 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 you want the intersection.

II.6.1.d Coordinate point:
Create a point defines 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, vector, circle by selecting two points.

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

II.6.2.b Half-line:
The first selected point is the half-line origin. The second point belong to the half-line.

II.6.2.c Segment:
Create a segment 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.3 Transform menu:
From this group of menu you can create parallel & perpendicular lines. Also there is geometric transformations : axial & central symetry,translation and rotation.

II.6.3.a A parallel:
Create a parallel line by
   selecting a line and a point: the line passes by 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 by the third selected points.

II.6.3.b A perpendicular:
Create a perpendicular line by
   selecting a line and a point: the line passes by 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 by the third selected points.

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

II.6.3.d Central symetry
Computerize the transformation of a point, line, half line, segment, circle by a central symetry by:
   selecting a point and another object (point, line, etc.): the first selected point is always the central symetry 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 to point, length of segment, norme of a vector,perimeter of a circle, slope of a line, etc.
   - geometric angle between three points, oriented 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 human decision object appear in the macro-construction tree (moveable point on a line, etc.) however human decison object can be choosen as input object.

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 unvalid. This means that the output object can't be construct from the input object. May be you forget some input object.

II.6.5.d How to play a macro-construction:
   1. in the list double click on the choosen macro-construction
   2. select the input objects (same order as you create 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 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.

II.6.6.b Draw rendering
With this mneu you can change the aspect of an object.
   1. select an object with the action button.
   2. a set-up window appear with the selected object drawing set-up.
You can change :
      a. the width/size of object : the four right lines. The first dot line mean unvisible 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 object.
   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 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.
In it, can be find the file Lang.uni.
As I want Dr Geo to cope a maximum of languages (education should not have frontier, don't you ?), I launch via the internet a traduction 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 futur version I want :
	- macro feature
	- arc & conic objects
	- more numeric features
	- add some text with figures

IV) HOW TO CONTACT THE AUTHOR:

Email:			hilaire.fernandes@iname.com

www:			http://xoom.com/FeYiLai

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


V) THANKS:

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.

