Tree [fc97a3] libpano / tools /
 History



File Date Author Commit
 compat_win32 2006-12-12 dangelo dangelo [9fed6f] make trunk buildable with MSVC 2003. Instructio...
 .cvsignore 2009-02-02 brunopostle brunopostle [ef403c] housekeeping
 CMakeLists.txt 2009-09-28 kornelbenko kornelbenko [e0514f] Use the correct target to add dependencies
 ChangeLog 2006-10-25 dmg dmg [778c42] 2006-10-24 dmg <dmg@uvic.ca>
 Makefile.am 2010-07-24 brunopostle brunopostle [3293a4] Fixes for building on Solaris (Robert Campbell)
 PTAInterpolate.c 2008-01-26 jim0watters jim0watters [349c3d] Fix some warning messages
 PTAInterpolate.vcproj 2010-01-13 tksharpless tksharpless [56c6be] MSVC projects updated
 PTOptimizer.vcproj 2010-01-13 tksharpless tksharpless [56c6be] MSVC projects updated
 PTainterpolate.rc 2007-12-31 jim0watters jim0watters [c7051d] Update trunk to be pano13. Create a name separ...
 PTblender.c 2009-11-10 dmg dmg [322508] Went too far in revert, reverting revert of 1120
 PTblender.rc 2007-12-31 jim0watters jim0watters [c7051d] Update trunk to be pano13. Create a name separ...
 PTblender.vcproj 2010-01-13 tksharpless tksharpless [56c6be] MSVC projects updated
 PTcrop.c 2006-12-12 dangelo dangelo [9fed6f] make trunk buildable with MSVC 2003. Instructio...
 PTcrop.rc 2007-12-31 jim0watters jim0watters [c7051d] Update trunk to be pano13. Create a name separ...
 PTcrop.vcproj 2010-01-13 tksharpless tksharpless [56c6be] MSVC projects updated
 PTinfo.c 2009-09-28 kornelbenko kornelbenko [1ee8b4] Remove unneded include.
 PTinfo.rc 2007-12-31 jim0watters jim0watters [c7051d] Update trunk to be pano13. Create a name separ...
 PTinfo.vcproj 2010-01-13 tksharpless tksharpless [56c6be] MSVC projects updated
 PTmasker.c 2009-10-08 jim0watters jim0watters [117fcb] ColourBrightness.c, file.c, hdrfile.c, main.c, ...
 PTmasker.rc 2007-12-31 jim0watters jim0watters [c7051d] Update trunk to be pano13. Create a name separ...
 PTmasker.vcproj 2010-01-13 tksharpless tksharpless [56c6be] MSVC projects updated
 PTmender.c 2009-10-08 jim0watters jim0watters [344932] Move function to PTCommon where it belongs.
 PTmender.h 2009-10-08 jim0watters jim0watters [117fcb] ColourBrightness.c, file.c, hdrfile.c, main.c, ...
 PTmender.rc 2007-12-31 jim0watters jim0watters [c7051d] Update trunk to be pano13. Create a name separ...
 PTmender.vcproj 2010-01-13 tksharpless tksharpless [56c6be] MSVC projects updated
 PToptimizer.c 2008-01-05 jim0watters jim0watters [f5f394] - Added FastTransform to the data structures re...
 PToptimizer.rc 2007-12-31 jim0watters jim0watters [c7051d] Update trunk to be pano13. Create a name separ...
 PTroller.c 2009-10-08 jim0watters jim0watters [117fcb] ColourBrightness.c, file.c, hdrfile.c, main.c, ...
 PTroller.rc 2007-12-31 jim0watters jim0watters [c7051d] Update trunk to be pano13. Create a name separ...
 PTroller.vcproj 2010-01-13 tksharpless tksharpless [56c6be] MSVC projects updated
 PTtiff2psd.c 2009-09-28 kornelbenko kornelbenko [1ee8b4] Remove unneded include.
 PTtiff2psd.rc 2007-12-31 jim0watters jim0watters [c7051d] Update trunk to be pano13. Create a name separ...
 PTtiff2psd.vcproj 2010-01-13 tksharpless tksharpless [56c6be] MSVC projects updated
 PTtiffdump.c 2010-01-13 tksharpless tksharpless [56c6be] MSVC projects updated
 PTtiffdump.rc 2007-12-31 jim0watters jim0watters [c7051d] Update trunk to be pano13. Create a name separ...
 PTtiffdump.vcproj 2010-01-13 tksharpless tksharpless [56c6be] MSVC projects updated
 PTuncrop.c 2006-12-12 dangelo dangelo [9fed6f] make trunk buildable with MSVC 2003. Instructio...
 PTuncrop.rc 2007-12-31 jim0watters jim0watters [c7051d] Update trunk to be pano13. Create a name separ...
 PTuncrop.vcproj 2010-01-13 tksharpless tksharpless [56c6be] MSVC projects updated
 README.PTmender 2006-04-11 dmg dmg [8c18fe] 2006-04-10 dmg <dmgerman@uvic.ca>
 panoinfo.c 2007-12-31 jim0watters jim0watters [c7051d] Update trunk to be pano13. Create a name separ...
 panoinfo_unix.c 2009-12-27 dmg dmg [86e5f5] Added name of projection, which I forgot to do ...

Read Me

PTmender
--------

This is a rewrite of PTStitcher. It has most of its functionality (see
below) and it should be (for most people) a drop in replacement for
PTstitcher. 


----------------------------------------------------------------------
HOW TO HELP.

* Man pages for PTmender and PTblender.

* Create test cases.  We need to create some test cases that we can
   use to verify if PTmender works _exactly_ as PTStitcher. This will
   require some panorama scripts and the images, and some scripts to
   verify the results.

* See TODO list and WHAT IS NOT GOING TO BE SUPPORTED for more ideas.


----------------------------------------------------------------------

TODO:

* Testing. I am sure there are defects in the implementation that need
  to be spotted and then removed.

* Fully support 16 bit images. I don't quite remember what is done so
  far, but I am planning to support 16 bit images in all the stages of
  PTmender and PTblender.

* Improving seam computation. The current algorithm is very poor.

----------------------------------------------------------------------
WHAT IS NOT GOING TO BE SUPPORTED

These are features present in PTstitcher that I am not interesting in
adding to PTmender. But I'll be happy to accept patches for them:

* The following output formats:

  WTVR
  IVR_java
  VRML
  IVR
  PAN
  

* 16bit Multi-layer PSD output. We do not know the format of these
  types of PSD files. Either use 8 bit images, or generate TIFFs and
  read them into photoshop.
  

----------------------------------------------------------------------

COMMAND LINE OPTIONS

-s     Sort image files. I assume that the processing of the files
       (by default) is in the command line order. This overrides it.

-q     Quiet execution. Do not display progress messages during
       execution.

-o     Specify the name of the result panorama file.

-f     Specify the name of the script file.

The program assumes that the last file specified in the command line
with a .txt extension is the script (even if the -f option is
specified). This means that if the script has no .txt extension it is
treated as an image (in that case use -f option).

If a command line argument is a directory, any files in it are
processed (non-recursively) as if they were all specified in the
command line.

Any other command line argument that is a file is treated as an image.


If the command line does not have any image in it, then the script is
processed and any references to images in it are processed.

If the command line does not have a script file, then the user is
asked for it.

----------------------------------------------------------------------