MIL_ID RegResultId, | //in |
MIL_INT ResultIndex, | //in |
MIL_INT64 ResultType, | //in |
void *ResultArrayPtr | //out |
This function retrieves the result(s) of the specified type from a registration result buffer.
The result(s) that can be retrieved from an M_STITCHING_RESULT result buffer are only available after calling MregCalculate() with an M_STITCHING registration context. Result(s) from an M_DEPTH_FROM_FOCUS_RESULT result buffer can only be retrieved after calling MregCalculate() with an M_DEPTH_FROM_FOCUS registration context. Result(s) from an M_EXTENDED_DEPTH_OF_FIELD_RESULT result buffer can only be retrieved after calling MregCalculate() with an M_EXTENDED_DEPTH_OF_FIELD registration context. Result(s) from an M_HIGH_DYNAMIC_RANGE_RESULT result buffer can only be retrieved after calling MregCalculate() with an M_HIGH_DYNAMIC_RANGE registration context. Result(s) from an M_PHOTOMETRIC_STEREO_RESULT result buffer can only be retrieved after calling MregCalculate() with an M_PHOTOMETRIC_STEREO registration context.
Specifies the identifier of the registration result buffer from which to retrieve results.
Specifies which results to get. This parameter can be set to one of the following values:
![]() |
|||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Description | ||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Specifies the default value. For an M_STITCHING_RESULT result buffer, same as M_ALL. For an M_EXTENDED_DEPTH_OF_FIELD_RESULT, M_DEPTH_FROM_FOCUS_RESULT, M_HIGH_DYNAMIC_RANGE_RESULT, or M_PHOTOMETRIC_STEREO_RESULT result buffer, same as M_GENERAL. (summarize)Specifies the default value. (more details...) |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Specifies to retrieve the results of the specified type for all registration result elements. This setting is only available for M_STITCHING_RESULT result buffers. (summarize)Specifies to retrieve the results of the specified type for all registration result elements. (more details...) |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Specifies to retrieve a result relating to the entire registration result buffer. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Specifies the registration result element's index, for an M_HIGH_DYNAMIC_RANGE_RESULT result buffer. Note that the maximum index (M_NUMBER_OF_IMAGES - 1) is also equal to M_HDR_IMAGE_STATUS_SIZE - 1. (summarize)Specifies the registration result element's index, for an M_HIGH_DYNAMIC_RANGE_RESULT result buffer. (more details...) |
||||||||||||||||||||||||||||||||||||||
![]() ![]() M_NUMBER_OF_REGISTRATION_ELEMENTS |
Specifies the registration result element's index, for an M_STITCHING_RESULT or M_PHOTOMETRIC_STEREO_RESULT result buffer. |
Specifies the type of result to retrieve.
See the Parameter associations section for possible values that can be specified.
Specifies the address of the array in which to write the requested information.
See the Parameter associations section for possible values that can be returned.
The tables below list possible values for the ResultType parameter and possible values returned to the ResultArrayPtr parameter.
To retrieve a general result or the result for one or all registration result elements of an M_STITCHING_RESULT result buffer, the ResultType parameter can be set to one of the following values.
![]() |
|||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Description | ||||||||||||||||||||||||||||||||||||||
ResultArrayPtr - Possible values returned |
|||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Retrieves whether the registration calculation (MregCalculate()) was successful. When using M_GENERAL, and the calculation of one registration result element fails, M_RESULT returns a fail as well. (summarize)Retrieves whether the registration calculation (MregCalculate()) was successful. (more details...) |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Data type info: Data
type: address of a MIL_DOUBLE
| array of type MIL_DOUBLE [optionally,
in C++: a reference to a std::vector<MIL_DOUBLE>
] MORE
Data type info: Data
type: address of a MIL_DOUBLE
| array of type MIL_DOUBLE [optionally,
in C++: a reference to a std::vector<MIL_DOUBLE>
] MORE
|
||||||||||||||||||||||||||||||||||||||
![]() ![]() ![]() |
Specifies that the registration calculation failed. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() ![]() |
Specifies that the registration calculation was successful. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Retrieves the score of the registration calculation (MregCalculate()). To determine the type of score to calculate, use MregControl() with M_SCORE_TYPE. When using M_GENERAL, the score is an average of the scores of all result elements together. (summarize)Retrieves the score of the registration calculation (MregCalculate()). (more details...) |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Data type info: Data
type: address of a MIL_DOUBLE
| array of type MIL_DOUBLE [optionally,
in C++: a reference to a std::vector<MIL_DOUBLE>
] MORE
Data type info: Data
type: address of a MIL_DOUBLE
| array of type MIL_DOUBLE [optionally,
in C++: a reference to a std::vector<MIL_DOUBLE>
] MORE
|
||||||||||||||||||||||||||||||||||||||
![]() ![]() ![]() |
Specifies the score of the registration calculation. The lower the value, the less optimal the alignment. For example, 0.0 equals no alignment and 100.0 equals a perfect alignment. Note that image noise can also adversely affect the score. (summarize)Specifies the score of the registration calculation. (more details...) |
To retrieve a general result from an M_STITCHING_RESULT result buffer, the ResultType parameter can be set to one of the following values:
![]() |
|||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Description | ||||||||||||||||||||||||||||||||||||||
ResultArrayPtr - Possible values returned |
|||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Retrieves the horizontal offset that will exist between the origin of the mosaic's coordinate system and the left side of the destination image buffer, when you compose the mosaic. (summarize)Retrieves the horizontal offset that will exist between the origin of the mosaic's coordinate system and the left side of the destination image buffer, when you compose the mosaic. (more details...) |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Data type info: Data
type: address of a
MIL_DOUBLE
Data type info: Data
type: address of a
MIL_DOUBLE
|
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Retrieves the vertical offset that will exist between the origin of the mosaic's coordinate system and the top of the destination image buffer, when you compose the mosaic. (summarize)Retrieves the vertical offset that will exist between the origin of the mosaic's coordinate system and the top of the destination image buffer, when you compose the mosaic. (more details...) |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Data type info: Data
type: address of a
MIL_DOUBLE
Data type info: Data
type: address of a
MIL_DOUBLE
|
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Retrieves the width that the mosaic will have when it is composed. This value can be used to allocate an image buffer large enough to hold the entire mosaic composed by MregTransformImage(). (summarize)Retrieves the width that the mosaic will have when it is composed. (more details...) |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Data type info: Data
type: address of a
MIL_DOUBLE
Data type info: Data
type: address of a
MIL_DOUBLE
|
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Retrieves the height that the mosaic will have when it is composed. This value can be used to allocate an image buffer large enough to hold the entire mosaic composed by MregTransformImage(). (summarize)Retrieves the height that the mosaic will have when it is composed. (more details...) |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Data type info: Data
type: address of a
MIL_DOUBLE
Data type info: Data
type: address of a
MIL_DOUBLE
|
To retrieve the result from one or all the registration result elements of an M_STITCHING_RESULT result buffer, the ResultType parameter can be set to one of the following values:
![]() |
|||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Description | ||||||||||||||||||||||||||||||||||||||
ResultArrayPtr - Possible values returned |
|||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Retrieves the X-coordinate of the registration result element image's origin in the global/reference coordinate system. (summarize)Retrieves the X-coordinate of the registration result element image's origin in the global/reference coordinate system. (more details...) |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Data type info: Data
type: address of a MIL_DOUBLE
| array of type MIL_DOUBLE [optionally,
in C++: a reference to a std::vector<MIL_DOUBLE>
] MORE
Data type info: Data
type: address of a MIL_DOUBLE
| array of type MIL_DOUBLE [optionally,
in C++: a reference to a std::vector<MIL_DOUBLE>
] MORE
|
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Retrieves the Y-coordinate of the registration result element image's origin in the global/reference coordinate system. (summarize)Retrieves the Y-coordinate of the registration result element image's origin in the global/reference coordinate system. (more details...) |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Data type info: Data
type: address of a MIL_DOUBLE
| array of type MIL_DOUBLE [optionally,
in C++: a reference to a std::vector<MIL_DOUBLE>
] MORE
Data type info: Data
type: address of a MIL_DOUBLE
| array of type MIL_DOUBLE [optionally,
in C++: a reference to a std::vector<MIL_DOUBLE>
] MORE
|
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Retrieves the 9 elements of the 3x3 transformation matrix that performs a reverse transformation. The transformation matrix can transform any position in the specified image (xs , ys ) with a position in the global/reference coordinate system (xg , yg ). (summarize)Retrieves the 9 elements of the 3x3 transformation matrix that performs a reverse transformation. (more details...) |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Data type info: Data
type: array of type MIL_DOUBLE [optionally, in C++:
a reference to a std::vector<MIL_DOUBLE>
] MORE
Data type info: Data
type: array of type MIL_DOUBLE [optionally, in C++:
a reference to a std::vector<MIL_DOUBLE>
] MORE
|
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Retrieves the identifier of the MIL array buffer containing the 3x3 transformation matrix that performs a reverse transformation. The transformation matrix can transform any position in the specified image (xs , ys ) with a position in the global/reference coordinate system (xg , yg ). Note that you cannot free the retrieved buffer. (summarize)Retrieves the identifier of the MIL array buffer containing the 3x3 transformation matrix that performs a reverse transformation. (more details...) |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Data type info:
Data type: address of a
MIL_DOUBLE | array of type
MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE>
] MORE
Data type info:
Data type: address of a
MIL_DOUBLE | array of type
MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE>
] MORE
|
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Retrieves the 9 elements of the 3x3 transformation matrix. The transformation matrix can transform any position in the global/reference coordinate system (xg , yg ) with a position in the specified image (xs , ys ). You can put the matrix data into a MIL buffer (MbufPut()) and pass the matrix (buffer) to MimWarp() to transform the source image to the global/reference coordinate system. (summarize)Retrieves the 9 elements of the 3x3 transformation matrix. (more details...) |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Data type info:
Data type: array of type
MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE>
] MORE
Data type info:
Data type: array of type
MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE>
] MORE
|
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Retrieves the identifier of the MIL array buffer containing the 3x3 transformation matrix. The transformation matrix can transform any position in the global/reference coordinate system (xg , yg ) with a position in the specified image (xs , ys ). You can pass the matrix to MimWarp() to transform the source image to the global/reference coordinate system. Note that you cannot free the retrieved buffer. (summarize)Retrieves the identifier of the MIL array buffer containing the 3x3 transformation matrix. (more details...) |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Data type info:
Data type: address of a
MIL_DOUBLE | array of type
MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE>
] MORE
Data type info:
Data type: address of a
MIL_DOUBLE | array of type
MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE>
] MORE
|
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Retrieves the X-coordinate of the bottom-left corner of the specified registration result element's image. This coordinate is with respect to the global/reference coordinate system. (summarize)Retrieves the X-coordinate of the bottom-left corner of the specified registration result element's image. (more details...) |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Data type info:
Data type: address of a
MIL_DOUBLE | array of type
MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE>
] MORE
Data type info:
Data type: address of a
MIL_DOUBLE | array of type
MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE>
] MORE
|
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Retrieves the Y-coordinate of the bottom-left corner of the specified registration result element's image. This coordinate is with respect to the global/reference coordinate system. (summarize)Retrieves the Y-coordinate of the bottom-left corner of the specified registration result element's image. (more details...) |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Data type info:
Data type: address of a
MIL_DOUBLE | array of type
MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE>
] MORE
Data type info:
Data type: address of a
MIL_DOUBLE | array of type
MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE>
] MORE
|
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Retrieves the X-coordinate of the bottom-right corner of the specified registration result element's image. This coordinate is with respect to the global/reference coordinate system. (summarize)Retrieves the X-coordinate of the bottom-right corner of the specified registration result element's image. (more details...) |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Data type info:
Data type: address of a
MIL_DOUBLE | array of type
MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE>
] MORE
Data type info:
Data type: address of a
MIL_DOUBLE | array of type
MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE>
] MORE
|
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Retrieves the Y-coordinate of the bottom-right corner of the specified registration result element's image. This coordinate is with respect to the global/reference coordinate system. (summarize)Retrieves the Y-coordinate of the bottom-right corner of the specified registration result element's image. (more details...) |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Data type info:
Data type: address of a
MIL_DOUBLE | array of type
MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE>
] MORE
Data type info:
Data type: address of a
MIL_DOUBLE | array of type
MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE>
] MORE
|
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Retrieves the X-coordinate of the upper left corner of the specified registration result element's image. This coordinate is with respect to the global/reference coordinate system. (summarize)Retrieves the X-coordinate of the upper left corner of the specified registration result element's image. (more details...) |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Data type info:
Data type: address of a
MIL_DOUBLE | array of type
MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE>
] MORE
Data type info:
Data type: address of a
MIL_DOUBLE | array of type
MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE>
] MORE
|
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Retrieves the Y-coordinate of the upper left corner of the specified registration result element's image. This coordinate is with respect to the global/reference coordinate system. (summarize)Retrieves the Y-coordinate of the upper left corner of the specified registration result element's image. (more details...) |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Data type info:
Data type: address of a
MIL_DOUBLE | array of type
MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE>
] MORE
Data type info:
Data type: address of a
MIL_DOUBLE | array of type
MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE>
] MORE
|
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Retrieves the X-coordinate of the upper right corner of the specified registration result element's image. This coordinate is with respect to the global/reference coordinate system. (summarize)Retrieves the X-coordinate of the upper right corner of the specified registration result element's image. (more details...) |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Data type info:
Data type: address of a
MIL_DOUBLE | array of type
MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE>
] MORE
Data type info:
Data type: address of a
MIL_DOUBLE | array of type
MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE>
] MORE
|
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Retrieves the Y-coordinate of the upper right corner of the specified registration result element's image. This coordinate is with respect to the global/reference coordinate system. (summarize)Retrieves the Y-coordinate of the upper right corner of the specified registration result element's image. (more details...) |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Data type info:
Data type: address of a
MIL_DOUBLE | array of type
MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE>
] MORE
Data type info:
Data type: address of a
MIL_DOUBLE | array of type
MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE>
] MORE
|
You can add the following value to the above-mentioned values to determine the required array size (number of elements) to store the returned values.
![]() |
|||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Description | ||||||||||||||||||||||||||||||||||||||
ResultArrayPtr - Possible values returned |
|||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Retrieves the required array size (number of elements) to store the returned values. (summarize)Retrieves the required array size (number of elements) to store the returned values. (more details...) |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Data type info:
Data type: address of a
MIL_DOUBLE MORE
Data type info:
Data type: address of a
MIL_DOUBLE MORE
|
You can add one of the following values to the above-mentioned values to get the requested results with respect to the required coordinate system.
![]() |
|||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Description | ||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Retrieves the results with respect to the reference coordinate system. The reference coordinate system is associated with the registration element that was specified in the Target parameter of MregSetLocation(). (summarize)Retrieves the results with respect to the reference coordinate system. (more details...) |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Retrieves the results with respect to the global pixel coordinate system. This is the default value. (summarize)Retrieves the results with respect to the global pixel coordinate system. (more details...) |
To retrieve a general result from an M_PHOTOMETRIC_STEREO_RESULT result buffer, the result type parameter can be set to one of the following values:
![]() |
|||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Description | ||||||||||||||||||||||||||||||||||||||
ResultArrayPtr - Possible values returned |
|||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Retrieves whether the Gaussian curvature image was computed when using MregCalculate(). (summarize)Retrieves whether the Gaussian curvature image was computed when using MregCalculate(). (more details...) |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Data type info:
Data type: address of a
MIL_DOUBLE
Data type info:
Data type: address of a
MIL_DOUBLE
|
||||||||||||||||||||||||||||||||||||||
![]() ![]() ![]() |
Specifies that the Gaussian curvature image was not computed and is not available to draw. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() ![]() |
Specifies that the Gaussian curvature image was computed and is available to draw using MregDraw() with M_DRAW_MEAN_CURVATURE_IMAGE. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Retrieves whether the local contrast image was computed when using MregCalculate(). (summarize)Retrieves whether the local contrast image was computed when using MregCalculate(). (more details...) |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Data type info:
Data type: address of a
MIL_DOUBLE
Data type info:
Data type: address of a
MIL_DOUBLE
|
||||||||||||||||||||||||||||||||||||||
![]() ![]() ![]() |
Specifies that the local contrast image was not computed and is not available to draw. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() ![]() |
Specifies that the local contrast image was computed and is available to draw using MregDraw() with M_DRAW_LOCAL_CONTRAST_IMAGE. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Retrieves whether the local shape image was computed when using MregCalculate(). (summarize)Retrieves whether the local shape image was computed when using MregCalculate(). (more details...) |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Data type info:
Data type: address of a
MIL_DOUBLE
Data type info:
Data type: address of a
MIL_DOUBLE
|
||||||||||||||||||||||||||||||||||||||
![]() ![]() ![]() |
Specifies that the local shape image was not computed and is not available to draw. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() ![]() |
Specifies that the local shape image was computed and is available to draw using MregDraw() with M_DRAW_LOCAL_SHAPE_IMAGE. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Retrieves whether the mean curvature image was computed when using MregCalculate(). (summarize)Retrieves whether the mean curvature image was computed when using MregCalculate(). (more details...) |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Data type info:
Data type: address of a
MIL_DOUBLE
Data type info:
Data type: address of a
MIL_DOUBLE
|
||||||||||||||||||||||||||||||||||||||
![]() ![]() ![]() |
Specifies that the mean curvature image was not computed and is not available to draw. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() ![]() |
Specifies that the mean curvature image was computed and is available to draw using MregDraw() with M_DRAW_MEAN_CURVATURE_IMAGE. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Retrieves the automatically calculated remap factor value for an M_DRAW_GAUSSIAN_CURVATURE_IMAGE operation, when M_DRAW_REMAP_FACTOR_MODE is set to M_AUTO. The calculated value is equal to 1 / (max | Gaussian curvature image |), where (max | Gaussian curvature image |) is the maximum of the absolute value of the pixel intensity values in the Gaussian curvature image. (summarize)Retrieves the automatically calculated remap factor value for an M_DRAW_GAUSSIAN_CURVATURE_IMAGE operation, when M_DRAW_REMAP_FACTOR_MODE is set to M_AUTO. (more details...) |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Data type info:
Data type: address of a
MIL_DOUBLE
Data type info:
Data type: address of a
MIL_DOUBLE
|
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Retrieves the automatically calculated remap factor value for an M_DRAW_LOCAL_SHAPE_IMAGE operation, when M_DRAW_REMAP_FACTOR_MODE is set to M_AUTO. The calculated value is equal to 1 / (max | local shape image |), where (max | local shape image |) is the maximum of the absolute value of the pixel intensity values in the local shape image. (summarize)Retrieves the automatically calculated remap factor value for an M_DRAW_LOCAL_SHAPE_IMAGE operation, when M_DRAW_REMAP_FACTOR_MODE is set to M_AUTO. (more details...) |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Data type info:
Data type: address of a
MIL_DOUBLE
Data type info:
Data type: address of a
MIL_DOUBLE
|
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Retrieves the automatically calculated remap factor value for an M_DRAW_MEAN_CURVATURE_IMAGE operation, when M_DRAW_REMAP_FACTOR_MODE is set to M_AUTO. The calculated value is equal to 1 / (max | mean curvature image |), where (max | mean curvature image |) is the maximum of the absolute value of the pixel intensity values in the mean curvature image. (summarize)Retrieves the automatically calculated remap factor value for an M_DRAW_MEAN_CURVATURE_IMAGE operation, when M_DRAW_REMAP_FACTOR_MODE is set to M_AUTO. (more details...) |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Data type info:
Data type: address of a
MIL_DOUBLE
Data type info:
Data type: address of a
MIL_DOUBLE
|
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Retrieves whether the texture image was computed when using MregCalculate(). (summarize)Retrieves whether the texture image was computed when using MregCalculate(). (more details...) |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Data type info:
Data type: address of a
MIL_DOUBLE
Data type info:
Data type: address of a
MIL_DOUBLE
|
||||||||||||||||||||||||||||||||||||||
![]() ![]() ![]() |
Specifies that the texture image was not computed and is not available to draw. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() ![]() |
Specifies that the texture image was computed and is available to draw using MregDraw() with M_DRAW_TEXTURE_IMAGE. |
To retrieve a general result from an M_DEPTH_FROM_FOCUS_RESULT, M_HIGH_DYNAMIC_RANGE_RESULT, M_PHOTOMETRIC_STEREO_RESULT, or M_EXTENDED_DEPTH_OF_FIELD_RESULT result buffer, the result type parameter can be set to one of the values listed in the table below.
Note that for an M_DEPTH_FROM_FOCUS_RESULT, M_HIGH_DYNAMIC_RANGE_RESULT, or an M_PHOTOMETRIC_STEREO_RESULT result buffer, M_STATUS must return M_COMPLETE.
![]() |
|||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Description | ||||||||||||||||||||||||||||||||||||||
ResultArrayPtr - Possible values returned |
|||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Retrieves the number of bands of the images used as input in the MregCalculate() operation. This value can be used to allocate an image buffer large enough to hold the image drawn using MregDraw(). (summarize)Retrieves the number of bands of the images used as input in the MregCalculate() operation. (more details...) |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Data type info:
Data type: address of a
MIL_DOUBLE
Data type info:
Data type: address of a
MIL_DOUBLE
|
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Retrieves the size of the X-dimension of the images used as input in the MregCalculate() operation. This value can be used to allocate an image buffer large enough to hold the image drawn using MregDraw(). (summarize)Retrieves the size of the X-dimension of the images used as input in the MregCalculate() operation. (more details...) |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Data type info:
Data type: address of a
MIL_DOUBLE
Data type info:
Data type: address of a
MIL_DOUBLE
|
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Retrieves the size of the Y-dimension of the images used as input in the MregCalculate() operation. This value can be used to allocate an image buffer large enough to hold the image drawn using MregDraw(). (summarize)Retrieves the size of the Y-dimension of the images used as input in the MregCalculate() operation. (more details...) |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Data type info:
Data type: address of a
MIL_DOUBLE
Data type info:
Data type: address of a
MIL_DOUBLE
|
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Retrieves the data type and depth of the images used as input in the MregCalculate() operation. This value can be used to allocate an image buffer with the appropriate settings to hold the image drawn using MregDraw(). In the case of a raw HDR image, its bit depth must be twice that of the source images. For example, if the source images are 8-bit, then the raw HDR image must be written to a 16-bit buffer. (summarize)Retrieves the data type and depth of the images used as input in the MregCalculate() operation. (more details...) |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Data type info:
Data type: address of a
MIL_DOUBLE
Data type info:
Data type: address of a
MIL_DOUBLE
|
||||||||||||||||||||||||||||||||||||||
![]() ![]() ![]() |
Specifies 32-bit float data. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() ![]() |
Specifies 8-bit signed data. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() ![]() |
Specifies 16-bit signed data. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() ![]() |
Specifies 32-bit signed data. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() ![]() |
Specifies 1-bit unsigned data. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() ![]() |
Specifies 8-bit unsigned data. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() ![]() |
Specifies 16-bit unsigned data. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() ![]() |
Specifies 32-bit unsigned data. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Retrieves the highest index value of the non-null images used as input in the MregCalculate() operation. This result type is only available for M_DEPTH_FROM_FOCUS_RESULT. (summarize)Retrieves the highest index value of the non-null images used as input in the MregCalculate() operation. (more details...) |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Data type info:
Data type: address of a
MIL_DOUBLE
Data type info:
Data type: address of a
MIL_DOUBLE
|
||||||||||||||||||||||||||||||||||||||
![]() ![]() ![]() |
Specifies the highest index value. |
To retrieve a general result from an M_EXTENDED_DEPTH_OF_FIELD_RESULT result buffer, the result type parameter can be set to one of the following values:
![]() |
|||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Description | ||||||||||||||||||||||||||||||||||||||
ResultArrayPtr - Possible values returned |
|||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Retrieves the radius of the maximum circle of confusion (blurring circle) used during calculations, in pixels. (summarize)Retrieves the radius of the maximum circle of confusion (blurring circle) used during calculations, in pixels. (more details...) |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Data type info:
Data type: address of a
MIL_DOUBLE
Data type info:
Data type: address of a
MIL_DOUBLE
|
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Retrieves the computation mode used. (summarize)Retrieves the computation mode used. (more details...) |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Data type info:
Data type: address of a
MIL_DOUBLE
Data type info:
Data type: address of a
MIL_DOUBLE
|
||||||||||||||||||||||||||||||||||||||
![]() ![]() ![]() |
Specifies that the extended depth of field registration operation used the fast computation mode. This mode favored reducing computation time over accuracy. (summarize)Specifies that the extended depth of field registration operation used the fast computation mode. (more details...) |
||||||||||||||||||||||||||||||||||||||
![]() ![]() ![]() |
Specifies that the extended depth of field registration operation used the reconstruction computation mode. This mode favored accuracy over reducing computation time. (summarize)Specifies that the extended depth of field registration operation used the reconstruction computation mode. (more details...) |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Retrieves the maximum distance, used during calculations, 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. (summarize)Retrieves the maximum distance, used during calculations, 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. (more details...) |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Data type info:
Data type: address of a
MIL_DOUBLE
Data type info:
Data type: address of a
MIL_DOUBLE
|
To retrieve a general result or the result of one registration result element from an M_HIGH_DYNAMIC_RANGE_RESULT result buffer, the result type parameter can be set to one of the following values:
![]() |
|||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Description | ||||||||||||||||||||||||||||||||||||||
ResultArrayPtr - Possible values returned |
|||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Retrieves the status of the image associated with the specified registration result element. (summarize)Retrieves the status of the image associated with the specified registration result element. (more details...) |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Data type info:
Data type: address of a
MIL_DOUBLE
Data type info:
Data type: address of a
MIL_DOUBLE
|
||||||||||||||||||||||||||||||||||||||
![]() ![]() ![]() |
Specifies that the number of colors in the current HDR image is reduced to a single color within the merge area. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() ![]() |
Specifies that there is an inadequate number of colors available in the merge area of the input image. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() ![]() |
Specifies that the input image does not increase the dynamic range already present in the current HDR image. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() ![]() |
Specifies that the gain to be applied to the input image is less that 1. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() ![]() |
Specifies that the calculated merge area, where the pixel values are between M_FUSION_LOW_THRESHOLD and M_FUSION_HIGH_THRESHOLD, on both the working HDR image and the source image, is below the threshold specified with M_FUSION_COVERAGE. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() ![]() |
Specifies that the image has been processed successfully. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Retrieves the number of images that have been processed and that have their status available. (summarize)Retrieves the number of images that have been processed and that have their status available. (more details...) |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Data type info:
Data type: address of a
MIL_DOUBLE
Data type info:
Data type: address of a
MIL_DOUBLE
|
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Retrieves the ratio of images used with success to the total number of source images, when calculating the HDR image. This is a quick check value to evaluate the relative quality of the HDR image. (summarize)Retrieves the ratio of images used with success to the total number of source images, when calculating the HDR image. (more details...) |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Data type info:
Data type: address of a
MIL_DOUBLE
Data type info:
Data type: address of a
MIL_DOUBLE
|
||||||||||||||||||||||||||||||||||||||
![]() ![]() ![]() |
Specifies the HDR status ratio. A ratio of 1.0 signifies that every image was used. (summarize)Specifies the HDR status ratio. (more details...) |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Retrieves the tone mapping mode used for the resulting HDR image. (summarize)Retrieves the tone mapping mode used for the resulting HDR image. (more details...) |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Data type info:
Data type: address of a
MIL_DOUBLE
Data type info:
Data type: address of a
MIL_DOUBLE
|
You can add the following value to the above-mentioned values to determine whether a result is available..
![]() |
|||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Description | ||||||||||||||||||||||||||||||||||||||
ResultArrayPtr - Possible values returned |
|||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Retrieves whether the requested result type is available for retrieval. (summarize)Retrieves whether the requested result type is available for retrieval. (more details...) |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Data type info:
Data type: address of a
MIL_DOUBLE
Data type info:
Data type: address of a
MIL_DOUBLE
|
||||||||||||||||||||||||||||||||||||||
![]() ![]() ![]() |
Specifies that the requested result type is not available. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() ![]() |
Specifies that the requested result type is available. |
To retrieve a general result from a M_DEPTH_FROM_FOCUS_RESULT, M_EXTENDED_DEPTH_OF_FIELD_RESULT, M_HIGH_DYNAMIC_RANGE_RESULT or M_PHOTOMETRIC_STEREO_RESULT result buffer, the result type parameter can be set to one of the following values:
![]() |
|||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Description | ||||||||||||||||||||||||||||||||||||||
ResultArrayPtr - Possible values returned |
|||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Retrieves the number of non-null images used to calculate the results that are stored in the result buffer. (summarize)Retrieves the number of non-null images used to calculate the results that are stored in the result buffer. (more details...) |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Data type info:
Data type: address of a
MIL_DOUBLE
Data type info:
Data type: address of a
MIL_DOUBLE
|
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Retrieves the status of the registration operation. (summarize)Retrieves the status of the registration operation. (more details...) |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Data type info:
Data type: address of a
MIL_DOUBLE
Data type info:
Data type: address of a
MIL_DOUBLE
|
||||||||||||||||||||||||||||||||||||||
![]() ![]() ![]() |
Specifies that the result buffer has been filled with some preprocessing information, but the EDoF or HDR image is not yet available. The EDoF image can be calculated using MregCalculate() with M_ACCUMULATE_AND_COMPUTE. The HDR image can be calculated using MregCalculate() with M_ACCUMULATE_AND_COMPUTE. This value can only be returned for an M_EXTENDED_DEPTH_OF_FIELD_RESULT or an M_HIGH_DYNAMIC_RANGE_RESULT result buffer. (summarize)Specifies that the result buffer has been filled with some preprocessing information, but the EDoF or HDR image is not yet available. (more details...) |
||||||||||||||||||||||||||||||||||||||
![]() ![]() ![]() |
Specifies that the resulting image (EDoF image, photometric stereo image, HDR image, or index image) is available and can be retrieved using MregDraw(). |
||||||||||||||||||||||||||||||||||||||
![]() ![]() ![]() |
Specifies that the result buffer is empty. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() ![]() |
Specifies that an unexpected internal error occurred during the registration operation. This value can only be returned for an M_PHOTOMETRIC_STEREO_RESULT result buffer. (summarize)Specifies that an unexpected internal error occurred during the registration operation. (more details...) |
||||||||||||||||||||||||||||||||||||||
![]() ![]() ![]() |
Specifies that this operation was not completed because of a lack of available memory. This value can only be returned for an M_PHOTOMETRIC_STEREO_RESULT result buffer. (summarize)Specifies that this operation was not completed because of a lack of available memory. (more details...) |
||||||||||||||||||||||||||||||||||||||
![]() ![]() ![]() |
Specifies that the registration operation was stopped from another thread using MregControl() with M_STOP_CALCULATE. This value can only be returned for an M_PHOTOMETRIC_STEREO_RESULT result buffer. (summarize)Specifies that the registration operation was stopped from another thread using MregControl() with M_STOP_CALCULATE. (more details...) |
||||||||||||||||||||||||||||||||||||||
![]() ![]() ![]() |
Specifies that the operation took longer than the allowed value, specified by MregControl() with M_TIMEOUT, and has stopped before completion. This value can only be returned for an M_PHOTOMETRIC_STEREO_RESULT result buffer. (summarize)Specifies that the operation took longer than the allowed value, specified by MregControl() with M_TIMEOUT, and has stopped before completion. (more details...) |
You can add one of the following values to the above-mentioned values to cast the requested results to the required data type.
Note: In C++, when using a standard vector (std::vector) instead of an array, the values listed in this combination table must not be used. If you need to use a specific data type, instantiate the vector with the necessary data type.
![]() |
|||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Description | ||||||||||||||||||||||||||||||||||||||
ResultArrayPtr - Possible values returned |
|||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Casts the requested results to a MIL_DOUBLE. (summarize)Casts the requested results to a MIL_DOUBLE. (more details...) |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Data type info:
Data type: array of type
MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE>
] | address of a
MIL_DOUBLE MORE
Data type info:
Data type: array of type
MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE>
] | address of a
MIL_DOUBLE MORE
|
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Casts the requested results to a MIL_ID. (summarize)Casts the requested results to a MIL_ID. (more details...) |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Data type info:
Data type: array of type
MIL_ID [optionally, in C++: a reference to a std::vector<MIL_ID>
] | address of a
MIL_ID MORE
Data type info:
Data type: array of type
MIL_ID [optionally, in C++: a reference to a std::vector<MIL_ID>
] | address of a
MIL_ID MORE
|
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Casts the requested results to a MIL_INT. (summarize)Casts the requested results to a MIL_INT. (more details...) |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Data type info:
Data type: array of type
MIL_INT [optionally, in C++: a reference to a std::vector<MIL_INT>
] | address of a
MIL_INT MORE
Data type info:
Data type: array of type
MIL_INT [optionally, in C++: a reference to a std::vector<MIL_INT>
] | address of a
MIL_INT MORE
|
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Casts the requested results to a MIL_INT32. (summarize)Casts the requested results to a MIL_INT32. (more details...) |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Data type info:
Data type: array of type
MIL_INT32 [optionally, in C++: a reference to a std::vector<MIL_INT32>
] | address of a
MIL_INT32 MORE
Data type info:
Data type: array of type
MIL_INT32 [optionally, in C++: a reference to a std::vector<MIL_INT32>
] | address of a
MIL_INT32 MORE
|
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Casts the requested results to a MIL_INT64. (summarize)Casts the requested results to a MIL_INT64. (more details...) |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Data type info:
Data type: array of type
MIL_INT64 [optionally, in C++: a reference to a std::vector<MIL_INT64>
] | address of a
MIL_INT64 MORE
Data type info:
Data type: array of type
MIL_INT64 [optionally, in C++: a reference to a std::vector<MIL_INT64>
] | address of a
MIL_INT64 MORE
|
Header | Include mil.h. |
Library | Use mil.lib; milreg.lib. |
DLL | Requires mil.dll; milreg.dll. |