Change Log

September 18th 2005 - 2.1.1

• snapshotFilename renamed snapshotFileName (uppercased 'N').
• When negative, the snapshotCounter is not appended to snapshotFileName in automatic mode.

• saveSnapshot(fileName) no longer opens a file dialog (bug finder Jürgen).

September 14th 2005 - 2.1.0

The library now compiles with Qt version 2, 3 and 4. When enum or function names have been changed in Qt4, the QGLViewer documentation uses their Qt 4 version and gives Qt 2 & 3 translations.

• Support for Qt version 2, 3 and 4.
• Dual licensing : a LGPL version of the library is available for commercial applications.
• QGLViewer::drawArrow() method from two points (thanks Sylvain).

Qt::ButtonState (Qt versions 2 & 3) has been split into Qt::KeyboardModifiers and Qt::MouseButtons in Qt4. Since these are just enums, previous code will still work.

• playPathStateKey() and addKeyFrameStateKey() were renamed playPathKeyboardModifiers() and addKeyFrameKeyboardModifiers().
  Their int parameter has been replaced by a type-safe Qt::KeyboardModifiers.
• setHandlerStateKey renamed setHandlerKeyboardModifiers.

• Camera copy constructor fixed (bug finder Xavier).

August 10th 2005 - 2.0.1

• Bounding box warning when viewing generated EPS snapshots fixed. Thanks Dominik.

June 24th 2005 - 2.0.0

• Cyril Soler entirely rewrote the VRender vectorial rendering code. Smaller and better ouput files.
• New QGLViewer::copyBufferToTexture() to copy the frame buffer in a texture.
• New Camera::drawCamera() and draw() methods.
• New QGLViewer::drawArrow() static method.
• New QGLViewer::mouseGrabberIsEnabled() method.
• Copy constructor and = operator implemented for Camera and KeyFrameInterpolator classes.

• Vec
• address() deprecated, use operator const float* instead.
• sqNorm() renamed Vec::squaredNorm().
• Quaternion
• Constructor with half angle removed.
• randomOrientation renamed randomQuaternion.
• operator* now returns a non-const Quaternion.
• Frame
• referenceFrame() is no longer const.
• setOrientationAxisAngle() and Frame::setRotationAxisAngle() removed.
• translate(float t[3]) and Frame::rotate(float q[4]) removed: use Vec and Quaternion equivalents instead.
• invert() and Frame::worldInvert() removed: use inverse() instead.
• inverseMatrix() and worldInverseMatrix() removed: use inverse().matrix() instead.
• setReferenceFrame() emits the modified() signal as expected.
• SpinningFrame
• SpinningFrame class has been removed. Spinning was integrated in ManipulatedFrame.
• ManipulatedFrame
• spinned signal renamed spun.
• MouseGrabber
• Mouse event method now all take a non-const Camera parameter.
• AxisPlaneConstraint
• float methods removed: use Vec equivalents instead.
• *Dir() methods renamed *Direction().
• KeyFrameInterpolator
  • keyFramePosition() and keyFrameOrientation() removed: use KeyFrame().position() and KeyFrame().orientation() instead.
  • finished() renamed endReached().
• Camera
• Methods with float parameter removed. Use their Vec(x,y,z) and Quaternion(q0,q1,q2,q3) equivalents instead.
• editCameraPath() and cameraPathIsEdited() removed.
• float versions of getModelViewMatrix and getProjectionMatrix removed. Use double equivalents instead.
• Methods using pixel input (pointUnderPixel()...) take QPoint parameter instead of x and y. Use QPoint(x,y) constructor if needed.
• nbPaths() removed. Camera now contains an arbitrary number of paths.
• fitScreenRegion now takes a QRect parameter.
• getOrthoWidthHeight made virtual.
• ORTHO type renamed ORTHOGRAPHIC.
• zNearCoef and zClippingCoef renamed zNearCoefficient and zClippingCoefficient.
• setWindowWidthAndHeight renamed setScreenWidthAndHeight.
• playKeyFramePath, deleteKeyFramePath and resetKeyFramePath renamed playPath, deletePath and resetPath.
• addKeyFrame renamed addKeyFrameToPath.
• distanceToScreen() renamed physicalDistanceToScreen().
• distanceToZeroParallaxPlane() renamed focusDistance().
• IODist renamed IODistance.
• setCameraFromProjectionMatrix() renamed setFromProjectionMatrix().
• QGLViewer
• cameraPathIsEdited and editCameraPath renamed cameraIsEdited and setCameraIsEdited.
• EDIT_CAMERA_PATHS renamed EDIT_CAMERA in prevision of a future camera edition.
• setDrawAxis, setDrawGrid, setDisplayFPS, setDisplayText renamed setAxisIsDrawn, setGridIsDrawn, setFPSIsDisplayed, setTextIsEnabled.
• float methods removed. Use Vec and Quaternion equivalents instead.
• drawAxis made static.
• setMouseStateKey renamed setHandlerStateKey.
• keyFrameKey renamed pathKey, with swapped parameters.
• playKeyFramePathStateKey renamed playPathStateKey.
• keyboardAccelerator (resp. setKeyboardAccelerator) renamed shortcut (resp. setShortcut).
• select, beginSelection, endSelection and postSelection use QPoint instead of x and y.
• toggleAnimationMode renamed toggleAnimation.
• version syntax in state file changed and is now compared with current version on restoration.
• Destructor now also deletes the camera().
• connectSignalToAllViewers, disconnectSignalToAllViewers and updateGLForAllViewers removed. Use QGLViewerPool insead.
• Keys F1-F12 are binded to camera keyFrameInterpolator indexes 1..12 (was 0..11).

• zip and tar files names include release number.
• rpm now includes a static version of the library.

• QGLViewer::stateFileName no longer skips the directory prefix.
• QGLViewer::drawLight nicer and fixed.
• WheelEvents now use fastDraw(). A final draw() is now triggered at a short delay after the last wheel event.

April 28th, 2005 - 1.3.9-6

• A new Camera::zClippingCoef() method to define z clipping planes positions.
• A new mouseGrabberChanged signal.
• Some hacks allow a compilation with .NET and the free Qt 2.3 version (thanks Lionel).

• Camera::pixelGLRatio() made const
• QGLViewer::drawGrid and drawAxis() made virtual.

• Help window improved: new About button and custom bindings descriptions separated.
• Problem with camera keyFrameInterpolator domElement fixed.

March 2nd, 2005 - 1.3.9-5

• A new setStateFileName method (default stateFileName is .qglviewer.xml, as before).
• A new helpWidget method.
• A Debian package of the library is now available (thanks to Artur Czechowski).

• saveToFile and restoreFromFile were renamed saveStateToFile and restoreStateFromFile.
  They no longer take file names as parameters, use stateFileName instead.

• Version number saved in state files.

February 9th, 2005 - 1.3.9-4

• restoreFromFile() now returns a bool that indicates restoration success.
• A message is briefly displayed when one changes the camera displacement mode (using the Space key).

• Enabled text status (toggled using the ? key) no longer saved in .qglviewer.xml file.

• Only the last saved camera position (or path) was restored from file (bug finder Xavier).
• Error message in restoreFromFile() with several viewers finally removed (bug finder Xavier).
• Proper include file (with QGLViewer/ prefix) in classes' documentation.

January 13th, 2005 - 1.3.9-3

• New terrain and dvonn cool examples.

• setMouseBindingDescription parameters reordered.
• startScreenCoordinatesSystem z mapping now ranges in [0.0, 1.0[ (was [1.0, -1.0]).
• Frame alignement (left and right buttons double click) are now filtered by constraints.
• Double click events are disabled in fly camera mode.
• Vec::projectOnAxis() no longer requires a normalized axis.

• Vec values stored in a union to ensure proper memory allocation (bug finder Olivier).
• Problem with vectorial rendering using several GL contexts fixed (bug finder Cyril).
• Problem with displayMessage() that regularly called updateGL fixed (bug finder Stéphane).
• No more error message when no .qglviewer.xml file is found in multi-viewer configuration.
• Slightly modified screenCoordSystem example.
• Warning message when quickly deleting several times the same camera paths removed.
• Double click properly handled by ManipulatedFrame when used as MouseGrabber.
• Mouse events binded to no action are no longer displayed in mouse help tab.
• Frame::setFromMatrix() now expects an OpenGL format matrix.

November 23rd, 2004 - 1.3.9-2

• New QGLViewer::sizeHint() method returns prefered viewer size (600x400).

• Infinite loop when displayMessage() is called in draw() fixed.
• EPSInterface.ui version downgraded to 3.0.
• Better mouseGrabber example.
• Rounding problems in Quaternion(from, to) method fixed.
• Viewers share their OpenGL contexts in the multiView example.

November 17th, 2004 - 1.3.9-1

• A designer plugin can be installed to ease user interfaces creation. Thanks Glen.
• New setSnapshotQuality() method to tune snapshots' quality (and hence size).
• New displayMessage() method, useful to give feedback to the user.
• New QGLViewer constructor, that enables Open GL context sharing between several viewers (requires Qt > 3.2).
• New saveSnapshot() method, with a filename as parameter.
• New openSnapshotFormatDialog() method to select snapshot format using a popup dialog.
• New drawFinished signal, that can be connected to saveSnapshot() to create movies.
• New firstTime(), lastTime() and duration() method in KeyFrameInterpolator.
• New aboutQGLViewer() method displays libQGLViewer version and info.
• New Camera::setViewDirection() method.
• Several new examples:
  • multiSelect illustrates multi-objects selection and features an area selection.
  • A contribs page describes so-called "contribution" more complex examples.
  • eventRecorder enables scenario recording and replay for movie creation.
  • backgroundImage displays a static backgroundImage in your viewer. Thanks Sylvain.
  • thumbnail is a dual display illustration. Thanks Sylvain.
• SpinningFrame, ManipulatedFrame and ManipulatedCameraFrame have copy constructors and = operators.
• Vec and Quaternion classes have a convenient explicit constructor from a QDomElement.
• Full XML syntax checking in initFromDOMElement() functions.

• New cleaned domElement() XML syntax. Incompatibilities will result in warnings at first start (or delete your old .qglviewer.xml).
• foregroundColor() and backgroundColor() use QColor instead of Vec. Attention, range is 0-255 instead of 0.0-1.0
• setSelectRegionSize() replaced by setSelectRegionWidth() and setSelectRegionHeight().
• Spurious foregroundColor() and backgroundColor() methods removed.
• The EXIT KeyboardAction was renamed EXIT_VIEWER because of potential name conflict.
• Vec::unit() made const.

• Adding or deleting a camera keyframe shorlty displays a feedback message.
• Default snapshot image quality was increased to 95 (see setSnapshotQuality()).
• Camera holds its projection matrix, which makes projectedCoordinatesOf() faster and more versatile.
• Crash with anti-aliased font with nVidia cards fixed (once again, but now for good).
• Nicer help window, with colored lines and a header.
• KeyFrameInterpolator documentation mostly rewritten.
• cwFiles custom widget directory removed and replaced by a qglviewer.cw file.
• Default snapshotFormat() set to the first one available (instead of JPEG).
• mouseTracking state no longer saved in (nor restored from) .qglviewer.xml file.

June 7th, 2004 - 1.3.8-3

• QAccel abandonned : user defined key bindings are prioritary.
• setKeyboardAccelerator() and setKeyDescription() take an int as parameter instead of a QKeySequence.
• keyboardAccelerator() logically returns an int accordingly.
• Frame::referenceFrame() (and related methods) are now const.

• Subtle bug flawed mouse bindings (especially object selection).
• Compilation successfully tested on SUN and IBM AIX (thanks Benjamin).

June 14th, 2004 - 1.3.8-2

• A new anaglyph example.

• Patches for compilation on HP UX architecture (thanks Benjamin).

June 9th, 2004 - 1.3.8-1

• A new setKeyDescription() method to customize the help dialog.
• A new setMouseBindingDescription() method to customize the help dialog.
• Camera::projectedCoordinatesOf() and similar methods have an additional optional Frame parameter.

• ShortcutAction enum renamed KeyboardAction.
• New MOVE_CAMERA and FLYSPEED values added to the KeyboardAction enum, see keyboard page.
• setShortcutKey() and setShortcutStateKey() replaced by setKeyboardAccelerator().
• QGLViewer::shortcutBindingsString() renamed keyboardString().
• QGLViewer::mouseBindingsString() renamed mouseString().
• SpinningFrame::updateFrame() renamed spin().
• Several functions made const.
• QGLViewer::rootWidget() removed, use QWidget::topLevelWidget() instead.
• SCREEN_ROTATE_BOTTOM renamed ROLL.
• Asking for help window several times simply updates and shows instead of opening a new window.
• Scene radius and center no longer saved and restored in .qglviewer.xml.

• Web site design updated. New Unix and Windows installation pages.
• New KeyboardAction added (MOVE_CAMERA_LEFT, INCREASE_FLYSPEED, ....
• ManipulatedFrame didn't correctly take its rotationCenter() into account (bug finder Manu).
• SpinningFrame::rotatesAroundPoint() and SpinningFrame::orientationIsFrozen() were not documented.
• Camera::setType() changed zoom when called twice with ORTHO (bug finder Manu).
• Shortcut help window tab renamed Keyboard.

May 5th, 2004 - 1.3.7-1

• The object selection process has been simplified. Simply overload the drawWithNames() function and get the resulting selection id with selectedName(). See the updated select examples for a practical implementation.
• Previous select() implementations still work.
• Quaternion::inverseMatrix() and associated similar methods.
• Frame::inverse() and associated similar methods.
• Frame::inverseMatrix() and associated similar methods.
• A new quarto example.

• QGLViewer::startAnimation() has no more parameter.

• The new Qt 3.2.2 version patches the anti-aliased font display on nVidia hardware that made drawText() crash.
• The examples page is divided in three sections: basic, pedagogical and complex.

March 17th, 2004 - 1.3.6-2

• A new Vec::unit() method. Returns a unitary copy of a vector.
• Camera::setAspectRatio() function, useful when a Camera is used to create a shadow map.

• Vec::normalize() now returns the previous norm of the vector (instead of normalized vector).
• RPM now installs the documentation in /usr/local/share/doc/QGLViewer.
• Tarred versions of the sources now available under tar.bz2 format.
• make install now also install the documentation (default path is /usr/local/share/doc/QGLViewer).
• New make options let you install separately the includes, the library and the documentation.
• Examples autodetect if Qt is threaded or not and change link accordingly.

• The Qt 2.3 version (free win32 Qt version) is (almost) fully functionnal.
• Some typos in the documentation were fixed.
• Patch for << operator with gcc 2.96 (bug finder Ranjith).

February 3rd, 2004 - 1.3.6-1

• The mouse sensitivity can be tuned for ManipulatedFrame and ManipulatedCameraFrame.
• The viewer window previous position is properly restored back, even for embedded widgets or in full screen mode.
• The version and packaging date are added to all files, so that you know your current version.

• The spinned(), manipulated() and interpolated() signals are no longer connected to all the viewers updateGL() slots.
  If you use several viewers, you should now explicitely make these connections. See the signals' documentations for details.
• The ManipulatedFrame::mouseMotion enum (ROTATE, ZOOM,...) is renamed QGLViewer::mouseAction.
• drawText() made public.
• Deprecated mouseStateKey(), Camera::mode(), ... functions removed.

• The Quaternion(from,to) constructor had a bug (bug finders Marc and Tanguy).
• MouseGrabber no longer activated when hovered while moving the camera or the manipulatedFrame().
• Calls to updateGL() limited to the strict minimum.
• FAQ page splitted in two, with a new technical FAQ.

December 24th, 2003 - 1.3.5-8

• startScreenCoordinatesSystem() can set the origin in the lower or the upper left corner.

• The Camera::domElement() syntax has been changed (previous .qglviewer.xml files are not compatible).
• The TriangleSetConstraint class has been removed from the main library and moved in the triSetConstraint contrib example.

• Problem with MouseGrabber/ManipulatedFrame wheel zoom fixed.
• QGLViewer::saveToFileForAllViewers() is back and called by Escape (problems with multiple viewers).
• The .qglviewer.xml state file is saved even when the viewer is not a top level window.
• A Qt bug with full screen has been patched so that viewers can start in full screen mode.
• When pressing a key, display is updated only when required.

November 26th, 2003 - 1.3.5-7

• A new ManipulatedFrame::ZOOM_ON_REGION mouse action, binded to Shift + middle button.
• The associated Camera::fitScreenRegion() function.

• startScreenCoordinatesSystem no longer disable lighting nor enables blending.

November 17th, 2003 - 1.3.5-6

• A MouseGrabber::clearMouseGrabberPool() function.

• Problem with classes derived from ManipulatedFrame used as MouseGrabber (bug finder Cyril).
• Unclean old malloc removed from EPSRender code.
• libQGLViewer135.obj error message with Visual C++ removed.

November 7th, 2003 - 1.3.5-5

• A new keyboardAndMouse example.

• ManipulatedFrame grabsMouse within a distance of 10 pixels (instead of 5).
• Fly speed modification problem when using +/- fixed.

November 5th, 2003 - 1.3.5-4

• QGLViewer::setBackgroundColor(QColor) added to prevent hidding the QGLWidget function.
• QGLViewer::setForegroundColor(QColor) added for consistency reasons.
• A new keyboardAndMouse example.

• Patch for QTextEdit with Qt 2.3.

October 24th, 2003 - 1.3.5-3

• The nVidia bug with anti-aliased fonts has been patched.

October 22nd, 2003 - 1.3.5-2

• Help window now has a keyboard and a mouse tabs.
• QGLViewer::mouseBindingsString() and QGLViewer::shortcutBindingsString() functions.
• Tested on Windows Visual 6 (Qt 2.3) and with MS .NET (Qt 3.2).

• ManipulatedFrame associated state key are no longer considered when they are manipulated as MouseGrabber.
• QGLViewer::ZOOM_OUT renamed QGLViewer::ZOOM_TO_FIT.
• QGLViewer::CENTER_AS_RAP renamed QGLViewer::RAP_IS_CENTER.

• ManipulatedFrame can now correctly be used as mouse grabbers (see the keyFrames example).
• displayZBuffer problem with glRasterPos fixed..
• displayFPS correctly handles application default font size.

October 2nd, 2003 - 1.3.5-1

• Glut no longer needed if your Qt version is at least 3.1.
• QGLViewer::drawText can use different QFont.

• QGLViewer::drawText() has changed :
  • QGLWidget::renderText() is used instead of GLUT (no longer needed) if your Qt version is at least 3.1.
  • Parameter list differs : now uses QString and QFont.
  • Function is no longer const since it calls makeCurrent.
• draw3DText() does not work anymore (because of Qt's text rendering). Use QGLWidget::renderText() instead.
• The following functions now have their origin in the upper left corner :
  • QGLViewer::startScreenCoordinatesSystem().
  • Camera::projectedCoordinatesOf().
  • Camera::unprojectedCoordinatesOf().
  • MouseGrabber::checkIfGrabsMouse().
• Camera::setFOVToFitScene() is clamped to M_PI/2.0.
• The examples now #include "QGLViewer/qglviewer.h".
• The src directory has subsequently been renamed QGLViewer.

September 24th, 2003 - 1.3.4-2

• Camera::getViewport function.

• drawNeeded() is emitted before each call to draw() (it was no longer the case if you chose to override draw()).
• ZOOM_OUT default mouse binding changed. See mouse page.
• Wheel bindings now also modified by setMouseStateKey()..

• Segmentation fault when exiting fixed.
• Frustum modification minimized when switching between PERSPECTIVE and ORTHO camera type.
• Disabled shortcuts no longer appear in help window.
• Missing includes on specific linux architechture were added.
• Missing display update when using fastDraw() fixed.
• Position and size of the window properly saved and restored when QGLViewer is a part of an other QWidget.
• Camera now correctly handles KeyFrameInterpolator indexes out of range (bug finder Xadeck).
• No more erroneous initializeGL() message when several viewers are used (bug finder Franck).

July 16th, 2003 - 1.3.4-1

• Mouse bindings can entirely be customized. See mouse page.
• Double simple click action removed. See mouse page for new bindings.
• setMouseBinding, setWheelBinding mouse customization functions.
• The select function is back ! Simply overload. Shift-LeftButton by default.
• QGLViewer::closeEvent() saves the current viewer state to file.
• QGLViewer icon added to the web pages.
• A Frame::alignOnAxis() function.

• setMouseStateKey() has been modified to fit with setMouseBinding(). Read its documentation.
• The ManipulatedCameraFrame::Mode enum and all mode functions are removed.
• The mouseBehavior enum is replaced by mouseHandler.
• The mouseStateKey removed and replaced by setMouseBinding.
• QGLViewer::saveToFileForAllViewers() removed as saveToFile is now called in closeEvent.
• Camera::setRevolveAroundPointToSceneCenter() function removed.

• Zooms is not too slow when close to scene center.

June 27th, 2003 - 1.3.3-1

• Doxygen search engine added to the reference manual.
• setXXXWithConstraint() functions in Frame.
• A finished signal in KeyFrameInterpolator.
• Z-buffer can be displayed with shortcut Z (thanks Sylvain).
• A Quaternion::randomOrientation() static function.
• The Max OS X version of Qt is now free ! Download the latest version.
• The gcc 2.96 version of the rpm in no longer maintained. You need to compile it from the .src.rpm file.

• KeyFrameInterpolators now enforce frame constraints.
• Easier compilation with darwin on mac architectures and on Linux Debian.
• QGLViewer::drawLight() made const and has an optional scale.
• updateGL() no longer called in QGLViewer::keyPressEvent() when the key is not handled.

June 1st, 2003 - 1.3.2-3

• Camera::horizontalFieldOfView() fixed. Previous value was flawed.

April 17th, 2003 - 1.3.2-2

• The rpm installs the library in /usr/local, as does a make install. The examples now compile with no manual tweaking.
• Easier compilation with Qt 2.3. See the installation page for details.

April 17th, 2003 - 1.3.2-1

• A new helpString() function used by help().
• A Qt::QMessageBox is now used to display help().
• A Camera::getViewDirection() with float parameters.
• Windows compilation now creates a DLL.
• A Camera::setFOVToFitScene() function.
• cout and cerr replaced by QMessageBox and qWarning.
• QGLViewer::message() removed.
• A new QGLViewer::snapshotCounter() makes saveSnapshot() faster in automatic mode.
• QGLViewer::saveSnapshot() has an overwrite parameter.

• Camera::zoomOutToFitScene() and zoomOnPixel() become Camera::interpolateToFitScene() and interpolateToZoomOnPixel().
• QGLViewer::setShortcutKey takes an optional stateKey parameter.
• Camera::setSceneRadius and setSceneCenter become public.

• Camera::fitSphere() fixed (bug finder Sylvain).

April 10th, 2003 - 1.3.1-1

• setForegroundColor() and setBackgroundColor() functions.
• ManipulatedFrame inherits MouseGrabber. See the example.
• A ManipulatedFrame::spinningSensitivity() function.
• A setSceneBoundingBox() with float[3] parameters.

• In MouseGrabber, checkIfActive() and others become checkIfGrabsMouse, ....
• A new ManipulatedCameraFrame class merges specific ManipulatedFrame camera behavior.
• Camera::mouseDoubleClickEvent() and Camera::adaptFrameState() removed.

• Camera zNear() and zFar() are more tightly (a factor 2) set from sceneRadius().
• Camera zNear() and zFar() are canged to display path when cameraPathIsEdited().
• A #define QGLVIEWER_VERSION 0x010301 added. Allows #if QGLVIEWER_VERSION < Ox010300 ... #endif.
• make install creates links to libraries instead of copies.
• Quaternion internal representation switched from float to double because of precision problems with very small rotations (bug finder Christof).

March 26th, 2003 - 1.3.0-1

• A new MouseGrabber class for even more interactive applications. See the example
• Code was modified so that it compiles with the Qt 2.3 version (win32 free version).
  Screenshot saving is not supported with Qt 2.3.
• QGLViewer.setCamera() lets you switch between different cameras in your viewer.
• restoreFromFile() and saveToFile() now also accept a directory as an argument.
• A QGLViewerPool() holds all the QGLViewers, and QGLViewerIndex() identifies a viewer.

• viewer.camera and camera.frame are now pointers. Use viewer.camera() and camera()->frame() instead.
• manipulatedFrame() are now manipulated with the Control key instead of Alt.
• saveToFile() and restoreFromFile() removed from constructor/destructor.
  Call restoreFromFile() in your init() function if you want to restore previous state.
  saveToFile() is called when you quit your application (default key is Escape). See also saveToFileForAllViewers().
• Camera::saveCurrentPOV() and restorePOV() removed. Use addKeyFrame() and playKeyFramePath() instead.
• Control+Fx is replaced by Alt+double press Fx to delete a camera KeyFrame path.
  deleteKeyFrameStateKey() and associated functions are removed.
• Camera::getProjectionMatrix() and getModelViewMatrix() are now public.
  Use these camera()->get...Matrix() instead of the ones in QGLViewer, which have been removed.
• Camera::fieldOfView() in radians instead of degrees.
• The ShortcutAction names used in setShortcutKey() were uppercased to prevent name conflicts.

• Most of the documentation was updated. Detailed descriptions and more code examples were added.
• pixelGLRatio() fixed and now correct in ORTHO camera mode.
• Frame and Camera translation follow mouse in ORTHO mode.
• fitSphere() fixed in ORTHO camera mode.

March 19th, 2003 - 1.2.9-3

• revolveAroundPoint() no longer moves in ORTHO mode.
• Special key (Esc, Return, Space...) displayed properly in help()
• rpm are created with the debugged gcc 3-2-2. Optimizations now available.

March 5th, 2003 - 1.2.9-2

• Slerp interpolation debugged.
• Quaternion::log() and exp() more robust.
• distanceToSceneCenter() changed so that zNear() and zFar() handle tight sceneRadius().
• revolveAroundPoint was not fixed on screen with an ORTHO camera (bug finder Christof).

February 26th, 2003 - 1.2.9-1

• A new SpinningFrame class, between Frame and ManipulatedFrame. See the example.
• QGLViewer::setSceneBoundingBox() function.
• Quaternion::log() and Quaternion::exp() functions.
• Quaternion::slerp() and Quaternion::squad() static members.
• A new MultiView example.
• Double click is handled for ManipulatedFrame as for Camera.
• Frame::getMatrix() and Quaternion::getMatrix() with double[16] parameters.
• A Frame::rotatesAroundPoint() function.

• Camera no longer has a default referenceFrame().
• Orientations interpolation now based on slerps in KeyFrameInterpolator.
• Successful compilation on Linux Debian distribution, with gcc 2.95 and 3.2.

• Default install directory for make install and RPM becomes /usr/local.
  You should remove the previous files when you install this version (with rm or rpm -e libQGLViewer*).
• make install installs include files in INCLUDE_DIR/QGLViewer.
• SpinningFrame, KeyFrameInterpolator and ManipulatedFrame update signals are automatically connected to all viewers.
• Camera::setSceneBoundingBox() also set the sceneCenter().
• Camera::setConstraint() removed. Use camera.frame.setConstraint() instead.
• Camera::zoomOutFromPixel() replaced by zoomOutToFitScene().
• ManipulatedFrame::alignWithAxis() replaced by Frame::alignWithFrame().
• QGLViewer::convertClickToLine() moved in Camera and takes int.

January 30th, 2003 - 1.2.8-3

• A convenient Camera::pixelGLRatio() function

• Minor changes in the trackball behavior.
• Visual feedback when a double simple click is used to change the revolveAroundPoint().
• std::min patched for windows compilation

• QGLViewer::help() becomes a public method.

January 22nd, 2003 - 1.2.8-2

• The PLANE constraint type can no longer be used for rotations.
• A KeyFrameInterpolator used to crash if the path was deleted while interpolating (bug finder Sylvain).
• drawAxis() and drawGrid() no longer save the openGL state.
  postDraw(), that call them does it instead.

• Camera::loadProjectionMatrix() and Camera::loadModelViewMatrix() are no longer protected.

January 15th, 2003 - Version 1.2.8

• A textureViewer pedagogical example shows how to map textures with OpenGL.
• Camera::pointUnderPixel(x,y) to convert from screen to 3D coordinates.
• New cool trackball functionalities, see mouse page for details.
• In Camera : setSceneBoundingBox(), zoomOnPixel(), viewDirection().
• The ManipulatedFrame now has a rotationSensitivity() and a translationSensitivity().

• Camera::lookAt() preserves the horizon.
• Camera::fitSphere() no longer modifies the orientation.
• The ManipulatedFrame bug was (finally) identified...and not fixed. See the AxisPlaneConstraint() man page for details.
• There used to be a problem in the displayed FPS when the manipulatedFrame was changed (bug finder Sylvain).
• There was a Quaternion drift. They are now re-normalized (bug finder Stéphane).

• The SPECIAL mouse behavior disappears. See the mouse page.
• The select() function is removed. Overload mousePressEvent() to implement selection, see the select example.

December 14th, 2002 - Version 1.2.7-2

• QGLViewer::currentFPS() returns the current frame rate.
• QGLViewer::setSnapshotFormat() and QGLViewer::snapshotFormat().
• Quaternion::matrix() to use Quaternions as openGL 4x4 matrices.
• QGLViewer::draw3DText() to draw text in 3D, see the draw3DText example.

• Frame spinning threshold was flawed. Unwanted spinnings should no longer occur.
• Camera translation is infered from revolveAroundPoint(). Should fix problems with small objects in large scene.
• libGLcore has been removed from the rpm dependencies.

• QGLViewer::saveSnapshot() has only one parameter.

December 4th, 2002 - Version 1.2.7

• KeyFrameInterpolator class. See the keyFrames examples.
• Key Frames can be used to define a camera path. Binded on F1-12 (see keyboard page).
• Snapshot can be saved in EPS, PS and XFIG vectorial format (thanks Cyril).
• Gestion of a QGLViewer pool. See QGLViewer::updateGLForAllViewers() and QGLViewer::connectSignalToAllViewers().
• The complete QGLViewer state can be saved and restored in XML format (see saveToFile() and restoreFromFile(). All classes implement domElement() and initFromDOMElement().
• Quaternion::inverse() and Quaternion::invert() : two separated methods (thanks Dominique).
• Frame::modified() signal is now emitted when a frame is modified.
• const versions of Frame::translate() and Frame::rotate().
• Camera::setCameraFromProjectionMatrix() (thanks Sylvain).
• +/- change camera fly speed. Arrows move the camera.
• designer cw files (custom widget) are distributed with the library (in include_dir/cwFiles).

• Float trigonometric function removed : now compile on Mac OS X architecture.
• QGLViewer::startScreenCoordinatesSystem() was flawed, now ok. See the screenCoordSystem example.
• The different slots (toggleDisplayFPS(), toggleDrawAxis()...) now call updateGL(). The qt bug that prevented it was patched.
• REVOLVE trackball orientation no longer depends on the mouse path.
• Vec class slightly modified (some const removed and normalize() returns a ref).
• Quaternion::axis() and Quaternion::angle() now respect the 0-pi specification.

• Most of the "Display of visual hints" functions' names were changed. See the QGLViewer documentation.
• Camera::setRevolveAroundPoint() is replaced by Camera::seamlesslySetRevolveAroundPoint().
• QGLViewer::animationPeriod() replaces QGLViewer::animationInterval().
• Camera::aspect() and QGLViewer::aspect() are now named aspectRatio().
• Quaternion::setAxisAndAngle() becomes Quaternion::setAxisAngle().
• MouseBehavior enum is uppercased : { CAMERA, FRAME, SPECIAL } (see QGLViewer::setMouseStateKey() and mouseStateKey()).
• Exit2 shortcut key ('Q') removed. Exit key (Escape) remains.

September 10th, 2002 - Version 1.2.6

• The entire library and the examples now use the threaded version of QT.
• Pressing the left and middle mouse button together rotates the scene around an axis orthogonal to the screen.
• Camera::setUpVector() function.
• Camera::setOrientation(theta, phi) : an other easy way to position the camera.
• Frame::getMatrix(), Frame::getWorldMatrix(), Frame::worldMatrix() : new matrix expressions of a frame transformation.
• FullScreen mode now set the parent window (if any) in full screen mode.
• Frame::transformOf() and similar functions to convert vectors between frames.
• In FLY mode (see Camera::setMode()), a double click changes fly speed. See mouse page.

• QGLViewer::drawLight() polished. See the drawLight example.
• Quaternion::setFromRotationMatrix fixed. Was completely flawed (thanks Sylvain).
• Camera::setOrientation fixed. It used to change the camera position too because of the complex camera frame setup (web page to come). setPosition and setOrientation can now be used in any order. See also setOrientation(theta,phi) in the NEW section.
• Frame::setConstraint() now supports a NULL pointer, which intuitively results in no constraint.
• Camera::FLY mode changed to maintain the horizon.
• Quaternion(from, to) had a problem with angles > pi/2 and null vectors.

• QGLViewer::setDisplayText becomes QGLViewer::setEnableText (idem for QGLViewer::toggleEnableText() and QGLViewer::isTextEnabled()). It controls whether QGLViewer::drawText() actually draws text or not (default is yes). Convenient to remove all the displayed text with a single shortcut ('?' by default).
• Frame::setRotationAxisAngle(), Frame::setOrientationAxisAngle() now take angles expressed in radians instead of degrees.
• FullScreen mode shortcut key changed to Alt-Return, to fit the windows standard..
• Frame::orientationOf() is replaced by Frame::transformOf().

Mardi 21 Juillet - Version 1.2.5

• Stereo display available. See the stereoViewer example.
• A startScreenCoordinatesSystem() function that allows to directly draw in screen coordinates.
• A new help() function. Key Binding 'H'. Complete default behavior.
• First RPM release, some cleanup, web pages updated.
• Web pages will now be in english, so that they can be shared on the web. Maintaining two versions is really too much work.

• Text drawing is done using drawText() directly in draw().
• Key shortcut are no longer defined by static variables. They can be tuned using setShortcutKey() and setShortcutStateKey() See also setMouseStateKey(), setSavePOVShortcutKey(),....

Last modified on Sunday, September 18, 2005.