Operator Reference
polar_trans_image (Operator)
polar_trans_image
— Transform an image to polar coordinates
Warning
polar_trans_image
is obsolete and is only provided for
reasons of backward compatibility. New applications should use
the operator polar_trans_image_ext
instead.
Signature
Description
polar_trans_image
transforms an image in Cartesian coordinates
to an image in polar coordinates. The size of the resulting image
is selected with Width
and Height
.
Width
determines the angular resolution, while
Height
determines the resolution of the radius.
Row
and Column
determine the center of the
polar coordinate system in the original image ImageXY
.
This point is mapped to the upper row of ImagePolar
.
A point (x',y') in the result image corresponds to the point (x,y) in the original image in the following manner:
polar_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
ImageXY
(input_object) (multichannel-)image(-array) →
object (byte* / int2* / uint2* / real*) *allowed for compute devices
Input image in Cartesian coordinates.
ImagePolar
(output_object) (multichannel-)image(-array) →
object (byte / int2 / uint2 / real)
Result image in polar coordinates.
Row
(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
≤
512
Minimum increment: 1
Recommended increment: 1
Column
(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
≤
512
Minimum increment: 1
Recommended increment: 1
Width
(input_control) extent.x →
(integer)
Width of the result image.
Default: 314
Suggested values: 100, 200, 157, 314, 512
Value range:
2
≤
Width
≤
512
Minimum increment: 1
Recommended increment: 10
Height
(input_control) extent.y →
(integer)
Height of the result image.
Default: 200
Suggested values: 100, 128, 256, 512
Value range:
2
≤
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)
Module
Foundation