| Operatoren |
set_local_deformable_model_metric — Setzen der Metrik eines lokal deformierbaren Modells, das aus XLD-Konturen erzeugt wurde.
set_local_deformable_model_metric(Image, VectorField : : ModelID, Metric : )
set_local_deformable_model_metric ermöglicht eine Änderung des Wertes des Parameters Metric, der bei der Erstellung des Formmodells ModelID 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 Modellkonturen an der entsprechenden Position an der das Objekt im Bild Image erscheint, abgebiltet. Hierfür wird das VectorField benötigt, welches vom semantischen Typ 'vector_field_absolute' sein muss und mit einem vorherigen Aufruf von find_local_deformable_model ermittelt wird. Es ist zu beachten, das die 'expand_border' Option in find_local_deformable_model nicht verwendet werden darf, da sonst das zurückgelieferte VectorField die falsche Größe hat.
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_local_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. Desweiteren 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 (VectorField) bestimmen, die die Modellkonturen an der Stelle des Suchbildes abbilden, an der das Objekt erscheint. Ist das Matchingergebnis korrekt, kann der Wert des Parameters Metric z.B. auf 'use_polarity' gesetzt werden. Dies führt in den nachfolgenden Bildern zu einer schnelleren und robusteren Erkennung.
set_local_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.
Vektorfeld der lokalen Deformation.
Handle des Modells.
Art der zum Matchen verwendeten Metrik.
Defaultwert: 'use_polarity'
Werteliste: 'ignore_global_polarity', 'use_polarity'
Sind die Parameterwerte korrekt, dann liefert set_local_deformable_model_metric den Wert 2 (H_MSG_TRUE). Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.
create_local_deformable_model_xld, find_local_deformable_model
create_local_deformable_model_xld
Matching
| Operatoren |