MimGetResult1d()函数

Synopsis

Get values from an image processing 1D region of a result buffer.

Format

void MimGetResult1d(ImResultId, OffEntry, NbEntries, ResultType, UserArrayPtr)

MIL_ID ImResultId; Image processing result buffer identifier
long OffEntry; Result entry offset
long NbEntries; Number of result entries to get
long ResultType; Type of result to read
void *UserArrayPtr; Array in which to return results

Description

This function copies the specified number of result entries from the specified result buffer to the specified one-dimensional destination user array.

The ImResultId parameter specifies the identifier of the image processing result buffer from which to get results.

The OffEntry parameter specifies the offset of the first result to read. The given value must be within the number of allocated result entries.

The NbEntries parameter specifies the number of result entries to get starting from the entry specified by OffEntry.

The ResultType parameter specifies the type of data that the MIL result buffer contains. This parameter can be set to one of the following:

ResultType Description
M_VALUE Read values from M_HIST_LIST, M_PROJ_LIST, M_EXTREME_LIST, M_EVENT_LIST, or M_COUNT_LIST type buffer.
M_POSITION_X Read image X-coordinate of values in M_EVENT_LIST type buffer.
M_POSITION_Y Read image Y-coordinate of values in M_EVENT_LIST type buffer.
M_NB_EVENT Read the number of occurrences in M_EVENT_LIST type buffer. Only one value is returned.

If an M_EXTREME_LIST type result buffer contains both the minimum and maximum value of an image, the minimum is written first followed by the second.

The UserArrayPtr parameter specifies the address of the one-dimensional array in which to write results from the MIL result buffer. This array must have at least the same number of elements as the total number of entries to get (NbEntries) specified at MimAllocResult time.

See also

MimAllocResult, MimGetResult