HALCON Reference Manual 10.0.2

Name

select_objselect_objselect_objSelectObjSelectObj — Select objects from an object tuple.

Signature

select_obj(Objects : ObjectSelected : Index : )

select_objselect_objselect_objSelectObjSelectObj copies the iconic objects with the indices given by IndexIndexIndexIndexindex (starting with 1) from the iconic input object tuple ObjectsObjectsObjectsObjectsobjects to the output object ObjectSelectedObjectSelectedObjectSelectedObjectSelectedobjectSelected. 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_objcount_objcount_objCountObjCountObj.

Parallelization

Supports objects on compute devices.
Multithreading type: reentrant (runs in parallel with non-exclusive operators).
Multithreading scope: global (may be called from any thread).
Processed without parallelization.

Parameters

ObjectsObjectsObjectsObjectsobjects (input_object) object(-array) → object

Input objects.

ObjectSelectedObjectSelectedObjectSelectedObjectSelectedobjectSelected (output_object) object(-array) → object

Selected objects.

IndexIndexIndexIndexindex (input_control) integer(-array) → (integer)

Indices of the objects to be selected.

Default value: 1

Suggested values: 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 50, 100, 200, 500, 1000, 2000, 5000

Restriction: Index >= 1

Example (C)

/* 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);
  clear_obj(Single);
}