Operator Reference

select_objselect_objSelectObjSelectObjselect_obj (Operator)

select_objselect_objSelectObjSelectObjselect_obj — Select objects from an object tuple.

Signature

select_obj(Objects : ObjectSelected : Index : )

Description

select_objselect_objSelectObjSelectObjselect_obj copies the iconic objects with the indices given by IndexIndexIndexindexindex (starting with 1) from the iconic input object tuple ObjectsObjectsObjectsobjectsobjects to the output object ObjectSelectedObjectSelectedObjectSelectedobjectSelectedobject_selected. 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_objCountObjCountObjcount_obj.

For a short description of the iconic objects that are available in HALCON see the introduction of chapter Object.

Execution Information

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.

ObjectSelectedObjectSelectedObjectSelectedobjectSelectedobject_selected (output_object) object(-array) → object

Selected objects.

IndexIndexIndexindexindex (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

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);
}

Complexity

Runtime complexity: O(|ObjectsObjectsObjectsobjectsobjects|)

Result

select_objselect_objSelectObjSelectObjselect_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>:)set_system("no_object_result",<Result>)SetSystem("no_object_result",<Result>)SetSystem("no_object_result",<Result>)set_system("no_object_result",<Result>). If necessary, an exception is raised.

Possible Predecessors

count_objcount_objCountObjCountObjcount_obj

Alternatives

copy_objcopy_objCopyObjCopyObjcopy_obj

Module

Foundation

Operators