get_obj_info

Herror ::get_obj_info ( const HTuple &ParameterNumber, const HTuple &Request, char *Information ) Herror ::get_obj_info ( const HTuple &ParameterNumber, const HTuple &Request, HTuple *Information )

Information about the input image objects last used.

The operator ::get_obj_info provides information about the image objects last used. Currently only one request is supported (Request = 'last_used_object'). The procedure returns the input image objects used by the procedure last carried out at the parameter positions ParameterNumber. This information is particularly useful if the cause (the exact time respectively) of an ``exception'' which occurred during processing of a tuple of image objects has to be detected.

The index (in the input tuple) and the surrogate are returned. The parameter positions are from 1 to n, i.e. the numbering starts with 1 (not with 0).

The result of ::get_obj_info is influenced only by procedures having input object parameters. If meanwhile a procedure without input object parameter is called the operator ::get_obj_info returns the same value.

If so far no objects have been accessed 'none' is returned (e.g. after ::reset_obj_db).

Parameters

`ParameterNumber` (input_control)	integer(-array) `->` HTuple.long
Positions of the input object parameters to be examined.
Default value: 1

`Request` (input_control)	string `->` HTuple.char *
Desired request.
Default value: 'last_used_object'
Suggested values: 'last_used_object'

`Information` (output_control)	string(-array) `->` (HTuple.) char * / long *
Index of last used input image object or 'none'.

Example

reset_obj_db(512,512,3) ;
get_obj_info(1,"last_used_object",&I1) ;
read_image(&X,"affe") ;
get_obj_info(1,"last_used_object",&I2) ;
mean_image(X,&Y,3,3) ;
get_obj_info(1,"last_used_object",&I3) ;

Result

::get_obj_info always returns the value H_MSG_TRUE.

Possible Predecessors

::reset_obj_db

Module

Basic operators