Jump to: navigation, search

Difference between revisions of "APP/APG v2.0 Control Points Editor"

(Options)
 
(47 intermediate revisions by 9 users not shown)
Line 1: Line 1:
== Un concept novateur ==
+
== Ground Breaking Concept ==
  
 
<div style="float:right">__TOC__</div>
 
<div style="float:right">__TOC__</div>
  
Voila encore un concept novateur d'Autopano Pro qui va vous simplifier grandement les manipulations sur vos panoramas.
+
Yet another Autopano Pro & Giga innovative concept; the Control Points Editor will allow you to manipulate your panoramas with great ease, in a very efficient way.
L'idée générale de l'éditeur de points de contrôle est de pouvoir corriger manuellement les liens et les points de contrôle pour obtenir un placement optimum de vos images. En effet, il arrive parfois que le mode automatique positionne mal certaines images ou qu'il n'arrive pas à en inclure certaines. Tout cela peut être corrigé très facilement avec l'éditeur de points de contrôle.
+
The general idea behind the Control Points Editor is to be able to manually edit the Links and the Control Points to achieve an optimal alignment of the source images.   In some cases the automatic stitching mode will have trouble aligning some images, and will even exclude some of them from the panorama. This problem can easily be corrected using the Control Points Editor.
  
Mais avant de rentrer plus en détail, je vous invite à suivre le tutoriel [[lien ici]].
+
But before going into more details, we invite you to take the [[Manual_stitching_of_panoramas|tutorial]].  
  
== Présentation de l'interface ==
+
== Interface Description ==
  
Vous retrouvez la fenêtre de l'éditeur sur laquelle un maillage va se superposer. La deuxième fenêtre vous permet d'éditer les points de contrôle en sélectionnant les images ou les liens. Ce sont les points de contrôle qui permettent à Autopano Pro de placer les images entres elles.
+
Selecting the tool will modify the Editor Window display. The Editing Grid formed by a network of points connected by lines and labels will be now displayed on top of the panorama. The second window will allow you to edit the control points by selecting either the links (i.e. bounds between two or more images), or the individual source images currently included in the panorama. The control points are used by Autopano Pro to place the images within the panorama.
  
Si vous n'avez qu'un écran je vous conseille d'organiser les fenêtres comme ci dessous.
+
If you do not have a dual-monitor setup, I suggest you arrange your workspace as follow.
  
[[Image:Manuel-ctrlpoint-main.png|thumb|400px|center|Copie d'écran de l'éditeur de points de contrôle et de l'éditeur de panorama]]
+
[[Image:V2.0en-wnd-editor-ctrl-point.jpg|thumb|700px|center|Control Points Editor and Panorama Editor Screen Capture]]
  
== La barre d'outils ==
+
== Local Help Window ==
  
[[Image:Manuel-ctrlpoint-toolbar-lien.png]]
+
This area will be displayed after entering the control points editing mode. It gives access to the most important functions of the editing mode and displays a summary of the panorama’s status related to the stitching quality.  
* [[Image:group_addpicture.png]] Permet d'ajouter une image au panorama.
+
* [[Image:links_remove.png]] Suppression des images, des liens ou des points de contrôle sélectionnés.
+
* [[Image:Manuel-ctrlpoint-global-rms.png]]Informe de la qualité de l'assemblage du panorama.
+
  
=== Fenêtres de sélection ===
+
[[Image:v2.0fr-wnd-cp-editor2.png|thumb|700px|center|Local Help Window screen shot]]
 +
 
 +
 
 +
{|
 +
|-
 +
| [[Image:v2.0fr-wnd-cp-editor3.png|200px]]
 +
| valign='top' | The Local Help Window is divided in two parts :
 +
 
 +
* Tools:
 +
** a slider to hide "good" links by selecting a threshold
 +
** optimization tools
 +
*** [[image:ctrl_cleanbadpoint.png]] : Clears the links still displayed. This button is to be used in combination with the threshold slider.
 +
*** [[image:links_optimize_quick.png]] : quick optimization.  Allow for a quick optimization of the last performed changes.
 +
*** [[image:links_optimize.png]] : complete optimization.
 +
 
 +
* Information area:
 +
** The number of images, the panorama links and the total number of control points.
 +
** An estimate of the assembly quality on the panorama (RMS).
 +
*** If all goes well, this area should be empty most of the time.
 +
*** If things look suspicious the concerned links will be displayed here. The links are clickable and will open the control points editor for the appropriate images.
 +
| valign='top' | [[Image:v2.0fr-wnd-cp-editor4.png|400px]]
 +
Example of slider usage.
 +
| valign='top' | [[Image:v2.0fr-wnd-cp-editor1.png|400px]]
 +
Using the slider we can hide all the “good” links and only visualize the “bad” links.
 +
|}
 +
 
 +
== Selection Windows ==
 
{|
 
{|
 
|-  
 
|-  
 
|
 
|
==== Liste des images ====  
+
==== Image List ====
[[Image:Manuel-ctrlpoint-listeimage.png|right|thumb|Liste des images]]
+
[[Image:V2.0en-wnd-ctrlpoint-pictures.jpg|right|thumb|200px|Image List]]
La liste des images est étroitement liée à la liste des liens et à la liste des points de contrôle.
+
The Image List is closely tied to the Link List and the Control Points List.
En effet, toute image sélectionnée affichera ses liens et ses points de contrôle en commun avec les autres images.
+
By selecting an image you will effectively be able to visualize the links and the control points this particular image shares with the other images inside the panorama.
  
Cette fonctionnalité vous permet de connaitre rapidement si une image est bien liée à une autre.
+
This feature will allow you to quickly see if an image is correctly bounded to another.
  
Une image redondante peut être supprimée (touche '''Suppr.''') ou par un clique sur [[image:links_remove.png]]
+
A duplicated image can easily be deleted using the keyboard '''Delete''' key.
  
Astuce: Une sélection de toutes les images vous permet d'afficher tous les liens entre toutes les images.
+
Tip: Selecting all the images will allow you to display the global Grid of the panorama.  
 
|
 
|
==== Liste des liens ====
 
[[Image:Manuel-ctrlpoint-listelien.png|right|thumb|Liste des liens]]
 
La liste des liens est étroitement liée à la liste des images.
 
Cette à dire que lorsque que vous sélectionnez une ou plusieurs images, la liste affiche leurs liens en commun.
 
  
Il est pertinent de trier la liste par RMS (Qualité du lien ) afin d'en supprimer les mauvais (touche '''Suppr.''') ou par un clique [[image:links_remove.png]]
+
==== Link List ====
 +
[[Image:V2.0en-wnd-ctrlpoint-links.jpg|right|thumb|200px|Link List]]
 +
The Link List is closely tied to the Image List.
 +
Meaning that when selecting one or more images the list will display the links shared by the selected images.
  
Note: Plus la valeur du RMS est petite, plus la qualité du lien est bonne.
+
It is a good practice to sort the list by RMS (i.e. link quality), and to delete the bad links using the keyboard '''Delete''' key.
 +
 
 +
Note: A smaller RMS value equals a higher quality link.
 
|
 
|
==== Liste des points de contrôle ====
 
[[Image:Manuel-ctrlpoint-listectrlpoint.png|right|thumb|Liste des points de contrôle]]
 
La liste des points de contrôle est étroitement liée à la liste des images. Cette à dire que lorsque que vous sélectionnez une ou plusieurs images, la liste affiche leurs points de contrôle en commun.
 
  
Il est pertinent de trier la liste par RMS (Qualité des points de contrôle) afin d'en supprimer les mauvais (Touche Suppr.) ou par un clique [[image:links_remove.png]]
+
==== Control Points List ====
 +
[[Image:V2.0en-wnd-ctrlpoint-ctrlpoints.jpg|right|thumb|200px|Control Points List]]
 +
The Control Points List is closely tied to the Image List. This means that when selecting one or more images the list will display the control points shared by the selected images.
 +
 
 +
It is a good practice to sort the list by RMS (i.e. control points quality) and to delete the bad ones using the keyboard '''Delete''' key.
  
Note: Plus la valeur du RMS est petite et plus la qualité du point de contrôle est bonne.
+
Note: A smaller RMS value equals a higher quality control point.
 
|}
 
|}
  
== La barre d'outil de la fenêtre vue ==
+
== Viewer Toolbar ==
  
[[Image:Manuel-ctrlpoint-toolbar-ctrlpoint.png]]
+
[[Image:v1.4-manuel-ctrlpoint-toolbar-ctrlpoint.jpg]]
* Affichage des vues verticales/Horizontales: [[Image:display_horizontal.png]]/[[Image:display_vertical.png]]
+
* Views Activation / Deactivation: [[Image:display_on.png]]/[[Image:display_off.png]]
* Optimisation du panorama:[[image:links_optimize.png]]
+
* Portrait / Landscape Layout: [[Image:display_vertical.png]]/[[Image:display_horizontal.png]]
* Ajout des points de contrôle:[[image:ctrl_add.png]]
+
* Synchronize the views: [[Image:display_linked.png]]
* Suppression des points de contrôle:[[image:ctrl_remove.png]]
+
* Launch Panorama Optimization: [[image:links_optimize.png]]
* Ajout automatique de points de contrôle/liens:[[image:ctrl_ga.png]]
+
* Add Control Points to the selected areas: [[image:ctrl_add.png]]
* Suppression automatique des mauvais points:[[image:ctrl_cleanbadpoint.png]]
+
* Delete Control Points from the selected areas: [[image:ctrl_remove.png]]
* Ajout et suppression automatique des points de contrôle/liens: [[image:ctrl_autotune.png]]
+
* Automatically add links/control points: [[image:ctrl_ga.png]]
 +
* Automatically delete bad Control Points: [[image:ctrl_cleanbadpoint.png]]
 +
* Automatically add and delete Links/Control Points: [[image:ctrl_autotune.png]]
 +
* Find orphan images locations: [[image:Ctrl_guess_location.png]]
 
* Options: [[image:settings.png]]
 
* Options: [[image:settings.png]]
  
=== [[image:links_optimize.png]] Optimisation du panorama ===
+
=== [[image:links_optimize.png]] Panorama Optimization ===
  
Cette icône lance le calcul de l'optimisation du panorama. C'est l'opération qui va prendre en compte les changements effectués sur le panorama et ajuster celui-ci aux nouvelles contraintes.<br/>C'est une opération configurable dans les options.
+
This icon initiates the panorama’s optimization calculations. This step will take in account all the changes performed on the panorama and adjust it to the new constraints.<br/>This process can be configured in the Options Dialog.
  
=== [[image:ctrl_add.png]] Ajout de points de contrôle ===
+
=== [[image:ctrl_add.png]] Add Control Points ===
  
[[image:Manuel-ctrlpoint-add-step2.gif|right]]
+
[[image:v1.4-manuel-ctrlpoint-add-step2.gif|right]]
  
Cette icône permet d'ajouter des points de contrôle de façon automatique. Il vous suffit de tracer une zone commune sur chaque image puis d'appuyer sur la touche '''Entrer'''.
+
This icon will allow you to automatically add control points. All you need to do is to define a common area on each image and hit the keyboard '''Enter''' key.
  
 
'''Note:'''
 
'''Note:'''
  
* Plus la zone sélectionnée est petite plus la détectivité des points de contrôle est grande. Néanmoins, il se peut que l'ajout de points de contrôle échoue (aucun point de contrôle n'apparait). Essayer alors une zone plus petite.
+
* A smaller area will lead to a higher accuracy in the control points placement.   In some cases however, it is possible that adding control points will fail (i.e. no new control points are generated). In such case try a smaller area.
* Tout ajout de points de contrôle implique la création d'un lien entre les images.
+
* Adding control points implies the creation of a link between the images.
  
 
<br style=clear:right/>
 
<br style=clear:right/>
  
=== [[image:ctrl_remove.png]] Suppression de points de contrôle ===
+
=== [[image:ctrl_remove.png]] Delete Control Points ===
  
[[image:Manuel-ctrlpoint-remove-anime.gif|right]]
+
[[image:v1.4-manuel-ctrlpoint-remove-anime.gif|right]]
  
Cette icône permet de supprimer des points de contrôle. Pour effectuer l'opération, c'est très simple, il suffit de tracer une zone dans une des deux images affichées, tous les points de contrôle à l'intérieur de cette zone seront automatiquement sélectionnés. Ensuite, il faut cliquer sur cette icône ou utiliser la touche '''Suppr'''.
+
This icon will allow you do delete control points. To do so, define an area on one of the displayed images. All controls points inside the created area will automatically be selected. Next, click on the icon or use the keyboard '''Delete''' key.
  
'''Note:''' Si vous supprimez tous les points de contrôle entre une paire d'image, ça veut dire que le lien entre les 2 images n'existe plus.
+
'''Note:''' If you delete all of the control points shared by two images you are also deleting the link between those two images.
  
 
<br style=clear:right/>
 
<br style=clear:right/>
  
=== [[image:ctrl_ga.png]] Ajout automatique de points de contrôle ===
+
=== [[image:ctrl_ga.png]] Automatically Add Control Points ===
  
[[image:Manuel-ctrlpoint-geom-anime.gif|right]]
+
[[image:v1.4-manuel-ctrlpoint-geom-anime.gif|right]]
  
Cet bouton permet de faire une analyse géométrique du panorama dans son état courant. L'analyse géométrique consiste à trouver à partir des positions actuelles des images, les recouvrements existant. Pour chaque zone de recouvrement trouvé, le logiciel simule l'ajout de point de contrôle comme si vous aviez vous-même fait l'opération en traçant deux zones. Vous pouvez configurer la façon dont le logiciel va rajouter des liens dans la boite de dialogue des options de l'optimiseur.<br/>
+
The use of this button will perform a geometry analysis of the panorama in its current state. The geometrical analysis is used to find the existing overlaps from the source images current locations. For each overlapping area found, the software simulates the adding of control points, just like you would have done yourself by defining the two zones. You can configure the way the software will be adding the links in the Optimization Settings Dialog.<br/>
C'est exactement ce qu'on voit sur la copie d'écran ci-contre. L'analyse des recouvrements fait qu'Autopano Pro ajoute automatiquement les liens au centre.
+
The screen capture on the right illustrates this concept. The overlaps analysis forces Autopano Pro to automatically add links in the center of the panorama.
  
L'intérêt de cette icône est qu'en général, elle renforce la qualité du panorama, car les liens sont entre images sont plus nombreux et donc plus robuste. Ce n'est pas toujours le cas. Par exemple, pour les panorama de 360x180, cette analyse marche moins bien au niveau des pôles.
+
The main appeal of this function is that its use generally raises the panorama's quality. The number of links between the images is increasing; the individual links are then becoming stronger. But it’s not always the case. In the case of a 360x180 panorama, this analysis is less efficient at the poles.
  
 
<br style=clear:right/>
 
<br style=clear:right/>
  
=== [[image:ctrl_cleanbadpoint.png]] Suppression automatique des points de contrôle ===
+
=== [[image:ctrl_cleanbadpoint.png]] Automatically Delete Control Points ===
  
[[image:Manuel-ctrlpoint-rbd-anime.gif|right]]
+
[[image:v1.4-manuel-ctrlpoint-rbd-anime.gif|right]]
  
Cette icône permet de supprimer des points de contrôle sur toutes les images suivant 2 méthodes :
+
This icon will allow you to delete control points on all images following two methods:
* Méthode de seuil d'erreur : tous les points qui sont au-dessus du seuil maximum d'erreur sont effacés.
+
* Error threshold method: all points over a maximum error threshold will be deleted.
* Méthode des "N" meilleurs : On garde les "N" meilleurs point par lien.
+
* “N” best control points method: Only the "N" best control points per link are kept.
  
Chaque méthode a ses avantages et ses inconvénients. J'ai tendance à privilégier la deuxième méthode car celle-ci ne brisera jamais un lien (même si tous les points de contrôle sont franchement mauvais, il en gardera toujours). Ce n'est pas le cas de la méthode avec seuil d'erreur qui peut effacer tous les points de contrôle d'un lien.
+
Each method has its own upside and downside. We personally have a tendency to give a plus to the second method as it will never break a link (i.e. even if all control points are really bad, some will always remain). This is not the case with the Error Threshold method as it can very well delete all control points from a link.  The choice of method is performed in Setting dialog. It can be accessed using the    [[image:settings.png]] icon.
 +
 
 +
=== [[image:ctrl_autotune.png]] Automatically add and delete Links/Control Points ===
 +
 
 +
Selecting this tool will perform in one click the sum of actions performed by the previous two icons.
 +
 
 +
=== [[image:Ctrl_guess_location.png]] Find orphan images locations ===
 +
 
 +
Selecting this icon will enable you to find the location of those images that would otherwise have been left out during the initial stitching pass. This can arise if you chose, for example, to force using all images in a group. This method can be useful when finding yourself with images left out because of their high degree of resemblance (examples: highly homogenous blue sky, rows of identical windows on a building, etc.).
  
 
<br style=clear:right/>
 
<br style=clear:right/>
  
== Le maillage de l'éditeur ==
+
== The Editor Grid ==
  
[[image:manuel-ctrlpoint-maillage-1.jpg|right|450px]]
+
[[image:V2.0en-wnd-editor-&-ctrlpoint.jpg|right|450px]]
  
Le rôle du maillage est de visualiser les liens entre les images, et leurs qualités. Ce maillage s'affiche au-dessus de l'aperçu du panorama et permet de voir en un seul coup d'oeil les liens existant, la qualité des liens, ceux qui manquent, etc. Il permet aussi une nouvelle sélection des images et des liens.
+
The goal of the Grid is to visualize the links existing between the images and to give information on their quality. This Grid is displayed on top of the panorama preview and allow for a rapid visualization of the existing links, their quality, missing links, etc. It also allow for a new selection of the images and the links.
  
 
<br style="clear: right"/>
 
<br style="clear: right"/>
  
*'''Sélection d'une Image :'''
+
*'''Selecting an Image:'''
  
[[image:manuel-ctrlpoint-maillage-2.jpg|right|450px]]
+
[[image:V2.0en-wnd-editor-&-ctrlpoint-sel-picture.jpg|right|450px]]
  
[[image:Manuel-ctrlpoint-image.png]] représente une image avec son index dans la liste des images.<br/>
+
[[image:Manuel-ctrlpoint-image.png]] represents an image and its index in the Image List.<br/>
Lorsque vous sélectionnez une image, l'éditeur l'affiche en surimpression et des lignes rouges vous montrent toutes les images reliées.
+
When selecting an image, the Editor Window will highlight the selected image along with some red lines showing you witch images are linked to the current selection.  
  
Dans l'exemple ci contre, l'image sélectionnée (numéro 13) est reliée aux images 3, 4, 5, 6, 12, 14, 16, 17. Et si l'on regarde bien dans l'entourage, il n'y a pas d'autre image, Autopano Pro n'a oublié aucun lien, Bravo.
+
In the example given on the right, the selected image (#13) is linked to the images 3, 4, 5, 6, 12, 14, 16 and 17. And if we look closer in that area we can see that there is no other image present; Autopano Pro found all links!
  
 
<br style="clear: right"/>
 
<br style="clear: right"/>
  
*'''Multi-sélection d'images :'''
+
*'''Selecting Multiple Images:'''
  
[[image:manuel-ctrlpoint-maillage-3.jpg|right|450px]]
+
[[image:V2.0en-wnd-editor-&-ctrlpoint-sel-pictures.jpg|right|450px]]
  
Pour éditer des points de contrôle entre deux images, il suffit d'en sélectionner deux. On sélectionne la première image en cliquant dessus, la deuxième image se sélectionne en utilisant la touche ''Ctrl'' et en cliquant sur le deuxième indexe. La fenêtre des aperçus des images se met alors à jour avec les bonnes images. Il vous suffit plus que d'ajouter ou supprimer des points de contrôle.
+
In order to edit the control points shared by two images, all you need to do is select a pair of images. Click on the first image to select it, you can then select the second image by holding the keyboard ''Ctrl'' key down and by clicking on the second image. The Preview Windows will refresh and display the selected images. You can now add or delete control points.
  
 
<br style="clear: right"/>
 
<br style="clear: right"/>
  
*'''Sélection d'un lien :'''
+
*'''Selecting a Link:'''
  
[[image:manuel-ctrlpoint-maillage-4.jpg|right|450px]]
+
[[image:V2.0en-wnd-editor-&-ctrlpoint-sel-link.jpg|right|450px]]
  
[[image:Manuel-ctrlpoint-lien.png]] représente un lien avec un RMS de 1.79 et un nombre de points de contrôle de 47. Lorsque vous sélectionnez un lien, l'éditeur l'affiche avec ses deux images en surimpression. De plus, une ligne rouge relie ces deux images. Un code de couleur permet visualiser rapidement les bons liens des mauvais :
+
[[image:Manuel-ctrlpoint-lien.png]] represents a link with a RMS value of 1.79 and a number of control points of 47. When selecting a link, the Editor Window will highlight the link itself, along with the two images located at each extremity of that link. A red line connecting the two images is also displayed. A color code is used to quickly identify good and bad links:
* Vert (RMS <5) : Lien de bonne qualité.
+
* Green (RMS <5): Good quality link.
* Orange (RMS entre 5 et 10) : Lien de qualité moyenne.
+
* Orange (RMS between 5 and 10): Medium quality link.
* Rouge (RMS > 10) : Lien de mauvaise qualité.
+
* Red (RMS > 10): Poor quality link.
  
Si vous avez des liens rouges (de mauvaise qualité) cela veut dire que vous avez des mauvais points de contrôle. Vous devez les éditer. Il se peut que les images n'ont pas de relation entres elles. Dans ce cas, il suffit de supprimer le lien.
+
If you find yourself with red links (i.e. poor quality links) it means you have bad control points. The control points must be edited. It is possible that the images do not relate to each other. In such a case, delete the link.
  
 
<br style="clear: right"/>
 
<br style="clear: right"/>
  
*'''Multi-sélection de liens :'''
+
*'''Selecting Multiple Links:'''
  
[[image:manuel-ctrlpoint-maillage-5.jpg|right|450px]]
+
[[image:V2.0en-wnd-editor-&-ctrlpoint-sel-links.jpg|right|450px]]
  
Il est tout à fait possible de sélectionner plusieurs liens. L'affichage du maillage s'accordera en fonction de la sélection.
+
It is possible to select multiple links at once. The Grid display will then change to reflect the selection.
  
  
 
<br style=clear:right/>
 
<br style=clear:right/>
  
== Options ==
+
== Optimization ==
{{Option Optimisation|image=Manuel-ctrlpoint-option-optimisation-en.png|title=Optimizer Settings}}
+
{{Option Optimisation|image=V2.0en-dlg-ctrlpoint-optimization.jpg}}
 +
 
 +
== Tools ==
 +
 
 +
{{Option Tools|image=V2.0en-dlg-ctrlpoint-tools.jpg}}
 +
 
 +
[[Category: 2.0 Reference Manual]]
 +
[[fr: Editeur de points de contrôle]]

Latest revision as of 14:58, 3 February 2011

Ground Breaking Concept

Yet another Autopano Pro & Giga innovative concept; the Control Points Editor will allow you to manipulate your panoramas with great ease, in a very efficient way. The general idea behind the Control Points Editor is to be able to manually edit the Links and the Control Points to achieve an optimal alignment of the source images. In some cases the automatic stitching mode will have trouble aligning some images, and will even exclude some of them from the panorama. This problem can easily be corrected using the Control Points Editor.

But before going into more details, we invite you to take the tutorial.

Interface Description

Selecting the tool will modify the Editor Window display. The Editing Grid formed by a network of points connected by lines and labels will be now displayed on top of the panorama. The second window will allow you to edit the control points by selecting either the links (i.e. bounds between two or more images), or the individual source images currently included in the panorama. The control points are used by Autopano Pro to place the images within the panorama.

If you do not have a dual-monitor setup, I suggest you arrange your workspace as follow.

Control Points Editor and Panorama Editor Screen Capture

Local Help Window

This area will be displayed after entering the control points editing mode. It gives access to the most important functions of the editing mode and displays a summary of the panorama’s status related to the stitching quality.

Local Help Window screen shot


V2.0fr-wnd-cp-editor3.png The Local Help Window is divided in two parts :
  • Tools:
    • a slider to hide "good" links by selecting a threshold
    • optimization tools
      • Ctrl cleanbadpoint.png : Clears the links still displayed. This button is to be used in combination with the threshold slider.
      • Links optimize quick.png : quick optimization. Allow for a quick optimization of the last performed changes.
      • Links optimize.png : complete optimization.
  • Information area:
    • The number of images, the panorama links and the total number of control points.
    • An estimate of the assembly quality on the panorama (RMS).
      • If all goes well, this area should be empty most of the time.
      • If things look suspicious the concerned links will be displayed here. The links are clickable and will open the control points editor for the appropriate images.
V2.0fr-wnd-cp-editor4.png

Example of slider usage.

V2.0fr-wnd-cp-editor1.png

Using the slider we can hide all the “good” links and only visualize the “bad” links.

Selection Windows

Image List

Image List

The Image List is closely tied to the Link List and the Control Points List. By selecting an image you will effectively be able to visualize the links and the control points this particular image shares with the other images inside the panorama.

This feature will allow you to quickly see if an image is correctly bounded to another.

A duplicated image can easily be deleted using the keyboard Delete key.

Tip: Selecting all the images will allow you to display the global Grid of the panorama.

Link List

Link List

The Link List is closely tied to the Image List. Meaning that when selecting one or more images the list will display the links shared by the selected images.

It is a good practice to sort the list by RMS (i.e. link quality), and to delete the bad links using the keyboard Delete key.

Note: A smaller RMS value equals a higher quality link.

Control Points List

Control Points List

The Control Points List is closely tied to the Image List. This means that when selecting one or more images the list will display the control points shared by the selected images.

It is a good practice to sort the list by RMS (i.e. control points quality) and to delete the bad ones using the keyboard Delete key.

Note: A smaller RMS value equals a higher quality control point.

Viewer Toolbar

V1.4-manuel-ctrlpoint-toolbar-ctrlpoint.jpg

  • Views Activation / Deactivation: Display on.png/Display off.png
  • Portrait / Landscape Layout: Display vertical.png/Display horizontal.png
  • Synchronize the views: Display linked.png
  • Launch Panorama Optimization: Links optimize.png
  • Add Control Points to the selected areas: Ctrl add.png
  • Delete Control Points from the selected areas: Ctrl remove.png
  • Automatically add links/control points: Ctrl ga.png
  • Automatically delete bad Control Points: Ctrl cleanbadpoint.png
  • Automatically add and delete Links/Control Points: Ctrl autotune.png
  • Find orphan images locations: Ctrl guess location.png
  • Options: Settings.png

Links optimize.png Panorama Optimization

This icon initiates the panorama’s optimization calculations. This step will take in account all the changes performed on the panorama and adjust it to the new constraints.
This process can be configured in the Options Dialog.

Ctrl add.png Add Control Points

V1.4-manuel-ctrlpoint-add-step2.gif

This icon will allow you to automatically add control points. All you need to do is to define a common area on each image and hit the keyboard Enter key.

Note:

  • A smaller area will lead to a higher accuracy in the control points placement. In some cases however, it is possible that adding control points will fail (i.e. no new control points are generated). In such case try a smaller area.
  • Adding control points implies the creation of a link between the images.


Ctrl remove.png Delete Control Points

V1.4-manuel-ctrlpoint-remove-anime.gif

This icon will allow you do delete control points. To do so, define an area on one of the displayed images. All controls points inside the created area will automatically be selected. Next, click on the icon or use the keyboard Delete key.

Note: If you delete all of the control points shared by two images you are also deleting the link between those two images.


Ctrl ga.png Automatically Add Control Points

V1.4-manuel-ctrlpoint-geom-anime.gif

The use of this button will perform a geometry analysis of the panorama in its current state. The geometrical analysis is used to find the existing overlaps from the source images current locations. For each overlapping area found, the software simulates the adding of control points, just like you would have done yourself by defining the two zones. You can configure the way the software will be adding the links in the Optimization Settings Dialog.
The screen capture on the right illustrates this concept. The overlaps analysis forces Autopano Pro to automatically add links in the center of the panorama.

The main appeal of this function is that its use generally raises the panorama's quality. The number of links between the images is increasing; the individual links are then becoming stronger. But it’s not always the case. In the case of a 360x180 panorama, this analysis is less efficient at the poles.


Ctrl cleanbadpoint.png Automatically Delete Control Points

V1.4-manuel-ctrlpoint-rbd-anime.gif

This icon will allow you to delete control points on all images following two methods:

  • Error threshold method: all points over a maximum error threshold will be deleted.
  • “N” best control points method: Only the "N" best control points per link are kept.

Each method has its own upside and downside. We personally have a tendency to give a plus to the second method as it will never break a link (i.e. even if all control points are really bad, some will always remain). This is not the case with the Error Threshold method as it can very well delete all control points from a link. The choice of method is performed in Setting dialog. It can be accessed using the Settings.png icon.

Ctrl autotune.png Automatically add and delete Links/Control Points

Selecting this tool will perform in one click the sum of actions performed by the previous two icons.

Ctrl guess location.png Find orphan images locations

Selecting this icon will enable you to find the location of those images that would otherwise have been left out during the initial stitching pass. This can arise if you chose, for example, to force using all images in a group. This method can be useful when finding yourself with images left out because of their high degree of resemblance (examples: highly homogenous blue sky, rows of identical windows on a building, etc.).


The Editor Grid

V2.0en-wnd-editor-&-ctrlpoint.jpg

The goal of the Grid is to visualize the links existing between the images and to give information on their quality. This Grid is displayed on top of the panorama preview and allow for a rapid visualization of the existing links, their quality, missing links, etc. It also allow for a new selection of the images and the links.


  • Selecting an Image:
V2.0en-wnd-editor-&-ctrlpoint-sel-picture.jpg

Manuel-ctrlpoint-image.png represents an image and its index in the Image List.
When selecting an image, the Editor Window will highlight the selected image along with some red lines showing you witch images are linked to the current selection.

In the example given on the right, the selected image (#13) is linked to the images 3, 4, 5, 6, 12, 14, 16 and 17. And if we look closer in that area we can see that there is no other image present; Autopano Pro found all links!


  • Selecting Multiple Images:
V2.0en-wnd-editor-&-ctrlpoint-sel-pictures.jpg

In order to edit the control points shared by two images, all you need to do is select a pair of images. Click on the first image to select it, you can then select the second image by holding the keyboard Ctrl key down and by clicking on the second image. The Preview Windows will refresh and display the selected images. You can now add or delete control points.


  • Selecting a Link:
V2.0en-wnd-editor-&-ctrlpoint-sel-link.jpg

Manuel-ctrlpoint-lien.png represents a link with a RMS value of 1.79 and a number of control points of 47. When selecting a link, the Editor Window will highlight the link itself, along with the two images located at each extremity of that link. A red line connecting the two images is also displayed. A color code is used to quickly identify good and bad links:

  • Green (RMS <5): Good quality link.
  • Orange (RMS between 5 and 10): Medium quality link.
  • Red (RMS > 10): Poor quality link.

If you find yourself with red links (i.e. poor quality links) it means you have bad control points. The control points must be edited. It is possible that the images do not relate to each other. In such a case, delete the link.


  • Selecting Multiple Links:
V2.0en-wnd-editor-&-ctrlpoint-sel-links.jpg

It is possible to select multiple links at once. The Grid display will then change to reflect the selection.



Optimization

Onglet Optimization

This set of parameters determines how the panorama will be optimized. It is during the optimization step that each image position is computed based on the control points it holds. By default only the optimization profiles are displayed in the dialog. The Advanced Options are only displayed if you click on the "Show Advanced Options" button.

Four (4) optimization profiles are available:

  • Quick: this will perform a very fast optimization that can possibly fail if some bad image links exist in the panorama.
  • Strong: (default) suited for most stitching projects. This profiles leaves room for intervention in case some bad links exist but, as a trade-off, is slower.
  • Gigapixel: select this profile for all projects over 200 images.
  • Fisheye: select this profile for any project using fisheye images.

These profiles are presets for the several optimization steps.

  • Options
    • Use grid position: this option will only be available after an import from a panoramic shooting head that will provide the images coordinates (typically Papywizard or Clauss). This option will then be active and will let the optimization engine know if it needs (or not) to take the images coordinates in account during the optimization process.
    • Assume row/column shooting: was the shooting performed in a row/column pattern or not? This option is activated for panoramas issued from a Gigapan shooting head. We suggest using this option only in that particular case because this mode needs enhanced accuracy during the shooting process (n row, p column). It is best not to use this option if you find yourself with an extra source image in one row or in one column, or if the spacing between two consecutive rows varies too much.
  • Optimizer stages
    • 1) Local approach: this is a very fast algorithm that allow for a local pre-location of the images.
    • 2) First optimization: this is the main optimizer, taking all links into account in a global way.
    • 3) Clean up control points or links:
      • Keep only control points below this error (RMS): useful when only quality matters.
      • Keep only the N best control points: useful when only the number of control points per image matters.
      • Remove links over this error (RMS): useful when only links quality matters.
    • 4) Final optimization: the same main optimizer used in stage 2 is called upon (if it hasn't been yet) or recalled upon (to take into account de deletions performed in stage 3).
    • 5) Adjust lens distortion: this option allows for lens distortion correction (very useful on short and medium focal length). It is better to uncheck this option if you are stitching a gigapixel panorama as it will slow down the detection process.
      • Advanced distortion: allow for better distortion correction on fisheye lenses



Tools

Onglet Tools

This tab regroups the Control Points Editor Settings.

CP detector quality

Sets the detection quality when adding control points in an area using the Add Control Points Ctrl add.png tool.

The default value is inherited from the value used for the initial detection of the panorama.

  • Detection Quality:
    • Low is a good compromise between control points quality and detection speed.
    • Standard (default) increases control points density but slows down detection speed. In the case of a set of images presenting a small overlapping ratio this option can enhance the detection quality on the overall panorama. It is also used with panoramas presenting a lot a bracketing.
    • High very slow, mostly reserved to desperate cases (… worth a try before giving up).
  • Control Points / Image Pair : This is the number of control points used per image pair. Influences the number of control points exported to PanoTools as well as the overall detection quality.

Geometry analysis

Allow for tuning of the Automatically add links/control points Ctrl ga.png tool:

This tool performs a geometrical analysis and tries to find similarities between the source images overlapping inside the panorama. This analysis can be performed in three different ways:

  • We only want to find new control points for overlapping images that do not share any control points.
  • We want to find new control points for all overlapping image pairs and add them the already existing control points.
  • We want to find new control points for all overlapping image pairs and replace the existing control point by the new ones.

Bad control point cleaner

Allow for tuning of the Automatically delete bad Control Points Ctrl cleanbadpoint.png tool:

  • Keep only control points below this error (RMS): Useful when only quality matters.
  • Keep only the N best control points: Useful when only the number of control points per image matters.
  • Remove links over this error (RMS): Useful when only links quality matters.