Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Fetching contributors…

Cannot retrieve contributors at this time

file 228 lines (183 sloc) 8.088 kb
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228
     * 1. Introduction
          * 1.1. Features
     * 2. New in this release
          * 2.1. New Features
          * 2.2. Enhancements
          * 2.3. Optimizations
          * 2.4. Examples
          * 2.5. Tools
          * 2.6. API Changes
          * 2.7. Documentation
          * 2.8. Bug Fixes
          * 2.9. Known Bugs
     * 3. About
          * 3.1. Operating System Support
          * 3.2. Window System Support
          * 3.3. Documentation
          * 3.4. Support
     * 4. Errata

1. Introduction

   Welcome to Equalizer, the standard middleware to create and
   deploy parallel, scalable OpenGL applications. This release
   TBD

   Equalizer 1.2 is a feature release extending the 1.0 API,
   distilling over 6 years of development and decades of
   experience into a feature-rich, high-performance and mature
   parallel rendering framework and an object-oriented
   high-level network library. It is intended for all
   application developers creating parallel, interactive
   OpenGL applications. Equalizer 1.2 can be retrieved by
   downloading the source code or one of the precompiled
   packages.

  1.1. Features

   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.

     * Runtime Configurability: An Equalizer application is
       configured automatically or manually at runtime and can
       be deployed on laptops, multi-GPU workstations and
       large-scale visualization clusters without
       recompilation.
     * Runtime Scalability: An Equalizer application can
       benefit from multiple graphics cards, processors and
       computers to scale rendering performance, visual
       quality and display size.
     * Distributed Execution: Equalizer applications can be
       written to support cluster-based execution. Equalizer
       furnishes and uses the Collage network library, a
       cross-platform C++ library for building heterogenous,
       distributed applications.
     * Support for Stereo and Immersive Environments:
       Equalizer supports both active and passive stereo
       rendering, as well as head tracking and head-mounted
       displays used in immersive Virtual Reality
       installations.

2. New in this release

   Equalizer 1.2 contains the following features,
   enhancements, bug fixes and documentation changes:

  2.1. New Features

     * Automic local and remote configuration using the GPU-SD
       library
     * Initial release of Sequel, a simplification and utility
       layer on top of Equalizer, enabling rapid development
       of clustered multi-GPU applications
     * Runtime failure tolerance detecting hardware and
       software failures
     * Tile compounds for fill-limited rendering such as
       direct volume rendering and interactive raytracing
     * Distributed single-producer, multi-consumer queue
     * RDMA-based connection class for InfiniBand (Linux only)
     * Support push-based object distribution

  2.2. Enhancements

     * Added FindEqualizer.cmake and FindCollage.cmake for
       integration of Equalizer and Collage in CMake build
       environments
     * Support for render clients without listening sockets
     * Per-segment or per-canvas swap barriers
     * Allow the image compressor to be chosen by the
       application
     * Allow and prefer external GLEW installation during
       compilation
     * Upgrade internal GLEW version to 1.7.0
     * Implement EQ_WINDOW_IATTR_HINT_SWAPSYNC for GLX
     * Add time member to eq::Event recording time when the
       event was received from the operating system
     * 43: Add View::isActive and Layout::isActive
     * 45: Make RNG functional without co::base::init
     * Implement maximum size of multi-threaded queue,
       resulting in blocking push operations
     * Extend co::base::SpinLock and ScopedMutex with
       read-write semantics
     * Make Collage usable from multiple libraries by allowing
       init and exit to be called multiple times

  2.3. Optimizations

     * Make LocalNode::registerObject and Object::commit
       parallelizable by executing object serialization from
       calling thread

  2.4. Examples

     * Provide CMake files for installed examples
     * seqPly: An new example similar to eqPly, but using the
       Sequel API
     * eqAsync: A new example demonstrating OpenGL context
       sharing for asynchronously texture uploads
     * eqHello: Ported to Sequel

  2.5. Tools

     * No Changes

  2.6. API Changes

   The following API changes may impact existing applications:

     * Removed co::Object::commitNB and commitSync since the
       commit request is no longer dispatched to command
       thread. Use commit instead.
     * Moved installed client headers to eq/client.
       Applications should always use eq/eq.h instead of
       individual headers.
     * Added a return value and timeout to
       co::LocalNode::acquireSendToken(), see method
       documentation.
     * Changed 'uint32_t eq::Version::getRevision()' to
       'std::string eq::Version::getRevision()'

  2.7. Documentation

   The following documentation has been added or substantially
   improved since the last release:

     * Full API documentation for the public Equalizer API.
     * The Programming and User Guide has been extended to TBD
       pages and TBD figures.

  2.8. Bug Fixes

   Equalizer 1.2 includes various bugfixes over the 1.0
   release, including the following:

     * RSP: Fix scattered ack implementation
     * 29: NV swap barrier with affinity context does not work
     * Fixed activation of OpenMP during build
     * Fixed glxew.h include
     * 3383573: Win32: occasional crash with
       CO_AGGRESSIVE_CACHING OFF
     * 3357684: View user data occasionally synced one frame
       too late
     * 3306308: Deadlock with config.eqc and window init
       failure
     * 3306148: Including eq/gl.h with AGL fails
     * 3301423: Config::stopFrames called from non-main thread
       causes deadlocks

  2.9. Known Bugs

   The following bugs were known at release time. Please file
   a Bug Report if you find any other issue with this release.

     * 19: zoom readback with FBO
     * 18: zoom: depth readback does not work
     * 17: AGL: Window close does not work

3. About

   Equalizer is a cross-platform toolkit, designed to run on
   any modern operating system, including all Unix variants
   and the Windows operating system. A compatibility matrix
   can be found on the Equalizer website.

   Equalizer requires at least OpenGL 1.1, but uses newer
   OpenGL features when available. Version 1.2 has been tested
   on:

  3.1. Operating System Support

   Equalizer uses CMake to create a platform-specific build
   environment. The following platforms and build environments
   are tested:

     * Linux: Ubuntu 11.04, RHEL 6.1 (Makefile, i386, x64)
     * Windows: XP and 7 (Visual Studio 2008, i386, x64)
     * Mac OS X: 10.6, 10.7 (Makefile, XCode, i386, x64)

  3.2. Window System Support

     * X11: Full support for all documented features.
     * WGL: Full support for all documented features.
     * AGL: Full support for all documented features.

  3.3. Documentation

   The Programming and User Guide is available as a hard-copy
   and online. API documentation can be found on the Equalizer
   website.

   As with any open source project, the available source code,
   in particular the shipped examples provide a reference for
   developing or porting applications. The Developer
   Documentation on the website provides further design
   documents for specific features. XCode users can download a
   Documentation Set.

  3.4. Support

   Technical questions can be posted to the Developer Mailing
   List, or directly to info@equalizergraphics.com.

   Commercial support, custom software development and porting
   services are available from Eyescale. Please contact
   info@eyescale.ch for further information.

4. Errata
Something went wrong with that request. Please try again.