HALCON Reference Manual 10.0.2
Table of Contents / Filters / Geometric Transformations ClassesClassesClasses | | | Operators

polar_trans_imagepolar_trans_imagepolar_trans_imagePolarTransImagePolarTransImage (Operator)

Name

polar_trans_imagepolar_trans_imagepolar_trans_imagePolarTransImagePolarTransImage — Transform an image to polar coordinates

Signature

polar_trans_image(ImageXY : ImagePolar : Row, Column, Width, Height : )

Herror polar_trans_image(const Hobject ImageXY, Hobject* ImagePolar, const Hlong Row, const Hlong Column, const Hlong Width, const Hlong Height)

Herror T_polar_trans_image(const Hobject ImageXY, Hobject* ImagePolar, const Htuple Row, const Htuple Column, const Htuple Width, const Htuple Height)

Herror polar_trans_image(Hobject ImageXY, Hobject* ImagePolar, const HTuple& Row, const HTuple& Column, const HTuple& Width, const HTuple& Height)

HImage HImage::PolarTransImage(const HTuple& Row, const HTuple& Column, const HTuple& Width, const HTuple& Height) const

HImageArray HImageArray::PolarTransImage(const HTuple& Row, const HTuple& Column, const HTuple& Width, const HTuple& Height) const

void HOperatorSetX.PolarTransImage(
[in] IHUntypedObjectX* ImageXY, [out] IHUntypedObjectX** ImagePolar, [in] VARIANT Row, [in] VARIANT Column, [in] VARIANT Width, [in] VARIANT Height)

IHImageX* HImageX.PolarTransImage(
[in] Hlong Row, [in] Hlong Column, [in] Hlong Width, [in] Hlong Height)

static void HOperatorSet.PolarTransImage(HObject imageXY, out HObject imagePolar, HTuple row, HTuple column, HTuple width, HTuple height)

HImage HImage.PolarTransImage(int row, int column, int width, int height)

Description

polar_trans_imagepolar_trans_imagepolar_trans_imagePolarTransImagePolarTransImage transforms an image in cartesian coordinates to an image in polar coordinates. The size of the resulting image is selected with WidthWidthWidthWidthwidth and HeightHeightHeightHeightheight. WidthWidthWidthWidthwidth determines the angular resolution, while HeightHeightHeightHeightheight determines the resolution of the radius. RowRowRowRowrow and ColumnColumnColumnColumncolumn determine the center of the polar coordinate system in the original image ImageXYImageXYImageXYImageXYimageXY. This point is mapped to the upper row of ImagePolarImagePolarImagePolarImagePolarimagePolar.

A point (x',y') in the result image corresponds to the point (x,y) in the original image in the following manner: 

    x = cos(2*pi*(x'/result_width)) * y' + ColumnColumnColumnColumncolumn 


    y = sin(2*pi*(x'/result_width)) * y' + RowRowRowRowrow.

polar_trans_imagepolar_trans_imagepolar_trans_imagePolarTransImagePolarTransImage can be executed on an OpenCL device if the input image does not exceed the maximum size of image objects of the selected device. Due to numerical reasons, there can be slight differences in the output compared to the execution on the CPU.

Parallelization

Parameters

ImageXYImageXYImageXYImageXYimageXY (input_object)  (multichannel-)image(-array) → objectHImageHImageHImageXHobject (byte* / int2* / uint2* / real*) *allowed for compute devices

Input image in cartesian coordinates.

ImagePolarImagePolarImagePolarImagePolarimagePolar (output_object)  (multichannel-)image(-array) → objectHImageHImageHImageXHobject * (byte / int2 / uint2 / real)

Result image in polar coordinates.

RowRowRowRowrow (input_control)  point.y → HTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong)

Row coordinate of the center of the coordinate system.

Default value: 100

Suggested values: 0, 10, 100, 200

Typical range of values: 0 ≤ Row Row Row Row row ≤ 512

Minimum increment: 1

Recommended increment: 1

ColumnColumnColumnColumncolumn (input_control)  point.x → HTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong)

Column coordinate of the center of the coordinate system.

Default value: 100

Suggested values: 0, 10, 100, 200

Typical range of values: 0 ≤ Column Column Column Column column ≤ 512

Minimum increment: 1

Recommended increment: 1

WidthWidthWidthWidthwidth (input_control)  extent.x → HTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong)

Width of the result image.

Default value: 314

Suggested values: 100, 200, 157, 314, 512

Typical range of values: 2 ≤ Width Width Width Width width ≤ 512

Minimum increment: 1

Recommended increment: 10

HeightHeightHeightHeightheight (input_control)  extent.y → HTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong)

Height of the result image.

Default value: 200

Suggested values: 100, 128, 256, 512

Typical range of values: 2 ≤ Height Height Height Height height ≤ 512

Minimum increment: 1

Recommended increment: 10

Example (HDevelop)

read_image(Image,'monkey')
disp_image(Image,WindowHandle)
polar_trans_image(Image,PolarImage,100,100,314,200)
disp_image(PolarImage,WindowHandle)

Example (C)

read_image(&Image,"monkey");
disp_image(Image,WindowHandle);
polar_trans_image(Image,&PolarImage,100,100,314,200);
disp_image(PolarImage,WindowHandle);

Example (HDevelop)

read_image(Image,'monkey')
disp_image(Image,WindowHandle)
polar_trans_image(Image,PolarImage,100,100,314,200)
disp_image(PolarImage,WindowHandle)

Example (HDevelop)

read_image(Image,'monkey')
disp_image(Image,WindowHandle)
polar_trans_image(Image,PolarImage,100,100,314,200)
disp_image(PolarImage,WindowHandle)

Example (HDevelop)

read_image(Image,'monkey')
disp_image(Image,WindowHandle)
polar_trans_image(Image,PolarImage,100,100,314,200)
disp_image(PolarImage,WindowHandle)

Alternatives

polar_trans_image_extpolar_trans_image_extpolar_trans_image_extPolarTransImageExtPolarTransImageExt

See also

polar_trans_image_invpolar_trans_image_invpolar_trans_image_invPolarTransImageInvPolarTransImageInv, polar_trans_regionpolar_trans_regionpolar_trans_regionPolarTransRegionPolarTransRegion, polar_trans_region_invpolar_trans_region_invpolar_trans_region_invPolarTransRegionInvPolarTransRegionInv, polar_trans_contour_xldpolar_trans_contour_xldpolar_trans_contour_xldPolarTransContourXldPolarTransContourXld, polar_trans_contour_xld_invpolar_trans_contour_xld_invpolar_trans_contour_xld_invPolarTransContourXldInvPolarTransContourXldInv, affine_trans_imageaffine_trans_imageaffine_trans_imageAffineTransImageAffineTransImage

Module

Foundation

Table of Contents / Filters / Geometric Transformations ClassesClassesClasses | | | Operators
HALCON Reference Manual 10.0.2 Copyright © 1996-2011 MVTec Software GmbH