HALCON Website / HALCON Operator Reference / Tools / Background Estimator
ClassesClassesClassesClasses | | | | Operators

update_bg_estiupdate_bg_estiUpdateBgEstiupdate_bg_estiUpdateBgEstiUpdateBgEsti (Operator)

Name

update_bg_estiupdate_bg_estiUpdateBgEstiupdate_bg_estiUpdateBgEstiUpdateBgEsti — Change the estimated background image.

Signature

update_bg_esti(PresentImage, UpDateRegion : : BgEstiHandle : )

Herror update_bg_esti(const Hobject PresentImage, const Hobject UpDateRegion, const Hlong BgEstiHandle)

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

Herror update_bg_esti(Hobject PresentImage, 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

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

void HOperatorSetX.UpdateBgEsti(
[in] IHUntypedObjectX* PresentImage, [in] IHUntypedObjectX* UpDateRegion, [in] VARIANT BgEstiHandle)

void HImageX.UpdateBgEsti(
[in] IHRegionX* UpDateRegion, [in] IHBgEstiX* BgEstiHandle)

void HBgEstiX.UpdateBgEsti(
[in] IHImageX* PresentImage, [in] IHRegionX* UpDateRegion)

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

Parallelization

Parameters

PresentImagePresentImagePresentImagePresentImagePresentImagepresentImage (input_object)  singlechannelimage → objectHImageHImageHImageHImageXHobject (byte / real)

Current image.

UpDateRegionUpDateRegionUpDateRegionUpDateRegionUpDateRegionupDateRegion (input_object)  region → objectHRegionHRegionHRegionHRegionXHobject

Region describing areas to change.

BgEstiHandleBgEstiHandleBgEstiHandleBgEstiHandleBgEstiHandlebgEstiHandle (input_control)  bg_estimation → HBgEsti, HTupleHTupleHBgEsti, HTupleHBgEstiX, VARIANTHtuple (integer) (IntPtr) (Hlong) (Hlong) (Hlong) (Hlong)

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.

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_estiUpdateBgEstiupdate_bg_estiUpdateBgEstiUpdateBgEsti returns 2 (H_MSG_TRUE) if all parameters are correct.

Possible Predecessors

run_bg_estirun_bg_estiRunBgEstirun_bg_estiRunBgEstiRunBgEsti

Possible Successors

run_bg_estirun_bg_estiRunBgEstirun_bg_estiRunBgEstiRunBgEsti

See also

run_bg_estirun_bg_estiRunBgEstirun_bg_estiRunBgEstiRunBgEsti, give_bg_estigive_bg_estiGiveBgEstigive_bg_estiGiveBgEstiGiveBgEsti

Module

Foundation

ClassesClassesClassesClasses | | | | Operators
HALCON Operator Reference 13.0.4 Copyright © 1996-2019 MVTec Software GmbH