select_obj
— Select objects from an object tuple.
select_obj(Objects : ObjectSelected : Index : )
select_obj
copies the iconic objects with the indices given
by Index
(starting with 1) from the iconic input object
tuple Objects
to the output object ObjectSelected
.
No new storage is allocated for the regions and images. Instead,
new objects containing references to the existing objects are
created. The number of objects in an object tuple can be queried
with the operator count_obj
.
For a short description of the iconic objects that are available in HALCON see the introduction of chapter Object.
Objects
(input_object) object(-array) →
object
Input objects.
ObjectSelected
(output_object) object(-array) →
object
Selected objects.
Index
(input_control) integer(-array) →
(integer)
Indices of the objects to be selected.
Default: 1
Suggested values: 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 50, 100, 200, 500, 1000, 2000, 5000
Restriction:
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); }
Runtime complexity: O(|Objects
|)
select_obj
returns 2 (
H_MSG_TRUE)
if all objects are contained in
the HALCON database and all parameters are correct. If the input
is empty the behavior can be set via
set_system(::'no_object_result',<Result>:)
.
If necessary, an exception is raised.
count_obj
,
concat_obj
,
obj_to_integer
Foundation