| Operatoren |
obj_to_integer — Konversion von Surrogaten (Bildobjekten) zu „ganzen Zahlen“.
obj_to_integer(Objects : : Index, Number : SurrogateTuple)
obj_to_integer speichert ab der angegebenen Stelle (Index) die gewünschte Anzahl von Surrogaten der Objekte (Objektschlüssel) aus Objects als Integer-Werte im Ausgabeparameter SurrogateTuple. Wird für Number der Wert -1 verwendet, dann werden alle Objekte ab Index kopiert. Damit wird ein Direktzugriff auf ein beliebiges Element von Objects möglich. Im Zusammenhang mit count_obj (liefert die Anzahl der in Objects enthaltenen Objekte) kann man so eine sukzessive Abarbeitung der einzelnen Objekte in Objects durchführen. Die Objekte werden von obj_to_integer nicht dupliziert und dürfen deshalb nicht gelöscht (clear_obj) werden.
Die in HALCON verfügbaren ikonischen Objekte werden bei der Einleitung zu Kapitel Objekt vorgestellt.
Die Daten der Objekte werden nicht dupliziert.
Objekte, deren Surrogate ausgegeben werden.
Ab diesem Element werden die Surrogate der Objekte ausgegeben.
Defaultwert: 1
Typischer Wertebereich: 1 ≤ Index
Anzahl der zu übergebenden Surrogate.
Defaultwert: -1
Restriktion: Number == -1 || Number + Index <= number(Objects)
Tupel der Surrogate
* Access the i-th element: obj_to_integer(Objects,i,1,Surrogat)
Laufzeitkomplexität: O(|Objects| + Number)
obj_to_integer liefert den Wert 2 (H_MSG_TRUE), falls die Parameterwerte korrekt sind. Das Verhalten bei leerer Eingabe (keine Eingabeobjekte vorhanden) lässt sich mittels set_system(::'no_object_result',<Result>:) festlegen. Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.
copy_obj, select_obj, copy_image, gen_image_proto
Foundation
| Operatoren |