---
name: "pto_gen"
section: "1"
platform: "linux"
package: "hugin"
version: "2025.0.1-5"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/pto_gen"
---

# pto\_gen(1)

Generate a Hugin project file from a list of images.

## NAME

pto\_gen - Generate a Hugin project file from a list of images.

## SYNOPSIS

**pto\_gen** \[options\] *image* \[...\]

## DESCRIPTION

**pto\_gen** assembles a Hugin .pto project file that is suitable as input for further tools such as the **cpfind** control-point generator, or for opening with the Hugin panorama GUI itself.  Functionality is similar to **match-n-shift**.

## USAGE

```
   pto_gen *.jpg
```

This creates a project file from all jpg images, in the same folder as the first photo. The project file is named first\_file-last\_file.pto using the same convention as the Hugin GUI.

## OPTIONS

- **-o\|--output** *file*

  Output Hugin PTO file.

- **-p\|--projection** *num*

  Projection type (default: 0)

- **-f\|--fov** *float*

  Horizontal field of view of images (default: 50)

- **-c\|--crop=left,right,top,bottom**

  Sets the crop of input images (especially for fisheye lenses)

- **-s\|--stacklength** *num*

  Number of images in stack (default: automatic detection)

- **-l\|--linkstacks**

  Link image positions in stacks

- **--distortion**

  Try to load distortion information from lens database

- **--vignetting**

  Try to load vignetting information from lens database

- **-h\|--help**

  shows help

## AUTHORS

Thomas Modes