HALCON 18.05 / HALCON Operator Reference / Tools / Background Estimator
ClassesClasses | | Operators

update_bg_estiT_update_bg_estiUpdateBgEstiUpdateBgEsti (Operator)

Name

update_bg_estiT_update_bg_estiUpdateBgEstiUpdateBgEsti — Change the estimated background image.

Signature

update_bg_esti(PresentImage, UpDateRegion : : BgEstiHandle : )

Herror T_update_bg_esti(const Hobject PresentImage, const Hobject UpDateRegion, const Htuple BgEstiHandle)

void UpdateBgEsti(const HObject& PresentImage, const HObject& UpDateRegion, const HTuple& BgEstiHandle)

void HImage::UpdateBgEsti(const HRegion& UpDateRegion, const HBgEsti& BgEstiHandle) const

void HBgEsti::UpdateBgEsti(const HImage& PresentImage, const HRegion& UpDateRegion) const

static void HOperatorSet.UpdateBgEsti(HObject presentImage, HObject upDateRegion, HTuple bgEstiHandle)

void HImage.UpdateBgEsti(HRegion upDateRegion, HBgEsti bgEstiHandle)

void HBgEsti.UpdateBgEsti(HImage presentImage, HRegion upDateRegion)

Description

update_bg_estiupdate_bg_estiUpdateBgEstiUpdateBgEstiUpdateBgEsti overwrites the image stored in the current BgEsti data set with the grayvalues of PresentImagePresentImagePresentImagePresentImagepresentImage within the bounds of UpDateRegionUpDateRegionUpDateRegionUpDateRegionupDateRegion. 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 (PresentImagePresentImagePresentImagePresentImagepresentImage) must have the same type and size as the background image of the current data set (initialized with create_bg_esticreate_bg_estiCreateBgEstiCreateBgEstiCreateBgEsti).

Execution Information

Parameters

PresentImagePresentImagePresentImagePresentImagepresentImage (input_object)  singlechannelimage → objectHImageHImageHobject (byte / real)

Current image.

UpDateRegionUpDateRegionUpDateRegionUpDateRegionupDateRegion (input_object)  region → objectHRegionHRegionHobject

Region describing areas to change.

BgEstiHandleBgEstiHandleBgEstiHandleBgEstiHandlebgEstiHandle (input_control)  bg_estimation → HBgEsti, HTupleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)

ID of the BgEsti data set.

Example (HDevelop)

* read Init-Image:
read_image(InitImage,'xing/init')
* 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(Image0,'xing/xing000')
* estimate the Background:
run_bg_esti(Image0,Region1,BgEstiHandle)
* use the Region and the information of a knowledge base
* to calculate the UpDateRegion
update_bg_esti(Image0,UpdateRegion,BgEstiHandle)
* then read the next image in sequence:
read_image(Image1,'xing/xing001')
* estimate the Background:
run_bg_esti(Image1,Region2,BgEstiHandle)
* etc.

Example (C)

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

Example (HDevelop)

* read Init-Image:
read_image(InitImage,'xing/init')
* 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(Image0,'xing/xing000')
* estimate the Background:
run_bg_esti(Image0,Region1,BgEstiHandle)
* use the Region and the information of a knowledge base
* to calculate the UpDateRegion
update_bg_esti(Image0,UpdateRegion,BgEstiHandle)
* then read the next image in sequence:
read_image(Image1,'xing/xing001')
* estimate the Background:
run_bg_esti(Image1,Region2,BgEstiHandle)
* etc.

Example (HDevelop)

* read Init-Image:
read_image(InitImage,'xing/init')
* 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(Image0,'xing/xing000')
* estimate the Background:
run_bg_esti(Image0,Region1,BgEstiHandle)
* use the Region and the information of a knowledge base
* to calculate the UpDateRegion
update_bg_esti(Image0,UpdateRegion,BgEstiHandle)
* then read the next image in sequence:
read_image(Image1,'xing/xing001')
* estimate the Background:
run_bg_esti(Image1,Region2,BgEstiHandle)
* etc.

Example (HDevelop)

* read Init-Image:
read_image(InitImage,'xing/init')
* 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(Image0,'xing/xing000')
* estimate the Background:
run_bg_esti(Image0,Region1,BgEstiHandle)
* use the Region and the information of a knowledge base
* to calculate the UpDateRegion
update_bg_esti(Image0,UpdateRegion,BgEstiHandle)
* then read the next image in sequence:
read_image(Image1,'xing/xing001')
* estimate the Background:
run_bg_esti(Image1,Region2,BgEstiHandle)
* etc.

Result

update_bg_estiupdate_bg_estiUpdateBgEstiUpdateBgEstiUpdateBgEsti returns 2 (H_MSG_TRUE) if all parameters are correct.

Possible Predecessors

run_bg_estirun_bg_estiRunBgEstiRunBgEstiRunBgEsti

Possible Successors

run_bg_estirun_bg_estiRunBgEstiRunBgEstiRunBgEsti

See also

run_bg_estirun_bg_estiRunBgEstiRunBgEstiRunBgEsti, give_bg_estigive_bg_estiGiveBgEstiGiveBgEstiGiveBgEsti

Module

Foundation

ClassesClasses | | Operators
HALCON Operator Reference 18.05 Copyright © 1996-2018 MVTec Software GmbH