User defined output sequence and user defined assistant

From PanoTools.org Wiki
Jump to: navigation, search

Normally the stitching of Hugin is controlled by the settings on the stitcher tab and by the settings in the preferences dialog. In this case you can tweak a lot of options at both places, but you can't add additional steps to the processing queue. Also the assistant has a fixed algorithm suitable for normal panorama. But for same use case (e.g. stitching scanned images or multi-row panorama with orphaned images) this algorithm is not so good suited. For adjusting the work flow the concept of user defined output sequences and user defined assistant was introduced.

In an user defined output sequence / assistant you can define which programs should be executed. So you can add additional process step or add parameters which are not exposed in the normal processing. In case of user defined output sequence the settings on the stitcher tab and in the preferences are ignored. An exception are the projection, field of view and canvas size on the stitcher tab - these are used.

The user defined output sequences are defined in .executor files, the user defined assistant in .assistant files respectively. The format of these files is described in the files doc/executor_file_format.txt and doc/assistant_file_format.txt. Hugin_executor and Hugin can use these files for stitching. Also hugin_stitch_project can handle user defined output sequences. (PTBatcherGUI can't handle the user defined output sequences and the user defined assistant.)

In Hugin you can open an executor file from any directory and stitch with the settings from this file your project. Hugin 2017.1 and later lists the executor and assistant files from 2 directories in the menu bar for easier access: from a systemwide data directory and from an user data directory. On Windows the paths are install directory\share\hugin\data and c:\users\USERNAME\AppName\Roaming\hugin, on Linux the paths are /usr/share/hugin/data and ~/.hugindata.