///////////////////////////////////////////////////////////////////////////
/                                                                         /
/                                                        /
/                                              /
/                                                 /
/                                                                         /
///////////////////////////////////////////////////////////////////////////

Alchimi version 2.0     

Version for MS-DOS of the program T.P. 1.1 for AMIGA

Original project............MAGICSOFT INFORMATIC TEAM 1994
Programming.................Stefano Tamascelli
Graphics....................Enzo Davi' and Stefano Tamascelli
Manual......................Michele Tedeschi and Monia Zangheratti
Testing.....................Michele Tedeschi

All Rights Reserved. No part of this program, manual and license can be 
reproduced, stored in a retrieval system or transmitted by any means
without a written permission of the MagicSoft Informatic Team 1994 ( apart
from the demo version ).

********** INDEX *************************************  

CHAPTER 1......................................................
		HardWare Configuration.........................
		Installation...................................

CHAPTER 2......................................................
		Alchimi 2.0....................................
		Contents of the disk...........................

CHAPTER 3......................................................
		How to utilize Alchimi 2.0.....................
		The Bar Menu...................................
		The Icons......................................
		The Keys of Rapid Choice.......................
		More Information About Alchimi 2.0.............
		More Information About The Calculator..........
		Calculator Keys................................

CHAPTER 4......................................................
		Alchimi, a few statistics......................
		Demo version...................................
		Thanks.........................................
		CopyRight......................................
		ShareWare......................................

           
                       C H A P T E R     1                           
         

********** Hardware Configuration ********************

To use the program it is necessary to have a compatible PC-IBM with a 80286
microprocessor, 512 Kb of RAM memory, VGA, a mouse, a color monitor and 1
drive ( the program can also work only from a disk ).

Configuration that we advice : compatible PC-IBM with a 80386 microprocessor
or more, 640 Kb of Ram memory, VGA, Hard Disk and mouse.

********** Installation ******************************

To install the program it is sufficient to use the INSTAL.BAT program. It 
will install the program Alchimi 2.0 in the ALCHIMI directory on the C:\ disk.

We advice to protect the disk from writing and to make a safety copy.


           
                       C H A P T E R     2                           
         

********** ALCHIMI 2.0 *******************************

Alchimi version 2.0 is a complete program of chemistry for everyone who 
works with this subject ( especially students ).
The program contains :

- The periodic table of the 103 elements with their chemical and physical 
  characteristics.

- Tables of consultation of oxides and of isotopes, electronic configurations, 
  acid and basic constants.

- The system for the resolution of the most important chemical formulas.

- A calculator that can be activated whit the mouse or whit the keyboard.

- Test on the periodic table for the learning.

********** Contents of the disk **********************

The disk contains :
			ALCHIMI.EXE
			MANUALE.TXT
			LICENSE.TXT
			README .TXT
			ORDER  .FRM

			Directory \DATA

				TAVDAT .DAT
				OSSI   .DAT
				ISOTOPI.DAT
				PESO   .DAT
				ATOM   .DAT
				PESOMOL.DAT
				HELP   .HLP
				LISTA  .DAT
				CONELE .DAT


			Directory \GRAPH

				0001   .WWW 
				0002   .WWW
				0003   .WWW
				0004   .WWW
				0005   .WWW
				0006   .WWW
				0007   .WWW
				0008   .WWW
				0009   .WWW
				0010   .WWW
				0011   .WWW
				0012   .WWW
				0013   .WWW
				0014   .WWW
				LOGO   .WWW
				TITOLO1.WWW
				TITOLO2.WWW
				NOME1  .WWW
				NOME2  .WWW
				NOME3  .WWW
				NOME4  .WWW
				EGAVGA .BGI


           
                       C H A P T E R     3                           
         


********** HOW TO UTILIZE ALCHIMI VERSION 2.0 ***********

To utilize Alchimi 2.0 you can use :

	- The Bar Menu
	- The Icons
	- The Keys of rapid choice

MIND OUT !!! To go out of a window you must press the left bottom of the
	     mouse or the ESC key.

	     If you press the left bottom of the mouse when the cursor is
	     on the DOS icon and if you utilize the EXIT menu or Ctrl + X
	     the program goes out automatically without asking for any
	     confirmations.

********** THE BAR MENU *********************************

To activate the bar menu you have to press the left bottom of the mouse 
( only once ) on the item that you want.
To activate an order you must press the left key of the mouse ( the order
that you choose will be darker than the others ). 
To annul an order you have to press the left key of the mouse outside the
menu.

ALCHIMI  :
	 -"  Alchimi " - It contains information about the program.
	 -"  M.I.S.  " - It presents the Team who has realized the program
			 ( all italians ). 
	 -"  About   " - It contains the version, the number of registration           
			 the name and the language of the programming.
	 -"  Table   " - It enables to activate the Periodic Table ( see the
			 relative chapter ).


FORMULAS -" Laws of Gases    " - It contains Boyle, Charles, Gay-Lussac,
				 Avogadro, of State, Dalton and Graham 
				 law's.
	 -" Solubility       " - It contains these formulas : molarity 1 and 2
				 number of moles, molality, normality 1 and 2,
				 gram formula, formality 1 and 2.
	 -" Dissociation     " - It contains the dissociational formula.
	 -" Thermodynamics   " - It contains the formuals of : internal energy,
				 system work exchange, isoterm and
				 isobar transformations and calculation of H.

PROBLEMS -" Laws of Gases    " - It contains Boyle, Charles, Gay-Lussac,
				 Avogadro, of State, Dalton and Graham 
				 problem's.
	 -" Solubility       " - It contains these problems : molarity 1 and 2
				 number of moles, molality, normality 1 and 2,
				 gram formula, formality 1 and 2.
	 -" Dissociation     " - It contains the dissociational problem.
	 -" Thermodynamics   " - It contains the problems of : internal energy,
				 system work exchange, isoterm and
				 isobar transformations and calculation of H.

M.W.     :
	 -" Molecular Weight " - It enables to activate the calculation of the 
				 molecular weight ( see the relative chapter ).
	 -" Multiple Weight  " - It activates the multiple molecular weight.
				 ( see the relative chapter ).
	 -" pH               " - It activates the calculation of the pH of a 
				 solution ( see the relative chapter ).


GRAPHS :
	 -" Atom     " - It enables to activate the atomic configuration
			 ( see the relative chapter ).
	 -" Graphs   " - It contains four graphics relative to the atomic 
			 radius, the atomic weight, the electronegativity 
			 and the first ionization energy ( see the relative 
			 chapter ).

UTILITY  :
	 -" Calculator " - It enables to activate the calculator ( see the
			   relative chapter ).
	 -" Date       " - It contains the date and the time.
	 -" Tables     " - It contains four tables relative to : isotopes,
			   electronic configurations, ossidation states and
			   contants ( see the relative chapter ).
	 -" Test       " - It enables to activate the test ( see the relative
			   chapter ).

HELP     :
	 -" Info       " - It contains the information about the registration,
			   statics, funcions and kays of the calculator.      
	 -" Index      " - It contains the information about : icons, the bar 
			   menu, the keys and the main functions.
	 -" Error      " - It contains all error messag.

Exit    :
	 -" Yes         " - It enables to go out of the program.

********** THE ICONS ************************************

The program contains 14 icons on the right side of the screen.
To utilize them you have to press the left key of the mouse on the icon that 
you want.

First Icon      : It enables to activate the periodic table.

Second Icon     : It presents the Team who has realized the program.

Third Icon      : It contains the date and the time.

Fourth Icon     : It contains the four graphics relative to the atomic radius,
		  the atom weight, the electronegativity and the first
		  ionization energy.

Fiveth Icon     : It enables to activate the problems.

Sixth Icon      : It enables to activate the test.

Seventh Icon    : It enables to activate the molecular weight.

Eighth Icon     : It enables to activate the calculator.

Nineth Icon     : It enables to activate the pH.

Tenth Icon      : It enables to activate the formulas.

Eleventh Icon   : It enables to activate the tables.

Twelfth Icon    : It enables to activate the atomic graphics.

Thirteenth Icon : It enables to activate the help.

Fourteenth Icon : It enables to end the program.

********** THE KEYS OF RAPID CHOICE *********************

The main functions of the program can be activated with the use of several
combination of keys. The menu of the keys is :

Crtl + A    :  It enables to activate the ATOM.
Crtl + C    :  It enables to activate the CALCULATOR.
Crtl + F    :  It enables to activate the FORMULAS.
Crtl + G    :  It enables to activate the GRAPHS.
Crtl + I    :  It enables to activate the ABOUT.
Crtl + M    :  It enables to activate the MULTIPLE WEIGHT.
Crtl + P    :  It enables to activate the PROBLEMS.
Crtl + Q    :  It enables to activate the TEST.
Crtl + T    :  It enables to activate the PERIODIC TABLE.
Crtl + W    :  It enables to activate the MOLECULAR WEIGHT.
Crtl + X    :  It enables to activate the EXIT.
F1          :  It enables to activate the HELP. 
F2          :  It enables to activate the INFO.
F3          :  It enables to activate the M.I.S.

********** MORE INFORMATION ABOUT ALCHIMI 2.0 ***********

It is easy to use Alchimi 2.0, but there can still be doubts,
afterwards the most important topics of the program, their use, the errors
to avoid and some notes are treated.

- Periodic Table -

The Periodc Table can be activated by the ALCHIMI menu, by the first icon or
with the pression of Ctrl + T keys. It contains 104 boxes, 103 elements and 1
push button with an arrow turner to left, that is useful for coming back to
the principal menu. The different colors of the boxes mean respectively :

		  yellow -> gaseous
		  red    -> solid
		  blue   -> liquid
		  green  -> artificial

To have information about a certain element you must press the correspondent box
with the left key of the mouse ; it will appear a square with these information :
atomic number, name, symbol, atomic weight, density, number of oxidation,
electronegativity, boiling point, melting point, first ionization energy,
atomic radius, type of element, year of discovery and abundance on the Earth.
To finish the visualization of the information you must push the EXIT key.

- Tables -

The menu contains some tables for the consultation :
- isotopes
- oxides
- electronic configuration
- acid and basic constants.

- Help -

The help on line doesn't replace the manual ( this file ), but it enables you 
to have much more information about the program without going out of it.
To have the indispensable information, in the ambit of the program, you must 
see the INDEX where information about icons, the periodic table, formulas,
problems, molecular weight, the pH, ecc.. are contained.
To have information which are not about the program you must see the menu INFO
, that gives you useful news about new versions, registration, ecc.

- Molecular Weight -

The calculus of the molecular weight is activable with the Ctrl + W keys and 
it enables to find the molecular weight of the compounds. To do this, the
program ask for the formula of the compound. The compound must be introduced 
without parenthesis or other symbols, apart from symbols of the elements 
or numbers.
Look the examples :

	HCl             OK
	H2SO4           OK
	H200            OK
	3HCl            OK
	Al2(SO4)3       NO
	Al2SO4SO4       OK

- Multiple Weight -

It is possible to find the molecular weight of many compounds at the same 
time. The opzion multiple weight is activable with Crtl + M or with the 
bar menu. To use it you must introduce the formulas in sequence and then 
you have to push RETURN to calculate. In the end the computer will show you 
all the formulas and their molecular weights.

- Test -

The Test, which is activable with the Crtl + Q, enables you to check your
knowledge of chemistry. You can choose 4 levels of difficulty ( 1 easy -
4 hard ), and 4 levels of lenght ( 5, 10, 15, 20 questions ).
In the end of the test the program will give you a grade.

- Calculator -

The calculator, which is activable with Crtl + C, is a normal calculator that
contains the 4 operations and the trigonometric functions. You can use it with 
the mouse or with the keyboard ( the keys are inserted in the Help ).

- pH -

The calculus of the pH enables you to find the pH of a solution. To do
this the program ask for the normality of the solution ( and for the constant 
if the solution is weak ). 

- Atom -

The Atom graphics can be activated by the GRAPHICS menu, by the twelfth icon 
or with the pression of Ctrl + A keys. They contain 104 boxes, 103 elements and 
1 push button with an arrow turner to left, that is useful for coming back to the
principal menu. The different colors of the boxes mean respectively :

	yellow -> gaseous
	red    -> solid
	blue   -> liquid
	green  -> artificial

To have the graphic of a certain element you must press the correspondent box
with the left button of the mouse ; it will appear a square with these 
information : atomic number, name, symbol, mass number, number of neutrons and
graphic of the atom ( atomic nucleus and electrons ).
To finish the visualization of the information you must push the EXIT key.

- Formulas -

The Formula can be activated by the FORMULAS menu, by the 10th icon or with 
the pression of Crtl + F keys. They contain the formula and the relative 
explanations.

- Problems -

The Problems can be activated by the PROBLEMS menu, by the 4th icon or with
the pression of Crtl + P keys. To calculate a variable is necessary to insert
the value of the other variables and to press F1. To end you have to press F2.

********** MORE INFORMATION ABOUT THE CALCULATOR ******* 

  +  :  Addition.
  -  :  Subtraction.
  *  :  Multiplication.
  /  :  Division.
  =  :  Equal.
 < :  It deletes the last input numeral.
 Ce  :  It deletes the last input number.
 C   :  It deletes the last input number and the last operation.
 Log :  It returns the decimal logarithm of the argoment.
 Ln  :  It returns the natural logarithm of the argoment.
 Sin :  It returns the sine of the argoment.
 Cos :  It returns the cosine of the argoment.
 Tan :  It returns the tangent of the argument.
 X  :  It returns the square of the argument.
 X  :  It returns the root square of the argument.
 Exp :  It returns the exponential function of the argument.
  %  :  It returns the per cent of the argument.
 X!  :  It returns the factorial of the argument.
 Mem :  It stores the argument in memory.
 Sto :  It returns the stored argument.
 Off :  Exit from the calculator.

********** CALCULATOR KEYS ***************************** 

Key(s)                  Calculator Function

0..9            :   0..9
+, -, *, /      :   +, -, *, /
 Return         :   =
 s or S         :   Sin
 c or C         :   Cos
 t or T         :   Tan
 l              :   Ln
 L              :   Log
 r or R         :   X
 q or Q         :   X
 i or I         :   Int
 e or E         :   Exp
 M              :   Mem
 m              :   Sto
 f or F         :   1/X
 !              :   X!
 %              :   %
 x or X         :   -X
 BackSpace      :   <
 BarSpace       :   Ce
 Del            :   C
 Esc            :   Off

-----------------------------------------------------------------------------
         
                       C H A P T E R     4                           
         


********** ALCHIMI 2.0 A FEW STATICS *******************

Four months of hard work, the talent of a programmer, a grafics artist and
two translators.

Over 2000 lines of Turbo Pascal,
over  700 lines of Assembly,
over   76 Kb of Compressed Graphics,
over   16 Kb of Compressed Datas,
over    7 Kb of Help On-Line and
over   20 Kb of Documentation.

********** DEMO VERSION ********************************

The demo version has two limitation : 

	- the program goes out automatical after some minuts
	  ( from 10 to 30 minuts ).

	- some functions are disabled.

********** THANKS **************************************

- TEDESCHI MICHELE   : - For the ideation of the program.
		       - For the help.
		       - For the manual.

- DAVI' ENZO         : - For giving me the ispiration of all graphics routine.

- ZANGHERATTI MONIA  : - For the manual.
		   
- TEDESCHI ANTONELLA : - For the help.

- SANTATO RICCARDO   : - For the testing.

					THANKS.
						Tamascelli Stefano

********** COPYRIGHT ***********************************

Alchimi version 2.0a Basic
(C) Copyright MagicSoft Informatic Team 1994 (R) All Right Reserved.

The mark Borland Turbo Pascal 7.0 copyright Borland International
The mark MS-DOS copyright MicroSoft Corporation
The mark AMIGA copyright ESCOM

********** SHAREWARE ***********************************

The demo version of the program can be distributed liberally. After
30 days ( 1 month ) the user must decide if the program is used regularly and 
then the user must register.
The program registered, that contains a number of registration, is personal
and it can't be duplicated liberally.
With the Shareware the user can see the program before to buy it, he can use 
it for a certain period of time and, if he wants, he can decide to register.
The registering is very advantageous for the user because he can with a small 
price : buy the programs that he tests, receive possible adjournaments gratis
and have an assistence for 90 days.

For information :  Tamascelli Stefano
		   via Roma 833
		   45020 Zelo ( ROVIGO )
		   ITALY

*****************************************************************************
*                                                                           *
*       PLEASE WRITE FOR BUGS, SUGGESTIONS OR FOR ANY INFORMATION           *
*                                                                           *
*****************************************************************************
