polar_trans_region_invpolar_trans_region_invPolarTransRegionInvPolarTransRegionInv (Operator)

Name

polar_trans_region_invpolar_trans_region_invPolarTransRegionInvPolarTransRegionInv — Rücktransformieren einer Region in Polarkoordinaten.

Signatur

Beschreibung

polar_trans_region_invpolar_trans_region_invPolarTransRegionInvPolarTransRegionInvPolarTransRegionInv transformiert die Polarkoordinatendarstellung einer Region, gespeichert in PolarRegionPolarRegionPolarRegionPolarRegionpolarRegion, zurück auf einen Kreisring in kartesischen Koordinaten, der durch die Radien RadiusStartRadiusStartRadiusStartRadiusStartradiusStart und RadiusEndRadiusEndRadiusEndRadiusEndradiusEnd sowie durch die Winkel AngleStartAngleStartAngleStartAngleStartangleStart und AngleEndAngleEndAngleEndAngleEndangleEnd beschrieben ist und dessen Mittelpunkt in (RowRowRowRowrow, ColumnColumnColumnColumncolumn) liegt. Alle diese Werte können frei aus den reellen Zahlen gewählt werden. Zusätzlich müssen die Dimensionen des virtuellen Eingabebildes, welches die Region PolarRegionPolarRegionPolarRegionPolarRegionpolarRegion enthält, in WidthInWidthInWidthInWidthInwidthIn und HeightInHeightInHeightInHeightInheightIn übergeben werden. WidthInWidthInWidthInWidthInwidthIn-1 ist die Spaltenkoordinate, die AngleEndAngleEndAngleEndAngleEndangleEnd entspricht, und HeightInHeightInHeightInHeightInheightIn-1 ist die Zeilenkoordinate, die RadiusEndRadiusEndRadiusEndRadiusEndradiusEnd entspricht. AngleStartAngleStartAngleStartAngleStartangleStart bzw. RadiusStartRadiusStartRadiusStartRadiusStartradiusStart entspricht der Spalten- bzw. Zeilenkoordinate 0. Außerdem müssen die Dimensionen des virtuellen Ausgabebildes, welches die Region XYTransRegionXYTransRegionXYTransRegionXYTransRegionXYTransRegion enthält, in WidthWidthWidthWidthwidth und HeightHeightHeightHeightheight übergeben werden.

Die Winkel und Radien sind inklusive, die Zeile mit der Koordinate 0 der Eingaberegion wird also auf einen Kreis im Abstand RadiusStartRadiusStartRadiusStartRadiusStartradiusStart vom angegebenen Mittelpunkt abgebildet, die Zeile mit der Koordinate HeightInHeightInHeightInHeightInheightIn-1 auf einen Kreis im Abstand RadiusEndRadiusEndRadiusEndRadiusEndradiusEnd. Das Gleiche gilt für AngleStartAngleStartAngleStartAngleStartangleStart, AngleEndAngleEndAngleEndAngleEndangleEnd und WidthInWidthInWidthInWidthInwidthIn. Entspricht die Breite der Eingaberegion einem Winkelintervall, dessen Länge größer als 2pi ist, wird die Eingaberegion so beschnitten, dass die Länge dieses Intervalls 2pi ist.

Über den Parameter InterpolationInterpolationInterpolationInterpolationinterpolation kann dabei zwischen den Interpolationsverfahren 'bilinear'"bilinear""bilinear""bilinear""bilinear" und 'nearest_neighbor'"nearest_neighbor""nearest_neighbor""nearest_neighbor""nearest_neighbor" gewählt werden. Die Wahl InterpolationInterpolationInterpolationInterpolationinterpolation = 'bilinear'"bilinear""bilinear""bilinear""bilinear" kann insbesondere bei Vergrößerungen zu glatteren Regionenrändern führen. Allerdings steigt dadurch die Laufzeit signifikant an.

polar_trans_region_invpolar_trans_region_invPolarTransRegionInvPolarTransRegionInvPolarTransRegionInv ist die exakte Umkehrfunktion zu polar_trans_regionpolar_trans_regionPolarTransRegionPolarTransRegionPolarTransRegion.

Die Aufrufsequenz: polar_trans_region(Region, PolarRegion, Row, Column, rad(360), 0, 0, Radius, Width, Height, 'nearest_neighbor') polar_trans_region_inv(PolarRegion, XYTransRegion, Row, Column, rad(360), 0, 0, Radius, Width, Height, Width, Height, 'nearest_neighbor') liefert in der Ausgaberegion XYTransRegion die Region Region eingeschränkt auf den Kreis um (Row,Column) mit Radius Radius zurück.

Werden mehrere Regionen in PolarRegionPolarRegionPolarRegionPolarRegionpolarRegion übergeben, werden deren Transformationen individuell berechnet und als Tupel in XYTransRegionXYTransRegionXYTransRegionXYTransRegionXYTransRegion abgespeichert. Dabei entsprechen die Indizes von Ein- und Ausgaberegionen nur dann einander, wenn die Systemvariable 'store_empty_regions'"store_empty_regions""store_empty_regions""store_empty_regions""store_empty_regions" auf 'true'"true""true""true""true" gesetzt wird (siehe auch set_systemset_systemSetSystemSetSystemSetSystem). Sonst werden leere Regionen nicht zurückgegeben und deshalb entspricht die Länge des Ausgabetupels XYTransRegionXYTransRegionXYTransRegionXYTransRegionXYTransRegion im Allgemeinen nicht der Länge des Eingabetupels PolarRegionPolarRegionPolarRegionPolarRegionpolarRegion.

Weitere Informationen

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

Achtung

Werden die Dimensionen des virtuellen Ausgabebildes WidthWidthWidthWidthwidth und HeightHeightHeightHeightheight größer als die Dimensionen des aktuellen Bildes gewählt, sollte die Systemvariable 'clip_region'"clip_region""clip_region""clip_region""clip_region" auf 'false'"false""false""false""false" gesetzt werden (siehe auch set_systemset_systemSetSystemSetSystemSetSystem). Andernfalls kann eine Ausgaberegion, die nicht innerhalb der Dimensionen des aktuellen Bildes liegt, zu einer Fehlermeldung führen.

Ausführungsinformationen

• 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 interner Datenebene.

Parameter

Siehe auch

polar_trans_image_extpolar_trans_image_extPolarTransImageExtPolarTransImageExtPolarTransImageExt, polar_trans_image_invpolar_trans_image_invPolarTransImageInvPolarTransImageInvPolarTransImageInv, polar_trans_regionpolar_trans_regionPolarTransRegionPolarTransRegionPolarTransRegion, polar_trans_contour_xldpolar_trans_contour_xldPolarTransContourXldPolarTransContourXldPolarTransContourXld, polar_trans_contour_xld_invpolar_trans_contour_xld_invPolarTransContourXldInvPolarTransContourXldInvPolarTransContourXldInv

Modul

Foundation