get_obj_classget_obj_classGetObjClassGetObjClass (Operator)


get_obj_classget_obj_classGetObjClassGetObjClass — Name of the class of an image object.


get_obj_class(Object : : : Class)

Herror get_obj_class(const Hobject Object, char* Class)

Herror T_get_obj_class(const Hobject Object, Htuple* Class)

void GetObjClass(const HObject& Object, HTuple* Class)

HTuple HObject::GetObjClass() const

static void HOperatorSet.GetObjClass(HObject objectVal, out HTuple classVal)

HTuple HObject.GetObjClass()


get_obj_classget_obj_classGetObjClassGetObjClassGetObjClass returns the name of the corresponding class to each object. The following classes are possible:


Object with region (definition domain) and at least one channel.


Object with a region without gray values.


XLD object as contour


XLD object as polygon


XLD object with parallel polygons

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

Execution Information


ObjectObjectObjectObjectobjectVal (input_object)  object(-array) objectHObjectHObjectHobject

Image objects to be examined.

ClassClassClassClassclassVal (output_control)  string(-array) HTupleHTupleHtuple (string) (string) (HString) (char*)

Name of class.


If the parameter values are correct the operator get_obj_classget_obj_classGetObjClassGetObjClassGetObjClass returns the value 2 (H_MSG_TRUE). Otherwise an exception is raised.

Possible Successors

disp_imagedisp_imageDispImageDispImageDispImage, disp_regiondisp_regionDispRegionDispRegionDispRegion, disp_xlddisp_xldDispXldDispXldDispXld

See also

get_channel_infoget_channel_infoGetChannelInfoGetChannelInfoGetChannelInfo, count_relationcount_relationCountRelationCountRelationCountRelation