Loading Reference... User Guide... Hardware-specific Notes...

Customize Help

MIL systems:
Show All

Installed MIL systems

Multiple

None

Host system

Matrox GigE Vision driver (MIL 10, Update 25, Update 54, or Update 85)*

Matrox Morphis

Matrox Morphis QxT

Matrox Orion HD

Matrox Radient eCL

Matrox Radient eV-CXP (MIL 10 or Update 29)*

Matrox Solios eA/XA

Matrox Solios ecl/xcl/ev-cl

Matrox USB3 Vision driver (Update 19)

Matrox RadientPro-CL (Update 7)

Matrox Radient eV-CL (Update 27 or 74)

Matrox Iris GTR (Update 28 or Update 68)

Matrox Clarity UHD (Update 36 or 76)

Matrox GenTL driver (Update 34)

Matrox Indio (Update 53 or Update 68)

Matrox Rapixo CXP (Update 75 or Update 84)

Matrox Concord PoE with ToE (Update 82)

Matrox Rapixo CL Pro (Update 96)

As Tooltip

Value descriptions: Detailed Summarized

Save Settings

| Customize Help

| Save Settings

MedgeGetNeighbors

See also

User Guide:

Advanced edge extraction Optimizing edge extractions Steps to extract and analyze edges

Reference:

MedgeControl MedgeInquire

Availability

Availability

Not available in MIL-Lite

Available in MIL

Available on Windows

Available on Linux

Not supported on:

Not supported on Matrox Indio (Update 53 or Update 68) (w)

Not supported on Matrox Concord PoE with ToE (Update 82) (z)

Fully supported on:

Fully supported on Host system (a)

Fully supported on Matrox GigE Vision driver (MIL 10, Update 25, Update 54, or Update 85)* (c)

Fully supported on Matrox Morphis (g)

Fully supported on Matrox Morphis QxT (h)

Fully supported on Matrox Orion HD (i)

Fully supported on Matrox Radient eCL (j)

Fully supported on Matrox Radient eV-CXP (MIL 10 or Update 29)* (k)

Fully supported on Matrox Solios eA/XA (l)

Fully supported on Matrox Solios ecl/xcl/ev-cl (m)

Fully supported on Matrox USB3 Vision driver (Update 19) (o)

Fully supported on Matrox RadientPro-CL (Update 7) (p)

Fully supported on Matrox Radient eV-CL (Update 27 or 74) (r)

Fully supported on Matrox Iris GTR (Update 28 or Update 68) (t)

Fully supported on Matrox Clarity UHD (Update 36 or 76) (u)

Fully supported on Matrox GenTL driver (Update 34) (v)

Fully supported on Matrox Rapixo CXP (Update 75 or Update 84) (y)

Fully supported on Matrox Rapixo CL Pro (Update 96) (aa)

* Refer to the MIL system-specific information
in the MIL Reference for the minimum update required.

For any information regarding a MIL system added during a MIL Update, see the MIL system’s release note

Available on Non-Matrox computer

Available on Matrox 4Sight-X

Available on Matrox 4Sight GP/GPm

Available on Matrox Supersight

function map

Function map

Examples

None.

Function Map

- SrcArrayAnglePtr

- DstArrayIndexPtr

- DstArrayLabelPtr

Table:

For specifying the accuracy

Compilation information

Synopsis

Get edgels from an Edge Finder result buffer that are the closest neighbors to a list of user-specified point coordinates.

Syntax

void MedgeGetNeighbors(

MIL_ID EdgeResultId,	//in
MIL_INT SizeOfArray,	//in
const MIL_DOUBLE *SrcArrayXPtr,	//in
const MIL_DOUBLE *SrcArrayYPtr,	//in
const MIL_DOUBLE *SrcArrayAnglePtr,	//in
MIL_DOUBLE *DstArrayXPtr,	//out
MIL_DOUBLE *DstArrayYPtr,	//out
MIL_INT *DstArrayIndexPtr,	//out
MIL_INT *DstArrayLabelPtr,	//out
MIL_INT64 ControlFlag	//in

)

Description

This function retrieves the coordinates of edgels, from an Edge Finder result buffer, that correspond to the closest neighbors from a list of user-specified source point coordinates. You can also set a series of constraints that potential results must adhere to before being returned. To do so, use the appropriate settings in MedgeControl().

If your target image was associated with a camera calibration context but you want to retrieve positional and dimensional results in pixel units, use MedgeControl() with the M_RESULT_OUTPUT_UNITS control type set to M_PIXEL. Note that if you set M_RESULT_OUTPUT_UNITS to M_WORLD and the results were not obtained from a calibrated image, MedgeGetNeighbors() will generate an error. Additionally, if results were obtained from a calibrated source image, and you specify to retrieve results in world units, user-specified coordinates and constraints must be specified in the same world units as the coordinate system used to calculate the results.

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

EdgeResultId

Specifies the identifier of the Edge Finder result buffer from which to search for edgel candidates.

SizeOfArray

Specifies the number of points provided. This value represents how many user-specified point coordinates will be searched for in the Edge Finder result buffer.

When using a standard vector (std::vector) overload function in C++, you can pass M_DEFAULT to this parameter and MIL will automatically determine the size based on the number of items in the vector passed to the SrcArrayXPtr, SrcArrayYPtr, SrcArrayAnglePtr, DstArrayXPtr, DstArrayYPtr, DstArrayIndexPtr, or DstArrayLabelPtr parameter.

SrcArrayXPtr

Accepts the address of one of the following:

array of type MIL_DOUBLE [optionally, in C++: a reference to a constant std::vector<MIL_DOUBLE> ] (and a maximum array rank for C# of 1)
Required array size:(SizeOfArray)

Specifies the address of the array containing the X-coordinate(s) of the source point(s).

SrcArrayYPtr

Accepts the address of one of the following:

array of type MIL_DOUBLE [optionally, in C++: a reference to a constant std::vector<MIL_DOUBLE> ] (and a maximum array rank for C# of 1)
Required array size:(SizeOfArray)

Specifies the address of the array containing the Y-coordinate(s) of the source point(s).

SrcArrayAnglePtr

Accepts the address of one of the following:

array of type MIL_DOUBLE [optionally, in C++: a reference to a constant std::vector<MIL_DOUBLE> ] (and a maximum array rank for C# of 1)
Required array size:(SizeOfArray)

Specifies the address of the array containing the constraint angle(s) used to refine the search for edgel candidates. Note that angle values (0° to 360°) are measured counter-clockwise and must be mapped between either 0 to 255 (for contour contexts) or 0 to 127 (for crest contexts).

If no value is required, set this parameter to M_NULL.

DstArrayXPtr

Accepts the address of one of the following:

array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] (and a maximum array rank for C# of 1)
Required array size:(SizeOfArray)
array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] (and a maximum array rank for C# of 1)
Required array size:(SizeOfArray) * MedgeInquire ( M_NEIGHBOR_MAXIMUM_NUMBER )

Specifies the address of the array in which the X-coordinate(s) of the edgel(s) found in the Edge Finder result buffer are to be written. If no edgels were found, ignore the information written. Note that if no edgels were found, the index (DstArrayIndexPtr) and label (DstArrayLabelPtr) of the edgels is M_NULL.

The size of the array must be equal to SizeOfArray multiplied by the maximum number of edgel candidates for each point (M_NEIGHBOR_MAXIMUM_NUMBER).

If no value is required, set this parameter to M_NULL.

DstArrayYPtr

Accepts the address of one of the following:

array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] (and a maximum array rank for C# of 1)
Required array size:(SizeOfArray)
array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] (and a maximum array rank for C# of 1)
Required array size:(SizeOfArray) * MedgeInquire ( M_NEIGHBOR_MAXIMUM_NUMBER )

Specifies the address of the array in which the Y-coordinate(s) of the edgel(s) found in the Edge Finder result buffer is to be written. If no edgels were found, ignore the information written. Note that if no edgels were found, the index (DstArrayIndexPtr) and label (DstArrayLabelPtr) of the edgels is M_NULL.

The size of the array must be equal to SizeOfArray multiplied by the maximum number of edgel candidates for each point (M_NEIGHBOR_MAXIMUM_NUMBER).

If no value is required, set this parameter to M_NULL.

DstArrayIndexPtr

Accepts the address of one of the following:

array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] (and a maximum array rank for C# of 1)
Required array size:(SizeOfArray)
array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] (and a maximum array rank for C# of 1)
Required array size:(SizeOfArray) * MedgeInquire ( M_NEIGHBOR_MAXIMUM_NUMBER )

Specifies the address of the array in which the index of the edgel(s) found in the Edge Finder result buffer is to be written. If no edgels were found, M_NULL is written.

The size of the array must be equal to SizeOfArray multiplied by the maximum number of edgel candidates for each point (M_NEIGHBOR_MAXIMUM_NUMBER).

If no value is required, set this parameter to M_NULL.

DstArrayLabelPtr

Accepts the address of one of the following:

array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] (and a maximum array rank for C# of 1)
Required array size:(SizeOfArray)
array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] (and a maximum array rank for C# of 1)
Required array size:(SizeOfArray) * MedgeInquire ( M_NEIGHBOR_MAXIMUM_NUMBER )

Specifies the address of the array in which the label of the edgel's edge found in the Edge Finder result buffer is to be written. If no edgels were found, M_NULL is written.

The size of the array must be equal to SizeOfArray multiplied by the maximum number of edgel candidates for each point (M_NEIGHBOR_MAXIMUM_NUMBER).

If no value is required, set this parameter to M_NULL.

ControlFlag

Specifies the accuracy with which to return edgels.

For specifying the accuracy
Value	Description
M_DEFAULT	Same as M_GET_EDGELS.
M_GET_EDGELS	Specifies that edgels are returned with normal accuracy. In this case, only edgels explicitly located in the Edge Finder result buffer can be returned. (summarize) Specifies that edgels are returned with normal accuracy. (more details...)
M_GET_SUBEDGELS	Specifies that edgels are returned with high accuracy. In this case, a point between two edgels can be returned. When using M_GET_SUBEDGELS, the M_NEIGHBOR_MAXIMUM_NUMBER constraint in MedgeControl() must be set to 1. (summarize) Specifies that edgels are returned with high accuracy. (more details...)

Compilation information

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

DEFAULT GET EDGELS GET SUBEDGELS