select_obj
— Selektieren von Bildobjekten.
select_obj(Objects : ObjectSelected : Index : )
select_obj
kopiert die Bildobjekte an den Positionen, die
durch Index
(beginnend mit 1) gegeben sind, aus dem Tupel
von Eingabeobjekten in Objects
. Beim Kopieren werden die
Region und die Bilder nicht dupliziert. Es werden neue Objekte
angelegt, die Verweise auf die Regionen und Bilder enthalten. Die
Anzahl von Objekten in einem Tupel kann mit count_obj
abgefragt werden.
Die in HALCON verfügbaren ikonischen Objekte werden bei der Einleitung zu Kapitel Objekt vorgestellt.
Objects
(input_object) object(-array) →
object
Eingabeobjekte.
ObjectSelected
(output_object) object(-array) →
object
Selektierte Objekte.
Index
(input_control) integer(-array) →
(integer)
Indizes der Objekte, die selektiert werden sollen.
Defaultwert: 1
Wertevorschläge: 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 50, 100, 200, 500, 1000, 2000, 5000
Restriktion: Index >= 1
/* Access to all Regions */ count_obj(Regions,&Num); for (i=1; i<=Num; i++) { select_obj(Regions,&Single,i); T_get_region_polygon(Single,5.0,&Row,&Column); T_disp_polygon(WindowHandleTuple,Row,Column); destroy_tuple(Row); destroy_tuple(Column); }
Laufzeitkomplexität: O(|Objects
|)
Sind die Surrogate korrekt, d.h. alle Objekte in der
HALCON-Datenbank vorhanden und die Parameter korrekt, dann liefert
select_obj
den Wert 2 (H_MSG_TRUE). 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.
count_obj
,
concat_obj
,
obj_to_integer
Foundation