polar_trans_region_invpolar_trans_region_invPolarTransRegionInvPolarTransRegionInvpolar_trans_region_inv (Operator)
Name
polar_trans_region_invpolar_trans_region_invPolarTransRegionInvPolarTransRegionInvpolar_trans_region_inv — Rücktransformieren einer Region in Polarkoordinaten.
Signatur
polar_trans_region_inv(PolarRegion : XYTransRegion : Row, Column, AngleStart, AngleEnd, RadiusStart, RadiusEnd, WidthIn, HeightIn, Width, Height, Interpolation : )
Herror polar_trans_region_inv(const Hobject PolarRegion, Hobject* XYTransRegion, double Row, double Column, double AngleStart, double AngleEnd, double RadiusStart, double RadiusEnd, const Hlong WidthIn, const Hlong HeightIn, const Hlong Width, const Hlong Height, const char* Interpolation)
Herror T_polar_trans_region_inv(const Hobject PolarRegion, Hobject* XYTransRegion, const Htuple Row, const Htuple Column, const Htuple AngleStart, const Htuple AngleEnd, const Htuple RadiusStart, const Htuple RadiusEnd, const Htuple WidthIn, const Htuple HeightIn, const Htuple Width, const Htuple Height, const Htuple Interpolation)
void PolarTransRegionInv(const HObject& PolarRegion, HObject* XYTransRegion, const HTuple& Row, const HTuple& Column, const HTuple& AngleStart, const HTuple& AngleEnd, const HTuple& RadiusStart, const HTuple& RadiusEnd, const HTuple& WidthIn, const HTuple& HeightIn, const HTuple& Width, const HTuple& Height, const HTuple& Interpolation)
HRegion HRegion::PolarTransRegionInv(const HTuple& Row, const HTuple& Column, double AngleStart, double AngleEnd, const HTuple& RadiusStart, const HTuple& RadiusEnd, Hlong WidthIn, Hlong HeightIn, Hlong Width, Hlong Height, const HString& Interpolation) const
HRegion HRegion::PolarTransRegionInv(double Row, double Column, double AngleStart, double AngleEnd, double RadiusStart, double RadiusEnd, Hlong WidthIn, Hlong HeightIn, Hlong Width, Hlong Height, const HString& Interpolation) const
HRegion HRegion::PolarTransRegionInv(double Row, double Column, double AngleStart, double AngleEnd, double RadiusStart, double RadiusEnd, Hlong WidthIn, Hlong HeightIn, Hlong Width, Hlong Height, const char* Interpolation) const
HRegion HRegion::PolarTransRegionInv(double Row, double Column, double AngleStart, double AngleEnd, double RadiusStart, double RadiusEnd, Hlong WidthIn, Hlong HeightIn, Hlong Width, Hlong Height, const wchar_t* Interpolation) const
(Nur Windows)
static void HOperatorSet.PolarTransRegionInv(HObject polarRegion, out HObject XYTransRegion, HTuple row, HTuple column, HTuple angleStart, HTuple angleEnd, HTuple radiusStart, HTuple radiusEnd, HTuple widthIn, HTuple heightIn, HTuple width, HTuple height, HTuple interpolation)
HRegion HRegion.PolarTransRegionInv(HTuple row, HTuple column, double angleStart, double angleEnd, HTuple radiusStart, HTuple radiusEnd, int widthIn, int heightIn, int width, int height, string interpolation)
HRegion HRegion.PolarTransRegionInv(double row, double column, double angleStart, double angleEnd, double radiusStart, double radiusEnd, int widthIn, int heightIn, int width, int height, string interpolation)
def polar_trans_region_inv(polar_region: HObject, row: Union[int, float], column: Union[int, float], angle_start: float, angle_end: float, radius_start: Union[int, float], radius_end: Union[int, float], width_in: int, height_in: int, width: int, height: int, interpolation: str) -> HObject
Beschreibung
polar_trans_region_invpolar_trans_region_invPolarTransRegionInvPolarTransRegionInvPolarTransRegionInvpolar_trans_region_inv transformiert die
Polarkoordinatendarstellung einer Region, gespeichert in
PolarRegionPolarRegionPolarRegionPolarRegionpolarRegionpolar_region, zurück auf einen Kreisring in kartesischen
Koordinaten, der durch die Radien RadiusStartRadiusStartRadiusStartRadiusStartradiusStartradius_start und
RadiusEndRadiusEndRadiusEndRadiusEndradiusEndradius_end sowie durch die Winkel AngleStartAngleStartAngleStartAngleStartangleStartangle_start und
AngleEndAngleEndAngleEndAngleEndangleEndangle_end beschrieben ist und dessen Mittelpunkt in
(RowRowRowRowrowrow, ColumnColumnColumnColumncolumncolumn) 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
PolarRegionPolarRegionPolarRegionPolarRegionpolarRegionpolar_region enthält, in WidthInWidthInWidthInWidthInwidthInwidth_in und
HeightInHeightInHeightInHeightInheightInheight_in übergeben werden. WidthInWidthInWidthInWidthInwidthInwidth_in-1 ist die
Spaltenkoordinate, die AngleEndAngleEndAngleEndAngleEndangleEndangle_end entspricht, und
HeightInHeightInHeightInHeightInheightInheight_in-1 ist die Zeilenkoordinate, die
RadiusEndRadiusEndRadiusEndRadiusEndradiusEndradius_end entspricht. AngleStartAngleStartAngleStartAngleStartangleStartangle_start
bzw. RadiusStartRadiusStartRadiusStartRadiusStartradiusStartradius_start entspricht der Spalten-
bzw. Zeilenkoordinate 0. Außerdem müssen die Dimensionen
des virtuellen Ausgabebildes, welches die Region
XYTransRegionXYTransRegionXYTransRegionXYTransRegionXYTransRegionxytrans_region enthält, in WidthWidthWidthWidthwidthwidth und
HeightHeightHeightHeightheightheight übergeben werden.
Die Winkel und Radien sind inklusive, die Zeile mit der Koordinate
0 der Eingaberegion wird also auf einen Kreis im Abstand
RadiusStartRadiusStartRadiusStartRadiusStartradiusStartradius_start vom angegebenen Mittelpunkt abgebildet, die
Zeile mit der Koordinate HeightInHeightInHeightInHeightInheightInheight_in-1 auf einen Kreis im
Abstand RadiusEndRadiusEndRadiusEndRadiusEndradiusEndradius_end. Das Gleiche gilt für
AngleStartAngleStartAngleStartAngleStartangleStartangle_start, AngleEndAngleEndAngleEndAngleEndangleEndangle_end und
WidthInWidthInWidthInWidthInwidthInwidth_in.
Ü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.
polar_trans_region_invpolar_trans_region_invPolarTransRegionInvPolarTransRegionInvPolarTransRegionInvpolar_trans_region_inv ist die exakte Umkehrfunktion zu
polar_trans_regionpolar_trans_regionPolarTransRegionPolarTransRegionPolarTransRegionpolar_trans_region.
Die Aufrufsequenz:
polar_trans_region(Region, PolarRegion, Row, Column, rad(360), 0, 0, Radius, Width, Height, 'nearest_neighbor')polar_trans_region(Region, PolarRegion, Row, Column, rad(360), 0, 0, Radius, Width, Height, "nearest_neighbor")PolarTransRegion(Region, PolarRegion, Row, Column, rad(360), 0, 0, Radius, Width, Height, "nearest_neighbor")PolarTransRegion(Region, PolarRegion, Row, Column, rad(360), 0, 0, Radius, Width, Height, "nearest_neighbor")PolarTransRegion(Region, PolarRegion, Row, Column, rad(360), 0, 0, Radius, Width, Height, "nearest_neighbor")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')polar_trans_region_inv(PolarRegion, XYTransRegion, Row, Column, rad(360), 0, 0, Radius, Width, Height, Width, Height, "nearest_neighbor")PolarTransRegionInv(PolarRegion, XYTransRegion, Row, Column, rad(360), 0, 0, Radius, Width, Height, Width, Height, "nearest_neighbor")PolarTransRegionInv(PolarRegion, XYTransRegion, Row, Column, rad(360), 0, 0, Radius, Width, Height, Width, Height, "nearest_neighbor")PolarTransRegionInv(PolarRegion, XYTransRegion, Row, Column, rad(360), 0, 0, Radius, Width, Height, Width, Height, "nearest_neighbor")polar_trans_region_inv(PolarRegion, XYTransRegion, Row, Column, rad(360), 0, 0, Radius, Width, Height, Width, Height, "nearest_neighbor")
|
XYTransRegionXYTransRegionXYTransRegionXYTransRegionXYTransRegionxytrans_region die Region
RegionRegionRegionRegionregionregion eingeschränkt auf den Kreis um
(RowRowRowRowrowrow,ColumnColumnColumnColumncolumncolumn) mit Radius RadiusRadiusRadiusRadiusradiusradius zurück.
Werden mehrere Regionen in PolarRegionPolarRegionPolarRegionPolarRegionpolarRegionpolar_region übergeben, werden
deren Transformationen individuell berechnet und als Tupel in
XYTransRegionXYTransRegionXYTransRegionXYTransRegionXYTransRegionxytrans_region 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_systemset_systemSetSystemSetSystemSetSystemset_system). Sonst werden leere
Regionen nicht zurückgegeben und deshalb entspricht die Länge des
Ausgabetupels XYTransRegionXYTransRegionXYTransRegionXYTransRegionXYTransRegionxytrans_region im Allgemeinen nicht der Länge
des Eingabetupels PolarRegionPolarRegionPolarRegionPolarRegionpolarRegionpolar_region.
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 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_systemSetSystemSetSystemSetSystemset_system). 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
PolarRegionPolarRegionPolarRegionPolarRegionpolarRegionpolar_region (input_object) region(-array) → objectHRegionHObjectHRegionHobject
Eingaberegion.
XYTransRegionXYTransRegionXYTransRegionXYTransRegionXYTransRegionxytrans_region (output_object) region(-array) → objectHRegionHObjectHRegionHobject *
Ergebnisregion.
RowRowRowRowrowrow (input_control) number → HTupleUnion[int, float]HTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)
Zeilenkoordinate des Kreismittelpunktes.
Defaultwert: 256
Wertevorschläge: 0, 16, 32, 64, 128, 240, 256, 480, 512
Typischer Wertebereich: -131068
≤
Row
Row
Row
Row
row
row
≤
131068
ColumnColumnColumnColumncolumncolumn (input_control) number → HTupleUnion[int, float]HTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)
Spaltenkoordinate des Kreismittelpunktes.
Defaultwert: 256
Wertevorschläge: 0, 16, 32, 64, 128, 256, 320, 512, 640
Typischer Wertebereich: -131068
≤
Column
Column
Column
Column
column
column
≤
131068
AngleStartAngleStartAngleStartAngleStartangleStartangle_start (input_control) angle.rad → HTuplefloatHTupleHtuple (real) (double) (double) (double)
Winkel, auf den die Spaltenkoordinate 0 von
PolarRegionPolarRegionPolarRegionPolarRegionpolarRegionpolar_region abgebildet wird.
Defaultwert: 0.0
Wertevorschläge: 0.0, 0.78539816, 1.57079632, 3.141592654, 6.2831853
Typischer Wertebereich: -6.2831853
≤
AngleStart
AngleStart
AngleStart
AngleStart
angleStart
angle_start
≤
6.2831853
RadiusStartRadiusStartRadiusStartRadiusStartradiusStartradius_start (input_control) number → HTupleUnion[int, float]HTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)
Kreisradius, auf den die Zeilenkoordinate 0 in
PolarRegionPolarRegionPolarRegionPolarRegionpolarRegionpolar_region abgebildet wird.
Defaultwert: 0
Wertevorschläge: 0, 16, 32, 64, 100, 128, 256, 512
Typischer Wertebereich: 0
≤
RadiusStart
RadiusStart
RadiusStart
RadiusStart
radiusStart
radius_start
≤
32767
WidthInWidthInWidthInWidthInwidthInwidth_in (input_control) extent.x → HTupleintHTupleHtuple (integer) (int / long) (Hlong) (Hlong)
Breite des virtuellen Eingabebildes.
Defaultwert: 512
Wertevorschläge: 256, 320, 512, 640, 800, 1024
Typischer Wertebereich: 2
≤
WidthIn
WidthIn
WidthIn
WidthIn
widthIn
width_in
≤
32767
HeightInHeightInHeightInHeightInheightInheight_in (input_control) extent.y → HTupleintHTupleHtuple (integer) (int / long) (Hlong) (Hlong)
Höhe des virtuellen Eingabebildes.
Defaultwert: 512
Wertevorschläge: 240, 256, 480, 512, 600, 1024
Typischer Wertebereich: 2
≤
HeightIn
HeightIn
HeightIn
HeightIn
heightIn
height_in
≤
32767
WidthWidthWidthWidthwidthwidth (input_control) extent.x → HTupleintHTupleHtuple (integer) (int / long) (Hlong) (Hlong)
Breite des virtuellen Zielbildes.
Defaultwert: 512
Wertevorschläge: 256, 320, 512, 640, 800, 1024
Typischer Wertebereich: 1
≤
Width
Width
Width
Width
width
width
≤
32767
HeightHeightHeightHeightheightheight (input_control) extent.y → HTupleintHTupleHtuple (integer) (int / long) (Hlong) (Hlong)
Höhe des virtuellen Zielbildes.
Defaultwert: 512
Wertevorschläge: 240, 256, 480, 512, 600, 1024
Typischer Wertebereich: 1
≤
Height
Height
Height
Height
height
height
≤
32767
InterpolationInterpolationInterpolationInterpolationinterpolationinterpolation (input_control) string → HTuplestrHTupleHtuple (string) (string) (HString) (char*)
Interpolationsverfahren für die Transformation.
Defaultwert:
'nearest_neighbor'
"nearest_neighbor"
"nearest_neighbor"
"nearest_neighbor"
"nearest_neighbor"
"nearest_neighbor"
Werteliste: 'bilinear'"bilinear""bilinear""bilinear""bilinear""bilinear", 'nearest_neighbor'"nearest_neighbor""nearest_neighbor""nearest_neighbor""nearest_neighbor""nearest_neighbor"
Siehe auch
polar_trans_image_extpolar_trans_image_extPolarTransImageExtPolarTransImageExtPolarTransImageExtpolar_trans_image_ext,
polar_trans_image_invpolar_trans_image_invPolarTransImageInvPolarTransImageInvPolarTransImageInvpolar_trans_image_inv,
polar_trans_regionpolar_trans_regionPolarTransRegionPolarTransRegionPolarTransRegionpolar_trans_region,
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