imaqConvolve

NI Vision for LabWindows/CVI Function

imaqConvolve

Usage

int imaqConvolve(Image* dest, Image* source, const float* kernel, int matrixRows, int matrixCols, float normalize, const Image* mask);

Purpose

Applies a linear filter to an image by convolving the image with a filtering kernel. The convolution kernel must have an odd width and height.

Note   This function is obsolete. The replacement function is imaqConvolve2().

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 to filter. This function modifies the border of the source image. The border must be at least half as large as the larger dimension of the kernel.
kernel const float* The matrix representing the linear filter. This parameter is required and cannot be NULL.
matrixRows int The number of rows in the kernel matrix. This number must be odd.
matrixCols int The number of columns in the kernel matrix. This number must be odd.
normalize float The normalization factor. After performing the convolution, the function divides each pixel value by this value. Set this parameter to 0 to divide by the sum of the elements of the kernel.
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 entire 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.