| Customize Help
| Save Settings

MimDistance


Function Map
Syntax
Description
Parameters
- SrcImageBufId
- DstImageBufId
- DistanceTransform
Table: For specifying how to calculate the minimum distance
Remarks
Compilation information
Synopsis
Perform a distance transformation.
Syntax
void MimDistance(
MIL_ID SrcImageBufId, //in
MIL_ID DstImageBufId, //in
MIL_INT64 DistanceTransform //in
)
Description

This function determines the shortest distance between each blob pixel and the blob's background, and assigns this distance to the pixel. It produces a type of contour mapping of a blob.

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
SrcImageBufId

Specifies the identifier of the source of the operation. This parameter must be given an image buffer identifier.

This image buffer must not have a region of interest (ROI) associated with it. Using an image buffer with an ROI will cause an error.

DstImageBufId

Specifies the identifier of the destination of the resulting image. This parameter must be given an image buffer identifier.

This image buffer must not have a region of interest (ROI) associated with it. Using an image buffer with an ROI will cause an error.

DistanceTransform

Specifies the way in which the minimum distance from blob pixel to background pixel is calculated. This parameter approximates the true distance from blob pixel to background pixel using a 3x3 distance matrix and can be set to one of the following:

function map For specifying how to calculate the minimum distance
Click to summarizeValue Description
Click to summarize M_CHAMFER_3_4

Determines the minimum distance using horizontal, vertical or diagonal pixel steps. Horizontal and vertical steps are counted as 3; diagonal steps are counted as 4. Then, the resulting distance is normalized by a factor of 3. This transform provides the best approximation to Euclidean distance.

This transform requires that the destination buffer be deep enough to hold a number at least three times the maximum distance from a blob pixel to its edge. For example, an 8-bit buffer (255 max) can be used for a maximum distance of 85 pixels and a 16-bit buffer (65535 max) for a maximum distance of 21845 pixels.

3x3 Distance Matrix:

(summarize)
Click to summarize M_CHESSBOARD

Determines the minimum distance using horizontal, vertical, or diagonal pixel steps. All steps count as 1.

3x3 Distance Matrix:

(summarize)
Click to summarize M_CITY_BLOCK

Determines the minimum distance using only horizontal or vertical pixel steps. Horizontal and vertical steps count as 1.

3x3 Distance Matrix:

(summarize)
Remark
Compilation information
Header Include mil.h.
Library Use mil.lib; milim.lib.
DLL Requires mil.dll; milim.dll.
PROC NONE PROC NONE CHAMFER 3 4 CHESSBOARD CITY BLOCK