      *****************************************************************
      *                                                               *
      *                C M A T H  for  Lazarus / FreePascal           *
      *                                                               *
      *                         Demo Version 8                        *
      *****************************************************************

Contents
    1. Introduction
    2. System requirements
    3. Installation
    4. Running the example
    5. Documentation
    6. What's New?
    7. Copyright
    8. Registered Version

1. Introduction
---------------
CMATH is a comprehensive library for complex-number arithmetics and mathematics.
Superior speed, accuracy and safety are achieved through the implementation
in machine code (as opposed to compiled Pascal or C source code).

Each floating-point accuracy (Single and Double) is given its own, 
optimized version of each function.


2. System requirements
----------------------
This version of CMATH for Lazarus / FreePascal is for x64-based Windows
systems. While cross-platform support is perhaps the greatest strength 
of Lazarus, a machine-code written add-on library has to be specific for
one processor family and Operating System. Therefore, other platforms
than Intel / AMD-based Windows64 are not supported at this time.
                      
If you need versions for other compilers, please visit 
https://www.optivec.com/download 

At present, CMath is available for the following target compilers:
Windows:
- C++ Builder  (Embarcadero RAD Studio; formerly Borland C++)
- Microsoft Visual C++
- GCC, the GNU Compiler Collection
- LLVM Clang
- Delphi (Embarcadero RAD Studio)
- Lazarus / FreePascal
Linux:
- GCC or CLang



3. Installation
---------------
a) To install, you need to have administrator privileges.

b) To install the Demo version of CMATH, you need to execute INSTALL.EXE,
   contained in the ZIP file you downloaded. Only then, programs using the
   CMATH library can run. It is not possible to just copy the files, e.g., 
   from another computer.

c) If you wish to install CMATH for different versions of Lazarus, you must 
   choose different directories.
   
d) Windows has a habit of sometimes warning users after the installation
   of third-party products: "Setup possibly incomplete". If INSTALL.EXE
   did finish and displayed this README.TXT file, you know that the
   installation is complete.

e) After you completed the installation, you must set the Units search path
   according to your CMATH directory choice.
   To this end, open the menu
   "Project / Project Settings" or hit [Shift][Ctrl][F11] in the Lazarus IDE.

   Say, your CMATH directory is C:\CMATH. Then, your units search path is
   C:\CMATH\LIB8
   
   Add this path into the line "Compiler Settings / Other Units".
   (Remember: a semicolon is used to separate entries in these fields.)

   You must do so for every project for which you wish to use CMATH
   functions.


4. Running the Example
----------------------
Check your installation by compiling and running the small demo programs:

CDEMO.lpi  checks the basic installation.
MANDEL.lpi shows a simple way to code a modified-Mandelbrodt graph.


5. Documentation
----------------
The full CMATH documentation is to be found in the file CMATH.HTM
to be read with a browser like Firefox, IE, Edge, Chrome, Opera, etc.


6. What's New?
--------------
Version 8.4.x:
  - 64-bit:
    - Faster implementation of most transcendental functions

	- Switch to Lazarus 4.2
	
	- bug fix in pf_powRe

For information on previous versions, see VersionHistory.txt.


7. Copyright
------------
The copyright owner of this product as a whole and of all its constituent
parts is
         OptiCode
         Dr. Martin Sander Software Development
         Brahmsstr. 6
         D-32756 Detmold
         Germany
         e-mail: optivec@gmx.de
         https://www.optivec.com

This Demo version of CMATH is freely distributable in unchanged form.
For the distribution of applications created using CMATH, you need the
registered version. The detailed licence conditions are described in
chapter 1.2 of the file CMATH.TXT.


8. Registered Version
---------------------
If you like CMATH and decide to use it, please be fair and register.

The cost is:
                                 single-compiler        master licence for all
                                   licence               supported compilers         
      commercial licence         EUR  59.00                 EUR 89.00
      educational licence        EUR  29.00                 EUR 49.00

The above prices include 19% German VAT.
If you are ordering from outside the EU, or if you have a European VAT ID,
you are exempt from German VAT, and it will be deduced from your bill,
but you may have to pay your local VAT and/or import duties according to
local laws.

See https://www.optivec.com/order  for ordering options and volume discounts.     


    * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *

Copyright (C) OptiCode - Dr. Martin Sander Software Dev. 1996-2025
