| Customize Help
| Save Settings

M3dimCalculateMapSize


Function Map
Syntax
Description
Parameters
- CalculateMapSizeContext3dimId
Table: For specifying the calculate map size 3D image processing context identifier
- SrcContainerBufId
- AABox3dgeoId
- ControlFlag
- DepthMapSizeXPtr
- DepthMapSizeYPtr
Compilation information
Synopsis
Estimate a recommended depth map image buffer size from a source container's point cloud.
Syntax
void M3dimCalculateMapSize(
MIL_ID CalculateMapSizeContext3dimId, //in
MIL_ID SrcContainerBufId, //in
MIL_ID AABox3dgeoId, //in
MIL_INT64 ControlFlag, //in
MIL_INT *DepthMapSizeXPtr, //out
MIL_INT *DepthMapSizeYPtr //out
)
Description

This function estimates a recommended depth map image buffer size in X and Y, using the dimensions of the source container's point cloud. You can optionally limit the calculation to consider only points inside a specified axis-aligned 3D box geometry.

The recommended size is useful for allocating a depth map image buffer (using MbufAlloc2d()) before calling M3dimProject().

Using M3dimControl(), you can set the depth map's required pixel aspect ratio. You can also set a fixed size along 1 dimension, and the function will calculate the necessary size of the other dimension (for either pixel size or image buffer size). Default settings let M3dimCalculateMapSize() do all calculations.

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
CalculateMapSizeContext3dimId

Specifies a calculate map size 3D image processing context.

function map For specifying the calculate map size 3D image processing context identifier
Click to summarizeValue Description
Click to summarize M_DEFAULT

Specifies the default calculate map size 3D image processing context of the current MIL application.

The operation will use default values for all calculate map size context control types (M3dimControl()).

(summarize)
Click to summarize MIL calculate map size 3D image processing
context identifier

Specifies the identifier of a calculate map size 3D image processing context, previously allocated using M3dimAlloc() with M_CALCULATE_MAP_SIZE_CONTEXT.

If a calculate map size context is specified, the function applies the calculate map size control settings specified using M3dimControl().

(summarize)
SrcContainerBufId

Specifies the identifier of the source container containing a 3D-processable point cloud. The container must be 3D-processable (that is, if you call MbufInquireContainer() with M_3D_PROCESSABLE, the function returns M_PROCESSABLE).

The container must have been previously allocated using MbufAllocContainer() with M_PROC. The container must have the components M_COMPONENT_RANGE and M_COMPONENT_CONFIDENCE.

AABox3dgeoId

Specifies the identifier of the axis-aligned 3D box geometry object to use to limit the calculation to points within the box. The 3D box geometry object must have been previously allocated using M3dgeoAlloc() with M_GEOMETRY, and defined as a box.

If a 3D box geometry object is not required, set this parameter to M_NULL.

ControlFlag

Reserved for future expansion and must be set to M_DEFAULT.

DepthMapSizeXPtr

Specifies the address of the variable in which to write the estimated depth map image buffer size in X.

DepthMapSizeYPtr

Specifies the address of the variable in which to write the estimated depth map image buffer size in Y.

Compilation information
Header Include mil.h.
Library Use mil.lib; mil3dim.lib.
DLL Requires mil.dll; mil3dim.dll.
DEFAULT NOT PROCESSABLE TRUE BOX