Operator Reference

HALCON Operator Reference / Object / Information
ClassesClasses | | Operators

get_channel_infoget_channel_infoGetChannelInfoGetChannelInfoget_channel_info (Operator)

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_infoGetChannelInfoGetChannelInfoget_channel_info gives information about the components of an image object. The following requests (RequestRequestRequestrequestrequest) are currently possible:

'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"

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 ChannelChannelChannelchannelchannel the numbers of the components about which information is required are stated. After carrying out get_channel_infoget_channel_infoGetChannelInfoGetChannelInfoget_channel_info, InformationInformationInformationinformationinformation contains a tuple of strings (one string per entry in ChannelChannelChannelchannelchannel) 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

  • Supports objects on compute devices.
  • Multithreading type: reentrant (runs in parallel with non-exclusive operators).
  • Multithreading scope: global (may be called from any thread).
  • Processed without parallelization.

Parameters

ObjectObjectObjectobjectValobject (input_object)  object → objectHObjectHObjectHObjectHobject

Image object to be examined.

RequestRequestRequestrequestrequest (input_control)  string → HTuplestrHTupleHtuple (string) (string) (HString) (char*)

Required information about object components.

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

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

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

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

Default: 0

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

InformationInformationInformationinformationinformation (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_infoGetChannelInfoGetChannelInfoget_channel_info returns the value 2 ( H_MSG_TRUE) . Otherwise an exception is raised.

Possible Predecessors

read_imageread_imageReadImageReadImageread_image

See also

count_relationcount_relationCountRelationCountRelationcount_relation

Module

Foundation

ClassesClasses | | Operators