get_channel_info ( Object : : Request, Channel : 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', 'uint2'
             '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 -> object
Image object to be examined.

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

Channel (input_control)
channel(-array) -> integer
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) -> string
Requested information.


Result

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


Parallelization Information

get_channel_info is reentrant and processed without parallelization.


Possible Predecessors

read_image


See also

count_relation


Module

Foundation



Copyright © 1996-2008 MVTec Software GmbH