MIL_ID ResultImId, | //in |
MIL_INT64 ResultType, | //in |
void *UserArrayPtr | //out |
This function retrieves all the results of the specified type from the specified result buffer and stores them in the specified one-dimensional destination user array. Results are only available after calling MimCountDifference(), MimFindExtreme(), MimHistogram(), MimLocateEvent(), MimProject(), MimStat(), or MimWaveletTransform().
If your target image was associated with a calibration context, positional and dimensional results are, by default, returned with respect to the relative coordinate system of the image. Otherwise, these results are returned in pixels, relative to the top-left pixel in the target image.
If your target image was associated with a calibration context but you want to retrieve positional and dimensional results in pixel units, use MimControl() with the M_RESULT_OUTPUT_UNITS control type set to M_PIXEL. However, note that if you set M_RESULT_OUTPUT_UNITS to M_WORLD without specifying a calibrated image in which to calculate the results, MimGetResult() will generate an error.
Specifies the identifier of the image processing result buffer from which to retrieve results.
Specifies the type of result(s) to retrieve.
See the Parameter associations section for possible values that can be specified.
Specifies the address of the one-dimensional array in which to write the results read from the MIL result buffer.
See the Parameter associations section for possible values that can be returned.
The table below lists possible values for the ResultType parameter and possible values returned to the UserArrayPtr parameter.
Unless otherwise specified, the following values require that you pass the UserArrayPtr parameter the address of an array of type MIL_DOUBLE with a size equal to 1.
For a result buffer
|
|||||||||||||||||||||||||||||||||||||||
ResultType |
Description
|
||||||||||||||||||||||||||||||||||||||
UserArrayPtr - Possible values returned |
|||||||||||||||||||||||||||||||||||||||
M_ANGULAR_DATA_COHERENCE + |
Retrieves the coherence, from an M_STAT_LIST result buffer, of pixels representing angles and as such, treated as unit vectors. (more details...) |
||||||||||||||||||||||||||||||||||||||
M_ANGULAR_DATA_MEAN + |
Retrieves the angle of the vector sum, from an M_STAT_LIST result buffer, of pixels representing angles, and as such, treated as unit vectors. (more details...) |
||||||||||||||||||||||||||||||||||||||
M_CUMULATIVE_VALUE + |
Retrieves the cumulative histogram values from an M_HIST_LIST result buffer. (more details...) |
||||||||||||||||||||||||||||||||||||||
UserArrayPtr data type info |
Data
type: array of type MIL_INT |
||||||||||||||||||||||||||||||||||||||
M_HIST_REAL_SIZE + |
Retrieves the number of values (entries) used by the histogram, from an M_HIST_LIST result buffer. (more details...) |
||||||||||||||||||||||||||||||||||||||
UserArrayPtr data type info |
Data
type: array of type MIL_INT |
||||||||||||||||||||||||||||||||||||||
M_HIST_VALUE_OFFSET + |
Retrieves the intensity value in the source that corresponds to the first bin (entry 0) in the histogram, from an M_HIST_LIST result buffer. (more details...) |
||||||||||||||||||||||||||||||||||||||
UserArrayPtr data type info |
Data
type: array of type MIL_INT |
||||||||||||||||||||||||||||||||||||||
M_HIST_VALUE_RANGE + |
Retrieves the number of intensity values in the source that were used to generate the histogram, from an M_HIST_LIST result buffer. (more details...) |
||||||||||||||||||||||||||||||||||||||
UserArrayPtr data type info |
Data
type: array of type MIL_INT |
||||||||||||||||||||||||||||||||||||||
M_MAX + |
Retrieves the maximum pixel value from an M_STAT_LIST result buffer. (more details...) |
||||||||||||||||||||||||||||||||||||||
M_MAX_ABS + |
Retrieves the maximum absolute pixel value from an M_STAT_LIST result buffer. (more details...) |
||||||||||||||||||||||||||||||||||||||
M_MEAN + |
Retrieves the mean pixel value from an M_STAT_LIST result buffer. (more details...) |
||||||||||||||||||||||||||||||||||||||
M_MIN + |
Retrieves the minimum pixel value from an M_STAT_LIST result buffer. (more details...) |
||||||||||||||||||||||||||||||||||||||
M_MIN_ABS + |
Retrieves the minimum absolute pixel value from an M_STAT_LIST result buffer. (more details...) |
||||||||||||||||||||||||||||||||||||||
M_NB_EVENT + |
Retrieves the number of events from an M_EVENT_LIST result buffer. (more details...) |
||||||||||||||||||||||||||||||||||||||
UserArrayPtr data type info |
|
||||||||||||||||||||||||||||||||||||||
M_NUMBER + |
Retrieves the number of pixels or the number of images, depending on the type of result buffer. (more details...) |
||||||||||||||||||||||||||||||||||||||
M_NUMBER_OF_LEVELS + |
Retrieves the total number of transformation levels calculated by the wavelet transformation, from an M_WAVELET_TRANSFORM_RESULT result buffer. (more details...) |
||||||||||||||||||||||||||||||||||||||
M_ORIGINAL_IMAGE_SIZE_X + |
Retrieves the unaltered width of the image used by the wavelet transformation, from an M_WAVELET_TRANSFORM_RESULT result buffer. (more details...) |
||||||||||||||||||||||||||||||||||||||
M_ORIGINAL_IMAGE_SIZE_Y + |
Retrieves the unaltered height of the image used by the wavelet transformation, from an M_WAVELET_TRANSFORM_RESULT result buffer. (more details...) |
||||||||||||||||||||||||||||||||||||||
M_PERCENTILE_VALUE + |
Retrieves the inverse cumulative histogram from an M_HIST_LIST result buffer. (more details...) |
||||||||||||||||||||||||||||||||||||||
UserArrayPtr data type info |
Data
type: array of type MIL_INT |
||||||||||||||||||||||||||||||||||||||
M_POSITION_X + |
Retrieves the image X-coordinate of each event from an M_EVENT_LIST result buffer. (more details...) |
||||||||||||||||||||||||||||||||||||||
UserArrayPtr data type info |
|
||||||||||||||||||||||||||||||||||||||
M_POSITION_Y + |
Retrieves the image Y-coordinate of each event from an M_EVENT_LIST result buffer. (more details...) |
||||||||||||||||||||||||||||||||||||||
UserArrayPtr data type info |
|
||||||||||||||||||||||||||||||||||||||
M_STANDARD_DEVIATION + |
Retrieves the pixel standard deviation value from an M_STAT_LIST result buffer. (more details...) |
||||||||||||||||||||||||||||||||||||||
M_SUM + |
Retrieves the sum of the pixel values from an M_STAT_LIST result buffer. (more details...) |
||||||||||||||||||||||||||||||||||||||
M_SUM_ABS + |
Retrieves the sum of the absolute pixel values from an M_STAT_LIST result buffer. (more details...) |
||||||||||||||||||||||||||||||||||||||
M_SUM_OF_SQUARES + |
Retrieves the sum of the squared pixel values from an M_STAT_LIST result buffer. (more details...) |
||||||||||||||||||||||||||||||||||||||
M_TOTAL_NUMBER + |
Retrieves the total number of images that have ever been used to calculate the results in an M_STAT_MULTIPLE_RESULT result buffer. (more details...) |
||||||||||||||||||||||||||||||||||||||
M_TRANSFORMATION_DOMAIN + |
Retrieves whether the mathematical domain of the resulting wavelet transformation values consist of complex numbers or only real numbers, from an M_WAVELET_TRANSFORM_RESULT result buffer. (more details...) |
||||||||||||||||||||||||||||||||||||||
M_COMPLEX |
Specifies that the mathematical domain of the values consist of real and imaginary numbers. (more details...) |
||||||||||||||||||||||||||||||||||||||
M_REAL |
Specifies that the mathematical domain of the values consist of only real numbers. (more details...) |
||||||||||||||||||||||||||||||||||||||
M_TRANSFORMATION_MODE + |
Retrieves the wavelet transformation mode, from an M_WAVELET_TRANSFORM_RESULT result buffer. (more details...) |
||||||||||||||||||||||||||||||||||||||
M_DEFAULT |
Same as M_DYADIC. |
||||||||||||||||||||||||||||||||||||||
M_DYADIC |
Specifies a dyadic wavelet transformation. INFO |
||||||||||||||||||||||||||||||||||||||
M_UNDECIMATED + |
Specifies an undecimated wavelet transformation. INFO |
||||||||||||||||||||||||||||||||||||||
M_VALUE + |
Retrieves values from an M_HIST_LIST, M_PROJ_LIST, M_EXTREME_LIST, M_EVENT_LIST, or M_COUNT_LIST result buffer. (more details...) |
||||||||||||||||||||||||||||||||||||||
UserArrayPtr data type info |
|
||||||||||||||||||||||||||||||||||||||
M_WAVELET_DRAW_SIZE_X + |
Retrieves the width required to draw, for every level calculated, all wavelet coefficient results (diagonal, horizontal, vertical, and the approximation), from an M_WAVELET_TRANSFORM_RESULT result buffer. (more details...) |
||||||||||||||||||||||||||||||||||||||
M_WAVELET_DRAW_SIZE_X_WITH_PADDING + |
Retrieves the width required to draw, for every level calculated, all wavelet coefficient results (diagonal, horizontal, vertical, and the approximation), from an M_WAVELET_TRANSFORM_RESULT result buffer. (more details...) |
||||||||||||||||||||||||||||||||||||||
M_WAVELET_DRAW_SIZE_Y + |
Retrieves the height required to draw, for every level calculated, all wavelet coefficient results (diagonal, horizontal, vertical, and the approximation), from an M_WAVELET_TRANSFORM_RESULT result buffer. (more details...) |
||||||||||||||||||||||||||||||||||||||
M_WAVELET_DRAW_SIZE_Y_WITH_PADDING + |
Retrieves the height required to draw, for every level calculated, all wavelet coefficient results (diagonal, horizontal, vertical, and the approximation), from an M_WAVELET_TRANSFORM_RESULT result buffer. (more details...) |
||||||||||||||||||||||||||||||||||||||
M_WAVELET_SIZE + |
Retrieves the size of the wavelet transformation, from an M_WAVELET_TRANSFORM_RESULT result buffer. (more details...) |
||||||||||||||||||||||||||||||||||||||
M_WAVELET_TYPE + |
Retrieves the type of the wavelet transformation, from an M_WAVELET_TRANSFORM_RESULT result buffer. (more details...) |
||||||||||||||||||||||||||||||||||||||
M_DEFAULT |
Same as M_HAAR. |
||||||||||||||||||||||||||||||||||||||
M_CUSTOM |
Specifies a custom wavelet processing. |
||||||||||||||||||||||||||||||||||||||
M_DAUBECHIES_1 |
Specifies a Daubechies wavelet filter that uses 1 vanishing moment and real coefficients. |
||||||||||||||||||||||||||||||||||||||
M_DAUBECHIES_2 |
Specifies a Daubechies wavelet filter that uses 2 vanishing moments and real coefficients. |
||||||||||||||||||||||||||||||||||||||
M_DAUBECHIES_3 |
Specifies a Daubechies wavelet filter that uses 3 vanishing moments and real coefficients. |
||||||||||||||||||||||||||||||||||||||
M_DAUBECHIES_3_COMPLEX |
Specifies a Daubechies wavelet filter that uses 3 vanishing moments and complex coefficients. |
||||||||||||||||||||||||||||||||||||||
M_DAUBECHIES_4 |
Specifies a Daubechies wavelet filter that uses 4 vanishing moments and real coefficients. |
||||||||||||||||||||||||||||||||||||||
M_DAUBECHIES_5 |
Specifies a Daubechies wavelet filter that uses 5 vanishing moments and real coefficients. |
||||||||||||||||||||||||||||||||||||||
M_DAUBECHIES_5_COMPLEX |
Specifies a Daubechies wavelet filter that uses 5 vanishing moments and complex coefficients. |
||||||||||||||||||||||||||||||||||||||
M_DAUBECHIES_6 |
Specifies a Daubechies wavelet filter that uses 6 vanishing moments and real coefficients. |
||||||||||||||||||||||||||||||||||||||
M_DAUBECHIES_7 |
Specifies a Daubechies wavelet filter that uses 7 vanishing moments and real coefficients. |
||||||||||||||||||||||||||||||||||||||
M_DAUBECHIES_7_COMPLEX |
Specifies a Daubechies wavelet filter that uses 7 vanishing moments and complex coefficients. |
||||||||||||||||||||||||||||||||||||||
M_DAUBECHIES_8 |
Specifies a Daubechies wavelet filter that uses 8 vanishing moments and real coefficients. |
||||||||||||||||||||||||||||||||||||||
M_HAAR |
Specifies a Haar wavelet filter. INFO |
||||||||||||||||||||||||||||||||||||||
M_SYMLET_1 |
Specifies a Symlet wavelet filter that uses 1 vanishing moment and real coefficients. |
||||||||||||||||||||||||||||||||||||||
M_SYMLET_2 |
Specifies a Symlet wavelet filter that uses 2 vanishing moments and real coefficients. |
||||||||||||||||||||||||||||||||||||||
M_SYMLET_3 |
Specifies a Symlet wavelet filter that uses 3 vanishing moments and real coefficients. |
||||||||||||||||||||||||||||||||||||||
M_SYMLET_4 |
Specifies a Symlet wavelet filter that uses 4 vanishing moments and real coefficients. |
||||||||||||||||||||||||||||||||||||||
M_SYMLET_5 |
Specifies a Symlet wavelet filter that uses 5 vanishing moments and real coefficients. |
||||||||||||||||||||||||||||||||||||||
M_SYMLET_6 |
Specifies a Symlet wavelet filter that uses 6 vanishing moments and real coefficients. |
||||||||||||||||||||||||||||||||||||||
M_SYMLET_7 |
Specifies a Symlet wavelet filter that uses 7 vanishing moments and real coefficients. |
||||||||||||||||||||||||||||||||||||||
M_SYMLET_8 |
Specifies a Symlet wavelet filter that uses 8 vanishing moments and real coefficients. |
You can add the following value to the above-mentioned values to get the requested results as a percentage.
For retrieving results as a
percentage
|
|||||||||||||||||||||||||||||||||||||||
ResultType |
Description
|
||||||||||||||||||||||||||||||||||||||
UserArrayPtr - Possible values returned |
|||||||||||||||||||||||||||||||||||||||
M_PERCENTAGE |
Retrieves the histogram values or cumulative histogram values, as a percentage. (more details...) |
||||||||||||||||||||||||||||||||||||||
UserArrayPtr data type info |
Data
type: array of type MIL_INT |
The following value might be combined with the above-mentioned value to determine if undecimated wavelet transformations are centered.
For specifying whether undecimated
wavelet transformations are centered
|
|||||||||||||||||||||||||||||||||||||||
Combination value | Description
|
||||||||||||||||||||||||||||||||||||||
M_CENTER |
Specifies undecimated wavelet transformations that are centered. INFO |
You can add one of the following values to the above-mentioned values to cast the requested results to the required data type.
For specifying the data type
|
|||||||||||||||||||||||||||||||||||||||
ResultType |
Description
|
||||||||||||||||||||||||||||||||||||||
UserArrayPtr - Possible values returned |
|||||||||||||||||||||||||||||||||||||||
M_TYPE_MIL_DOUBLE |
Casts the requested results to a MIL_DOUBLE. (more details...) |
||||||||||||||||||||||||||||||||||||||
UserArrayPtr data type info |
|
||||||||||||||||||||||||||||||||||||||
M_TYPE_MIL_FLOAT |
Casts the requested results to a MIL_FLOAT. (more details...) |
||||||||||||||||||||||||||||||||||||||
UserArrayPtr data type info |
|
||||||||||||||||||||||||||||||||||||||
M_TYPE_MIL_INT |
Casts the requested results to a MIL_INT. (more details...) |
||||||||||||||||||||||||||||||||||||||
UserArrayPtr data type info |
|
||||||||||||||||||||||||||||||||||||||
M_TYPE_MIL_INT32 |
Casts the requested results to a MIL_INT32. (more details...) |
||||||||||||||||||||||||||||||||||||||
UserArrayPtr data type info |
|
||||||||||||||||||||||||||||||||||||||
M_TYPE_MIL_INT64 |
Casts the requested results to a MIL_INT64. (more details...) |
||||||||||||||||||||||||||||||||||||||
UserArrayPtr data type info |
|
Header | Include mil.h. |
Library | Use mil.lib; milim.lib. |
DLL | Requires mil.dll; milim.dll. |