TG2QTVR README
Last modified: 28/02/2007
================================

This set of tools is the minimum set of files required from Panorama Tools and PanoCUBE that I use to create QTVR panoramas from Terragen (any version)

================================
Installation:
================================

Pano12.dll v2.7.0.11
--------------------

If you already have pano12.dll installed in your system directory and you answered NO to replacing it during the installation process you should delete the pano12.dll file included here.


Manual install
--------------------

The following steps should only be required if you manually extracted the files from TG2QTVR.exe or disabled the autosetup during extraction.

1: Extract these files to a separate directory. The path to PTStitcher should not have any spaces in it so it is best to create a directory directly off from the root directory e.g. C:\TG2QTVR\
2: Run setup.bat OR drag PTStitcher.exe onto the PanoCUBE.exe icon
   You only need to do this once.

================================
Usage with TG2 for dummies:
================================

1: Render 6 cube faces (or the first 4 for a cylindrical panorama)
-------------------------------------------------------------

In Terragen set your camera to use a horizontal field of view of 90 and your rendered output should have the same height and width.
Render six images with the following camera roation angles, and save them with the corresponding filename into the same directory as PTStitcher and PanoCUBE.
 
-----------------------------------------
Camera Rotation angles		Filename
-----------------------------------------
0	0	0		000.bmp
0	90	0		090.bmp
0	180	0		180.bmp
0	270	0		270.bmp
90	0	0		+090.bmp
-90	0	0		-090.bmp
-----------------------------------------



2: Stitch the cube faces to a seamless panorama
-------------------------------------------------------------

After rendering your images :

Run (double-click on) stitch_cube.bat
	*OR*
Drag the PTSTicher_script.txt onto the PTStitcher.exe icon.


Enter the filename for your output image when prompted (Don't add the file extension or attempt to save it into another directory). This will create a TIFF file 2000x1000 pixels in size of your stitched panorama.


3: Convert to QTVR
-------------------------------------------------------------

Drag the TIFF file created above onto PanoCUBE.exe

This will create a QTVR file of your panorama.

==================================
Basic Settings options
==================================

1: PTSticther

Panorama size/ cube face filenames.

Open PTSTicher_script.txt and edit the following lines:

	p w2000 h1000 f2 v360 u0 n"TIFF"

The numbers after w and h refer to the width and height of the stitched output file in pixels. These must be in the ratio of 2:1 but can be adjusted to any size you want (depending on how much RAM you have)

	i n"000.bmp"

The lines beginning with i contain the input filenames. You can change these if desired (e.g. you're using a script to automatically generate a numbered sequence of images). Full paths to files can also be included.

2: PanoCUBE

The settings for PanoCUBE are located in the file Script.txt There are comments in this file that will help you adjust your settings.

DO NOT change the name of this file. When PanoCUBE starts, it looks for this file in the same location as the image you are converting. For this reason it's simpler to copy/save/move your stitched image into this folder.


==================================
Cylindrical Panoramas
==================================

For those who just want a static image without the extra distortion at the top and bottom I have included an additional pre-configured script for stitching a cylindrical panorama from 4 x 90 images. The process is pretty much the same as for rendering the cube, without the last two images. You can set your image height to be anything. An image ratio of 0.5 (height is 2x width) works well. 

After rendering your images :

Run (double-click on) stitch_cylinder.bat
	*OR*
Drag the PTSTicher_script.txt onto the PTStitcher.exe icon.

The settings included produce a panoramic image with a vertical field of view of about 120.

After stitching the panorama simply open it and crop the top and bottom if required.

Do not use this image with PanoCUBE as it will not give you the correct result. If you don't want to  render the top and bottom cube faces for a QTVR, just leave them out, and adjust the max and min pitch angles in the PanoCube script file to restrict the range of movement.



==================================
File List
==================================

PTSTITCHER
---------------

PTStitcher.exe	Commandline stitching program from Panorama Tools

pano12.dll	dll file used by PTStitcher.exe. 
		This file is moved to %windir%\system32 during installation 
		but will also work in the same directory as PTStitcher.exe.

PTStitcher_cube_script.txt	Script used with PTStitcher.exe to crate an 
				equiractangular panorama from 6 images.
stitch_cube.bat		Commandline batch file to run the above script with PTStitcher

PTStitcher_cyl_script.txt	Script used with PTStitcher.exe to crate a 
				cylindrical panorama from 4 images.
stitch_cylinder.bat	Commandline batch file to run the above script with PTStitcher



PANOCUBE
---------------

PanoCUBE.exe	Program to convert an equirectangular image in to a cubic QTVR
		Requires PTStitcher
PCB.INI		Initialsiation file for PanoCUBE.exe

Script.txt	QTVR conversion settings for PanoCUBE



Documentation
---------------
	
README.txt			This file
Documentation_PTStitcher.txt	Documentation file for PTStitcher.exe
Readme_PanoCube.txt		Readme file distributed with PanoCUBE
Readme_PanoTools.txt		Readme file distributed with Panorama Tools
setup.bat			Commandline batch file to configure the software for first use
				This file will self-destruct once run
