Recreating the Configure Script
-------------------------------

If you need to recreate the configure script, run the bootstrap
script found in the top level directory.  This script will run the
appropriate "auto" tool-chain commands.  Note that this is only
necessary if you modify lower level files such as configure.ac.

If you are building Tovero from the repository source code rather than
a distribution tarball, to build the tutorial you may first have to
configure Tovero without the tutorial using:

  ./configure --disable-tutorial --with-brlcad-install-path=<path-to-BRL-CAD>

Then build and install Tovero.  This will install tovero_ruby which is
needed for recreating the images for the tutorial.  You will have to
configure Tovero with:

  ./configure --with-brlcad-install-path=<path-to-BRL-CAD>

Then build and install Tovero to create the tutorial.


Configure Script Options for Development
----------------------------------------

You can use the following options with the configure script during
development:

  ./configure --enable-debug


Running Tovero Ruby Models
--------------------------

The script tovero_ruby is provided to setup an environment for BRL-CAD
and run a model.  For example, after installing Tovero, running:

  tovero_ruby ./src/tovero/graphics/models/tovero.rb

will run and render the Tovero logo model.

Have a look at this script if you want to see what required to setup
for running a Tovero Ruby program.


Compiling Custom Applications using pkg-config
----------------------------------------------

Building Tovero creates three shared libraries with corresponding
pkg-config ".pc" files.  Your application make use of these libraries
with the pkg-config tool.  The names of the libraries to supply to
pkg-config are currently:

  libtovero_support_1
  libtovero_math_1
  libtovero_graphics_1

For example to get compiler flags for use with your application, use:

  pkg-config --cflags libtovero_support_1 libtovero_math_1 libtovero_graphics_1

See the pkg-config documentation for further details.

Note that since the Tovero graphics module uses BRL-CAD libraries, you
should adjust the PKG_CONFIG_PATH environment variable before using
pkg-config.  For example, if your BRL-CAD installation is in
/usr/brlcad, use:

  export PKG_CONFIG_PATH="${PKG_CONFIG_PATH}:/usr/brlcad/lib/pkgconfig"

to properly set up for pkg-config.

The script compile_tovero_graphics_cpp in src/tovero/graphics
demonstrates a simple example of how to compile and link a Tovero C++
program (with shared libraries).  Before you run your compiled
program, make sure you setup your system to find the Tovero and
BRL-CAD libraries, for example using the LD_LIBRARY_PATH environment
variable.

----

Copyright 2011-2014 Roan Trail, Inc.

This file is part of Tovero.

Tovero is free software; you can redistribute it and/or modify it
under the terms of the GNU Lesser General Public License
version 2.1 as published by the Free Software Foundation.

Tovero is distributed in the hope that it will be useful, but WITHOUT
ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public
License for more details.  You should have received a copy of the GNU
Lesser General Public License along with Tovero. If not, see
<http://www.gnu.org/licenses/>.
