| Customize Help
| Save Settings

MregAllocResult


Function Map
Syntax
Description
Parameters
- SystemId
Table: For specifying the system
- ControlFlag
Table: For specifying the type of result buffer
- ResultIdPtr
Return value
Compilation information
Synopsis
Allocate a registration result buffer.
Syntax
MIL_ID MregAllocResult(
MIL_ID SystemId, //in
MIL_INT64 ControlFlag, //in
MIL_ID *ResultIdPtr //out
)
Description

This function allocates a registration result buffer, on the specified system, to store results obtained from an MregCalculate() operation.

When the registration result buffer is no longer required, release its memory, using MregFree().

Note that this function reference has not been updated for a MIL system added during a MIL update. Refer to the MIL system's release note to see which MIL system’s documentation you should use in its place and any possible differences.
Parameters
This function is not supported on the selected boards.
This function reference has not been updated for the selected MIL system. To show the content of this page, choose a second MIL system; refer to the MIL system's release note to see which MIL system’s documentation to choose and any possible differences.
Parameters
SystemId INQ

Specifies the system on which to allocate the result buffer. This parameter should be set to one of the following values:

function map For specifying the system
Click to summarizeValue Description
Click to summarize M_DEFAULT_HOST

Specifies the default Host system of the current MIL application.
Click to summarize MIL system identifier

Specifies a valid system identifier, previously allocated using MsysAlloc().
ControlFlag

Specifies the type of result buffer to allocate. This parameter should be set to one of the following values.

function map For specifying the type of result buffer
Click to summarizeValue Description
Click to summarize M_DEFAULT

Same as M_STITCHING_RESULT.
Click to summarize M_DEPTH_FROM_FOCUS_RESULT

Specifies that the result buffer can hold results from a depth-from-focus operation.
Click to summarize M_EXTENDED_DEPTH_OF_FIELD_RESULT

Specifies that the result buffer can hold results from an extended depth of field (EDoF) operation.
Click to summarize M_HIGH_DYNAMIC_RANGE_RESULT

Specifies that the result buffer can hold results from a high dynamic range operation.
Click to summarize M_PHOTOMETRIC_STEREO_RESULT

Specifies that the result buffer can hold results from a photometric stereo operation.
Click to summarize M_STITCHING_RESULT

Specifies that the result buffer can hold results from a correlation-stitching registration operation.
ResultIdPtr

Specifies the address of the variable in which to write the registration result buffer identifier. Since MregAllocResult() also returns the registration result buffer identifier, you can set this parameter to M_NULL. If allocation fails, M_NULL is written as the identifier.

Return value
The returned value is the result buffer identifier if the allocation is successful. If allocation fails, M_NULL is returned.
Compilation information
Header Include mil.h.
Library Use mil.lib; milreg.lib.
DLL Requires mil.dll; milreg.dll.
DEFAULT HOST DEFAULT DEPTH FROM FOCUS RESULT EXTENDED DEPTH OF FIELD RESULT HIGH DYNAMIC RANGE RESULT PHOTOMETRIC STEREO RESULT STITCHING RESULT