ChemApp "light" README
Notes on the usage of ChemApp light with Borland C++ Builder®

These release notes contain information on

  1. how to install ChemApp,
  2. how to use ChemApp light with Borland C++ Builder,
  3. what example programs and example data-files are available,
  4. notes for users of ChemSage V3.x,
  5. how to sign up for e-mail support,
  6. how to report a problem or bug,
  7. how to join our GTT-News newsletter mailing list,
  8. and how to contact us.

Please read this file and the file c-notes.txt and license.txt before using ChemApp, and feel free to contact us any time if you need any further information.

You should also take a look at the ChemApp FAQ, which is at FAQ. It answers a lot of standard questions about ChemApp and ChemApp light and should especially be consulted before contacting our support.

Another must read for ChemApp developers is the chapter ChemApp best practises in the ChemApp Programmer's Manual (added for Edition 3.6). Before you contact our support with specific questions relating to your code, please make sure your code implements the ChemApp best practises.

  1. To install your version of ChemApp light, simply run the setup program. In case you downloaded ChemApp light from our web site, the setup program might be zipped. In this case, unzip the ZIP file to a temporary directory and execute the resulting setup program.

    A corresponding un-installation program will also be set up, in case you want to remove ChemApp light again later.

    The installation program creates a directory tree for ChemApp light containing all necessary files: The ChemApp library itself, various text and HTML files, the example programs and application notes for the languages supported by this distribution, and the example data-files.

    This distribution does NOT include the documentation for ChemApp light. The documentation for ChemApp light comes as a set of HTML files to be viewed with your web browser, and is available for download in a separate archive, also from the ChemApp light web page.

    The installation program will put the ChemApp DLL(s) not only in the user-defined directory you specify during installation, but also into the Windows system directory, in order to make it available to your applications during compile- and run-time.

  2. This version of ChemApp light has been compiled into a single-threaded 32bit DLL for use with Borland C++ Builder under Windows 95, Windows 98, Windows ME, Windows NT, Windows 2000, and Windows XP®.

    To successfully compile a C/C++ application program that uses ChemApp,

    • all C/C++ source files which call ChemApp routines must include the header file cacint.h,

    • your project must include the ChemApp-C/C++ interface routines cacint.c,

    • your project must link your application program against ca_bcb_l.lib.

    • and last but not least, the actual ChemApp DLL ca_bcb_l.dll must be accessible during run-time.

    When working under the C++ Builder IDE, you should thus do the following to build the example program (cademo1) supplied with ChemApp (this procedure has been tested and verified under Borland C++ Builder V5):

    • In the C++ Builder IDE, choose "New" from the "File"-Menu, or choose "New Project" from the popup menu for your ProjectGroup in the Project Manager.

      Click the icon "Console Wizard" and apply the following changes in the dialog that appears:

      • Choose Source Type "C",
      • uncheck "Multi Threaded",
      • check "Console Application",
      • check "Specify project source" and select (press the button to the right of the edit line) the file cademo1.c from your project directory.

    • Save your project by selecting it in the Project Manager, clicking with the right mouse button and choosing "Save" from the popup menu. In the "Save project" dialog change to your project directory and choose a name for the project file, for instance ca_test.bpr.

      NOTE: We strongly recommend that you choose a project name different from the project directory name, otherwise the linker might produce an error.

    • Now add more files to your project by choosing "Add" from the popup menu. For example choose file type "C file (*.c)" and open "cacint.c" from your project directory. Choose file type "Library file (*.lib) and add "ca_bcb_l.lib". For the example program, the content of your project should now look like this:
               |- cacint.c
               |- cademo1.c
               |- ca_bcb_l.lib
               |- ca_test.bpf

    • Now choose "Build" from the popup menu. The project should now compile and link.

    • Now you are ready to run the program. Note that only the example programs supplied with ChemApp and the ChemApp documentation need to be run as Win32 console applications. For your own programs, you are free to choose any of the other available targets too.

  3. A program named cademo1 is included with the distribution archive that demonstrates the use of each of the ChemApp functions. You can also use it to verify that you are compiling and linking correctly. When running the compiled program, compare its results with the results in the file cademo1.rst. They should be identical, except for formatting issues.

    The online documentation for ChemApp light, available from our web page, contains many more example codes.

    Apart from the thermochemical files cosi.dat (system C-O-Si) and subl-ex.dat (simplified system Co-Cr-Fe), which are used by the example program cademo1, this distribution also contains several other thermochemical data-files. Check the subdirectory dat for these data-files, and the ChemApp light documentation for details.

  4. Note for users of ChemSage V3.x: If you are still using ChemSage V3.x and would like to continue using your existing thermochemical data-files with ChemApp, you will need to convert them to the ChemSage 4.x/ChemApp format with a program called ChemFile. This program can be obtained from GTT-Technologies upon request, in case it is not included in this distribution of ChemApp. Note that users of ChemSage V4.x, FactSage, and earlier versions of ChemApp do not need to convert their data-files.

  5. To receive limited e-mail support for ChemApp light, please register your copy of ChemApp light. Registration is free and can be done in any of the following ways:

  6. We have installed a bug tracking system for ChemApp that allows us to handle bug and problem reports in a quick and flexible fashion. If you have a programming problem with ChemApp that you suspect might be a bug, please use the Bug Report Form at

    Bug Report Form

    There is also a link to this page from the ChemApp web page.

    If you don't have access to the World Wide Web, you can submit your bug reports by e-mail to We prefer the submission of bug reports via the web page though, since filling in the Bug Report Form makes sure we have important information like the ChemApp version number etc. we need to reproduce your problem already.

    If you have any other general or support questions about ChemApp, there is always our support e-mail address:

  7. Join our GTT-News newsletter mailing list: This newsletter is distributed mainly electronically by e-mail, and also posted to our web site ( It contains announcements of new versions of our various software programs, information on new features and enhancements, ongoing projects, new thermochemical data, additions to our web site, seminars, publications, and various other topics. To join, check the GTT-News section on our web site for instructions, or send an e-mail to with the line
    in the mail body.

  8. An up-to-date source of information on ChemApp, its applications, and related topics is "GTT's Technical Thermochemistry Web Page":

    We would like to include a brief description of your projects involving ChemApp on this World Wide Web page too. Please contact Dr. Stephan Petersen ( for details.

C++ Builder is a registered trademark of Borland.
Microsoft Windows, Windows 95, Windows 98, Windows NT, Windows ME, Windows 2000, and Windows XP are registered trademarks of Microsoft Corp.

If you have any problems or questions regarding ChemApp, please contact:

  Kaiserstrasse 100
  52134 Herzogenrath

Phone: +49-2407-59533 Fax: +49-2407-59661 E-mail: WWW:

GTT-Technologies, 5 June 2003

Copyright (C) GTT-Technologies 1996-2003, Herzogenrath, Germany


| Home | Software | Downloads | bcb.light.readme [TOP]