imaqRejectBorder

NI Vision for LabWindows/CVI Function

imaqRejectBorder

Usage

int imaqRejectBorder(Image* dest, Image* source, int connectivity8);

Purpose

Eliminates particles that touch the border of the image.

Image Types Supported

IMAQ_IMAGE_U8

Parameters

Name

Type

Description

dest Image* The destination image.
source Image* The source image. If the image has a border, the function sets all border pixel values to 0.
connectivity8 int Set this parameter to TRUE to use connectivity-8 to determine whether particles are touching. Set this parameter to FALSE to use connectivity-4 to determine whether particles are touching. For more information about connectivity, see Chapter 9, Binary Morphology, in the NI Vision Concepts Manual.

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.