Batch Builder [PTGui Pro only]
In combination with the Batch Stitcher,
Batch Builder is a tool for stitching a large number of panoramas in
batch. The Batch Builder is input with one or more folders with
images and optionally a template project. It analyzes the source
folders to find groups of images that form a panorama. Finally
files are created for each group of images. The generated project
can then be sent to the Batch Stitcher for processing.
The Batch Builder is
accessed by selecting Batch Builder in the Tools menu. Use it as
1. Create a template
A template can be used to define specific settings for the projects
be created. Using a template for the Batch Builder is optional, you
could choose to let PTGui Pro use default settings instead.
To create a template, start a new PTGui Pro project, set the desired
parameters and choose File -> Save As Template. Some guidelines
creating templates for use with the Batch Builder:
- Do not enter an output file name in the Create Panorama
tab. Instead set it to Use Default, and set the desired output
name in the File Naming section of the Project Settings.
generated projects would write to the same panorama file.
- In the File Naming section of the Project Settings choose:
Panorama: Save as: Same as project name
The Batch Builder will ensure that the project names are unique
optionally appending (1), (2) etc. to the name. Due to this when
the above setting the output file names will be unique as well.
- Often all panoramas will have been shot using the same known
lens. If so, it may be desirable to use predefined lens settings
instead of letting PTGui Pro override the lens based on the EXIF
This can be achieved by unchecking 'Use EXIF data to set the
parameters when adding the first image' in the Project Settings.
do this, don't forget to set the appropriate lens settings in
template in the Lens Settings tab.
- Circular fisheye images need to be cropped but the cropping
circle will differ for each camera and lens. To predefine the
- Load one of your source images in the template project (to
adjust the cropping the project should have at least one
- Adjust the cropping cirlce in the Crop
- Remove the source image again from the project. The crop
settings will be kept even when the image is removed.
- Uncheck 'Use EXIF data to set the lens parameters when
the first image' in the Project Settings tab (otherwise your
settings would be overridden based on the EXIF data)
- Set the appropriate lens settings in the Lens Settings tab
- If you would like to output panoramas with a predefined
projection and field of view, disable 'Fit panorama' and 'Choose
suitable projection' in the Project Settings. Switch to the
projection and field of view in the Panorama
Editor or Panorama
- If you would like to output to a panorama with specific pixel
dimensions, disable 'Set output to the maximum size...' in the
Settings and set the desired size in the Create Panorama
- Be sure to enable 'Do Align Images and save the modified
at Batch Stitcher Actions in the Project Settings; this ensures
control points will be generated for the new projects.
- If you would like to inspect the generated projects before
actually are stitched, disable 'Create the Panorama' at Batch
Actions in the Project Settings. Thus the batch stitcher will
generate control points, set up the panoramas and save the
projects. After inspecting and possibly tweaking the projects,
them to the Batch Stitcher again for the final stitching.
When the template has been set up, choose File -> Save As
to save it.
2. Detect panoramas
Launch the Batch Builder from the Tools menu. The topmost part of
window contains a list of image groups, initially empty.
Press Generate new projects. This opens the Detect Panorama
Settings dialog. Three different detection methods are available:
Use the Image file extension field to restrict the search to
files with certain extensions. Enter one or more file name
extensions, without leading period, separated by commas. For example
tif, jpg searches only for jpeg and tiff files. Leave this
box empty to have the batch builder search for all supported image
- One panorama per folder:
Use this if you have already organized your source images in
folders for each panorama. PTGui Pro will look in the chosen
all sub folders, sub sub folders and so on, and generate project
files for each folder that contains one or more images. Each
file will contain all images found in that folder.
- Multiple panoramas per folder with a fixed number of images:
Use this method if all source images are in one folder and all
panoramas should have a fixed number of images. For example if a
contains 100 images and the number of images per panorama is set
the result will be 15 projects with 7 images each (except for
one). Images are sorted and grouped alphabetically.
- Group images taken around the same time:
Projects will be detected based on the shooting date/time:
be considered to form a panorama if they were taken within the
specified number of seconds after each other. Additional filter
criteria allow you to filter based on the focal length and only
subsequent images that have the same focal length, exposure
aperture and/or ISO value.
Press OK to start the detection process.
3. Modify source image
When detection has finished, the Batch Builder proposes a list of
The actual project files have not been created yet and the image
can still be modified:
Press the red cross button to remove an image from a project. Use
images link to add an image to a project. Remove a project by
clicking Remove Project.
Projects can be split in two by clicking inbetween two images
will appear). Similarly, two adjacent projects can be combined using
the Combine with next link.
If a project contains more images than can be displayed in a single
(such as the second project in the above screenshot), the images
be collapsed with a number indicating the total number of images.
Expand the image group by clicking on one of the images, and
it by clicking again.
To create a project from a specific group of images, use New
project from source images. The selected images will be added
new row in the project list.
4. Generate the projects
When you are satisfied with the proposed projects, the actual
files can be generated:
If you have created a custom template in the first step, select it
template. Otherwise choose New empty project to let PTGui Pro
the default project settings for the newly generated projects.
The generated project files will be added to a new Batch List.
the name of the batch list at Save to Batch List, or use the
default name which is based on the current date and time. The Batch
List file will be saved to the designated Batch List folder as
/ Preferences (Folders & Files tab).
Press Generate Projects to create the project files and the
Batch List. When done, PTGui Pro will launch the Batch Stitcher for
and start processing the generated projects.
Also see: Batch Stitcher