select_objselect_objSelectObjSelectObjselect_obj (算子名称)

名称

select_objselect_objSelectObjSelectObjselect_obj — Select objects from an object tuple.

参数签名

select_obj(Objects : ObjectSelected : Index : )

描述

select_objselect_objSelectObjSelectObjSelectObjselect_obj copies the iconic objects with the indices given by IndexIndexIndexIndexindexindex (starting with 1) from the iconic input object tuple ObjectsObjectsObjectsObjectsobjectsobjects to the output object ObjectSelectedObjectSelectedObjectSelectedObjectSelectedobjectSelectedobject_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 该算子 count_objcount_objCountObjCountObjCountObjcount_obj.

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

运行信息

Supports objects on compute devices.
多线程类型:可重入(与非独占操作符并行运行)。
多线程作用域:全局(可以从任何线程调用)。
未经并行化处理。

参数表

ObjectsObjectsObjectsObjectsobjectsobjects (input_object) object(-array) → object

Input objects.

ObjectSelectedObjectSelectedObjectSelectedObjectSelectedobjectSelectedobject_selected (output_object) object(-array) → object

Selected objects.

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

例程 (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(|ObjectsObjectsObjectsObjectsobjectsobjects|)

结果

select_objselect_objSelectObjSelectObjSelectObjselect_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>)SetSystem("no_object_result",<Result>)set_system("no_object_result",<Result>). 如有必要，将引发异常。

可能的前置算子

count_objcount_objCountObjCountObjCountObjcount_obj

可替代算子

copy_objcopy_objCopyObjCopyObjCopyObjcopy_obj

参考其它

count_objcount_objCountObjCountObjCountObjcount_obj, concat_objconcat_objConcatObjConcatObjConcatObjconcat_obj, obj_to_integerobj_to_integerObjToIntegerObjToIntegerObjToIntegerobj_to_integer

模块

Foundation

算子列表