select_contours_xldselect_contours_xldSelectContoursXldSelectContoursXld (Operator)
Name
select_contours_xldselect_contours_xldSelectContoursXldSelectContoursXld — Filtern von XLD-Konturen.
Signatur
Herror select_contours_xld(const Hobject Contours, Hobject* SelectedContours, const char* Feature, double Min1, double Max1, double Min2, double Max2)
Herror T_select_contours_xld(const Hobject Contours, Hobject* SelectedContours, const Htuple Feature, const Htuple Min1, const Htuple Max1, const Htuple Min2, const Htuple Max2)
void SelectContoursXld(const HObject& Contours, HObject* SelectedContours, const HTuple& Feature, const HTuple& Min1, const HTuple& Max1, const HTuple& Min2, const HTuple& Max2)
HXLDCont HXLDCont::SelectContoursXld(const HString& Feature, double Min1, double Max1, double Min2, double Max2) const
HXLDCont HXLDCont::SelectContoursXld(const char* Feature, double Min1, double Max1, double Min2, double Max2) const
HXLDCont HXLDCont::SelectContoursXld(const wchar_t* Feature, double Min1, double Max1, double Min2, double Max2) const
(Nur Windows)
static void HOperatorSet.SelectContoursXld(HObject contours, out HObject selectedContours, HTuple feature, HTuple min1, HTuple max1, HTuple min2, HTuple max2)
HXLDCont HXLDCont.SelectContoursXld(string feature, double min1, double max1, double min2, double max2)
Beschreibung
select_contours_xldselect_contours_xldSelectContoursXldSelectContoursXldSelectContoursXld filtert die Konturen
ContoursContoursContoursContourscontours. Dabei kann zwischen folgenden Merkmalen
FeatureFeatureFeatureFeaturefeature ausgewählt werden:
- 'contour_length'"contour_length""contour_length""contour_length""contour_length":
-
Alle Konturen, deren Länge kleiner als
Min1Min1Min1Min1min1 oder größer als Max1Max1Max1Max1max1
ist, werden gelöscht, (Min2Min2Min2Min2min2 und
Max2Max2Max2Max2max2 sind hier ohne Bedeutung).
- 'maximum_extent'"maximum_extent""maximum_extent""maximum_extent""maximum_extent":
-
Alle Konturen, deren maximale
Ausdehnung (gemessen zwischen den
acht Extrempunkten in Zeilen- und
Spaltenrichtung, wie sie durch
Haralick und Shapiro Computer and
Robot Vision, Addison-Wesley 1992,
Kapitel 3.2 beschrieben werden)
kleiner als Min1Min1Min1Min1min1 oder
größer als Max1Max1Max1Max1max1 ist,
werden gelöscht, (Min2Min2Min2Min2min2 und
Max2Max2Max2Max2max2 sind hier ohne
Bedeutung).
- 'direction'"direction""direction""direction""direction":
-
Nur alle Konturen, deren Richtungen der
optimalen Regressionsgeraden zwischen
Min1Min1Min1Min1min1 und Max1Max1Max1Max1max1 (im
Bogenmaß, mathematischer Drehsinn) liegen,
werden behalten. Die Parameter Min1Min1Min1Min1min1
und Max1Max1Max1Max1max1 werden auf den Bereich
[0,2*PI[ abgebildet. (Min2Min2Min2Min2min2 und
Max2Max2Max2Max2max2 sind hier ohne Bedeutung).
- 'curvature'"curvature""curvature""curvature""curvature":
-
Nur alle Konturen, deren mittlerer Abstand
der Konturpunkte von der optimalen
Regressionsgeraden zwischen Min1Min1Min1Min1min1
und Max1Max1Max1Max1max1 liegt und der
Standardabweichung dieses Abstands zwischen
Min2Min2Min2Min2min2 und Max2Max2Max2Max2max2 liegt,
werden behalten.
- 'closed'"closed""closed""closed""closed":
-
Nur Konturen, deren Anfangs- und Endpunkte einen
Abstand von maximal Max1Max1Max1Max1max1 Pixeln
voneinander haben, werden behalten.
(Min1Min1Min1Min1min1, Min2Min2Min2Min2min2 und
Max2Max2Max2Max2max2 sind hier ohne Bedeutung).
- 'open'"open""open""open""open":
Nur Konturen, deren Anfangs- und Endpunkte einen
Abstand von mindestens Min1Min1Min1Min1min1 Pixeln
voneinander haben, werden behalten.
(Max1Max1Max1Max1max1, Min2Min2Min2Min2min2 und Max2Max2Max2Max2max2
sind hier ohne Bedeutung).
Wenn beim Filtern nach der Krümmung Min1Min1Min1Min1min1 = Max1Max1Max1Max1max1 =
0 oder Min2Min2Min2Min2min2 = Max2Max2Max2Max2max2 = 0 gewählt wird, spielt das
zugeordnete Merkmal keine einschränkende Rolle für die Selektion.
Achtung
Bevor Konturen mit select_contours_xldselect_contours_xldSelectContoursXldSelectContoursXldSelectContoursXld gemäß Merkmal
'direction' oder 'curvature' gefiltert werden können, müssen die
Regressionsgeradenparameter mit regress_contours_xldregress_contours_xldRegressContoursXldRegressContoursXldRegressContoursXld
berechnet werden. Falls dies nicht geschehen ist, ruft
select_contours_xldselect_contours_xldSelectContoursXldSelectContoursXldSelectContoursXld intern regress_contours_xldregress_contours_xldRegressContoursXldRegressContoursXldRegressContoursXld mit
den Parametern Mode = 'no'"no""no""no""no" und
Iterations = 1 auf. Falls ein anderer Modus
gewünscht wird, muss regress_contours_xldregress_contours_xldRegressContoursXldRegressContoursXldRegressContoursXld explizit
aufgerufen werden.
Ausführungsinformationen
- Multithreading-Typ: reentrant (läuft parallel zu nicht-exklusiven Operatoren).
- Multithreading-Bereich: global (kann von jedem Thread aufgerufen werden).
- Wird ohne Parallelisierung verarbeitet.
Parameter
ContoursContoursContoursContourscontours (input_object) xld_cont-array → objectHXLDContHXLDContHobject
Eingabe-Konturen.
SelectedContoursSelectedContoursSelectedContoursSelectedContoursselectedContours (output_object) xld_cont-array → objectHXLDContHXLDContHobject *
Ausgabe-Konturen.
FeatureFeatureFeatureFeaturefeature (input_control) string → HTupleHTupleHtuple (string) (string) (HString) (char*)
Selektionsmerkmal.
Defaultwert:
'contour_length'
"contour_length"
"contour_length"
"contour_length"
"contour_length"
Werteliste: 'closed'"closed""closed""closed""closed", 'contour_length'"contour_length""contour_length""contour_length""contour_length", 'curvature'"curvature""curvature""curvature""curvature", 'direction'"direction""direction""direction""direction", 'maximum_extent'"maximum_extent""maximum_extent""maximum_extent""maximum_extent", 'open'"open""open""open""open"
Min1Min1Min1Min1min1 (input_control) real → HTupleHTupleHtuple (real) (double) (double) (double)
Untere Schranke.
Defaultwert: 0.5
Max1Max1Max1Max1max1 (input_control) real → HTupleHTupleHtuple (real) (double) (double) (double)
Obere Schranke.
Defaultwert: 200.0
Min2Min2Min2Min2min2 (input_control) real → HTupleHTupleHtuple (real) (double) (double) (double)
Untere Schranke.
Defaultwert: -0.5
Max2Max2Max2Max2max2 (input_control) real → HTupleHTupleHtuple (real) (double) (double) (double)
Obere Schranke.
Defaultwert: 0.5
Vorgänger
regress_contours_xldregress_contours_xldRegressContoursXldRegressContoursXldRegressContoursXld
Siehe auch
get_contour_xldget_contour_xldGetContourXldGetContourXldGetContourXld,
get_contour_attrib_xldget_contour_attrib_xldGetContourAttribXldGetContourAttribXldGetContourAttribXld,
gen_contours_skeleton_xldgen_contours_skeleton_xldGenContoursSkeletonXldGenContoursSkeletonXldGenContoursSkeletonXld,
lines_gausslines_gaussLinesGaussLinesGaussLinesGauss,
lines_facetlines_facetLinesFacetLinesFacetLinesFacet,
edges_sub_pixedges_sub_pixEdgesSubPixEdgesSubPixEdgesSubPix,
get_regress_params_xldget_regress_params_xldGetRegressParamsXldGetRegressParamsXldGetRegressParamsXld,
get_contour_global_attrib_xldget_contour_global_attrib_xldGetContourGlobalAttribXldGetContourGlobalAttribXldGetContourGlobalAttribXld,
query_contour_global_attribs_xldquery_contour_global_attribs_xldQueryContourGlobalAttribsXldQueryContourGlobalAttribsXldQueryContourGlobalAttribsXld
Literatur
R. Haralick, L. Shapiro: „Computer and Robot Vision“ Vol. 1;
Kapitel 3.2, Addison-Wesley 1992
Modul
Foundation