imaqEdgeFilter

NI Vision for LabWindows/CVI Function

imaqEdgeFilter

Usage

int imaqEdgeFilter(Image* dest, Image* source, OutlineMethod method, const Image* mask);

Purpose

Applies a nonlinear filter to highlight edges.

Image Types Supported

IMAQ_IMAGE_U8, IMAQ_IMAGE_I16, IMAQ_IMAGE_SGL

Parameters

Name

Type

Description

dest Image* The destination image.
source Image* The image of which the function highlights edges. The convolution modifies the border of the source image. The border must be at least one pixel wide.
method OutlineMethod Method to use when outlining the edges.
mask const Image* An optional mask image. This image must be an IMAQ_IMAGE_U8 image. The function filters only those pixels in the source image whose corresponding pixels in the mask are non-zero. Set this parameter to NULL to filter the whole source image.

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.