obj_to_integerobj_to_integerObjToIntegerObjToIntegerobj_to_integer (Operator)
Name
obj_to_integerobj_to_integerObjToIntegerObjToIntegerobj_to_integer — Konversion von Surrogaten (Bildobjekten) zu „ganzen Zahlen“.
Signatur
Beschreibung
obj_to_integerobj_to_integerObjToIntegerObjToIntegerObjToIntegerobj_to_integer speichert ab der angegebenen Stelle
(IndexIndexIndexIndexindexindex) die gewünschte Anzahl von Surrogaten der Objekte
(Objektschlüssel) aus ObjectsObjectsObjectsObjectsobjectsobjects als Integer-Werte im
Ausgabeparameter SurrogateTupleSurrogateTupleSurrogateTupleSurrogateTuplesurrogateTuplesurrogate_tuple. Wird für NumberNumberNumberNumbernumbernumber
der Wert -1 verwendet, dann werden alle Objekte ab IndexIndexIndexIndexindexindex
kopiert. Damit wird ein Direktzugriff auf ein beliebiges Element
von ObjectsObjectsObjectsObjectsobjectsobjects möglich. Im Zusammenhang mit
count_objcount_objCountObjCountObjCountObjcount_obj (liefert die Anzahl der in ObjectsObjectsObjectsObjectsobjectsobjects
enthaltenen Objekte) kann man so eine sukzessive Abarbeitung der
einzelnen Objekte in ObjectsObjectsObjectsObjectsobjectsobjects durchführen. Die Objekte
werden von obj_to_integerobj_to_integerObjToIntegerObjToIntegerObjToIntegerobj_to_integer nicht dupliziert und dürfen
deshalb nicht gelöscht (clear_objclear_objClearObjClearObjClearObjclear_obj) werden.
Die in HALCON verfügbaren ikonischen Objekte werden bei der Einleitung
zu Kapitel Objekt vorgestellt.
Achtung
Die Daten der Objekte werden nicht dupliziert.
Ausführungsinformationen
- Unterstützt Objekte auf Compute Devices.
- Multithreading-Typ: reentrant (läuft parallel zu nicht-exklusiven Operatoren).
- Multithreading-Bereich: global (kann von jedem Thread aufgerufen werden).
- Wird ohne Parallelisierung verarbeitet.
Parameter
ObjectsObjectsObjectsObjectsobjectsobjects (input_object) object(-array) → objectHObjectHObjectHObjectHobject
Objekte, deren Surrogate ausgegeben werden.
IndexIndexIndexIndexindexindex (input_control) integer → HTupleintHTupleHtuple (integer) (int / long) (Hlong) (Hlong)
Ab diesem Element werden die Surrogate der
Objekte ausgegeben.
Defaultwert: 1
Typischer Wertebereich: 1
≤
Index
Index
Index
Index
index
index
NumberNumberNumberNumbernumbernumber (input_control) integer → HTupleintHTupleHtuple (integer) (int / long) (Hlong) (Hlong)
Anzahl der zu übergebenden Surrogate.
Defaultwert: -1
Restriktion: Number == -1 || Number + Index <= number(Objects)
SurrogateTupleSurrogateTupleSurrogateTupleSurrogateTuplesurrogateTuplesurrogate_tuple (output_control) pointer(-array) → HTupleSequence[int]HTupleHtuple (integer) (IntPtr) (Hlong) (Hlong)
Tupel der Surrogate
Beispiel (HDevelop)
* Access the i-th element:
obj_to_integer(Objects,i,1,Surrogat)
Beispiel (C)
/* Access the i-th element: */
Hlong i,Surrogate;
obj_to_integer(Objects,i,1,&Surrogat);
Beispiel (HDevelop)
* Access the i-th element:
obj_to_integer(Objects,i,1,Surrogat)
Beispiel (HDevelop)
* Access the i-th element:
obj_to_integer(Objects,i,1,Surrogat)
Beispiel (HDevelop)
* Access the i-th element:
obj_to_integer(Objects,i,1,Surrogat)
Komplexität
Laufzeitkomplexität: O(|ObjectsObjectsObjectsObjectsobjectsobjects| + NumberNumberNumberNumbernumbernumber)
Ergebnis
obj_to_integerobj_to_integerObjToIntegerObjToIntegerObjToIntegerobj_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>:)set_system("no_object_result",<Result>)SetSystem("no_object_result",<Result>)SetSystem("no_object_result",<Result>)SetSystem("no_object_result",<Result>)set_system("no_object_result",<Result>) festlegen.
Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.
Alternativen
copy_objcopy_objCopyObjCopyObjCopyObjcopy_obj,
select_objselect_objSelectObjSelectObjSelectObjselect_obj,
copy_imagecopy_imageCopyImageCopyImageCopyImagecopy_image,
gen_image_protogen_image_protoGenImageProtoGenImageProtoGenImageProtogen_image_proto
Siehe auch
integer_to_objinteger_to_objIntegerToObjIntegerToObjIntegerToObjinteger_to_obj,
count_objcount_objCountObjCountObjCountObjcount_obj
Modul
Foundation