| MIL 10 Reference
| Customize Help
| Save Settings

M3dmapAllocResult


See also
Availability
Not available in MIL-Lite
Available in MIL

Available on Windows
Available on Linux

Available on Non-Matrox computer
Available on Matrox 4Sight-X
Available on Matrox 4Sight GP
Available on Matrox Supersight
function map Function map
Examples
M3dmapAlloc
M3dmapArith
Synopsis
Allocate a 3D reconstruction result buffer.
Syntax
MIL_ID M3dmapAllocResult(
MIL_ID SysId, //in
MIL_INT64 ResultType, //in
MIL_INT64 ControlFlag, //in
MIL_ID *Result3dmapIdPtr //out
)
Description

This function allocates, on the specified system, a 3D reconstruction result buffer to be used with a 3D reconstruction context. When the result buffer is no longer required, release its memory, using M3dmapFree().

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 if there is complementary information.
Parameters
This function is not supported on the selected boards.
Parameters
SysId INQ

Specifies the identifier of the system on which to allocate the result buffer.

function map For specifying the system
CollapseValue Description
Collapse M_DEFAULT_HOST

Specifies the default Host system of the current MIL application.
Collapse MIL system identifier

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

Specifies the type of result buffer to allocate. This parameter must be set to the following value:

function map For specifying the type of result buffer to allocate
CollapseValue Description
Collapse M_ALIGNMENT_RESULT

Specifies to allocate a pairwise 3D alignment result buffer used for an M3dmapAlign() operation.
Collapse M_DEPTH_CORRECTED_DATA

Specifies to allocate a 3D reconstruction result buffer used to store results generated in M_DEPTH_CORRECTION mode, after the 3D reconstruction context has been calibrated.

This result buffer type is used to generate partially corrected depth maps.

(summarize)
Collapse M_LASER_CALIBRATION_DATA

Specifies to allocate a 3D reconstruction result buffer used to store images of laser line displacement at specified heights during the 3D reconstruction calibration process.

This result buffer type is used to calibrate a 3D reconstruction context.

(summarize)
Collapse M_POINT_CLOUD_CONTAINER

Specifies to allocate a 3D reconstruction result buffer used to store results generated in M_CALIBRATED_CAMERA_LINEAR_MOTION mode, after the 3D reconstruction context has been calibrated.

This result buffer type is used to generate fully corrected depth maps.

(summarize)
Collapse M_STAT_RESULT

Specifies to allocate a 3D reconstruction result buffer which will be used to store statistics results.
ControlFlag

Reserved for future expansion and must be set to M_DEFAULT.

Result3dmapIdPtr

Specifies the address of the variable in which to write the 3D reconstruction result buffer identifier. Since M3dmapAllocResult() also returns the 3D reconstruction result buffer identifier, you can set this parameter to M_NULL.

Return value
The returned value is the 3D reconstruction 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; mil3dmap.lib.
DLL Requires mil.dll; mil3dmap.dll.
DEFAULT HOST ALIGNMENT RESULT DEPTH CORRECTED DATA LASER CALIBRATION DATA POINT CLOUD CONTAINER STAT RESULT