BIAC XML header tools README

Syam Gadde (gadde@biac.duke.edu), June 2003

=========
COMPILING
=========

To compile the programs in this directory, you will need some
subset of the following libraries installed:
	gdome2 (DOM implementation in C)
	glib (required by gdome2)
	libxml2
	libz
	libiconv
	libintl/gettext
Additional support for BIRN XML files requires:
	libxslt
Alternatively, experimental support using:
	xerces-C
	Pathan
instead of libxml2/gdome2 is also available, but depends on some
bug fixes that aren't yet in the current distributions of xerces-C
or Pathan.  Contact Syam Gadde <gadde@biac.duke.edu> to get these
patches and instructions on how to build with xerces-C/Pathan.

Compiling on Linux/UNIX systems
-------------------------------

See the README file.

Compiling on Windows
--------------------

Compiling on Windows is quite involved, partly due to the need
to compile gdome2, which has no native Windows binary distribution.
However, we have provided a binary distribution at the location
below for your convenience.  These instructions are by no means
complete, and may be incorrect.

You will also require CMake version 2.0 or later
(available from http://www.cmake.org/).

Recent versions of these libraries are required:
  gdome2             -- http://gdome2.cs.unibo.it/
  libiconv, libintl  -- http://gettext.sourceforge.net/
  glib               -- http://www.gimp.org/~tml/gimp/win32/
  libxml2            -- http://www.zlatkovic.com/projects/libxml/
  zlib               -- http://www.gzip.org/zlib/

For DICOM support, you will also need to compile and install the DCMTK
libraries from
	http://dicom.offis.de/dcmtk.php.en
The BIAC XML header tools assume that DCMTK is installed the same way
it is on UNIX:
	dicom
	dicom/lib
	dicom/lib/dcmdata.lib
	dicom/lib/ofstd.lib
	...
	dicom/include/dcmdata/cmdlnarg.h
	dicom/include/dcmdata/dcdatset.h
	...
	dicom/include/ofstd/ofalgo.h
	dicom/include/ofstd/ofbmanip.h
	...
If you are not compiling DCMTK with zlib support, comment out the
line in CMakeLists.txt that includes $(ZLIB_LIB) (there is a comment
at the right place).

All the above libraries and include files are available compiled
for Windows (using Visual Studio 7 (.NET 2003) with the Multi-threaded
DLL runtime flag /MD) at:
	http://www.biac.duke.edu/home/gadde/xmlheader-support-win32.zip

Before compiling, run CMake and point it to the BIAC XML header tools
win32 directory.  Click the "Configure" button, and fill in the fields
to point to the correct paths.  If you have downloaded the binary
libraries above (or installed everything into the same directory
with a installed/include, installed/lib structure), set the GENERIC_PATH
field first to the "installed" directory, and hit "Configure" again to
let CMake search through that directory for required include files and
libraries.  If any paths are missing, you will have to specify them
individually.  When all the paths have been specified, click "OK" to
generate your project files.  Now open the xmlheader project file and
compile.
(Only tested with Visual Studio 7.)

