Skip to content

update_bg_estiupdate_bg_estiUpdateBgEstiUpdateBgEstiupdate_bg_estiT_update_bg_estiπŸ”—

Short descriptionπŸ”—

update_bg_estiupdate_bg_estiUpdateBgEstiUpdateBgEstiupdate_bg_estiT_update_bg_esti β€” Change the estimated background image.

SignatureπŸ”—

update_bg_esti( image PresentImage, region UpDateRegion, bg_estimation BgEstiHandle )update_bg_esti( PresentImage, UpDateRegion : : BgEstiHandle : )void UpdateBgEsti( const HObject& PresentImage, const HObject& UpDateRegion, const HTuple& BgEstiHandle )static void HOperatorSet.UpdateBgEsti( HObject presentImage, HObject upDateRegion, HTuple bgEstiHandle )def update_bg_esti( present_image: HObject, up_date_region: HObject, bg_esti_handle: HHandle ) -> None

Herror T_update_bg_esti( 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 HImage.UpdateBgEsti( HRegion upDateRegion, HBgEsti bgEstiHandle )

void HBgEsti.UpdateBgEsti( HImage presentImage, HRegion upDateRegion )

DescriptionπŸ”—

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

Execution informationπŸ”—

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πŸ”—

PresentImagepresentImagepresent_image (input_object) singlechannelimage β†’ object (byte / real)object (byte / real)HObject (byte / real)HImage (byte / real)HObject (byte / real)Hobject (byte / real)

Current image.

UpDateRegionupDateRegionup_date_region (input_object) region β†’ objectobjectHObjectHRegionHObjectHobject

Region describing areas to change.

BgEstiHandlebgEstiHandlebg_esti_handle (input_control) bg_estimation β†’ (handle)(handle)HTuple (HHandle)HBgEsti, HTuple (IntPtr)HHandleHtuple (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_estiUpdateBgEsti returns 2 (H_MSG_TRUE) if all parameters are correct.

Combinations with other operatorsπŸ”—

Combinations

Possible predecessors

run_bg_estiRunBgEsti

Possible successors

run_bg_estiRunBgEsti

See also

run_bg_estiRunBgEsti, give_bg_estiGiveBgEsti

ModuleπŸ”—

Foundation