give_bg_esti ( : BackgroundImage : : )

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.


Attention

Before calling give_bg_esti, a data set has to be marked as current set.


Parameters

BackgroundImage (output_object)
image -> object : byte / real
estimated background image of the current 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:) >
/* read the next image in sequence: */
read_image(:Image1:'Image_1':) >
/* estimate the Background: */
run_bg_esti(Image1:Region1::) >
/* give the background image from the aktive dataset: */
give_bg_esti(:BgImage::) >
/* display the background image: */
disp_image(BgImage:::).

Result

give_bg_esti returns TRUE if all parameters are correct.


Possible Predecessors

run_bg_esti


Possible Successors

run_bg_esti, create_bg_esti, update_bg_esti


See also

run_bg_esti, update_bg_esti, create_bg_esti



Copyright © 1996-1997 MVTec Software GmbH