get_found_component_modelT_get_found_component_modelGetFoundComponentModelGetFoundComponentModelget_found_component_model (Operator)

Name

get_found_component_modelT_get_found_component_modelGetFoundComponentModelGetFoundComponentModelget_found_component_model — Liefert die Komponenten einer gefundenen Instanz eines Komponentenmodells zurück.

Warnung

get_found_component_modelget_found_component_modelGetFoundComponentModelGetFoundComponentModelget_found_component_model ist veraltet und wird nur aus Gründen der Rückwärtskompatibilität zur Verfügung gestellt. Der Operator wird mit HALCON 26.11 entfernt.

Signatur

Beschreibung

get_found_component_modelget_found_component_modelGetFoundComponentModelGetFoundComponentModelget_found_component_model liefert die Komponenten einer gefundenen Instanz des Komponentenmodells ComponentModelIDComponentModelIDComponentModelIDcomponentModelIDcomponent_model_id sowohl in Form von Konturregionen in FoundComponentsFoundComponentsFoundComponentsfoundComponentsfound_components als auch in numerischer Form zurück.

Der Operator get_found_component_modelget_found_component_modelGetFoundComponentModelGetFoundComponentModelget_found_component_model kann dazu genutzt werden, das Ergebnis der mit find_component_modelfind_component_modelFindComponentModelFindComponentModelfind_component_model erhaltenen Matches zu visualisieren.

Die Lage der zurückgelieferten Komponenten entspricht deren Lage im Suchbild, wie sie mit find_component_modelfind_component_modelFindComponentModelFindComponentModelfind_component_model erhalten wurde. Daher müssen die Parameter ModelStartModelStartModelStartmodelStartmodel_start, ModelEndModelEndModelEndmodelEndmodel_end, RowCompRowCompRowComprowComprow_comp, ColumnCompColumnCompColumnCompcolumnCompcolumn_comp, AngleCompAngleCompAngleCompangleCompangle_comp, ScoreCompScoreCompScoreCompscoreCompscore_comp und ModelCompModelCompModelCompmodelCompmodel_comp an get_found_component_modelget_found_component_modelGetFoundComponentModelGetFoundComponentModelget_found_component_model so übergeben werden wie sie von find_component_modelfind_component_modelFindComponentModelFindComponentModelfind_component_model zurückgeliefert worden sind. In ModelMatchModelMatchModelMatchmodelMatchmodel_match muss der Index der gefunden Instanz des Komponentenmodells übergeben werden. ModelMatchModelMatchModelMatchmodelMatchmodel_match muss somit zwischen 0 und m-1 liegen, wobei m gleich der Anzahl an Elemente in den Parametern ModelStartModelStartModelStartmodelStartmodel_start und ModelEndModelEndModelEndmodelEndmodel_end ist und somit der Anzahl der gefundenen Instanzen entspricht. Soll zum Beispiel der beste aller gefundenen Matches zurückgeliefert werden, so muss ModelMatchModelMatchModelMatchmodelMatchmodel_match auf 0 gesetzt werden.

Bei rotationssymmetrischen Komponenten kann es darüber hinaus hilfreich sein, deren Orientierung zu markieren. Dies kann erreicht werden, indem MarkOrientationMarkOrientationMarkOrientationmarkOrientationmark_orientation auf 'true'"true""true""true""true" gesetzt wird. In diesem Fall wird die Konturregion der jeweiligen Komponente an ihrem Referenzpunkt durch einen Pfeil ergänzt, der in die Referenzrichtung zeigt. Die Referenzrichtung einer Komponente ergibt sich aus deren Orientierung im Modellbild (siehe train_model_componentstrain_model_componentsTrainModelComponentsTrainModelComponentstrain_model_components oder create_component_modelcreate_component_modelCreateComponentModelCreateComponentModelcreate_component_model) und wird beschrieben durch einen vom Referenzpunkt horizontal nach rechts zeigenden Pfeil.

Zur Vereinfachung werden sowohl die Lageparameter jeder Komponente als auch deren Bewertung (Score) der gefunden Instanz zusätzlich in numerischer Form in RowCompInstRowCompInstRowCompInstrowCompInstrow_comp_inst, ColumnCompInstColumnCompInstColumnCompInstcolumnCompInstcolumn_comp_inst, AngleCompInstAngleCompInstAngleCompInstangleCompInstangle_comp_inst und ScoreCompInstScoreCompInstScoreCompInstscoreCompInstscore_comp_inst zurückgegeben. Diese vier Tupel haben immer die Länge n, wobei n die Anzahl der Komponenten im Komponentenmodell ComponentModelIDComponentModelIDComponentModelIDcomponentModelIDcomponent_model_id beschreibt. Konnte während der Suche eine Komponente nicht gefunden werden, so wird im entsprechenden Element in FoundComponentsFoundComponentsFoundComponentsfoundComponentsfound_components eine leere Region zurückgeliefert und der Wert des entsprechenden Elements in RowCompInstRowCompInstRowCompInstrowCompInstrow_comp_inst, ColumnCompInstColumnCompInstColumnCompInstcolumnCompInstcolumn_comp_inst, AngleCompInstAngleCompInstAngleCompInstangleCompInstangle_comp_inst und ScoreCompInstScoreCompInstScoreCompInstscoreCompInstscore_comp_inst auf 0 gesetzt.

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

Ergebnis

Sind die Parameterwerte korrekt, dann liefert get_found_component_modelget_found_component_modelGetFoundComponentModelGetFoundComponentModelget_found_component_model den Wert 2 ( H_MSG_TRUE) . Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.

Modul

Matching

---