Operator Reference

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

update_bg_estiT_update_bg_estiUpdateBgEstiUpdateBgEstiupdate_bg_esti (Operator)

update_bg_estiT_update_bg_estiUpdateBgEstiUpdateBgEstiupdate_bg_esti — 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

def update_bg_esti(present_image: HObject, up_date_region: HObject, bg_esti_handle: HHandle) -> None

Description

update_bg_estiupdate_bg_estiUpdateBgEstiUpdateBgEstiupdate_bg_esti overwrites the image stored in the current BgEsti data set with the gray values of PresentImagePresentImagePresentImagepresentImagepresent_image within the bounds of UpDateRegionUpDateRegionUpDateRegionupDateRegionup_date_region. 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 (PresentImagePresentImagePresentImagepresentImagepresent_image) must have the same type and size as the background image of the current data set (initialized with create_bg_esticreate_bg_estiCreateBgEstiCreateBgEsticreate_bg_esti).

Execution Information

  • Multithreading type: reentrant (runs in parallel with non-exclusive operators).
  • Multithreading scope: global (may be called from any thread).
  • Processed without parallelization.

Parameters

PresentImagePresentImagePresentImagepresentImagepresent_image (input_object)  singlechannelimage → objectHImageHObjectHObjectHobject (byte / real)

Current image.

UpDateRegionUpDateRegionUpDateRegionupDateRegionup_date_region (input_object)  region → objectHRegionHObjectHObjectHobject

Region describing areas to change.

BgEstiHandleBgEstiHandleBgEstiHandlebgEstiHandlebg_esti_handle (input_control)  bg_estimation → HBgEsti, HTupleHHandleHTupleHtuple (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.

Result

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

Possible Predecessors

run_bg_estirun_bg_estiRunBgEstiRunBgEstirun_bg_esti

Possible Successors

run_bg_estirun_bg_estiRunBgEstiRunBgEstirun_bg_esti

See also

run_bg_estirun_bg_estiRunBgEstiRunBgEstirun_bg_esti, give_bg_estigive_bg_estiGiveBgEstiGiveBgEstigive_bg_esti

Module

Foundation

ClassesClasses | | Operators