Skip to content

gen_projective_mosaicgen_projective_mosaicGenProjectiveMosaicGenProjectiveMosaicgen_projective_mosaicT_gen_projective_mosaicπŸ”—

Short descriptionπŸ”—

gen_projective_mosaicgen_projective_mosaicGenProjectiveMosaicGenProjectiveMosaicgen_projective_mosaicT_gen_projective_mosaic β€” Combine multiple images into a mosaic image.

SignatureπŸ”—

gen_projective_mosaic( image Images, out image MosaicImage, integer StartImage, integer MappingSource, integer MappingDest, hom_mat2d HomMatrices2D, string StackingOrder, string TransformDomain, out hom_mat2d MosaicMatrices2D )gen_projective_mosaic( Images : MosaicImage : StartImage, MappingSource, MappingDest, HomMatrices2D, StackingOrder, TransformDomain : MosaicMatrices2D )void GenProjectiveMosaic( const HObject& Images, HObject* MosaicImage, const HTuple& StartImage, const HTuple& MappingSource, const HTuple& MappingDest, const HTuple& HomMatrices2D, const HTuple& StackingOrder, const HTuple& TransformDomain, HTuple* MosaicMatrices2D )static void HOperatorSet.GenProjectiveMosaic( HObject images, out HObject mosaicImage, HTuple startImage, HTuple mappingSource, HTuple mappingDest, HTuple homMatrices2D, HTuple stackingOrder, HTuple transformDomain, out HTuple mosaicMatrices2D )def gen_projective_mosaic( images: HObject, start_image: int, mapping_source: Sequence[int], mapping_dest: Sequence[int], hom_matrices_2d: Sequence[float], stacking_order: MaybeSequence[Union[str, int]], transform_domain: str ) -> Tuple[HObject, Sequence[float]]

Herror T_gen_projective_mosaic( const Hobject Images, Hobject* MosaicImage, const Htuple StartImage, const Htuple MappingSource, const Htuple MappingDest, const Htuple HomMatrices2D, const Htuple StackingOrder, const Htuple TransformDomain, Htuple* MosaicMatrices2D )

HImage HImage::GenProjectiveMosaic( Hlong StartImage, const HTuple& MappingSource, const HTuple& MappingDest, const HHomMat2DArray& HomMatrices2D, const HTuple& StackingOrder, const HString& TransformDomain, HHomMat2DArray* MosaicMatrices2D ) const

HImage HImage::GenProjectiveMosaic( Hlong StartImage, const HTuple& MappingSource, const HTuple& MappingDest, const HHomMat2DArray& HomMatrices2D, const HString& StackingOrder, const HString& TransformDomain, HHomMat2DArray* MosaicMatrices2D ) const

HImage HImage::GenProjectiveMosaic( Hlong StartImage, const HTuple& MappingSource, const HTuple& MappingDest, const HHomMat2DArray& HomMatrices2D, const char* StackingOrder, const char* TransformDomain, HHomMat2DArray* MosaicMatrices2D ) const

HImage HImage::GenProjectiveMosaic( Hlong StartImage, const HTuple& MappingSource, const HTuple& MappingDest, const HHomMat2DArray& HomMatrices2D, const wchar_t* StackingOrder, const wchar_t* TransformDomain, HHomMat2DArray* MosaicMatrices2D ) const (Windows only)

HImage HImage.GenProjectiveMosaic( int startImage, HTuple mappingSource, HTuple mappingDest, HHomMat2D[] homMatrices2D, HTuple stackingOrder, string transformDomain, out HHomMat2D[] mosaicMatrices2D )

HImage HImage.GenProjectiveMosaic( int startImage, HTuple mappingSource, HTuple mappingDest, HHomMat2D[] homMatrices2D, string stackingOrder, string transformDomain, out HHomMat2D[] mosaicMatrices2D )

DescriptionπŸ”—

gen_projective_mosaicGenProjectiveMosaic combines the input images contained in the object Imagesimagesimages into a mosaic image MosaicImagemosaicImagemosaic_image. The relative positions of the images are defined by 3x3 projective transformation matrices. The array HomMatrices2DhomMatrices2Dhom_matrices_2d contains a sequence of these linearized matrices. The values in MappingSourcemappingSourcemapping_source and MappingDestmappingDestmapping_dest are the indices of the images that the corresponding matrix applies to. MappingSourcemappingSourcemapping_source=44 and MappingDestmappingDestmapping_dest=77 means that the matrix describes the transformation of the image number 44 into the projective plane of image 77. The transformation matrices between the respective image pairs given by MappingSourcemappingSourcemapping_source and MappingDestmappingDestmapping_dest are typically determined with proj_match_points_ransacProjMatchPointsRansac.

As usual for operators that access image objects (e.g., select_objSelectObj), the images are numbered starting from 1, i.e., MappingSourcemappingSourcemapping_source, MappingDestmappingDestmapping_dest, StartImagestartImagestart_image, and StackingOrderstackingOrderstacking_order) must contain values between 1 and the number of images passed in Imagesimagesimages.

The parameter StartImagestartImagestart_image states which image defines the image plane of the final image, that is, which input image remains unchanged in the output image. This is usually an image that is located near the center of the image mosaic.

The origin of MosaicImagemosaicImagemosaic_image and its size are automatically chosen so that all of the input images are completely visible.

The order in which the images are added to the mosaic is given by the array StackingOrderstackingOrderstacking_order. 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'"default" is given instead of an array of integers, the canonical order (images in the order used in Imagesimagesimages) will be used.

The parameter TransformDomaintransformDomaintransform_domain can be used to determine whether the domains of Imagesimagesimages are also transformed. Since the transformation of the domains costs runtime, this parameter should be used to specify whether this is desired or not. If TransformDomaintransformDomaintransform_domain is set to 'false'"false" the domain of the input images is ignored and the complete images are transformed.

On output, the parameter MosaicMatrices2DmosaicMatrices2Dmosaic_matrices_2d contains a set of 3x3 projective transformation matrices that describe for each image in Imagesimagesimages the mapping of the image to its position in the mosaic.

Execution informationπŸ”—

Execution information
  • Multithreading type: reentrant (runs in parallel with non-exclusive operators).

  • Multithreading scope: global (may be called from any thread).

  • Processed without parallelization.

ParametersπŸ”—

Imagesimagesimages (input_object) (multichannel-)image-array β†’ object (byte / uint2 / real)object (byte / uint2 / real)HObject (byte / uint2 / real)HImage (byte / uint2 / real)HObject (byte / uint2 / real)Hobject (byte / uint2 / real)

Input images.

MosaicImagemosaicImagemosaic_image (output_object) (multichannel-)image β†’ object (byte / uint2 / real)object (byte / uint2 / real)HObject (byte / uint2 / real)HImage (byte / uint2 / real)HObject (byte / uint2 / real)Hobject * (byte / uint2 / real)

Output image.

StartImagestartImagestart_image (input_control) integer β†’ (integer)(integer)HTuple (Hlong)HTuple (int / long)intHtuple (Hlong)

Index of the central input image.

MappingSourcemappingSourcemapping_source (input_control) integer-array β†’ (integer)(integer)HTuple (Hlong)HTuple (int / long)Sequence[int]Htuple (Hlong)

Indices of the source images of the transformations.

MappingDestmappingDestmapping_dest (input_control) integer-array β†’ (integer)(integer)HTuple (Hlong)HTuple (int / long)Sequence[int]Htuple (Hlong)

Indices of the target images of the transformations.

HomMatrices2DhomMatrices2Dhom_matrices_2d (input_control) hom_mat2d-array β†’ (real)(real)HTuple (double)HHomMat2D, HTuple (double)Sequence[float]Htuple (double)

Array of 3x3 projective transformation matrices.

StackingOrderstackingOrderstacking_order (input_control) string(-array) β†’ (string / integer)(string / integer)HTuple (HString / Hlong)HTuple (string / int / long)MaybeSequence[Union[str, int]]Htuple (char* / Hlong)

Stacking order of the images in the mosaic.

Default: 'default'"default"
Suggested values: 'default'"default"

TransformDomaintransformDomaintransform_domain (input_control) string β†’ (string)(string)HTuple (HString)HTuple (string)strHtuple (char*)

Should the domains of the input images also be transformed?

Default: 'false'"false"
List of values: 'false', 'true'"false", "true"

MosaicMatrices2DmosaicMatrices2Dmosaic_matrices_2d (output_control) hom_mat2d-array β†’ (real)(real)HTuple (double)HHomMat2D, HTuple (double)Sequence[float]Htuple (double)

Array of 3x3 projective transformation matrices that determine the position of the images in the mosaic.

ExampleπŸ”—

(HDevelop)


gen_empty_obj (Images)
for J := 1 to 6 by 1
    read_image (Image, 'mosaic/pcb_'+J$'02')
    concat_obj (Images, Image, Images)
endfor
From := [1,2,3,4,5]
To := [2,3,4,5,6]
Num := |From|
ProjMatrices := []
for J := 0 to Num-1 by 1
    F := From[J]
    T := To[J]
    select_obj (Images, ImageF, F)
    select_obj (Images, ImageT, T)
    points_foerstner (ImageF, 1, 2, 3, 200, 0.3, 'gauss', 'false', \
                      RowJunctionsF, ColJunctionsF, CoRRJunctionsF, \
                      CoRCJunctionsF, CoCCJunctionsF, RowAreaF, \
                      ColAreaF, CoRRAreaF, CoRCAreaF, CoCCAreaF)
    points_foerstner (ImageT, 1, 2, 3, 200, 0.3, 'gauss', 'false', \
                      RowJunctionsT, ColJunctionsT, CoRRJunctionsT, \
                      CoRCJunctionsT, CoCCJunctionsT, RowAreaT, \
                      ColAreaT, CoRRAreaT, CoRCAreaT, CoCCAreaT)
    proj_match_points_ransac (ImageF, ImageT, RowJunctionsF, \
                              ColJunctionsF, RowJunctionsT, \
                              ColJunctionsT, 'ncc', 21, 0, 0, 480, 640, \
                              0, 0.5, 'gold_standard', 1, 4364537, \
                              ProjMatrix, Points1, Points2)
    ProjMatrices := [ProjMatrices,ProjMatrix]
endfor
gen_projective_mosaic (Images, MosaicImage, 2, From, To, ProjMatrices, \
                       'default', 'false', MosaicMatrices2D)

Combinations with other operatorsπŸ”—

Combinations

Possible predecessors

proj_match_points_ransacProjMatchPointsRansac, proj_match_points_ransac_guidedProjMatchPointsRansacGuided, vector_to_proj_hom_mat2dVectorToProjHomMat2d, hom_vector_to_proj_hom_mat2dHomVectorToProjHomMat2d

See also

projective_trans_imageProjectiveTransImage, projective_trans_image_sizeProjectiveTransImageSize, projective_trans_regionProjectiveTransRegion, projective_trans_contour_xldProjectiveTransContourXld, projective_trans_point_2dProjectiveTransPoint2d, projective_trans_pixelProjectiveTransPixel

ReferencesπŸ”—

Richard Hartley, Andrew Zisserman: ``Multiple View Geometry in Computer Visionβ€™β€˜; Cambridge University Press, Cambridge; 2000.

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.

ModuleπŸ”—

Matching