Equalizer
1.11.0
Parallel Rendering Framework
|
Welcome to Equalizer, the standard middleware to create and deploy parallel, scalable OpenGL applications. It enables applications to benefit from multiple graphics cards, processors and computers to scale the rendering performance, visual quality and display size. An Equalizer application runs unmodified on any visualization system, from a simple workstation to large scale graphics clusters, multi-GPU workstations and Virtual Reality installations.
The Equalizer Programming and User Guide covers the basics of Equalizer programming. The API documentation can be found on github.
As with any open source project, the available source code, in particular the shipped examples provide a reference for developing or porting applications.
Technical questions can be posted to the eq-dev Mailing List, or directly to info@. equa lizer grap hics. com
Commercial support, custom software development and porting services are available from Eyescale. Please contact info@eyescale.ch for further information.
Equalizer provides the following major features to facilitate the development and deployment of scalable OpenGL applications. A detailed feature list can be found on the Equalizer website. The change log lists features, improvements and bug fixes introduced in each version.
Please refer to the github issue tracker for fixed and open bugs, and to report new bugs.
Equalizer is a cross-platform library, designed to run on any modern operating system, including all Unix variants and the Windows operating system. Equalizer requires at least OpenGL 1.1, but uses newer OpenGL features when available. Equalizer uses CMake to create a platform-specific build environment. The following platforms and build environments are tested:
git clone https://github.com/Eyescale/Equalizer.git mkdir Equalizer/build cd Equalizer/build cmake .. make
In case of errors, remove all traces of previously installed dependencies, as cmake will not check if they are new enough and the build may fail:
rm -rf /usr/include/{eq,co,triply,seq,hwsd,pression,lunchbox} rm -rf /usr/share/{Collage,hwsd,Pression,Lunchbox} rm -rf /usr/lib/lib{triply*,Sequel*,Equalizer*,Collage*,hwsd*,Pression*,Lunchbox*} rm -rf Equalizer
Using "git pull" to update Equalizer later is not enough, as it does not update externals and subprojects. Use the 'make rebase' target to update these, or if your cmake run fails CMake/common use "git clean -ffdx" to remove them all and let cmake re-clone them.
If CMake
and git
are in PATH, run the following batch script to build using Visual Studio 2013:
build.bat
If your build fails with a Could NOT find Boost
message, you may have a bad environment setup for Boost
and CMake
. To remedy this, CMake
requires you to properly hint it to find your Boost
distribution. Make sure you have the following variables set up:
BOOST_ROOT
pointing to your Boost root directory.BOOST_INCLUDEDIR
pointing to your Boost includes (usually where BOOST_ROOT
points to).BOOST_LIBRARYDIR
pointing to your Boost binary directory (lib32-msvc-12.0
for instance).Boost_ADDITIONAL_VERSIONS
having major, minor, and patch versions (separated by space).Boost_USE_STATIC_LIBS
set to ON
if you want to statically link to Boost
. (default is OFF
)Boost_USE_MULTITHREAD
set to ON
if you want to use Boost
multi-threaded libraries. (default is ON
)An example set up would be (typed in Windows command prompt):