Click here to show toolbars of the Web Online Help System: show toolbars |
MIL_ID ContextOrResultId, | //in |
MIL_INT Index, | //in |
MIL_INT64 ControlType, | //in |
MIL_DOUBLE ControlValue | //in |
This function allows you to control a setting of a registration context itself, one (or all) of the registration elements contained therein (correlation-stitching registration context only), or a correlation-stitching registration result buffer. For registration contexts and registration elements, these settings control the execution of MregSetLocation() and MregCalculate() operations. For correlation-stitching registration result buffers, these settings control the execution of MregDraw() and MregTransformImage() operations.
All the control type settings can be inquired using MregInquire().
Specifies the identifier of the registration context or correlation-stitching registration result buffer whose settings to modify; you cannot control settings of other types of registration result buffers. The registration context must have been previously allocated on the system using MregAlloc(). The correlation-stitching registration result buffer must have been previously allocated on the system using MregAllocResult() with M_STITCHING_RESULT.
Specifies that a registration context, an individual registration element (of a correlation-stitching registration context), or a correlation-stitching registration result buffer is controlled. Set this parameter to one of the following values:
![]() |
|||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Description | ||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Specifies the default value. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Applies the specified control setting to all registration elements, if a correlation-stitching registration context is specified. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Controls a general setting of a registration context, if one is specified. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Controls a general setting of a correlation-stitching registration result buffer, if one is specified. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Specifies the index of the individual registration element to control, if a correlation-stitching registration context is specified. |
Specifies the setting to change.
See the Parameter associations section for possible values that can be specified.
Specifies the setting's new value.
See the Parameter associations section for possible values that can be specified.
The tables below list possible values for the ControlType and ControlValue parameters.
The following ControlType and corresponding ControlValue parameter settings are used to control M_STITCHING registration context settings; in this case, the Index parameter must be set to M_CONTEXT.
![]() |
|||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Description | ||||||||||||||||||||||||||||||||||||||
ControlValue | |||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Sets the accuracy of the registration calculation. INQ |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Same as M_HIGH. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Specifies high accuracy. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Specifies low accuracy. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Sets the maximum displacement that will be applied to any pixel in the images during registration, relative to its initial location set using MregSetLocation(). INQ |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Specifies the default value; the default value is 5%. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Specifies the maximum displacement as a percentage. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Sets the minimum overlap that should exist between an image and its reference image so that the registration calculation can optimize the match in their overlapping region. INQ |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Specifies the default value; the default value is 20.0%. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Specifies the minimum overlap as a percentage. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Sets the number of registration elements in the registration context. INQ |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Specifies the default value; the default value is 256. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Specifies the number of registration elements. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Sets the type of score calculated during registration. INQ |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Specifies to calculate the score based on the normalized grayscale correlation in the overlapped region. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Specifies that no score is calculated; it is set to 100%. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Sets the type of transformation that the registration calculation will use to optimize the match in the images' overlapping regions. INQ |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Same as M_TRANSLATION. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Specifies that a perspective warping can be performed to optimize the match in the overlapping regions. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Specifies that a translation can be performed to optimize the match in the overlapping regions. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Specifies that a translation and a rotation can be performed to optimize the match in the overlapping regions. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Specifies that a translation, a rotation, and a scale operation can be performed to optimize the match in the overlapping regions. |
The following ControlType and corresponding ControlValue parameter settings are used to control settings of registration elements (one or all) of a M_STITCHING registration context.
![]() |
|||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Description | ||||||||||||||||||||||||||||||||||||||
ControlValue | |||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Sets whether to perform the optimization step of the registration calculation for the registration element's image. INQ |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Same as M_ENABLE. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Specifies not to perform the optimization calculation. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Specifies to perform the optimization calculation. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Sets the X-coordinate of the origin of the image's pixel coordinate system. INQ |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Specifies that the default X-coordinate of the origin will be used. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Specifies the X-coordinate of the origin to be at the center of the image. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Specifies the X-coordinate of the origin, in pixels. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Sets the Y-coordinate of the origin of the image's pixel coordinate system. INQ |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Specifies that the default Y-coordinate of the origin will be used. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Specifies the Y-coordinate of the origin to be at the center of the image. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Specifies the Y-coordinate of the origin, in pixels. |
The following ControlType and corresponding ControlValue parameter settings are used to control the settings of a M_STITCHING_RESULT result buffer; in this case, the Index parameter must be set to M_GENERAL.
![]() |
|||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Description | ||||||||||||||||||||||||||||||||||||||
ControlValue | |||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Sets which image's pixel values to use when composing the mosaic and two or more images overlap. INQ |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Same as M_LAST_IMAGE. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Specifies to use the average value of the images' pixels in the overlapping region. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Specifies to use the pixels of the image associated with the registration result element with the lowest index. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Specifies to fuse the images by progressively blending overlapping pixels. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Specifies to use the pixels of the image associated with the registration result element with the highest index. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Specifies to use a super-resolution algorithm to create the mosaic. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Sets the X-offset between the origin of the coordinate system used to compose the mosaic and the left side of the destination image buffer. INQ |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Same as M_ALIGN_LEFT. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Specifies that the X-offset (in pixels) will be calculated such that the left-most part of the mosaic will be aligned with the left side of the destination image buffer. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Specifies the X-offset, in pixels. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Sets the Y-offset between the origin of the coordinate system used to compose the mosaic and the top of the destination image buffer. INQ |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Same as M_ALIGN_TOP. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Specifies that the Y-offset (in pixels) will be calculated such that the top-most part of the mosaic will be aligned with the top of the destination image buffer. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Specifies the Y-offset, in pixels. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Sets the scale factor to apply to the images before composition of the mosaic. INQ |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Specifies the scale factor. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Sets the coordinate system relative to which the mosaic will be composed. INQ |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Specifies the default value. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Specifies that the coordinate system will be chosen such that the minimum change is done on all images during the mosaic composition. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Specifies that the mosaic will be composed with respect to the global pixel coordinate system. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Specifies the index of the registration result element whose image's pixel coordinate system will be used as the reference coordinate system. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Sets the radius of the M_CIRCULAR and M_GAUSSIAN point-spread functions (PSF). INQ |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Specifies the default value; the default value is 0.5 pixels. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Specifies the radius of the PSF, in pixel units at the scale of the source images. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Sets the type of point-spread function (PSF) to use during super-resolution calculations to model the blurring in source images. INQ |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Same as M_GAUSSIAN. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Specifies to assume a PSF that models blurring of single points of light into uniform circles in the image. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Specifies that no PSF should be assumed during super-resolution calculations. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Specifies to assume a PSF that models blurring of single points of light into radially symmetric gaussian functions in the image. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Specifies to assume a PSF that models blurring of single points of light into symmetric square functions in the image. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Sets the smoothness value to use during super-resolution calculations. INQ |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Specifies the default value; the default value is 50.0. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Specifies the smoothness value. |
The following ControlType and corresponding ControlValue parameter settings are used to control M_EXTENDED_DEPTH_OF_FIELD registration context settings; in this case, the Index parameter must be set to M_CONTEXT.
![]() |
|||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Description | ||||||||||||||||||||||||||||||||||||||
ControlValue | |||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Sets the maximum radius of the circle of confusion (blurring circle), among the input images. INQ |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Specifies the default value; the default value is 8 pixels. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Specifies the maximum radius of the circle of confusion (blurring circle) in pixels. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Sets the computation mode of the extended depth of field operation. INQ |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Same as M_RECONSTRUCTION. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Specifies a faster computation mode. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Specifies a computation mode that favors the quality of the extended depth of field (EDoF) image. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Sets the maximum distance between a point of an object that is in focus in one image, and the same point in an image in which the object is out of focus, in pixels. INQ |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Specifies the default value; the default value is 1 pixel. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Specifies the maximum translation distance of a point between two images, in pixels. |
The following ControlType and corresponding ControlValue parameter settings are used to control M_DEPTH_FROM_FOCUS registration context settings; in this case, the Index parameter must be set to M_CONTEXT.
![]() |
|||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Description | ||||||||||||||||||||||||||||||||||||||
ControlValue | |||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Sets the maximum difference between the intensity values for an object in an image. INQ |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Specifies the default value; the default value is 50.0. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Specifies the maximum difference of intensities. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Sets which neighborhood pixels are given more weight when performing the smoothing component of the adaptive regularization. INQ |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Specifies the default value; the default value is 3.0 pixels. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Specifies a distance, in pixels, from the pixel being evaluated. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Sets whether the confidence map is computed. INQ |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Same as M_DISABLE. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Specifies that the confidence map is not computed. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Specifies that the confidence map is computed. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Sets the number of images for a portion of the image to go from out of focus to in focus, to out of focus again. INQ |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Specifies the default value; the default value is 3 images. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Specifies the number of images. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Sets whether the intensity map is computed. INQ |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Same as M_DISABLE. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Specifies that the intensity map is not computed. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Specifies that the intensity map is computed. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Sets the mode of regularization. INQ |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Same as M_AVERAGE. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Specifies that the regularization takes into account the local geometry and the change in intensity of the content in the source image. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Specifies that the regularization takes into account the average dominance of neighboring pixels. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Specifies that the regularization is based on the raw pixel values and that no post-processing is done to ensure the coherency of neighboring pixels. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Sets the neighborhood size when regularization is used. INQ |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Specifies the default value; the default value is 5 pixels. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Specifies the size of the neighborhood, in pixels. |
void MregControlInt64
(MIL_ID ContextOrResultId,
MIL_INT Index,
MIL_INT64 ControlType,
MIL_INT64 ControlValue)
Parameters
ContextOrResultId See ContextOrResultId of the main function for a description. Index See Index of the main function for a description. ControlType See ControlType of the main function for a description. ControlValue See ControlValue of the main function for a description. |
void MregControlDouble
(MIL_ID ContextOrResultId,
MIL_INT Index,
MIL_INT64 ControlType,
MIL_DOUBLE ControlValue)
Parameters
ContextOrResultId See ContextOrResultId of the main function for a description. Index See Index of the main function for a description. ControlType See ControlType of the main function for a description. ControlValue See ControlValue of the main function for a description. |
Header | Include mil.h. |
Library | Use mil.lib; milreg.lib. |
DLL | Requires mil.dll; milreg.dll. |