Herror ::get_channel_info (
    Hobject Object,
    const HTuple &Request,
    const HTuple &Channel,
    char *Information
)
Herror ::get_channel_info (
    Hobject Object,
    const HTuple &Request,
    const HTuple &Channel,
    HTuple *Information
)

Informations about the components of an image object.

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

'creator'    Output of the names of the procedures which initially created 
             the component (not the object).

'type'       Output of the type of image component ('byte', 'int1', 'int2',
             'int4', 'real', 'direction', 'cyclic', 'complex', 'dvf', 'lut').
	       The component 0 is of type 'region' or 'xld'.
In the tuple Channel the numbers of the components about which information is required are stated. After carrying out ::get_channel_info, Information contains a tuple of strings (one string per entry in Channel) with the required information.


Parameters

Object (input_object)
object -> Hobject: HObject
Image object to be examined.

Request (input_control)
string -> HTuple.char *
Required information about object components.
Default value: 'creator'
List of values: 'creator', 'type'

Channel (input_control)
channel(-array) -> HTuple.long
Components to be examined (0 for region/XLD).
Default value: 0
Suggested values: 0, 1, 2, 3, 4, 5, 6, 7, 8

Information (output_control)
string(-array) -> (HTuple.) char *
Requested information.


Result

If the parameters are correct the operator ::get_channel_info returns the value H_MSG_TRUE. Otherwise an exception is raised.


Possible Predecessors

::read_image


See also

::count_relation


Module

Basic operators



Copyright © 1996-2002 MVTec Software GmbH