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)
Tuple 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