VRMakePano

Easy Interfaces for Creating QuickTime VR Panoramas

Change History (most recent first):

	$Log: VRMakePano_READ_ME,v $
	Revision 1.5  2001/10/18 21:34:36  turk
	Fix endian problems with preview reference atom on WIndows.
	
	Revision 1.5  2001/10/18 14:33:00  turk
	Fix endian problems with preview reference atom on WIndows.

	Revision 1.4  2001/04/23 18:59:26  turk
	Enable setting of preview compression parameters.
	
	Revision 1.3  2001/03/06 07:25:05  turk
	Make sure all tracks span the same time interval.
	
	Revision 1.2  2001/02/08 18:30:58  turk
	Add Hot Spot specification to the API. Update the known bugs list.
	
	Revision 1.1  2000/12/05 00:09:36  turk
	first checked in
	


_________________________________________________________________________________________

                                   VRMakePano
                                   __________
            Easy Interfaces for Creating QuickTime VR Panoramas
            ___________________________________________________

This version of VRMakePano was designed to be a library function more than sample code.
As such, it has minimal dependencies and a rich API.

3 types of sources are supported:
- tiled movies
- picture files
- GWorlds

4 type of destinations are supported:
- 1.x panoramas (limited support)
- 2.x vertical cylinder panoramas (rotated)
- 2.x horizontal cylinder panoramas (non-rotated)
- 5.x cubic panoramas

Most parameters are now encapsulated in a standard parameter data structure:
	VRMakeQTVRParams
All fields should be set to something, e.g. the following would be suitable for cubics:
	p.tilesH             = 1;
	p.tilesV             = 1;
	p.tileCodec          = kJPEGCodecType;
	p.tileQuality        = codecNormalQuality;
	p.previewCodec       = kJPEGCodecType;
	p.previewQuality     = codecLowQuality;
	p.sceneName          = NULL;
	p.nodeName           = NULL;
	p.dynamicQuality     = codecNormalQuality;
	p.staticQuality      = codecHighQuality;
	p.trackDuration      = 7200;
	p.wraps              = 1;
	p.minPan             =   0.0f;
    p.maxPan             = 360.0f;
    p.minTilt            = -90.0f;
    p.maxTilt            =  90.0f;
    p.minFieldOfView     =   5.0f;
    p.maxFieldOfView     = 120.0f;
	p.defaultPan         =   0.0f;
    p.defaultTilt        =   0.0f;
    p.defaultFieldOfView =  60.0f;
	p.windowWidth        = 480;
	p.windowHeight       = 320;
	p.hotSpots           = NULL;
	p.flattenerFlags     = kVRMakePano_GeneratePreview | kVRMakePano_BlurGeneratedPreview;
	p.flattenerPreviewResolution = 4;

Typical usage would then be:
	err = VRPictToQTVRXXXXPano(&p, &srcSpec, &srcHSSpec, &srcFSSpec, &dstSpec);

____________________________________________________

Known bugs:

* The API doesn't include the ability to set the hot spot codec (default: graphics 100%)
  or the fast start codec (default: JPEG 25%).
