imaqInterpolatePoints

NI Vision for LabWindows/CVI Function

imaqInterpolatePoints

Usage

float* imaqInterpolatePoints(const Image* image, const Point* points, int numPoints, InterpolationMethod method, int subpixel, int* interpCount);

Purpose

Interpolates the pixel values of an image over specified points.

Image Types Supported

IMAQ_IMAGE_U8, IMAQ_IMAGE_I16, IMAQ_IMAGE_SGL

Parameters

Name

Type

Description

image const Image* The image containing the values to interpolate.
points const Point* The points over which to interpolate. All the points in this array must be within the image. This parameter is required and cannot be NULL.
numPoints int The number of points in the input points array.
method InterpolationMethod Specifies the method for the interpolation. The valid interpolation methods for rotation are IMAQ_BILINEAR, IMAQ_QUADRATIC and IMAQ_CUBIC_SPLINE.
subpixel int The number of subdivisions into which to interpolate. For example, a value of 0 causes the function to return only the pixel values at the given points, whereas a value of 1 returns the pixel values at the given points and at the midpoint of each pair.
interpCount int* On return, the number of interpolated values in the array returned by the function. Set this parameter to NULL if you do not need this information.

Return Value

Type

Description

float* On success, this function returns an array of the interpolated values. On failure, this function returns NULL. To get extended error information, call imaqGetLastError(). When you are finished with this array, dispose of it by calling imaqDispose().