samples/python/stitching.py

A basic example on image stitching in Python.

#!/usr/bin/env python

'''
Stitching sample
================

Show how to use Stitcher API from python in a simple way to stitch panoramas
or scans.
'''

# Python 2/3 compatibility
from __future__ import print_function

import numpy as np
import cv2 as cv

import argparse
import sys

modes = (cv.Stitcher_PANORAMA, cv.Stitcher_SCANS)

parser = argparse.ArgumentParser(prog='stitching.py', description='Stitching sample.')
parser.add_argument('--mode',
 type = int, choices = modes, default = cv.Stitcher_PANORAMA,
 help = 'Determines configuration of stitcher. The default is `PANORAMA` (%d), '
 'mode suitable for creating photo panoramas. Option `SCANS` (%d) is suitable '
 'for stitching materials under affine transformation, such as scans.' % modes)
parser.add_argument('--output', default = 'result.jpg',
 help = 'Resulting image. The default is `result.jpg`.')
parser.add_argument('img', nargs='+', help = 'input images')

__doc__ += '\n' + parser.format_help()

def main():
 args = parser.parse_args()

 # read input images
 imgs = []
 for img_name in args.img:
 img = cv.imread(cv.samples.findFile(img_name))
 if img is None:
 print("can't read image " + img_name)
 sys.exit(-1)
 imgs.append(img)

 stitcher = cv.Stitcher.create(args.mode)
 status, pano = stitcher.stitch(imgs)

 if status != cv.Stitcher_OK:
 print("Can't stitch images, error code = %d" % status)
 sys.exit(-1)

 cv.imwrite(args.output, pano);
 print("stitching completed successfully. %s saved!" % args.output)

 print('Done')


if __name__ == '__main__':
 print(__doc__)
 main()
 cv.destroyAllWindows()