#############           Example Script                  ##########################
#                       to run PTStitcher
#
#
# Only lines starting with 'p', 'v','o', i', or 'm' are read, 
# so you can add comments and info as you like by using 
# other line starting characters.  
# The * character at the first of a line indicated the end of the script file.

# The stitcher script must contain:
# one 'p'- line describing the output image (eg Panorama)
# one 'o'-line for each input image
# one 'i' line for each input image that is optional
# the 'm'-line is optional and allows you to specify modes for the optimization.
# the 'C'-line is optional and allows morphing of control points.

# if a v line is present it is read and verified that the parameters match images but is not used.

# 'p'-line options
# w1000        width in pixels
# h600         height in pixels (default: width/2)
# f0           projection format,
#                  0 - Rectilinear (for printing and viewing)
#                  1 - Cylindrical (for Printing and QTVR)
#                  2 - Equirectangular ( for Spherical panos), default
#                  3 - Fisheye Equidistance full-frame
#                  4 - Fisheye Stereographic full-frame
#                  5 - Mercator
#                  6 - Transverse Mercator
#                  7 - Sinusoidal
#                  8 - Lambert Equal Area Cylindrical
#                  9 - Lambert Azimuthal
#                 10 - Albers Equal Area Conical
#                 11 - Miller Cylindrical
#                 12 - Panini (for wide angle printing and viewing)
#                 13 - Architectural (combines Miller Cylindrical and Lambert Azimuthal)
#                 14 - Fisheye Orthographic full-frame
#                 15 - Fisheye Equisolid full-frame

#
# P"p1 p2 ..."    Optional parameters for some projections
#
#                 for f10 - 0, 1 or 2 parameters corresponding to the
#                 standard parallels.  If no parms specified
#                 defaults to <20,60>. If one given P1 == P2
#
# v360         horizontal field of view of panorama (default 360)
# nPICT        Panorama file format, one of:
#                  PICT          pict-file on macs, bmp-file on win (default)
#                  PSD           single layer Photoshop file, 48bits supported
#                  PNG           png-format, 48bits supported
#                  TIFF          tiff-format, 48bits supported
#                  PSD_mask      Photoshop file, one image per layer
#                                  + shape mask & feathered clip mask at overlap center
#                  PSD_nomask    Photoshop file, one image per layer,
#                  TIFF_mask     tiff-format, multi-file, one image per file, 48bit supported
#                                  alpha layer with feathered clip mask at overlap center
#                  TIFF_m        tiff-format, multi-file, one image per file, 48bit supported
#                                  alpha layer with non-feathered clip mask at image border
#                                  + shape mask & non-feathered clip mask at image border
#                  JPEG          Panoramic image in jpeg-format. Use with f1
#                                  for IBM Hotmedia panoramas.
#                  PAN           SmoothMove movie. Use only with f2.
#                  IVR           LivePicture IVR movie
#                                  cylindrical (format f1) or spherical (format f2)
#                  IVR_java      LivePicture Java Panorama,
#                                  cylindrical (format f1) or spherical (format f2)
#                  VRML          VRML background node, use only with f2 for panoramas, or
#                                  VRML-object for PTStereo
#                  QTVR          Apple QTVR-panomovie. Use only with f1
#                  3DMF          3DMF-object (PTStereo).
#
# n"QTVR w400 h300 c1"           additional viewer options in a quoted string together with format
#              the following options are recognized:
#                  w(width) and h(height) of viewer window (only QTVR on Macs)
#                  c(codec: 0-JPEG, 1-Cinepak, 2-Sorenson) (only QTVR on Macs)
#                  q(codec quality):
#                     0-high,1-normal,2-low    QTVR on Macs
#                     0-100(highest)           on other jpeg-formats (PAN, IVR, IVR_java, VRML)
#                  g  progressive jpeg (0-no, 1-yes) (PAN, IVR, IVR_java, VRML)
#                     Optimized JPEG (0-on(default), 2-disabled), (3-progressive with optimized disabled)
#                  p  initial pan angle ( QTVR on Macs, VRML, IVR)
#                  v  field of view (QTVR, VRML, IVR)
#
# n"TIFF_m  c:LZW r:CROP"        additional viewer options in a quoted string together with format
#              the following options are recognized for TIFF_m:
#                  c:LZW  enable LZW compression
#                  r:CROP enable cropping to ROI (default)
#                  r:UNCROP disable cropping to ROI
#
#                  Many more options can be set by editing the viewer scripts
#
# u10          width of feather for stitching all images. default:10
# k1           attempt color & brightness correction using image number as anchor
# b1           attempt brightness correction with no color change using image number as anchor
# d1           attempt color correction with no brightness change using image number as anchor
#                  Do not use more than one of k, d, b.This is new method of correcting

p w800 nPSD_mask


# The 'i' lines describe input images and is optional
# nName        file name of the input image.
#                  over ridable with command line parameters to PTStitcher

i n"photo1.jpg"


# The 'o' lines describe input images. One line per image is required
# The width and height of the image is obtained from image
# f0           projection format,
#                  0 - Rectilinear (normal lenses)
#                  1 - Panoramic (Scanning cameras like Noblex)
#                  2 - Fisheye Equidistance Circular
#                  3 - Fisheye Equidistance full-frame
#                  4 - Equirectangular (Spherical panos)
#                  7 - Mirror
#                  8 - Fisheye Orthographic (This is only allowed in PTStereo and
#                         for the first image. This indicates a map or ground plan)
#                 10 - Fisheye Stereographic
#                 19 - Fisheye Equisolid
# v82          horizontal field of view of image (required)
# y0           yaw angle (required)
# p43          pitch angle (required)
# r0           roll angle (required)
# a,b,c        lens correction coefficients (optional)
#                  (see http://www.fh-furtwangen.de/~dersch/barrel/barrel.html)
# d,e          initial lens offset in pixels(defaults d0 e0, optional).
#                  Used to correct for offset from center of image
#                  d - horizontal offset,
#                  e - vertical offset
# g,t          initial lens shear.  Use to remove slight misalignment
#                  of the line scanner relative to the film transport
#                  g - horizontal shear
#                  t - vertical shear
# Tx,Ty,Tz,Ts  tilt values.  Use to correct for off NPP nadir images
#                  Tx the x offset of the camera (default Tx0)
#                  Ty the y offset of the camera (default Ty0)
#                  Tz the z offset of the camera (default Tz0)
#                  Ts the scale offset of the camera (default Ts1, valid for values > 0)
# +buf         (obsolete, -buf and +buf are now ignored when stitching)
#                  load and merge image with buffer
# -buf         (obsolete, -buf and +buf are now ignored when stitching)
#                  save result to buffer. The first 'o' line should
#                  contain one '-buf' command, the last line one '+buf'
#                  command, and all other lines both '+buf -buf'
#                  Exception: remove all 'buf' commands when
#                  creating Photoshop-files to preserve the original images.
# S100,600,100,800   Selection(l,r,t,b), Only pixels inside the rectangle will be used for conversion.
#                       Original image size is used for all image parameters
#                       (e.g. field-of-view) refer to the original image.
#                       Selection can be outside image dimension.
# C100,600,100,800   Crop(l,r,t,b), Only pixels inside the rectangle will be used for conversion.
#                       Cropped image size is used for all image parameters
#                       (e.g. field-of-view) refer to the cropped part of the image.
# m20          (obsolete, use S & C) ignore a frame 20 pixels wide. default: 0
# mx100        (obsolete, use S & C) crop to brightest rectangle with size 100x200;
# my200        (obsolete, use S & C) used only for circular fisheye images (f2)
# s0           (obsolete, ignored, always blend) specify placement of seam between buffer and image:
#                  0-middle of overlap('blend' ,default)
#                  1- at edge of image ('paste').
# o            (the small letter). Morph-to-fit using control points.

o f2 r0   p0    y0     v183    a0 b-0.1 c0  S100,600,100,800
o f2 r0   p0    y180   v183    a0 b-0.1 c0  S100,600,100,800


# 'm'-line options
# ----------------
# Set mode for stitcher, not required
#
# g2.5         Set gamma value for internal computations (default 1.0)
#                  See <http://www.fh-furtwangen.de/~dersch/gamma/gamma.html>
# i2           Set interpolator, See <http://www.fh-furtwangen.de/~dersch/interpolator/interpolator.html>
#                one of:
#                   0 - poly3 (default)
#                   1 - spline16,
#                   2 - spline36,
#                   3 - sinc256,
#                   4 - spline64,
#                   5 - bilinear,
#                   6 - nearest neighbor,
#                   7 - sinc1024
#              \/ antialiasing filters \/ See <http://www.pano2qtvr.com/dll_patch/>
#                   8 - Box
#                   9 - Bartlett/Triangle
#                   10 - Hermite
#                   11 - Hanning
#                   12 - Hamming
#                   13 - Blackmann
#                   14 - Gaussian 1/sqrt(2)
#                   15 - Gaussian 1/2
#                   16 - Quadardic
#                   17 - Cubic
#                   18 - Catmull-Rom
#                   19 - Mitchell
#                   20 - Lanczos2
#                   21 - Lanczos3
#                   22 - Blackman/Bessel
#                   23 - Blackman/sinc
#                   
# f0		   Invoke Faster Transformation. Increase the speed of transformation with the side effect a little distortion
#                   0 Fastest speed, some distortion
#                   1 Some speed, little distortion
#                   - anything else turns off Faster Transformation (default)

m g1.5 i6 f0


#
# 'z'-lines options
# ----------------
# Extended Depth-Of-Field, not required
#
# Automatically determine, for every point in a picture, which of mumerous overlapping 
# images has best focus.  Masks are generated to reveale the best focused parts of 
# each image.  Feathering must be selected.  Used with PSD_mask or TIFF_mask file format
# to edit the mask or with flattened file formats for flattened final result.   Does not
# work if color and/or brightness correction are invoked.
#
# m2           mask type
#                m0 hard-edged masks, mutually exclusive
#                m1 hard-edged masks, stack of nested masks
#                m2 blended masks, stack of nested masks (default & strongly recommended)
#                   (this option includes a smoothing computation that seems to help a lot.)
# fN           focus estimation window size, N = halfwidth of window.
#                Recommended value is 0.5% of image width, e.g. 4 pixels for an 800-pixel image.
#                Computation cost for focus estimation increases proportional to N^2.  Default f4.
# sN           smoothing window size, N = halfwidth of window.
#                 Recommended value is 0.5% of image width, e.g. 4 pixels for an 800-pixel image.
#                 Computation cost for smoothing increases proportional to N^2.  Default s4.

z m2 f4 s4


#
# 'C' lines
# ----------------
# Morphing of control point lines
# One line per point
# Created automatically by optimizer
#
# i0           image
# x363.726     starting x point position
# y125.738     starting y point position
# X363.838     morphed x point position
# Y125.618     morphed y point position

C i0  x363.726 y125.738 X363.838 Y125.618



*
Every thing after * is ignored.

