give_bg_esti

give_bg_esti ( : BackgroundImage : 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 `->` object : byte / real
Estimated background image of the current data set.

`BgEstiHandle` (input_control)	bg_estimation `->` integer
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 2 (H_MSG_TRUE) if all parameters are correct.

Parallelization Information

give_bg_esti is local and processed completely exclusively without parallelization.

Possible Predecessors

run_bg_esti

Possible Successors

run_bg_esti, create_bg_esti, update_bg_esti

Module

Background estimation