MregTransformImage

This function composes a mosaic from the specified source images and stores it in the destination image buffer. The source images are transformed according to the results, stored in the registration result buffer, that were calculated during the MregCalculate() operation.

Each image in the image array is associated with the registration result element with the same index (for example, the third image in the array is associated with the third registration result element). Note that for the image to appear at the correct location in the mosaic, its index in the array must match the index of the registration result element containing the image's transformation.

It is possible to use some images and omit others when composing the mosaic. In this case, replace the images that you want to omit by M_NULL in the image array. It can be useful to omit images from a mosaic if you want to add images to a preexisting mosaic, for example. In this case, replace all the images in the array by M_NULL, except the ones to add, and call MregTransformImage() with the preexisting mosaic passed in DestImageBufId.

When composing the mosaic, you can control how it will appear in the destination image buffer. You can specify which image to place first, using M_MOSAIC_STATIC_INDEX. This image will be placed upright and will not be scaled. The other images in the mosaic will be positioned relative to this image's pixel coordinate system. In addition, you can also adjust the vertical and horizontal offsets between the origin of the mosaic's coordinate system and the origin of the destination image buffer, using MregControl() with M_MOSAIC_OFFSET_X and M_MOSAIC_OFFSET_Y.