INSTALL DRAWTIMING


ABOUT SAMPLES DOWNLOAD INSTALL USAGE

PORTABILITY

This software has been tested on FreeBSD, Linux, and Cygwin.

PREREQUISITES

You need some software to build drawtiming:

  • a tape archiver such as GNU tar.
  • a C++ compiler such as found in the GNU Compiler Collection
  • a make utility such as GNU make.
  • the development and runtime packages for ImageMagick.  Drawtiming uses the Magick++ API to render and output images.
  • ghostscript.  This is an unexpected runtime dependency. It appears that ImageMagick requires fonts from ghostscript in at least some circumstances.

EXTRACT SOURCES

Download the latest source package and extract it with GNU tar.  Assuming the latest release is 0.x:

tar -xzf drawtiming-0.x.tar.gz

CONFIGURE

Change directories to the newly extracted source directory and run configure to customize the package to your build environment: 

cd drawtiming-0.x
./configure

On FreeBSD, you may need to provide some environment variables when you run configure to get long command-line options to work:

CPPFLAGS=-I/usr/local/include LDFLAGS=-L/usr/local/lib ./configure

These directions assume you are compiling a source package downloaded from SourceForge.  If you are compiling from a CVS snapshot, you will need to generate the configure script with GNU autotools before running configure.

BUILD

Once configured, the package needs to be compiled:

make

INSTALL

You will need superuser privileges to install the application and man page in the default location, under /usr/local:

make install

TEST

You can test drawtiming by running "make check" and comparing the samples generated with images from the samples page from this website. Comparing the md5 for images from different runtime environments does not work unfortunately, so a visual inspection is necessary.

make check