Create a spherical mosaic image.

gen_spherical_mosaic creates a spherical mosaic image MosaicImage from the input images passed in Images. The pose of the images in space, which is used to compute the position of the images with respect to the surface of the sphere, can be determined with stationary_camera_self_calibration. The camera and rotation matrices computed with stationary_camera_self_calibration can be used in CameraMatrices and RotationMatrices. A spherical mosaic can only be created from images that were taken with a stationary camera (see stationary_camera_self_calibration).

The mosaic is computed in spherical coordinates (longitude and latitude). The row axis of MosaicImage corresponds to the latitude, while the column axis corresponds to the longitude. The part of the sphere that is computed by gen_spherical_mosaic is determined by LatMin, LatMax, LongMin, and LongMax. These parameters are specified in degrees and determine a rectangular part of the latitude and longitude coordinates. The latitude -90 corresponds to the north pole (i.e., the straight up viewing direction), while 90 corresponds to the south pole (i.e., the straight down viewing direction). The longitude 0 corresponds to the straight ahead viewing direction. Negative longitudes correspond to viewing directions to the left, while positive longitudes correspond to viewing directions to the right. Hence, to obtain a complete image of the sphere, LatMin = -90, LatMax = 90, LongMin = -180, and LongMax = 180 must be used. In many cases, the mosaic will not cover the entire sphere. In these cases, it is useful to select the desired part of the sphere with the above parameters. This can be done by explicitly specifying the desired rectangle. However, often it is desirable to determine the smallest rectangle that encloses all images automatically. This can be done by using LatMin < -90, LatMax > 90, LongMin < -180, and LongMax > 180. Only the parameters that lie outside the normal range of values are determined automatically.

The angle step per pixel in MosaicImage can be selected with LatLongStep, which also is an angle specified in degrees. With this, the resolution of the mosaic image can be controlled. If LatLongStep is set to 0 the angle step is calculated automatically by trying to preserve the pixel size of the original images as well as possible.

The order in which the images are added to the mosaic is given by StackingOrder. The first index in this array will end up at the bottom of the image stack while the last one will be on top. If 'default' is given instead of an array of integers, the canonical order (images in the order used in Images) will be used. If 'default' is not used, StackingOrder must contain a permutation of the numbers 1,...,n, where n is the number of images passed in Images.

* For the input data to stationary_camera_self_calibration, please
* refer to the example for stationary_camera_self_calibration.
stationary_camera_self_calibration (4, 640, 480, 1, From, To,
                                    HomMatrices2D, Rows1, Cols1,
                                    Rows2, Cols2, NumMatches,
                                    'gold_standard',
                                    ['focus','principal_point'],
                                    'true', CameraMatrix, Kappa,
                                    RotationMatrices, X, Y, Z, Error)
gen_spherical_mosaic (Images, MosaicImage, CameraMatrix,
                      RotationMatrices, -100, 100, -200, 200, 0,
                      'default')

* Alternatively, if kappa should be determined, the following calls
* can be made:
stationary_camera_self_calibration (4, 640, 480, 1, From, To,
                                    HomMatrices2D, Rows1, Cols1,
                                    Rows2, Cols2, NumMatches,
                                    'gold_standard',
                                    ['focus','principal_point','kappa'],
                                    'true', CameraMatrix, Kappa,
                                    RotationMatrices, X, Y, Z, Error)
cam_mat_to_cam_par (CameraMatrix, Kappa, 640, 480, CamParam)
change_radial_distortion_cam_par ('fixed', CamParam, 0, CamParOut)
gen_radial_distortion_map (Map, CamParam, CamParOut, 'bilinear')
map_image (Images, Map, ImagesRect)
gen_spherical_mosaic (ImagesRect, MosaicImage, CameraMatrix,
                      RotationMatrices, -100, 100, -200, 200, 0,
                      'default')

If the parameters are valid, the operator gen_spherical_mosaic returns the value 2 (H_MSG_TRUE). If necessary an exception handling is raised.

gen_spherical_mosaic is reentrant and processed without parallelization.

stationary_camera_self_calibration

gen_projective_mosaic

Lourdes Agapito, E. Hayman, I. Reid: ``Self-Calibration of Rotating and Zooming Cameras''; International Journal of Computer Vision; vol. 45, no. 2; pp. 107--127; 2001.

Olivier Faugeras, Quang-Tuan Luong: ``The Geometry of Multiple Images: The Laws That Govern the Formation of Multiple Images of a Scene and Some of Their Applications''; MIT Press, Cambridge, MA; 2001.

Matching