polar_trans_imagepolar_trans_imagePolarTransImagePolarTransImage (Operator)

Name

polar_trans_imagepolar_trans_imagePolarTransImagePolarTransImage — Transform an image to polar coordinates

Warning

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

Signature

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

Description

polar_trans_imagepolar_trans_imagePolarTransImagePolarTransImagePolarTransImage 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:

polar_trans_imagepolar_trans_imagePolarTransImagePolarTransImagePolarTransImage 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

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

Input image in cartesian coordinates.

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

Result image in polar coordinates.

RowRowRowRowrow (input_control) point.y → (integer)

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 → (integer)

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 → (integer)

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 → (integer)

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')
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