| Operatoren |
set_planar_uncalib_deformable_model_metric — Setzen der Metrik eines planaren unkalibrierten deformierbaren Modells, das aus XLD-Konturen erzeugt wurde.
set_planar_uncalib_deformable_model_metric ändert den Wert des Parameters Metric der bei der Erstellung des Formmodells ModelID aus XLD Konturen gesetzt wurde. Weil keine Information über die Polarität von Modellkonturen aus XLD Konturen vorhanden ist, wird die Polarität unter Verwendung des Bildes Image bestimmt. Dafür werden die Modelkonturen und die entsprechende Position an der das Objekt im Bild Image erscheint mit Hilfe von HomMat2D abgebildet. HomMat2D kann mit einem vorherigen Aufruf von find_planar_uncalib_deformable_model ermittelt werden.
Der Parameter Metric legt fest, unter welchen Bedingungen das Muster später im Suchbild noch erkannt wird. Falls Metric = 'use_polarity', muss das Objekt im Bild dieselben Kontrasteigenschaften aufweisen wie das Modell. Wenn z.B. das Modell ein helles Objekt auf dunklem Hintergrund ist, wird das Objekt im Bild nur dann gefunden, wenn es auch heller als der Hintergrund ist. Falls Metric = 'ignore_global_polarity', wird das Objekt auch dann im Bild gefunden, wenn sich der Kontrast global umkehrt. Im obigen Beispiel würde das Objekt also auch dann gefunden, wenn es dunkler als der Hintergrund ist. Die Laufzeit von find_planar_uncalib_deformable_model erhöht sich in diesem Fall geringfügig.
Es muss sichergestellt werden, dass die Objektkonturen im Bild Image die gleiche (oder inverse) Polarität aufweisen wie die entsprechenden Konturen im späteren Suchbild. Insbesondere darf das Objekt nicht verdeckt sein und der Hintergrund muss entweder heller oder dunkler sein als das Objekt. Ansonsten stimmt die Polarität der Modellkanten nicht mit der Polarität der Kanten im Suchbild überein und das Formmodell kann dort nicht gefunden werden. Zu beachten ist, dass nur die Polarität der Konturen bestimmt wird, nicht ihr Kontrast. Des Weiteren ist zu beachten, dass die Polarität nur aus einem einkanaligen Bild bestimmt wird. Wird ein Mehrkanalbild in Image übergeben, so wird nur der erste Kanal verwendet (und keine Fehlermeldung zurückgegeben).
Eine typische Vorgehensweise besteht darin, zuerst die XLD-Konturen aus einer Datei einzulesen. Da diese XLD-Konturen keine Polaritätsinformation haben, muss der Parameter Metric bei der Erzeugung des Formmodells aus den XLD-Konturen auf den Wert 'ignore_local_polarity' gesetzt werden. Dann kann das Modell in einem ersten Suchbild gefunden werden. Aus den resultierenden Matchingergebnissen lassen sich die Transformationsparameter (HomMat2D) bestimmen, die die Modellkonturen an die Stelle des Suchbildes abbilden, an der das Objekt erscheint. Um die Matchingergebnisse interaktiv zu kontrollieren, können die Modellkonturen entsprechend transformiert werden. Ist das Matchingergebnis korrekt, kann der Wert des Parameters Metric z.B. zu 'use_polarity' verändert werden. Dies führt in den nachfolgenden Bildern zu einer schnelleren und robusteren Erkennung.
set_planar_uncalib_deformable_model_metric kann nur mit Modellen genutzt werden, die aus XLD-Konturen erzeugt wurden.
Dieser Operator modifiziert den Zustand des folgenden Eingabeparameters:
Der Wert dieses Parameters darf nicht über mehrere Threads verwendet werden.Eingabebild, das zur Bestimmung der Polarität verwendet wird.
Handle des Modells.
Transformationsmatrix.
Art der zum Matchen verwendeten Metrik.
Defaultwert: 'use_polarity'
Werteliste: 'ignore_global_polarity', 'use_polarity'
Sind die Parameterwerte korrekt, dann liefert set_planar_uncalib_deformable_model_metric den Wert 2 (H_MSG_TRUE). Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.
create_planar_uncalib_deformable_model_xld, find_planar_uncalib_deformable_model
find_planar_uncalib_deformable_model
create_planar_uncalib_deformable_model_xld
Matching
| Operatoren |