ChartDirector Ver 3.0 (C++ Edition)
Installation
Windows Installation
This section describes how to install ChartDirector for C++ under Windows.
For the Linux, FreeBSD or Solaris version, please refer to
Linux/FreeBSD/Solaris Installation.
Installing ChartDirector for C++ on Windows
ChartDirector for C++ on Windows is distributed as a zip file. To install
ChartDirector, simply unzip the ChartDirector distribution in your preferred
installation directory.
Running ChartDirector Sample Programs on Windows
ChartDirector comes with a number of sample C++ projects under the "ChartDirector\cppdemo" directory,
together with project files for Microsoft VC++.
If you are using Microsoft VC++, simply double click on "ChartDirector\cppdemo\cppdemo.dsw". You
may then try to compile the projects to verify that ChartDirector is installed correctly.
If you are using other compilers, please refer to the following section on how to set up the
development environment to use ChartDirector.
Using ChartDirector in Your Projects on Windows
When you develop a project using ChartDirector, the development environment should be configured
appropriately so that it can find the proper header files and link to the proper library files.
- All C++ modules that use ChartDirector need to include the file "chartdir.h". The "chartdir.h"
will in turn include more header files. All these files are located in the "ChartDirector\include"
subdirectory. The development environment header file search path must be configured to include
that directory.
If you are using Microsoft VC++, the steps to do this are:
- Go to the menu Project/Settings.
- Click on the C/C++ tab.
- In the "Category" list box, select "Preprocessor"
- In the "Additional include directories" field, enter path of the ChartDirector "ChartDirector\include"
subdirectory.
- After compilation, the object file needs to link with "chartdir30.lib", located in "ChartDirector\lib".
If you are using Microsoft VC++, the steps to do this are:
- Go to the menu Project/Settings.
- Click on the Link tab.
- In the "Object/library modules" field, add the path name for "ChartDirector\lib\chartdir30.lib".
- When the executable runs, it needs to be able to find the "chartdir30.dll". That means you need
to copy the "chartdir30.dll" to the same directory where the executable runs, or you need to copy it
to a directory in the operating system search path (eg. [system32]).
Installing the ChartDirector License on Windows
If you have purchased a license to use ChartDirector, you should have a license code delivered
to you via email and postal mail.
To install the license code, follow the steps below:
- Save the license code in an ASCII text file, and name the file "chartdir.lic".
The ASCII text file should contain just one line, which is the license code. A
sample license file is available at
http://www.advsofteng.com/chartdir.lic
for your reference.
- Put the license file in the same directory as "chartdir30.dll".
Linux/FreeBSD/Solaris Installation
This section describes how to install ChartDirector for C++ under Linux/FreeBSD/Solaris.
For the Windows version, please refer to
Windows Installation.
Installing ChartDirector for C++ on Linux/FreeBSD/Solaris
ChartDirector for C++ on Linux/FreeBSD/Solaris is distributed as a tar.gz file.
To install ChartDirector:
Running ChartDirector Sample Programs on Linux/FreeBSD/Solaris
ChartDirector comes with a number of sample C++ programs with associated make
files. These are located under in "ChartDirector/cppdemo".
To compile those samples programs, simply change to the subdirectory of the
sample program, then enter "make". This will make an executable. You can then
run the executable and it will produce chart images in the subdirectory.
Note that the make files are based on the g++ (gcc) compiler. You may need to
modify the make files if you are using other brands of compilers.
Using ChartDirector in Your Projects on Linux/FreeBSD/Solaris
When you develop a project using ChartDirector, the development environment
should be configured appropriately so that it can find the proper header files
and link to the proper library files.
Important Note For Solaris User Using g++/gcc
In Solaris, some compilers (such as g++/gcc) requires an assembler (as) and
linker (ld) to produce executable code. Solaris comes standard with as/ld in
"/usr/ccs/bin". If you do not find as/ld in "/usr/ccs/bin", please install it
from the Solaris CD.
There is an alternative as/ld distributed in the GNU binutils package. The
GNU as/ld is incompatible with the Solaris as/ld.
ChartDirector is compiled using the Solaris as/ld. When developing software
using ChartDirector, please use the Solaris as/ld, not the GNU as/ld. The
GNU as/ld may crash, or the it may produce code that crashes.
If you have installed the GNU binutils package, by default, the gcc compiler
will use the GNU as/ld instead of the Solaris as/ld. In this case, please
uninstall the GNU binutils, or add the flag "-B/usr/ccs/bin/" in your compile
and link statements to tell gcc to use the Solaris as/ld. Simply setting the
"path" variable to search for "/usr/ccs/bin" first is not sufficient. The
"-B/usr/ccs/bin/" flag must be used.
|
Installing the ChartDirector License on Linux/FreeBSD/Solaris
If you have purchased a license to use ChartDirector, you should have a license
code delivered to you via email and postal mail.
To install the license code, follow the steps below:
- Save the license code in an ASCII text file, and name the file "chartdir.lic".
The ASCII text file should contain just one line, which is the license code. A
sample license file is available at
http://www.advsofteng.com/chartdir.lic
for your reference.
- Put the license file in the same directory as "libchartdir.so.3.a.b" (where a and b are
minor version numbers).
© 2003 Advanced Software Engineering Limited. All rights reserved.