give_bg_esti

Herror ::give_bg_esti ( Hobject *BackgroundImage, const HTuple &BgEstiHandle ) HImage HImage::GiveBgEsti ( const HTuple &BgEstiHandle )

Return the estimated background image.

::give_bg_esti returns the estimated background image of the current BgEsti data set. The background image has the same type and size as the initialization image passed in ::create_bg_esti.

Parameters

`BackgroundImage` (output_object)	image `->` Hobject : HImage* ( byte / real )
Estimated background image of the current data set.

`BgEstiHandle` (input_control)	bg_estimation `->` HTuple.long
ID of the BgEsti data set.

Example

/* read Init-Image: */
read_image(&InitImage,"Init_Image") ;
/* initialize BgEsti-Dataset with 
   fixed gains and threshold adaption: */
create_bg_esti(InitImage,0.7,0.7,"fixed",0.002,0.02,
               "on",7,10,3.25,15.0,&BgEstiHandle) ;
/* read the next image in sequence: */
read_image(&Image1,"Image_1") ;
/* estimate the Background: */
run_bg_esti(Image1,&Region1,BgEstiHandle) ;
/* give the background image from the aktive dataset: */
give_bg_esti(&BgImage,BgEstiHandle) ;
/* display the background image: */
disp_image(BgImage,WindowHandle) ;

Result

::give_bg_esti returns H_MSG_TRUE if all parameters are correct.

Possible Predecessors

::run_bg_esti

Possible Successors

::run_bg_esti, ::create_bg_esti, ::update_bg_esti

Module

Background estimation