polar_trans_regionpolar_trans_regionPolarTransRegionpolar_trans_regionPolarTransRegionPolarTransRegion (Operator)

Name

polar_trans_regionpolar_trans_regionPolarTransRegionpolar_trans_regionPolarTransRegionPolarTransRegion — Anwenden einer Polarkoordinatentransformation auf eine Region innerhalb eines Kreisrings.

Signatur

Beschreibung

polar_trans_regionpolar_trans_regionPolarTransRegionpolar_trans_regionPolarTransRegionPolarTransRegion transformiert eine RegionRegionRegionRegionRegionregion, die innerhalb des durch den Mittelpunkt (RowRowRowRowRowrow, ColumnColumnColumnColumnColumncolumn), die Radien RadiusStartRadiusStartRadiusStartRadiusStartRadiusStartradiusStart und RadiusEndRadiusEndRadiusEndRadiusEndRadiusEndradiusEnd und die Winkel AngleStartAngleStartAngleStartAngleStartAngleStartangleStart und AngleEndAngleEndAngleEndAngleEndAngleEndangleEnd definierten Kreisrings liegt, auf dessen Polarkoordinatendarstellung in der Region PolarTransRegionPolarTransRegionPolarTransRegionPolarTransRegionPolarTransRegionpolarTransRegion in einem virtuellen Bild mit den Dimensionen WidthWidthWidthWidthWidthwidth x HeightHeightHeightHeightHeightheight.

Die Polartransformation entspricht einem Wechsel des Koordinatensystems. Anstatt durch Zeilen- und Spaltenkoordinate wird die Position eines Punktes durch dessen Radius (Abstand zum Mittelpunkt RowRowRowRowRowrow,ColumnColumnColumnColumnColumncolumn) und den Winkel zwischen der Spaltenachse (durch den Mittelpunkt) und der Strecke vom Mittelpunkt zum Punkt beschrieben. Diese Transformation ist nicht affin.

Die Koordinate (0,0) in der Ausgabregion entspricht immer dem Punkt in der Eingaberegion, der durch RadiusStartRadiusStartRadiusStartRadiusStartRadiusStartradiusStart und AngleStartAngleStartAngleStartAngleStartAngleStartangleStart spezifiziert wird. Analog entspricht die Koordinate (HeightHeightHeightHeightHeightheight-1, WidthWidthWidthWidthWidthwidth-1) immer dem Punkt in der Eingaberegion, der durch RadiusEndRadiusEndRadiusEndRadiusEndRadiusEndradiusEnd und AngleEndAngleEndAngleEndAngleEndAngleEndangleEnd spezifiziert wird. Im Normalfall (AngleStartAngleStartAngleStartAngleStartAngleStartangleStart < AngleEndAngleEndAngleEndAngleEndAngleEndangleEnd und RadiusStartRadiusStartRadiusStartRadiusStartRadiusStartradiusStart < RadiusEndRadiusEndRadiusEndRadiusEndRadiusEndradiusEnd) wird die Polarkoordinatentransformation also in mathematisch positiver Durchlaufrichtung (entgegen dem Uhrzeigersinn) durchgeführt. Dabei liegen die Punkte mit kleineren Radien in der Ausgaberegion weiter oben. Durch geeignetes Vertauschen der Werte der Parameter (z.B. AngleStartAngleStartAngleStartAngleStartAngleStartangleStart > AngleEndAngleEndAngleEndAngleEndAngleEndangleEnd oder RadiusStartRadiusStartRadiusStartRadiusStartRadiusStartradiusStart > RadiusEndRadiusEndRadiusEndRadiusEndRadiusEndradiusEnd) kann jede beliebige Orientierung der Ausgaberegion erreicht werden.

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 RadiusEndRadiusEndRadiusEndRadiusEndRadiusEndradiusEnd und RadiusStartRadiusStartRadiusStartRadiusStartRadiusStartradiusStart dem Wert HeightHeightHeightHeightHeightheight-1, so wird die Berechnung durch eine optimierte Routine erheblich schneller durchgeführt.

Die Radien und Winkel sind inklusive, d.h. die erste Zeile des virtuellen Zielbildes entspricht dem Kreis mit dem Radius RadiusStartRadiusStartRadiusStartRadiusStartRadiusStartradiusStart, die letzte Zeile dem mit dem Radius RadiusEndRadiusEndRadiusEndRadiusEndRadiusEndradiusEnd. Für Vollkreise, bei denen die Differenz AngleStartAngleStartAngleStartAngleStartAngleStartangleStart - AngleEndAngleEndAngleEndAngleEndAngleEndangleEnd 2 * pi (360 Grad) beträgt, bedeutet dies insbesondere, dass die erste Spalte des virtuellen Zielbildes gleich der letzten ist.

Um diesem Verhalten vorzubeugen, sollte diese Differenz 2 * pi * (1 - 1/WidthWidthWidthWidthWidthwidth) statt 2 * pi betragen.

Ü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. Die Wahl InterpolationInterpolationInterpolationInterpolationInterpolationinterpolation = 'bilinear'"bilinear""bilinear""bilinear""bilinear""bilinear" kann insbesondere bei Vergrößerungen zu glatteren Regionenrändern führen. Allerdings steigt dadurch die Laufzeit signifikant an.

Werden mehrere Regionen in RegionRegionRegionRegionRegionregion übergeben, werden deren Polartransformationen individuell berechnet und als Tupel in PolarTransRegionPolarTransRegionPolarTransRegionPolarTransRegionPolarTransRegionpolarTransRegion 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""store_empty_regions" auf 'true'"true""true""true""true""true" gesetzt wird (siehe auch 'set_system'"set_system""set_system""set_system""set_system""set_system"). Sonst werden leere Regionen nicht zurückgegeben und deshalb entspricht die Länge des Ausgabetupels PolarTransRegionPolarTransRegionPolarTransRegionPolarTransRegionPolarTransRegionpolarTransRegion im Allgemeinen nicht der Länge des Eingabetupels RegionRegionRegionRegionRegionregion.

Achtung

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

Parallelisierung

• 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_extPolarTransImageExtpolar_trans_image_extPolarTransImageExtPolarTransImageExt, polar_trans_image_invpolar_trans_image_invPolarTransImageInvpolar_trans_image_invPolarTransImageInvPolarTransImageInv, polar_trans_region_invpolar_trans_region_invPolarTransRegionInvpolar_trans_region_invPolarTransRegionInvPolarTransRegionInv, polar_trans_contour_xldpolar_trans_contour_xldPolarTransContourXldpolar_trans_contour_xldPolarTransContourXldPolarTransContourXld, polar_trans_contour_xld_invpolar_trans_contour_xld_invPolarTransContourXldInvpolar_trans_contour_xld_invPolarTransContourXldInvPolarTransContourXldInv

Modul

Foundation