Warning, /documentation/digikam-doc/post_processing/pano_creator.rst is written in an unsupported language. File is not indexed.
0001 .. meta:: 0002 :description: The digiKam Panorama Creator 0003 :keywords: digiKam, documentation, user manual, photo management, open source, free, learn, easy, panorama, assembly, stitch 0004 0005 .. metadata-placeholder 0006 0007 :authors: - digiKam Team 0008 0009 :license: see Credits and License page for details (https://docs.digikam.org/en/credits_license.html) 0010 0011 .. _pano_creator: 0012 0013 Panorama Creator 0014 ================ 0015 0016 .. contents:: 0017 0018 .. figure:: images/pano_creator_selection.webp 0019 :alt: 0020 :align: center 0021 0022 The Panoramic JPEG Files Selected from Icon-View (7x24Mpx Images taken with Sony A77 - 59 Mb) 0023 0024 A panorama is a composition of photo taken in the same conditions with the same camera/lens. The camera turn around the same point of view to shot with many photos a wide-angle view which is a representation of a large physical space. Images must be taken with superimposed area on the borders. Algorithm will try to found the common portions of images to join and merge contents. To be sure about stability you can use a tripod especially with complex compositions. The tool allows to assemble shots taken horizontally, vertically, or as a matrix. 0025 0026 .. note:: 0027 0028 Take a care that target panorama is a huge amount of data and requires a lot of memory to be processed. 0029 0030 Select the images that you want to stitch and go to :menuselection:`Tools --> Create Panorama` a wizard dialog will open up as below. 0031 0032 .. figure:: images/pano_creator_01.webp 0033 :alt: 0034 :align: center 0035 0036 The Panorama Creator Wizard with the Hugin Components Detection 0037 0038 This plugin is based on the `Hugin command line tools <https://hugin.sourceforge.io/>`_ to analyze and assemble the items. If all software components are found on your system, just select the output format that you prefer to render the panorama and click on **Next** button. The page below must appears: 0039 0040 .. figure:: images/pano_creator_02.webp 0041 :alt: 0042 :align: center 0043 0044 The Panorama Creator Wizard with the List of Items to Assemble 0045 0046 Arrange the images in correct order if they are not, using the **Up** and **Down** buttons. Use the buttons with the **Plus** and **Minus** symbols to add or remove items. If you want to render a 360° panorama, the first image from the list will be the item placed on the center of the panorama. When all is done, click on **Next** button. 0047 0048 .. figure:: images/pano_creator_03.webp 0049 :alt: 0050 :align: center 0051 0052 The Panorama Creator Wizard Pre-Processing Stage 0053 0054 The option **Detect moving skies** allows an automatic detection of clouds to prevent wrong key-points matching between images due to moving shapes. To be more precise, during the control points selection, the process discards any points that are associated to a possible cloud. This is useful to prevent moving clouds from altering the control points matching process do by the algorithms. Depending of the scene contents, turn on the option and press **Next** button to pre-process items. 0055 0056 .. figure:: images/pano_creator_04.webp 0057 :alt: 0058 :align: center 0059 0060 The Panorama Creator Wizard Optimizations Stage 0061 0062 The optimizations page includes another option named **Level horizon** dedicated for horizontal scene. Turn on this setting to detect the horizon and adapt the projection accordingly. The detected horizon will be an horizontal line in the final panorama. If you scene is a vertical composition, you can ignore this setting. Click on the **Next** button to preview the result. 0063 0064 .. figure:: images/pano_creator_05.webp 0065 :alt: 0066 :align: center 0067 0068 The Panorama Creator Wizard Preview Stage 0069 0070 In this page the images are assembled, you can judge of the result, and crop the contents to drop black frames around your scene. By default, the tool is able to detect automatically the effective region of the panorama. If you move the mouse over the preview canvas, a toolbar must appears on top left corner to **Zoom In**, **Zoom Out**, and **Zoom to Fit** on the image. With a right click with the mouse, you can re-define a new crop area. When all in fine, click on **Next** button to process final composing of the panorama. 0071 0072 .. figure:: images/pano_creator_06.webp 0073 :alt: 0074 :align: center 0075 0076 The Last Page of the Panorama Creator Wizard 0077 0078 After a long computation, panorama stitching will be complete and the tool will propose a template name for the target file. If you want you can also save your project compatible with Hugin. Click on **Finish** button and you will see the output in the same **Album** as your original pictures. 0079 0080 .. note:: 0081 0082 The 7x24Mpx images (59 Mb) used as example in this section of this manual give one single post-processed panoramic JPEG file of 82 Mpx (23 Mb). 0083 0084 .. figure:: images/pano_creator_final.webp 0085 :alt: 0086 :align: center 0087 0088 The Assembled Panoramic JPEG Files Displayed in digiKam