polar_trans_image_extpolar_trans_image_extPolarTransImageExtPolarTransImageExtpolar_trans_image_ext (Operator)

Name

polar_trans_image_extpolar_trans_image_extPolarTransImageExtPolarTransImageExtpolar_trans_image_ext — Anwenden einer Polarkoordinatentransformation eines Kreisrings.

Signatur

Beschreibung

polar_trans_image_extpolar_trans_image_extPolarTransImageExtPolarTransImageExtPolarTransImageExtpolar_trans_image_ext transformiert den durch den Mittelpunkt (RowRowRowRowrowrow, ColumnColumnColumnColumncolumncolumn), die Radien RadiusStartRadiusStartRadiusStartRadiusStartradiusStartradius_start und RadiusEndRadiusEndRadiusEndRadiusEndradiusEndradius_end und die Winkel AngleStartAngleStartAngleStartAngleStartangleStartangle_start und AngleEndAngleEndAngleEndAngleEndangleEndangle_end definierten Kreisring im Bild ImageImageImageImageimageimage auf dessen Polarkoordinatendarstellung im Bild PolarTransImagePolarTransImagePolarTransImagePolarTransImagepolarTransImagepolar_trans_image mit den Dimensionen WidthWidthWidthWidthwidthwidth x HeightHeightHeightHeightheightheight.

Das linke obere Pixel im Ausgabebild entspricht immer dem Punkt im Eingabebild, der durch RadiusStartRadiusStartRadiusStartRadiusStartradiusStartradius_start und AngleStartAngleStartAngleStartAngleStartangleStartangle_start spezifiziert wird. Analog entspricht das rechte untere Pixel im Ausgabebild immer dem Punkt im Eingabebild, der durch RadiusEndRadiusEndRadiusEndRadiusEndradiusEndradius_end und AngleEndAngleEndAngleEndAngleEndangleEndangle_end spezifiziert wird. Im Normalfall (AngleStartAngleStartAngleStartAngleStartangleStartangle_start < AngleEndAngleEndAngleEndAngleEndangleEndangle_end und RadiusStartRadiusStartRadiusStartRadiusStartradiusStartradius_start < RadiusEndRadiusEndRadiusEndRadiusEndradiusEndradius_end) wird die Polarkoordinatentransformation also in mathematisch positiver Durchlaufrichtung (entgegen dem Uhrzeigersinn) durchgeführt. Dabei liegen die Punkte mit kleineren Radien im Ausgabebild weiter oben. Durch geeignetes Vertauschen der Werte der Parameter (z.B. AngleStartAngleStartAngleStartAngleStartangleStartangle_start > AngleEndAngleEndAngleEndAngleEndangleEndangle_end oder RadiusStartRadiusStartRadiusStartRadiusStartradiusStartradius_start > RadiusEndRadiusEndRadiusEndRadiusEndradiusEndradius_end) kann jede beliebige Orientierung des Ausgabebildes erreicht werden.

Über den Parameter InterpolationInterpolationInterpolationInterpolationinterpolationinterpolation kann dabei zwischen den Interpolationsverfahren 'bilinear'"bilinear""bilinear""bilinear""bilinear""bilinear" und 'nearest_neighbor'"nearest_neighbor""nearest_neighbor""nearest_neighbor""nearest_neighbor""nearest_neighbor" gewählt werden. Bei 'nearest_neighbor'"nearest_neighbor""nearest_neighbor""nearest_neighbor""nearest_neighbor""nearest_neighbor" wird der Grauwert des Pixels im Ausgabebild aus dem Grauwert des nächstgelegenen Pixels im Eingabebild bestimmt. Bei 'bilinear'"bilinear""bilinear""bilinear""bilinear""bilinear" wird der Grauwert des Pixels im Ausgabebild durch bilineare Interpolation aus den Grauwerten der vier nächstgelegenen Pixel im Eingabebild bestimmt. Der Modus 'bilinear'"bilinear""bilinear""bilinear""bilinear""bilinear" liefert qualitativ bessere Ergebnisse, ist allerdings auch langsamer als 'nearest_neighbor'"nearest_neighbor""nearest_neighbor""nearest_neighbor""nearest_neighbor""nearest_neighbor".

Die Winkel sind frei als reelle Zahlen wählbar, Mittelpunkt und Radien können ebenfalls frei als reelle Zahlen gewählt werden. Sind diese jedoch ganze Zahlen und entspricht die Differenz von RadiusEndRadiusEndRadiusEndRadiusEndradiusEndradius_end und RadiusStartRadiusStartRadiusStartRadiusStartradiusStartradius_start der Höhe HeightHeightHeightHeightheightheight des Zielbildes, so wird die Berechnung durch eine optimierte Routine erheblich schneller durchgeführt.

Die Radien und Winkel sind inklusive, d.h. die erste Zeile des Zielbildes entspricht dem Kreis mit dem Radius RadiusStartRadiusStartRadiusStartRadiusStartradiusStartradius_start, die letzte Zeile dem mit dem Radius RadiusEndRadiusEndRadiusEndRadiusEndradiusEndradius_end. Für Vollkreise, bei denen die Differenz AngleStartAngleStartAngleStartAngleStartangleStartangle_start - AngleEndAngleEndAngleEndAngleEndangleEndangle_end (360 Grad) beträgt, bedeutet dies insbesondere, dass die erste Spalte des Zielbildes gleich der letzten ist.

Um diesem Verhalten vorzubeugen sollte diese Differenz statt betragen.

Der Aufruf: polar_trans_image(Image, PolarTransImage, Row, Column, Width, Height)polar_trans_image(Image, PolarTransImage, Row, Column, Width, Height)PolarTransImage(Image, PolarTransImage, Row, Column, Width, Height)PolarTransImage(Image, PolarTransImage, Row, Column, Width, Height)PolarTransImage(Image, PolarTransImage, Row, Column, Width, Height)polar_trans_image(Image, PolarTransImage, Row, Column, Width, Height) entspricht dem Aufruf: polar_trans_image_ext(Image, PolarTransImage, Row-0.5, Column-0.5, 6.2831853, 6.2831853/Width, 0, Height-1, Width, Height, 'nearest_neighbor')polar_trans_image_ext(Image, PolarTransImage, Row-0.5, Column-0.5, 6.2831853, 6.2831853/Width, 0, Height-1, Width, Height, "nearest_neighbor")PolarTransImageExt(Image, PolarTransImage, Row-0.5, Column-0.5, 6.2831853, 6.2831853/Width, 0, Height-1, Width, Height, "nearest_neighbor")PolarTransImageExt(Image, PolarTransImage, Row-0.5, Column-0.5, 6.2831853, 6.2831853/Width, 0, Height-1, Width, Height, "nearest_neighbor")PolarTransImageExt(Image, PolarTransImage, Row-0.5, Column-0.5, 6.2831853, 6.2831853/Width, 0, Height-1, Width, Height, "nearest_neighbor")polar_trans_image_ext(Image, PolarTransImage, Row-0.5, Column-0.5, 6.2831853, 6.2831853/Width, 0, Height-1, Width, Height, "nearest_neighbor").

Der Offset von 0.5 ist notwendig, da polar_trans_imagepolar_trans_imagePolarTransImagePolarTransImagePolarTransImagepolar_trans_image keine Nearest-Neighbor Interpolation durchführt, Radien und Winkel ergeben sich durch die im vorherigen Abschnitt beschriebenen Überlegungen, da diese Werte in polar_trans_imagepolar_trans_imagePolarTransImagePolarTransImagePolarTransImagepolar_trans_image nicht inklusive behandelt werden. Der Startwinkel ist hier größer als der Endwinkel, damit der Kreisring von polar_trans_image_extpolar_trans_image_extPolarTransImageExtPolarTransImageExtPolarTransImageExtpolar_trans_image_ext genauso wie in polar_trans_imagepolar_trans_imagePolarTransImagePolarTransImagePolarTransImagepolar_trans_image im Uhrzeigersinn durchlaufen wird.

polar_trans_image_extpolar_trans_image_extPolarTransImageExtPolarTransImageExtPolarTransImageExtpolar_trans_image_ext kann auf OpenCL-Geräten ausgeführt werden, wenn das Eingangsbild die maximale Größe für Bildobjekte des ausgewählten Gerätes nicht überschreitet. Aus numerischen Gründen kann es dabei zu geringfügigen Abweichungen des Ergebnisses gegenüber der Ausführung auf der CPU kommen.

Für Bilder vom Typ byte, int2 oder uint2 kann mittels des Systemparameters 'int_zooming'"int_zooming""int_zooming""int_zooming""int_zooming""int_zooming" (siehe set_systemset_systemSetSystemSetSystemSetSystemset_system) zwischen schneller Berechnung in Festkommaarithmetik ('int_zooming'"int_zooming""int_zooming""int_zooming""int_zooming""int_zooming" = 'true'"true""true""true""true""true") und hochgenauer Berechnung in Fließkommaarithmetik ('int_zooming'"int_zooming""int_zooming""int_zooming""int_zooming""int_zooming" = 'false'"false""false""false""false""false") gewählt werden. Bei der Festkommaberechnung kann es allerdings zu leichten Grauwertabweichungen und Pixeln mit undefinierten Grauwerten kommen.

Weitere Informationen

Ein Überblick zu den verschiedenen in HALCON verwendeten 2D Koordinatensystemen ist in der Einleitung zum Kapitel Transformationen / 2D-Transformationen gegeben.

Achtung

Aus Geschwindigkeitsgründen wird die Region des Eingabebildes nicht beachtet. Das Ausgabebild hat immer ein komplettes Rechteck als Region.

Ausführungsinformationen

• Unterstützt OpenCL Compute Devices.
• Multithreading-Typ: reentrant (läuft parallel zu nicht-exklusiven Operatoren).
• Multithreading-Bereich: global (kann von jedem Thread aufgerufen werden).
• Automatisch parallelisiert auf Tupelebene.
• Automatisch parallelisiert auf Kanalebene.
• Automatisch parallelisiert auf interner Datenebene.

Parameter

Siehe auch

polar_trans_image_invpolar_trans_image_invPolarTransImageInvPolarTransImageInvPolarTransImageInvpolar_trans_image_inv, polar_trans_regionpolar_trans_regionPolarTransRegionPolarTransRegionPolarTransRegionpolar_trans_region, polar_trans_region_invpolar_trans_region_invPolarTransRegionInvPolarTransRegionInvPolarTransRegionInvpolar_trans_region_inv, polar_trans_contour_xldpolar_trans_contour_xldPolarTransContourXldPolarTransContourXldPolarTransContourXldpolar_trans_contour_xld, polar_trans_contour_xld_invpolar_trans_contour_xld_invPolarTransContourXldInvPolarTransContourXldInvPolarTransContourXldInvpolar_trans_contour_xld_inv

Modul

Foundation