imaqSimpleDistance

NI Vision for LabWindows/CVI Function

imaqSimpleDistance

Usage

int imaqSimpleDistance(Image* dest, Image* source, const StructuringElement* structuringElement);

Purpose

Creates a distance map. The function encodes a particle pixel value as a function of the distance of the pixel from the particle border. For a more precise but slower algorithm, use imaqDanielssonDistance().

Image Types Supported

IMAQ_IMAGE_U8

Parameters

Name

Type

Description

dest Image* The destination image.
source Image* The image that the function uses to compute the distance map. The function modifies the border of the source image. The border must be at least half as large as the larger of the structuring element dimensions.
structuringElement const StructuringElement* The structuring element used in the operation. Set this parameter to NULL if you do not want a custom structuring element.

Return Value

Type

Description

int On success, this function returns a non-zero value. On failure, this function returns 0. To get extended error information, call imaqGetLastError().

Parameter Discussion

source—This function modifies the source image. If you need the original image, create a copy of the image using imaqDuplicate() before using this function.