projective_trans_regionT_projective_trans_regionProjectiveTransRegionProjectiveTransRegionprojective_trans_region (Operator)

Name

projective_trans_regionT_projective_trans_regionProjectiveTransRegionProjectiveTransRegionprojective_trans_region — Anwenden einer projektiven Transformation auf eine Region.

Signatur

projective_trans_region(Regions : TransRegions : HomMat2D, Interpolation : )

Beschreibung

projective_trans_regionprojective_trans_regionProjectiveTransRegionProjectiveTransRegionProjectiveTransRegionprojective_trans_region wendet die durch die homogene Matrix HomMat2DHomMat2DHomMat2DHomMat2DhomMat2Dhom_mat_2d beschriebene projektive Transformation auf die Regionen in RegionsRegionsRegionsRegionsregionsregions an und liefert die Ergebnisregionen in TransRegionsTransRegionsTransRegionsTransRegionstransRegionstrans_regions zurück.

Zur Berechnung und Interpretation der Matrix siehe projective_trans_imageprojective_trans_imageProjectiveTransImageProjectiveTransImageProjectiveTransImageprojective_trans_image.

Wird 'clip_region'"clip_region""clip_region""clip_region""clip_region""clip_region" durch set_system('clip_region', 'true')set_system("clip_region", "true")SetSystem("clip_region", "true")SetSystem("clip_region", "true")SetSystem("clip_region", "true")set_system("clip_region", "true") auf seinen Grundzustand 'true'"true""true""true""true""true" gesetzt, oder ist die Transformation entartet, erzeugt also unendlich große Regionen, so wird die Ausgaberegion durch das Rechteck mit linker oberer Ecke (0, 0) und rechter unterer Ecke ('width'"width""width""width""width""width", 'height'"height""height""height""height""height") beschnitten, wobei 'width'"width""width""width""width""width" und 'height'"height""height""height""height""height" Systemvariablen sind (siehe get_systemget_systemGetSystemGetSystemGetSystemget_system). Falls 'clip_region'"clip_region""clip_region""clip_region""clip_region""clip_region" auf 'false'"false""false""false""false""false" gesetzt wird, so wird die Ausgaberegion nur durch die maximale unterstützte Koordinatengröße beschränkt. Für weitere Informationen zu Beschränkungen der maximalen Koordinatengröße wird auf den „Installation Guide“ verwiesen. Dies kann zu sehr speicher- und zeitintensiven Berechnungen führen, ist also mit Vorsicht zu benutzen.

Achtung

Der Transformation liegt das gleiche Koordinatensystem zugrunde, das auch bei dem Operator affine_trans_pixelaffine_trans_pixelAffineTransPixelAffineTransPixelAffineTransPixelaffine_trans_pixel verwendet wird. Das bedeutet, dass die Transformation nicht mit der Transformationsmatrix HomMat2DHomMat2DHomMat2DHomMat2DhomMat2Dhom_mat_2d, sondern mit einer modifizierte Version davon durchgeführt wird. Eine Transformation mit projective_trans_regionprojective_trans_regionProjectiveTransRegionProjectiveTransRegionProjectiveTransRegionprojective_trans_region entspricht für jeden Punkt der Region der folgenden Kette von Transformationen (Ein- und Ausgabekoordinaten als homogene Vektoren dargestellt):

Dies kann zu unerwarteten Ergebnissen führen, wenn die Transformationsmatrix unter Verwendung von Koordinaten erstellt wurde, die von der Region mit Operatoren wie z.B. area_centerarea_centerAreaCenterAreaCenterAreaCenterarea_center abgeleitet wurden. Wenn z.B. eine rotationssymmetrische Region unter Verwendung von hom_mat2d_rotatehom_mat2d_rotateHomMat2dRotateHomMat2dRotateHomMat2dRotatehom_mat2d_rotate um ihren mit area_centerarea_centerAreaCenterAreaCenterAreaCenterarea_center bestimmten Schwerpunkt rotiert wird, so liegt die transformierte Region nicht auf der Originalregion. Dieser Effekt kann dadurch kompensiert werden, dass vor dem Aufruf von

projective_trans_regionprojective_trans_regionProjectiveTransRegionProjectiveTransRegionProjectiveTransRegionprojective_trans_region

die Transformationsmatrix HomMat2DHomMat2DHomMat2DHomMat2DhomMat2Dhom_mat_2d durch die beiden folgenden Translationen modifiziert wird:

hom_mat2d_translate(HomMat2D, 0.5, 0.5, HomMat2DTmp)hom_mat2d_translate(HomMat2D, 0.5, 0.5, HomMat2DTmp)HomMat2dTranslate(HomMat2D, 0.5, 0.5, HomMat2DTmp)HomMat2dTranslate(HomMat2D, 0.5, 0.5, HomMat2DTmp)HomMat2dTranslate(HomMat2D, 0.5, 0.5, HomMat2DTmp)hom_mat2d_translate(HomMat2D, 0.5, 0.5, HomMat2DTmp)

hom_mat2d_translate_local(HomMat2DTmp, -0.5, -0.5, HomMat2DAdapted)hom_mat2d_translate_local(HomMat2DTmp, -0.5, -0.5, HomMat2DAdapted)HomMat2dTranslateLocal(HomMat2DTmp, -0.5, -0.5, HomMat2DAdapted)HomMat2dTranslateLocal(HomMat2DTmp, -0.5, -0.5, HomMat2DAdapted)HomMat2dTranslateLocal(HomMat2DTmp, -0.5, -0.5, HomMat2DAdapted)hom_mat2d_translate_local(HomMat2DTmp, -0.5, -0.5, HomMat2DAdapted)

projective_trans_region(Region, TransRegion, HomMat2DAdapted, 'bilinear')projective_trans_region(Region, TransRegion, HomMat2DAdapted, "bilinear")ProjectiveTransRegion(Region, TransRegion, HomMat2DAdapted, "bilinear")ProjectiveTransRegion(Region, TransRegion, HomMat2DAdapted, "bilinear")ProjectiveTransRegion(Region, TransRegion, HomMat2DAdapted, "bilinear")projective_trans_region(Region, TransRegion, HomMat2DAdapted, "bilinear")

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

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.

Parameter

RegionsRegionsRegionsRegionsregionsregions (input_object) region(-array) → object

Eingaberegionen.

TransRegionsTransRegionsTransRegionsTransRegionstransRegionstrans_regions (output_object) region(-array) → object

Ergebnisregionen.

HomMat2DHomMat2DHomMat2DHomMat2DhomMat2Dhom_mat_2d (input_control) hom_mat2d → (real)

Homogene projektive Transformationsmatrix.

InterpolationInterpolationInterpolationInterpolationinterpolationinterpolation (input_control) string → (string)

Interpolationsmethode für die Transformation.

Defaultwert: 'bilinear' "bilinear" "bilinear" "bilinear" "bilinear" "bilinear"

Werteliste: 'bilinear'"bilinear""bilinear""bilinear""bilinear""bilinear", 'nearest_neighbor'"nearest_neighbor""nearest_neighbor""nearest_neighbor""nearest_neighbor""nearest_neighbor"

Vorgänger

vector_to_proj_hom_mat2dvector_to_proj_hom_mat2dVectorToProjHomMat2dVectorToProjHomMat2dVectorToProjHomMat2dvector_to_proj_hom_mat2d, hom_vector_to_proj_hom_mat2dhom_vector_to_proj_hom_mat2dHomVectorToProjHomMat2dHomVectorToProjHomMat2dHomVectorToProjHomMat2dhom_vector_to_proj_hom_mat2d, proj_match_points_ransacproj_match_points_ransacProjMatchPointsRansacProjMatchPointsRansacProjMatchPointsRansacproj_match_points_ransac, proj_match_points_ransac_guidedproj_match_points_ransac_guidedProjMatchPointsRansacGuidedProjMatchPointsRansacGuidedProjMatchPointsRansacGuidedproj_match_points_ransac_guided, hom_mat3d_projecthom_mat3d_projectHomMat3dProjectHomMat3dProjectHomMat3dProjecthom_mat3d_project

Siehe auch

projective_trans_imageprojective_trans_imageProjectiveTransImageProjectiveTransImageProjectiveTransImageprojective_trans_image, projective_trans_image_sizeprojective_trans_image_sizeProjectiveTransImageSizeProjectiveTransImageSizeProjectiveTransImageSizeprojective_trans_image_size, projective_trans_contour_xldprojective_trans_contour_xldProjectiveTransContourXldProjectiveTransContourXldProjectiveTransContourXldprojective_trans_contour_xld, projective_trans_point_2dprojective_trans_point_2dProjectiveTransPoint2dProjectiveTransPoint2dProjectiveTransPoint2dprojective_trans_point_2d, projective_trans_pixelprojective_trans_pixelProjectiveTransPixelProjectiveTransPixelProjectiveTransPixelprojective_trans_pixel

Modul

Foundation

Operatoren