get_channel_infoget_channel_infoGetChannelInfoGetChannelInfoget_channel_info (Operator)

Name

get_channel_infoget_channel_infoGetChannelInfoGetChannelInfoget_channel_info — Information about the components of an image object.

Signature

get_channel_info(Object : : Request, Channel : Information)

Herror get_channel_info(const Hobject Object, const char* Request, const Hlong Channel, char* Information)

Herror T_get_channel_info(const Hobject Object, const Htuple Request, const Htuple Channel, Htuple* Information)

void GetChannelInfo(const HObject& Object, const HTuple& Request, const HTuple& Channel, HTuple* Information)

HTuple HObject::GetChannelInfo(const HString& Request, const HTuple& Channel) const

HString HObject::GetChannelInfo(const HString& Request, Hlong Channel) const

HString HObject::GetChannelInfo(const char* Request, Hlong Channel) const

HString HObject::GetChannelInfo(const wchar_t* Request, Hlong Channel) const   (Windows only)

static void HOperatorSet.GetChannelInfo(HObject objectVal, HTuple request, HTuple channel, out HTuple information)

HTuple HObject.GetChannelInfo(string request, HTuple channel)

string HObject.GetChannelInfo(string request, int channel)

def get_channel_info(object: HObject, request: str, channel: MaybeSequence[int]) -> Sequence[str]

def get_channel_info_s(object: HObject, request: str, channel: MaybeSequence[int]) -> str

Description

The operator get_channel_infoget_channel_infoGetChannelInfoGetChannelInfoGetChannelInfoget_channel_info gives information about the components of an image object. The following requests (RequestRequestRequestRequestrequestrequest) are currently possible:

'creator'"creator""creator""creator""creator""creator"

Output of the names of the procedures which initially created the image components (not the object).

'type'"type""type""type""type""type"

Output of the type of image component (byte, int1, int2, uint2 int4, real, direction, cyclic, complex, vector_field). The component 0 is of type 'region' or 'xld'.

In the tuple ChannelChannelChannelChannelchannelchannel the numbers of the components about which information is required are stated. After carrying out get_channel_infoget_channel_infoGetChannelInfoGetChannelInfoGetChannelInfoget_channel_info, InformationInformationInformationInformationinformationinformation contains a tuple of strings (one string per entry in ChannelChannelChannelChannelchannelchannel) with the required information.

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

Execution Information

Parameters

ObjectObjectObjectObjectobjectValobject (input_object)  object objectHObjectHObjectHObjectHobject

Image object to be examined.

RequestRequestRequestRequestrequestrequest (input_control)  string HTuplestrHTupleHtuple (string) (string) (HString) (char*)

Required information about object components.

Default value: 'creator' "creator" "creator" "creator" "creator" "creator"

List of values: 'creator'"creator""creator""creator""creator""creator", 'type'"type""type""type""type""type"

ChannelChannelChannelChannelchannelchannel (input_control)  channel(-array) HTupleMaybeSequence[int]HTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Components to be examined (0 for region/XLD).

Default value: 0

Suggested values: 0, 1, 2, 3, 4, 5, 6, 7, 8

InformationInformationInformationInformationinformationinformation (output_control)  string(-array) HTupleSequence[str]HTupleHtuple (string) (string) (HString) (char*)

Requested information.

Result

If the parameters are correct the operator get_channel_infoget_channel_infoGetChannelInfoGetChannelInfoGetChannelInfoget_channel_info returns the value 2 (H_MSG_TRUE). Otherwise an exception is raised.

Possible Predecessors

read_imageread_imageReadImageReadImageReadImageread_image

See also

count_relationcount_relationCountRelationCountRelationCountRelationcount_relation

Module

Foundation