ClassesClassesClassesClasses | | | | Operators

select_objselect_objSelectObjselect_objSelectObjSelectObj (Operator)

Name

select_objselect_objSelectObjselect_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)

Herror select_obj(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

void HOperatorSetX.SelectObj(
[in] IHUntypedObjectX* Objects, [out] IHUntypedObjectX*ObjectSelected, [in] VARIANT Index)

IHImageX* HImageX.SelectObj([in] VARIANT Index)

IHRegionX* HRegionX.SelectObj([in] VARIANT Index)

IHUntypedObjectX* HUntypedObjectX.SelectObj([in] VARIANT Index)

IHXLDContX* HXLDContX.SelectObj([in] VARIANT Index)

IHXLDPolyX* HXLDPolyX.SelectObj([in] VARIANT Index)

IHXLDParaX* HXLDParaX.SelectObj([in] VARIANT Index)

IHXLDModParaX* HXLDModParaX.SelectObj([in] VARIANT Index)

IHXLDExtParaX* HXLDExtParaX.SelectObj([in] VARIANT Index)

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_objSelectObjselect_objSelectObjSelectObj copies the iconic objects with the indices given by IndexIndexIndexIndexIndexindex (starting with 1) from the iconic input object tuple ObjectsObjectsObjectsObjectsObjectsobjects to the output object ObjectSelectedObjectSelectedObjectSelectedObjectSelectedObjectSelectedobjectSelected. 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_objCountObjcount_objCountObjCountObj.

Parallelization

Parameters

ObjectsObjectsObjectsObjectsObjectsobjects (input_object)  object(-array) objectHObjectHObjectHObjectHObjectXHobject

Input objects.

ObjectSelectedObjectSelectedObjectSelectedObjectSelectedObjectSelectedobjectSelected (output_object)  object(-array) objectHObjectHObjectHObjectHObjectXHobject *

Selected objects.

IndexIndexIndexIndexIndexindex (input_control)  integer(-array) HTupleHTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (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);
  clear_obj(Single);
}

Complexity

Runtime complexity: O(|ObjectsObjectsObjectsObjectsObjectsobjects|)

Result

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

Possible Predecessors

count_objcount_objCountObjcount_objCountObjCountObj

Alternatives

copy_objcopy_objCopyObjcopy_objCopyObjCopyObj

See also

count_objcount_objCountObjcount_objCountObjCountObj, concat_objconcat_objConcatObjconcat_objConcatObjConcatObj, obj_to_integerobj_to_integerObjToIntegerobj_to_integerObjToIntegerObjToInteger

Module

Foundation


ClassesClassesClassesClasses | | | | Operators