integer_to_obj — Konversion von „ganzen Zahlen“ zu Surrogaten (Bildobjekten).
integer_to_obj( : Objects : SurrogateTuple : )
integer_to_obj arbeitet invers zu
obj_to_integer. Alle Surrogate auf
Steuerparameterpositionen werden als Objekte abgelegt. Es ist zu
beachten, dass im Gegensatz zu obj_to_integer
die Objekte dupliziert werden. integer_to_obj ist
speziell für HALCON/C, da hier Bildobjekte und Steuerparameter
unterschiedlich behandelt werden. Bitte beachten Sie, dass das
Program abstürzt, wenn in SurrogateTuple der Wert
0 übergeben wird, da dies kein gültiger Zeiger ist.
Die in HALCON verfügbaren ikonischen Objekte werden bei der Einleitung zu Kapitel Objekt vorgestellt.
Die Objekte werden in der Datenbank dupliziert.
Objects (output_object) object(-array) → object
Surrogate auf Bildobjektposition.
SurrogateTuple (input_control) pointer(-array) → (integer)
Tupel von Surrogaten.
integer_to_obj liefert den Wert 2 (H_MSG_TRUE), falls die
Parameterwerte korrekt sind, es sich also um Objektschlüssel
handelt. 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.
Foundation