Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Updated AUTHORS and build instructions for Linux/Unix #28

Merged
merged 1 commit into from
May 31, 2011
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
17 changes: 11 additions & 6 deletions AUTHORS
Original file line number Diff line number Diff line change
@@ -1,8 +1,13 @@
OCE 0.1 contains additional code over OCC contributed by (alphabetical sort):
OCE contains additional code over OCC contributed by (alphabetical sort):

Guillaume Alleon ([email protected])
Denis Barbier ([email protected])
QbProg ([email protected])
Thomas Paviot ([email protected])
Mark Pictor ([email protected])
Guillaume Alleon (guillaume.alleon at gmail dot com)
Denis Barbier (bouzim at gmail dot com)
fohlenrolle (mmuellen at gmx dot de)
QbProg (tholag at gmail dot com)
Thomas Paviot (tpaviot at gmail dot com)
Mark Pictor (mpictor at gmail dot com)
Jérôme Robert (jrobert dot pro at gmail dot com)
Fotis Sioutis (sfotis at gmail dot com)
Hugh Sorby ()

Copyright 2011
69 changes: 12 additions & 57 deletions INSTALL → INSTALL.Unix
Original file line number Diff line number Diff line change
@@ -1,25 +1,21 @@
On Windows, Visual and Borland projects are provided, see in the
adm subdirectory. Please note that these projects will be
deprecated in favor of CMake, in order to have a single build
procedure for all architectures. Please help us by testing the
CMake procedure.
This file describes how to build OCE from sources on Linux or MacOSX.

Since the OCE release 0.3, the dev team definitely dropped the autotools
support and adopted the CMake build system. First ensure you have installed
CMake 2.6 or higher (http://www.cmake.org) before going further in the
compilation process.

The installation procedure detailed below is:
1. Download/extract the OCE-xxxxx.tar.gz archive to any directory
2. Configure
3. make/make install
4. Test installation

This file describes how to build OCE from sources on Linux or MacOSX.
At the end of this file, there are instructions to configure this
project with Autotools, but note that this build system may not be
supported in future releases.

1. Content extraction
=====================

Unpack OCE-xxxx.tar.gz to some folder - ${DISTRIBUTIVE_DIR}.
For example DISTRIBUTIVE_DIR=/tmp/OCE-0.2
For example DISTRIBUTIVE_DIR=/tmp/OCE-0.3
tar -zxvf OCE-xxxx.tar.gz
then
cd ${DISTRIBUTIVE_DIR}
Expand All @@ -46,11 +42,11 @@ rerun cmake after modifying this file.
==================

Here are default flags on Unix
OCE_64BIT ON (default depends on CPU)
OCE_BUILD_SHARED_LIB ON
OCE_BUILD_TYPE Release
OCE_DATAEXCHANGE ON
OCE_DRAW OFF
OCE_EXTRA_WARNINGS OFF
OCE_INSTALL_PREFIX /usr/local
OCE_MODEL ON
OCE_MULTITHREAD_LIBRARY NONE
Expand Down Expand Up @@ -97,6 +93,10 @@ by running the following commands:
make
make install/strip

If you have more than one (for instance 2) cores on your machine, you can use
make -j2
to enable multiprocessed compilation and speedup the whole compilation
process.

4. Test installation: OCE Draw Test Harness
===========================================
Expand All @@ -110,48 +110,3 @@ In order to load DRAW commands, you can then run demos
> source $INSTALL_DIR/src/DrawResources/VisualizationDemo.tcl

Installation is succesful. Enjoy!

Appendix. Old build system based on Autotools
=============================================
This build system uses scripts based on GNU autoconf, automake and libtool,
make sure to install these tools before compiling.

A. Configure step
=================
The configure script must be executed with the flags as described below.

A.1 Defining flags
==================
flags=""
flags="$flags --with-tcl=${TCLHOME}/lib"
flags="$flags --with-tk=${TCLHOME}/lib "
flags="$flags --with-freetype=/opt/freetype-2.3.7"
flags="$flags --with-ftgl=/opt/ftgl-2.1.3-rc5"
flags="$flags --disable-debug --enable-production"

where:
--enable-debug=yes/no - building in debug mode (yes: set -g compiler flag).
--enable-production=yes/no - building in optimize mode. (yes: set -O compiler flag).

A.2 FTGL note:
==============
OCE supports either ftgl-2.1.2 or the latest ftgl-2.1.3-rc5. If you wish to
build OCE over ftgl-2.1.2, use the configure flag '--with-ftgl212'.
For instance,
flags="$flags --with-ftg212=/opt/ftgl-2.1.2"
The '--with-ftgl' flag assumes you use a newer version.

A.3 Additional flags:
=====================
flags="$flags --with-tbb-include =/usr/include/tbb" - for compilation with tbb
flags="$flags --with-tbb-library=/usr/lib" - for compilation with tbb
flags="$flags --with-gl2ps=/opt/gl2ps-1.3.5" - for compilation with gl2ps
flags="$flags --with-freeimage=/opt/freeimage-3.14.1" - for compil with freeimage

A.4 Running ./configure
=======================

./configure $flags --prefix=${INSTALL_DIR}

where ${INSTALL_DIR} is folder to which OCE will be installed.