Click here to show toolbars of the Web Online Help System: show toolbars
 

| Customize Help
| Save Settings

M3dmapAllocResult


Function Map
Syntax
Description
Parameters
- SysId
Table: For specifying the system
- ResultType
Table: For specifying the type of result buffer to allocate
- ControlFlag
- Result3dmapIdPtr
Return value
Compilation information
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
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().
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
Click to summarizeValue Description
Click to summarize M_ALIGNMENT_RESULT

Specifies to allocate a pairwise 3D alignment result buffer used for an M3dmapAlign() operation.
Click to summarize 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)
Click to summarize 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)
Click to summarize 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)
Click to summarize 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