Select an object from an object tuple.
::select_obj copies the iconic object with index 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.
|
Objects (input_object) |
object(-array) -> Hobject: HObject(Array) |
| Objects, of which one is to be selected. | |
|
ObjectSelected (output_object) |
object -> Hobject * : HObject |
| Selected object. | |
|
Index (input_control) |
integer -> HTuple.long |
| Index of the object 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 | |
| Typical range of values: 1 <= Index | |
/* 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);
}Runtime complexity: O(|Objects|
::select_obj returns 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
Basic operators
