User defined output sequence and user defined assistant

From Wiki
Revision as of 20:10, 26 February 2023 by Thomas (talk | contribs)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to 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. Since Hugin 2023.0 PTBatcherGUI can also 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 2021.1 and later lists the executor and assistant files from 2 directories in the menu bar for easier access:

  • from systemwide data directories - one for the output sequence and the other for the assistant: On Windows the paths are install directory\share\hugin\data\output and install directory\share\hugin\data\assistant, on Linux the paths are /usr/share/hugin/data/output and /usr/share/hugin/data/assistant.
  • from an user data directory. On Windows the path is c:\users\USERNAME\AppName\Roaming\hugin, on Linux the path is ~/.hugindata.