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(). |