select_objselect_objSelectObjSelectObj (Operator)

Name

select_objselect_objSelectObjSelectObj — Select objects from an object tuple.

Signature

select_obj(Objects : ObjectSelected : Index : )

Herror select_obj(const Hobject Objects, Hobject* ObjectSelected, const Hlong Index)

Herror T_select_obj(const Hobject Objects, Hobject* ObjectSelected, const Htuple Index)

void SelectObj(const HObject& Objects, HObject* ObjectSelected, const HTuple& Index)

HObject HObject::SelectObj(const HTuple& Index) const

HObject HObject::SelectObj(Hlong Index) const

HImage HImage::SelectObj(const HTuple& Index) const

HImage HImage::SelectObj(Hlong Index) const

HRegion HRegion::SelectObj(const HTuple& Index) const

HRegion HRegion::SelectObj(Hlong Index) const

HXLD HXLD::SelectObj(const HTuple& Index) const

HXLD HXLD::SelectObj(Hlong Index) const

HXLDCont HXLDCont::SelectObj(const HTuple& Index) const

HXLDCont HXLDCont::SelectObj(Hlong Index) const

HXLDPoly HXLDPoly::SelectObj(const HTuple& Index) const

HXLDPoly HXLDPoly::SelectObj(Hlong Index) const

HXLDPara HXLDPara::SelectObj(const HTuple& Index) const

HXLDPara HXLDPara::SelectObj(Hlong Index) const

HXLDModPara HXLDModPara::SelectObj(const HTuple& Index) const

HXLDModPara HXLDModPara::SelectObj(Hlong Index) const

HXLDExtPara HXLDExtPara::SelectObj(const HTuple& Index) const

HXLDExtPara HXLDExtPara::SelectObj(Hlong Index) const

static void HOperatorSet.SelectObj(HObject objects, out HObject objectSelected, HTuple index)

HObject HObject.SelectObj(HTuple index)

HObject HObject.SelectObj(int index)

HImage HImage.SelectObj(HTuple index)

HImage HImage.SelectObj(int index)

HRegion HRegion.SelectObj(HTuple index)

HRegion HRegion.SelectObj(int index)

HXLD HXLD.SelectObj(HTuple index)

HXLD HXLD.SelectObj(int index)

HXLDCont HXLDCont.SelectObj(HTuple index)

HXLDCont HXLDCont.SelectObj(int index)

HXLDPoly HXLDPoly.SelectObj(HTuple index)

HXLDPoly HXLDPoly.SelectObj(int index)

HXLDPara HXLDPara.SelectObj(HTuple index)

HXLDPara HXLDPara.SelectObj(int index)

HXLDModPara HXLDModPara.SelectObj(HTuple index)

HXLDModPara HXLDModPara.SelectObj(int index)

HXLDExtPara HXLDExtPara.SelectObj(HTuple index)

HXLDExtPara HXLDExtPara.SelectObj(int index)

Description

select_objselect_objSelectObjSelectObjSelectObj 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_objCountObjCountObjCountObj.

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

Execution Information

Parameters

ObjectsObjectsObjectsObjectsobjects (input_object)  object(-array) objectHObjectHObjectHobject

Input objects.

ObjectSelectedObjectSelectedObjectSelectedObjectSelectedobjectSelected (output_object)  object(-array) objectHObjectHObjectHobject *

Selected objects.

IndexIndexIndexIndexindex (input_control)  integer(-array) HTupleHTupleHtuple (integer) (int / long) (Hlong) (Hlong)

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

Complexity

Runtime complexity: O(|ObjectsObjectsObjectsObjectsobjects|)

Result

select_objselect_objSelectObjSelectObjSelectObj 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>). If necessary, an exception is raised.

Possible Predecessors

count_objcount_objCountObjCountObjCountObj

Alternatives

copy_objcopy_objCopyObjCopyObjCopyObj

See also

count_objcount_objCountObjCountObjCountObj, concat_objconcat_objConcatObjConcatObjConcatObj, obj_to_integerobj_to_integerObjToIntegerObjToIntegerObjToInteger

Module

Foundation