| 1 |
VR Juggler Release Notes |
|---|
| 2 |
------------------------ |
|---|
| 3 |
|
|---|
| 4 |
For all versions: |
|---|
| 5 |
|
|---|
| 6 |
- See the ChangeLog for more system-level changes that do not directly |
|---|
| 7 |
affect applications. |
|---|
| 8 |
- See the Known Bugs page on the VR Juggler website (www.vrjuggler.org) |
|---|
| 9 |
for the current list of bugs. |
|---|
| 10 |
|
|---|
| 11 |
=============================================================================== |
|---|
| 12 |
|
|---|
| 13 |
Version: 2.2.1 |
|---|
| 14 |
Released: March 5, 2008 |
|---|
| 15 |
|
|---|
| 16 |
This is a bug fix release relative to VR Juggler 2.2.0. It is binary |
|---|
| 17 |
compatible with VR Juggler 2.2.0, and most users should not need to |
|---|
| 18 |
recompile existing applications to take advantage of the improvements |
|---|
| 19 |
in this release. The one exception is applications derived from |
|---|
| 20 |
vrj::OsgApp. These must be recompiled in order to take advantage of the |
|---|
| 21 |
bug fixes in that class. |
|---|
| 22 |
|
|---|
| 23 |
The most important new feature in this release is the elimination of |
|---|
| 24 |
the need to set VJ_BASE_DIR and related environment variables to execute |
|---|
| 25 |
VR Juggler applications on any platform. VR Juggler 2.2.0 introduced |
|---|
| 26 |
this capability on Windows, and this release broadens that to all other |
|---|
| 27 |
platforms. |
|---|
| 28 |
|
|---|
| 29 |
Version: 2.2.0 |
|---|
| 30 |
Released: August 14, 2007 |
|---|
| 31 |
|
|---|
| 32 |
Please refer to the following to get started with VR Juggler 2.2.0: |
|---|
| 33 |
|
|---|
| 34 |
http://developer.vrjuggler.org/wiki/MigratingToVrjTwoTwo |
|---|
| 35 |
|
|---|
| 36 |
In general, there are no required application changes to update from |
|---|
| 37 |
VR Juggler 2.0 to VR Juggler 2.2. However, applications making direct |
|---|
| 38 |
use of VPR (the VR Juggler Portable Runtime) classes including |
|---|
| 39 |
vpr::SerializableObject must be updated for API changes in VPR 2.0. |
|---|
| 40 |
|
|---|
| 41 |
VR Juggler 2.0 configurations must be loaded into VRJConfig in order |
|---|
| 42 |
to be updated automatically. Before doing that, however, it is highly |
|---|
| 43 |
recommended that all VR Juggler 2.0 configuration files be processed |
|---|
| 44 |
using an XSLT processor and the stylesheet |
|---|
| 45 |
modules/vrjuggler/data/xslt/key_sym_2_0.xsl. More information about this |
|---|
| 46 |
can be found on the above referenced web page. |
|---|
| 47 |
|
|---|
| 48 |
New in this release: |
|---|
| 49 |
* Improved cluster scalability and performance. |
|---|
| 50 |
|
|---|
| 51 |
* Improved error handling and recovery through the use of exceptions |
|---|
| 52 |
for error reporting. VR Juggler 2.2 is based on VPR 2.0 which uses |
|---|
| 53 |
exception handling for all error reporting. vpr::ReturnStatus is now |
|---|
| 54 |
considered deprecated. |
|---|
| 55 |
|
|---|
| 56 |
* Easier command-line application build support by leveraging |
|---|
| 57 |
Flagpoll (see https://realityforge.vrsource.org/view/FlagPoll/WebHome |
|---|
| 58 |
for more information). This includes support for the use of Flagpoll |
|---|
| 59 |
on Windows by using Flagpoll 0.9.1 or enwer. Note that the *-config |
|---|
| 60 |
Perl scripts (such as vrjuggler-config) no longer exist in VR Juggler |
|---|
| 61 |
2.2. Forward compatibility for this change was introduced with VR |
|---|
| 62 |
Juggler 2.0.2. |
|---|
| 63 |
|
|---|
| 64 |
* Cocoa support on Mac OS X. VR Juggler applications are deployed as |
|---|
| 65 |
bundles, and X11 is not required at all. Mac OS X users should review |
|---|
| 66 |
the updated VR Juggler /Getting Started Guide/ for information on |
|---|
| 67 |
application execution options. |
|---|
| 68 |
|
|---|
| 69 |
* Support for parallel installations. To facilitate long-lived |
|---|
| 70 |
applications, the Juggler runtime (shared libraries and data files) |
|---|
| 71 |
from multiple versions can be installed in parallel. To get the most |
|---|
| 72 |
from this capability, users are strongly encouraged to use GMTL 0.5.4 |
|---|
| 73 |
and CppDOM 0.7.9 or newer, both of which also support parallel |
|---|
| 74 |
installations. |
|---|
| 75 |
|
|---|
| 76 |
* Versioned headers, data files, and shared libraries on non-Windows |
|---|
| 77 |
platforms. This is all in support of parallel installations. |
|---|
| 78 |
|
|---|
| 79 |
* Versioned DLLs on Windows. Windows builds should use automatic |
|---|
| 80 |
linking to avoid complicated detection of .lib file names. Forward |
|---|
| 81 |
compatibility for this change (i.e., automatic linking) was |
|---|
| 82 |
introduced in VR Juggler 2.0.2. |
|---|
| 83 |
|
|---|
| 84 |
* Support for 64-bit applications on Windows. This requires the use of |
|---|
| 85 |
the CVS HEAD version of NSPR (currently known as NSPR 4.7). |
|---|
| 86 |
|
|---|
| 87 |
* Reduced dependency on NSPR on Windows. We are using Windows threading |
|---|
| 88 |
and synchronization primitives directly instead of the NSPR wrappers. |
|---|
| 89 |
|
|---|
| 90 |
* Reduced run-time dependence on environment variables such as |
|---|
| 91 |
VJ_BASE_DIR and SNX_BASE_DIR. This has been in the works since the |
|---|
| 92 |
VR Juggler 2.0 beta stages. Now, for the Windows case, running |
|---|
| 93 |
VR Juggler applications does not require setting VJ_BASE_DIR at all. |
|---|
| 94 |
The installation path is determined at run time when the DLLs are |
|---|
| 95 |
attached to the process. The Visual C++ project files still reference |
|---|
| 96 |
VJ_BASE_DIR and VJ_DEPS_DIR, however. |
|---|
| 97 |
|
|---|
| 98 |
* Support for OpenSG 2.0 in vrj::OpenSGApp. |
|---|
| 99 |
|
|---|
| 100 |
* Early support for Direct3D. The VR Juggler Direct3D Draw Manager is |
|---|
| 101 |
in the alpha stages of development, and feedback and improvements |
|---|
| 102 |
would be welcome. |
|---|
| 103 |
|
|---|
| 104 |
* Proper destruction of singletons created using the VPR singleton |
|---|
| 105 |
preprocessor macros when the application exits. This facilitates much |
|---|
| 106 |
cleaner shutdown, especially in the case of device drivers. |
|---|
| 107 |
|
|---|
| 108 |
* More flexible debug handling on Windows. There are now two |
|---|
| 109 |
debug-enabled versions of all binaries: one linked against the |
|---|
| 110 |
release runtime and one linked against the debug runtime. This allows |
|---|
| 111 |
applications linked against the release runtime to switch to using |
|---|
| 112 |
debug-enabled Juggler libraries simply by changing the PATH |
|---|
| 113 |
environment variable. This same capability has always existed on |
|---|
| 114 |
non-Windows platforms by modifying (DY)LD_LIBRARY_PATH. |
|---|
| 115 |
|
|---|
| 116 |
* Expanded use of boost::shared_ptr<> for better (internal) memory |
|---|
| 117 |
handling. User-level code will probably not see much of this. |
|---|
| 118 |
|
|---|
| 119 |
* Fixed stability problems with OSG applications when run with a |
|---|
| 120 |
multi-pipe/multi-threaded VR Juggler configuration. |
|---|
| 121 |
|
|---|
| 122 |
* Eliminated the need for OSG- and OpenSG-based applications to define |
|---|
| 123 |
plain OpenGL lighting just to make the VR Juggler simulator |
|---|
| 124 |
components render well. See the OSG and OpenSG sample applications |
|---|
| 125 |
for the current state of things. |
|---|
| 126 |
|
|---|
| 127 |
* Initial Unicode support for Gadgeteer keyboard/mouse devices. |
|---|
| 128 |
|
|---|
| 129 |
* Support for the noDNA X-IST device. Submitted by Damien Touraine. |
|---|
| 130 |
|
|---|
| 131 |
* Support for the USB Essential Reality P5 Glove. Submitted by Damian |
|---|
| 132 |
Touraine. |
|---|
| 133 |
|
|---|
| 134 |
* Revamped Polhemus Fastrak driver that is much easier to configure. |
|---|
| 135 |
|
|---|
| 136 |
* Enhanced configurability of multisampling with OpenGL windows. |
|---|
| 137 |
Currently, this is only supported fully on the X Window System. |
|---|
