ClassesClassesClassesClasses | | | | Operators

get_grayval_interpolatedget_grayval_interpolatedGetGrayvalInterpolatedget_grayval_interpolatedGetGrayvalInterpolatedGetGrayvalInterpolated (Operator)

Name

get_grayval_interpolatedget_grayval_interpolatedGetGrayvalInterpolatedget_grayval_interpolatedGetGrayvalInterpolatedGetGrayvalInterpolated — Return gray values of an image at the positions given by tuples of rows and columns.

Signature

get_grayval_interpolated(Image : : Row, Column, Interpolation : Grayval)

Herror get_grayval_interpolated(const Hobject Image, double Row, double Column, const char* Interpolation, double* Grayval)

Herror T_get_grayval_interpolated(const Hobject Image, const Htuple Row, const Htuple Column, const Htuple Interpolation, Htuple* Grayval)

Herror get_grayval_interpolated(Hobject Image, const HTuple& Row, const HTuple& Column, const HTuple& Interpolation, double* Grayval)

Herror get_grayval_interpolated(Hobject Image, const HTuple& Row, const HTuple& Column, const HTuple& Interpolation, HTuple* Grayval)

HTuple HImage::GetGrayvalInterpolated(const HTuple& Row, const HTuple& Column, const HTuple& Interpolation) const

void GetGrayvalInterpolated(const HObject& Image, const HTuple& Row, const HTuple& Column, const HTuple& Interpolation, HTuple* Grayval)

HTuple HImage::GetGrayvalInterpolated(const HTuple& Row, const HTuple& Column, const HString& Interpolation) const

double HImage::GetGrayvalInterpolated(double Row, double Column, const HString& Interpolation) const

double HImage::GetGrayvalInterpolated(double Row, double Column, const char* Interpolation) const

void HOperatorSetX.GetGrayvalInterpolated(
[in] IHUntypedObjectX* Image, [in] VARIANT Row, [in] VARIANT Column, [in] VARIANT Interpolation, [out] VARIANT* Grayval)

VARIANT HImageX.GetGrayvalInterpolated(
[in] VARIANT Row, [in] VARIANT Column, [in] BSTR Interpolation)

static void HOperatorSet.GetGrayvalInterpolated(HObject image, HTuple row, HTuple column, HTuple interpolation, out HTuple grayval)

HTuple HImage.GetGrayvalInterpolated(HTuple row, HTuple column, string interpolation)

double HImage.GetGrayvalInterpolated(double row, double column, string interpolation)

Description

The operator get_grayval_interpolatedget_grayval_interpolatedGetGrayvalInterpolatedget_grayval_interpolatedGetGrayvalInterpolatedGetGrayvalInterpolated returns interpolated gray values at several subpixel positions of an ImageImageImageImageImageimage. The coordinates of the row positions are given in the tuple RowRowRowRowRowrow, the coordinates of column positions are given in the tuple ColumnColumnColumnColumnColumncolumn. The gray values are returned in GrayvalGrayvalGrayvalGrayvalGrayvalgrayval as a tuple of floating point numbers.

The interpolation method can be selected via the parameter InterpolationInterpolationInterpolationInterpolationInterpolationinterpolation. The following interpolation methods are supported:

'bilinear'"bilinear""bilinear""bilinear""bilinear""bilinear":

The parameter GrayvalGrayvalGrayvalGrayvalGrayvalgrayval is computed using a bilinear interpolation of the four neighboring gray values of the selected coordinates. Note: direction and cyclic images are treated like byte images.

'bicubic'"bicubic""bicubic""bicubic""bicubic""bicubic":

The parameter GrayvalGrayvalGrayvalGrayvalGrayvalgrayval is computed using a bicubic interpolation of sixteen neighboring gray values of the selected coordinates. Direction and cyclic images are treated like byte images. In this mode, the resulting gray values may contain values that lie outside of the range of numbers that can be represented by the input image type.

'bicubic_clipped'"bicubic_clipped""bicubic_clipped""bicubic_clipped""bicubic_clipped""bicubic_clipped":

The parameter GrayvalGrayvalGrayvalGrayvalGrayvalgrayval is computed using a bicubic interpolation of sixteen neighboring gray values of the selected coordinates. Direction and cyclic images are treated like byte images. In this mode, resulting gray values that lie outside of the range of numbers that can be represented by the input image type are clipped to that range.

Note that get_grayval_interpolatedget_grayval_interpolatedGetGrayvalInterpolatedget_grayval_interpolatedGetGrayvalInterpolatedGetGrayvalInterpolated does not take the domain of the image into account, i.e., if the domain has been reduced, e.g., with reduce_domainreduce_domainReduceDomainreduce_domainReduceDomainReduceDomain, gray values are returned even for points that lie outside the domain.

Parallelization

Parameters

ImageImageImageImageImageimage (input_object)  singlechannelimage objectHImageHImageHImageHImageXHobject (byte / direction / cyclic / int1 / int2 / uint2 / int4 / real / complex)

Image whose gray values are to be accessed.

RowRowRowRowRowrow (input_control)  point.y(-array) HTupleHTupleHTupleVARIANTHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong) (double / Hlong) (double / Hlong)

Row coordinates of positions.

Default value: 0

Suggested values: 0, 64, 128, 256, 512, 1024

Typical range of values: -0.5 ≤ Row Row Row Row Row row

Restriction: -0.5 <= Row && Row < height(Image) - 0.5

ColumnColumnColumnColumnColumncolumn (input_control)  point.x(-array) HTupleHTupleHTupleVARIANTHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong) (double / Hlong) (double / Hlong)

Column coordinates of positions.

Number of elements: Column == Row

Default value: 0

Suggested values: 0, 64, 128, 256, 512, 1024

Typical range of values: -0.5 ≤ Column Column Column Column Column column

Restriction: -0.5 <= Column && Column < width(Image) - 0.5

InterpolationInterpolationInterpolationInterpolationInterpolationinterpolation (input_control)  string HTupleHTupleHTupleVARIANTHtuple (string) (string) (HString) (char*) (BSTR) (char*)

Interpolation method.

Default value: 'bilinear' "bilinear" "bilinear" "bilinear" "bilinear" "bilinear"

List of values: 'bicubic'"bicubic""bicubic""bicubic""bicubic""bicubic", 'bicubic_clipped'"bicubic_clipped""bicubic_clipped""bicubic_clipped""bicubic_clipped""bicubic_clipped", 'bilinear'"bilinear""bilinear""bilinear""bilinear""bilinear"

GrayvalGrayvalGrayvalGrayvalGrayvalgrayval (output_control)  grayval(-array) HTupleHTupleHTupleVARIANTHtuple (real) (double) (double) (double) (double) (double)

Gray values of the selected image coordinates.

Result

If the parameters are valid, the operator get_grayval_interpolatedget_grayval_interpolatedGetGrayvalInterpolatedget_grayval_interpolatedGetGrayvalInterpolatedGetGrayvalInterpolated returns the value 2 (H_MSG_TRUE). If necessary, an exception is raised.

Possible Predecessors

read_imageread_imageReadImageread_imageReadImageReadImage

Alternatives

get_grayval_contour_xldget_grayval_contour_xldGetGrayvalContourXldget_grayval_contour_xldGetGrayvalContourXldGetGrayvalContourXld, get_grayvalget_grayvalGetGrayvalget_grayvalGetGrayvalGetGrayval

Module

Foundation


ClassesClassesClassesClasses | | | | Operators