polar_trans_imagepolar_trans_imagePolarTransImagePolarTransImagepolar_trans_image (Operator)

Name

polar_trans_imagepolar_trans_imagePolarTransImagePolarTransImagepolar_trans_image — Transform an image to polar coordinates

Warning

polar_trans_imagepolar_trans_imagePolarTransImagePolarTransImagePolarTransImagepolar_trans_image is obsolete and is only provided for reasons of backward compatibility. New applications should use the operator polar_trans_image_extpolar_trans_image_extPolarTransImageExtPolarTransImageExtPolarTransImageExtpolar_trans_image_ext instead.

Signature

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

Description

polar_trans_imagepolar_trans_imagePolarTransImagePolarTransImagePolarTransImagepolar_trans_image transforms an image in Cartesian coordinates to an image in polar coordinates. The size of the resulting image is selected with WidthWidthWidthWidthwidthwidth and HeightHeightHeightHeightheightheight. WidthWidthWidthWidthwidthwidth determines the angular resolution, while HeightHeightHeightHeightheightheight determines the resolution of the radius. RowRowRowRowrowrow and ColumnColumnColumnColumncolumncolumn determine the center of the polar coordinate system in the original image ImageXYImageXYImageXYImageXYimageXYimage_xy. This point is mapped to the upper row of ImagePolarImagePolarImagePolarImagePolarimagePolarimage_polar.

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

polar_trans_imagepolar_trans_imagePolarTransImagePolarTransImagePolarTransImagepolar_trans_image 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.

Further Information

For an explanation of the different 2D coordinate systems used in HALCON, see the introduction of chapter Transformations / 2D Transformations.

Execution Information

Supports OpenCL compute devices.
Multithreading type: reentrant (runs in parallel with non-exclusive operators).
Multithreading scope: global (may be called from any thread).
Automatically parallelized on tuple level.
Automatically parallelized on channel level.

Parameters

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

Input image in Cartesian coordinates.

ImagePolarImagePolarImagePolarImagePolarimagePolarimage_polar (output_object) (multichannel-)image(-array) → object (byte / int2 / uint2 / real)

Result image in polar coordinates.

RowRowRowRowrowrow (input_control) point.y → (integer)

Row coordinate of the center of the coordinate system.

Default: 100

Suggested values: 0, 10, 100, 200

Value range: 0 ≤ Row Row Row Row row row ≤ 512

Minimum increment: 1

Recommended increment: 1

ColumnColumnColumnColumncolumncolumn (input_control) point.x → (integer)

Column coordinate of the center of the coordinate system.

Default: 100

Suggested values: 0, 10, 100, 200

Value range: 0 ≤ Column Column Column Column column column ≤ 512

Minimum increment: 1

Recommended increment: 1

WidthWidthWidthWidthwidthwidth (input_control) extent.x → (integer)

Width of the result image.

Default: 314

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

Value range: 2 ≤ Width Width Width Width width width ≤ 512

Minimum increment: 1

Recommended increment: 10

HeightHeightHeightHeightheightheight (input_control) extent.y → (integer)

Height of the result image.

Default: 200

Suggested values: 100, 128, 256, 512

Value range: 2 ≤ Height Height Height Height height height ≤ 512

Minimum increment: 1

Recommended increment: 10

Example (HDevelop)

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

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')
dev_display (Image)
polar_trans_image(Image,PolarImage,100,100,314,200)
dev_display (PolarImage)

Example (HDevelop)

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

Example (HDevelop)

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

Module

Foundation

Operators