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.


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_0
  libtovero_math_0
  libtovero_graphics_0

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

  pkg-config --cflags libtovero_support_0 libtovero_math_0 libtovero_graphics_0

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-2013 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/>.
