Herror ::update_bg_esti (
    Hobject PresentImage,
    Hobject UpDateRegion,
    const HTuple &BgEstiHandle
)
void HImage::UpdateBgEsti (
    const HRegion &UpDateRegion,
    const HTuple &BgEstiHandle
) const

Change the estimated background image.

::update_bg_esti overwrites the image stored in the current BgEsti data set with the grayvalues of PresentImage within the bounds of UpDateRegion. This can be used for a "hard" adaptation: Image regions with a sudden change in (known) background can be adapted very fast this way.


Attention

The passed image (PresentImage) must have the same type and size as the background image of the current data set (initialized with ::create_bg_esti).


Parameters

PresentImage (input_object)
image -> Hobject: HImage ( byte / real )
Current image.

UpDateRegion (input_object)
region -> Hobject: HRegion
Region describing areas to change.

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) ;
/* use the Region and the information of a knowledge base */
/* to calculate the UpDateRegion */
update_bg_esti(Image1,UpdateRegion,BgEstiHandle) ;
/* then read the next image in sequence: */
read_image(&Image2,"Image_2") ;
/* estimate the Background: */
run_bg_esti(Image2,&Region2,BgEstiHandle) ;
/* etc. */

Result

::update_bg_esti returns H_MSG_TRUE if all parameters are correct.


Possible Predecessors

::run_bg_esti


Possible Successors

::run_bg_esti


See also

::run_bg_esti, ::give_bg_esti


Module

Background estimation



Copyright © 1996-2002 MVTec Software GmbH