
	panini 0.62.xx  Release Notes	27 January 2009

At version 0.6, pvQt has been renamed "Panini".
Update 0.61 (SVN 77) fixes some UI bugs. It uses native 
file selector dialogs on Windows and OSX because some
Mac users have reported difficulty with the Qt dialog.
Update 0.62 adds the ability to make Pannini views from
cubic panoramas, and to control alignment of the image 
on the pancylinder. 

This is a beta release of software that is under active
development and will be replaced by a better version in
the not-too-distant future.  So you should expect to find
some bugs.  Please report those, either on the hugin-et-al
discussion group:
http://groups.google.com/group/hugin-ptx
or the pvQt project's bug tracker at SourceForge:
http://sourceforge.net/tracker/?group_id=241632&atid=1116683
You may find a newer release at:
http://sourceforge.net/projects/pvqt/

The main new features in version 0.6 are:
-- cylindrical panosurface enables "Panini projection" for
   convincing perspective effects in wide angle views (not 
   available for cubic source images).
-- The range of eye distance has been enlarged and the 
   controls for it linearized.  It is now possible to sweep 
   the viewing projection from linear through stereographic
   or Panini, all the way to sinusoidal.
-- There are presets for the 3 principal viewing projections.
-- framing controls shift view center with respect to screen
   window.
-- can shift eye point sideways as well as radially, for
   "software view camera" effects.

Some other improvements
-- fewer errors in input deprojection functions (some 
   still need work)
-- a bug in cubic picture loading has ben fixed.

Update 0.61 adds these bug fixes and UI improvements:
-- The menu for choosing source image format is now titled "Source" (was "Picture")
-- You can choose to see the wire frame panosphere models instead of an image
-- Panocylinder is automatically selected for non-cubic source formats; so just hit
   "P" to see the Pannini projection.
-- The current panosurface type is always displayed correctly
-- All window titles now say "Panini"
-- The program has a nice icon that shows a pano of the Erasmus bridge in Rotterdam, 
   that was perspective-corrected with Panini.

Update 0.62 adds these enhancements:
-- Pannini projections of cubic panoramas can now be displayed.
-- Angular alignment of the image on the panosurface can be adjusted via a new "Turn" dialog.  For cubic panos only, Yaw and pitch can be set to put the axis of the panosurface anywhere in the spherical image.
-- Panosurface is now selected by clicking a button at bottom of window.  Another such button cycles through the non-cubic input projections.  Menu items for these have been removed.
-- Mouse control can be made vertical-only by holding Alt. or horizontal-only by holding Control.  This may not work on Linux, depending on X11 option setup.
-- Framing shifts are displayed on status line, and reset along with eye shifts.
-- More errors in the input mappings have been fixed.

Known issues and limitations:
-- Cubic pano load fails unpredicatably on some OSX systems.
   If you are a Mac graphics expert, please help debug this!
-- on OSX, after a failed cubic load, no cubic pano can be
   loaded until Panini is restarted.
-- on OSX, cancelling a qtvr load may cause subsequent loads
   to fail.
-- Displayed vFov angle is correct only for the panosphere
   and eye distances between 0 and 1.
-- still does not read PT scripts/projects
-- To save high resolution views, your OpenGL must support 
off-screen framebuffers of arbitrary size. 

There are no longer any test images in the souce code package.
A set of test images, all made from one spherical panorama, 
is available for download as a separate package.

The win32 binary package has been built with Qt 4.4.3, and
contains executable Qt libraries from that version.  But
Qt version 4.4.1+ is probably sufficient.

LICENSE

panini 0.6 is free software, copyright (C) 2008 Thomas K Sharpless.  
You can redistribute and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

panini is distributed in the hope that it will be useful, but WITHOUT 
ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or 
FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License 
for more details.

You should have received a copy of the GNU General Public License
along with panini; if not, write to Free Software Foundation, Inc.,
59 Temple Place, Suite 330, Boston, MA  02111-1307  USA

