Building Demeter
Building with Visual C++
Workspace
Demeter includes a workspace for Visual Studio 6 in the \VisualStudio directory of the
distribution. All of the sample applications require both the sample data, available to download as
DemeterSampleData.zip, and SDL.
As explained in the “Project Architecture” section of this site, Demeter is divided into the core library itself
and a few optional “Loaders.” In the Visual Studio workspace, the core library is a project called “Demeter.” The
loaders are projects called “DemeterElevationLoader”, “DemeterTextureLoader”, “GDALElevationLoader”, and “SDLTextureLoader.”
In addition to each of these projects, the distribution also includes an optional library for using Demeter with
OpenSceneGraph called “DemeterOSG” and several sample projects. Each of these projects is described in detail
below.
All Demeter components are built as DLL’s. All final binaries (DLL’s for Demeter components and EXE’s for the
sample applications) are emitted to the \bin folder of the distribution. All import libraries are emitted to the
\lib folder of the distribution. All source for Demeter components are in the \src folder. All source for the
sample applications is in the \samples folder. Notice that all Demeter components are linked against the
“Multithreaded-DLL” Visual C Runtime Library. Your applications MUST also use this version of the runtime in
order to use Demeter components.
If you do not care about the optional loaders, OSG support, or the sample applications, then you can simply build
the Demeter project. This will create \bin\Demeter.dll (or DemeterDebug.dll
for the Debug configuration) and \lib\Demeter.lib. Link your application with this library
to use Demeter.
All of the rest of the projects in the workspace require some of the 3rd party libraries described in the
“Dependencies” section of this site. If you have satisfied all of the dependencies then simply do a “Batch Build”
and build all of the projects in the workspace. You may then run any of the sample applications in
\bin.
Building in Unix
For building on Unix-like systems, Demeter uses a standard Makefile. The easiest way to build is to follow these steps:
- run 'make'
- run 'make install' WITH SUPERUSER ACCESS
- run 'make optional'
- run 'make install' WITH SUPERUSER ACCESS AGAIN!
- switch to the bin subdirectory
- run any of the sample apps
Demeter’s Makefile will attempt to autodetect whether or not your system has 3rd party dependencies such as SDL
and GDAL installed, but if you know you do not have the 3rd party libraries described in the “Dependencies” section
of this site, then you can stop after step 2 of the above process to build only the Demeter core library itself.
All of the sample applications require both the sample data, available to download as
DemeterSampleData.zip, and SDL.