Skip to content

give_bg_estigive_bg_estiGiveBgEstiGiveBgEstigive_bg_estiT_give_bg_esti🔗

Short description🔗

give_bg_estigive_bg_estiGiveBgEstiGiveBgEstigive_bg_estiT_give_bg_esti — Return the estimated background image.

Signature🔗

give_bg_esti( out image BackgroundImage, bg_estimation BgEstiHandle )give_bg_esti( : BackgroundImage : BgEstiHandle : )void GiveBgEsti( HObject* BackgroundImage, const HTuple& BgEstiHandle )static void HOperatorSet.GiveBgEsti( out HObject backgroundImage, HTuple bgEstiHandle )def give_bg_esti( bg_esti_handle: HHandle ) -> HObject

Herror T_give_bg_esti( Hobject* BackgroundImage, const Htuple BgEstiHandle )

void HImage::GiveBgEsti( const HBgEsti& BgEstiHandle )

HImage HBgEsti::GiveBgEsti( ) const

void HImage.GiveBgEsti( HBgEsti bgEstiHandle )

HImage HBgEsti.GiveBgEsti( )

Description🔗

give_bg_estiGiveBgEsti returns the estimated background image of the current BgEsti data set. The background image has the same type and size as the initialization image passed in 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🔗

BackgroundImagebackgroundImagebackground_image (output_object) image → object (byte / real)object (byte / real)HObject (byte / real)HImage (byte / real)HObject (byte / real)Hobject * (byte / real)

Estimated background image of the current data set.

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 image for initialization:
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.0,10,3.25,15.0,BgEstiHandle)
* Read the next image in sequence:
read_image(Image0,'xing/xing000')
* Estimate the background:
run_bg_esti(Image0,ForegroundRegion1,BgEstiHandle)
* Give the background image from the aktive dataset:
give_bg_esti(BgImage,BgEstiHandle)
* Display the background image:
dev_display(BgImage)

Result🔗

give_bg_estiGiveBgEsti 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, create_bg_estiCreateBgEsti, update_bg_estiUpdateBgEsti

See also

run_bg_estiRunBgEsti, update_bg_estiUpdateBgEsti, create_bg_estiCreateBgEsti

Module🔗

Foundation