M3dimNormals

See also

User Guide:

Working with points in a point cloud

Reference:

M3dimAlloc M3dimControl MbufAllocComponent MbufAllocContainer MbufInquireContainer

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/GPm

Available on Matrox Supersight

Function map

Examples

m3dgra.cpp
m3dgra.cs
m3dgra.vb

Function Map

- NormalsContext3dimId

Table:

For specifying the normals 3D image processing context identifier

- SrcContainerBufId

- DstContainerBufId

- ControlFlag

Compilation information

Synopsis

Compute a point cloud's unit normal vectors.

Syntax

void M3dimNormals(

MIL_ID NormalsContext3dimId,	//in
MIL_ID SrcContainerBufId,	//in
MIL_ID DstContainerBufId,	//in
MIL_INT64 ControlFlag	//in

)

Description

This function computes the unit normal vector for each point in a point cloud, and stores the values in an M_COMPONENT_NORMALS_MIL component, which is added to the destination container. Any previously existing M_COMPONENT_NORMALS_MIL component in the destination container is overwritten.

All other source components are copied to the destination container, and replace any previously existing components.

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

NormalsContext3dimId

Specifies a normals 3D image processing context.

For specifying the normals 3D image processing context identifier
Value	Description
M_NORMALS_CONTEXT_MESH	Specifies a predefined normals 3D image processing context with all normals context control types (M3dimControl()) set to their default, except M_NEIGHBOR_SEARCH_MODE which is set to M_MESH. Use this predefined context to determine the neighbors of a point using the point cloud's M_COMPONENT_MESH_MIL component. (summarize) Specifies a predefined normals 3D image processing context with all normals context control types (M3dimControl()) set to their default, except M_NEIGHBOR_SEARCH_MODE which is set to M_MESH. (more details...)
M_NORMALS_CONTEXT_ORGANIZED	Specifies a predefined normals 3D image processing context with all normals context control types (M3dimControl()) set to their default, except M_NEIGHBOR_SEARCH_MODE which is set to M_ORGANIZED. Use this predefined context to determine the neighbors of a point using the point cloud's organizational structure. (summarize) Specifies a predefined normals 3D image processing context with all normals context control types (M3dimControl()) set to their default, except M_NEIGHBOR_SEARCH_MODE which is set to M_ORGANIZED. (more details...)
M_NORMALS_CONTEXT_TREE	Specifies a predefined normals 3D image processing context with all normals context control types (M3dimControl()) set to their default, including M_NEIGHBOR_SEARCH_MODE which is set to M_TREE. Use this predefined context to determine the neighbors of a point using a KD tree search mode. (summarize) Specifies a predefined normals 3D image processing context with all normals context control types (M3dimControl()) set to their default, including M_NEIGHBOR_SEARCH_MODE which is set to M_TREE. (more details...)
MIL normals 3D image processing context identifier	Specifies the identifier of a normals 3D image processing context, previously allocated using M3dimAlloc() with M_NORMALS_CONTEXT. If a previously allocated context is specified, the function applies the normals control settings specified using M3dimControl(). (summarize) Specifies the identifier of a normals 3D image processing context, previously allocated using M3dimAlloc() with M_NORMALS_CONTEXT. (more details...)

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.

If M_NEIGHBOR_SEARCH_MODE is set to M_MESH, the component M_COMPONENT_MESH_MIL must exist in the source container.

DstContainerBufId

Specifies the identifier of the destination container, previously allocated using MbufAllocContainer() with M_PROC. The destination container must not be a child container.

The destination's M_COMPONENT_NORMALS_MIL component is a 32-bit, floating-point, 3-band buffer.

ControlFlag

Reserved for future expansion and must be set to M_DEFAULT.

Compilation information

Header	Include mil.h.
Library	Use mil.lib; mil3dim.lib.
DLL	Requires mil.dll; mil3dim.dll.