Operator Reference

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

give_bg_estiT_give_bg_estiGiveBgEstiGiveBgEstigive_bg_esti (Operator)

give_bg_estiT_give_bg_estiGiveBgEstiGiveBgEstigive_bg_esti — Return the estimated background image.

Signature

give_bg_esti( : BackgroundImage : BgEstiHandle : )

Herror T_give_bg_esti(Hobject* BackgroundImage, const Htuple BgEstiHandle)

void GiveBgEsti(HObject* BackgroundImage, const HTuple& BgEstiHandle)

void HImage::GiveBgEsti(const HBgEsti& BgEstiHandle)

HImage HBgEsti::GiveBgEsti() const

static void HOperatorSet.GiveBgEsti(out HObject backgroundImage, HTuple bgEstiHandle)

void HImage.GiveBgEsti(HBgEsti bgEstiHandle)

HImage HBgEsti.GiveBgEsti()

def give_bg_esti(bg_esti_handle: HHandle) -> HObject

Description

give_bg_estigive_bg_estiGiveBgEstiGiveBgEstigive_bg_esti 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_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

BackgroundImageBackgroundImageBackgroundImagebackgroundImagebackground_image (output_object)  image → objectHImageHObjectHObjectHobject * (byte / real)

Estimated background image of the current data set.

BgEstiHandleBgEstiHandleBgEstiHandlebgEstiHandlebg_esti_handle (input_control)  bg_estimation → HBgEsti, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (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_estigive_bg_estiGiveBgEstiGiveBgEstigive_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, create_bg_esticreate_bg_estiCreateBgEstiCreateBgEsticreate_bg_esti, update_bg_estiupdate_bg_estiUpdateBgEstiUpdateBgEstiupdate_bg_esti

See also

run_bg_estirun_bg_estiRunBgEstiRunBgEstirun_bg_esti, update_bg_estiupdate_bg_estiUpdateBgEstiUpdateBgEstiupdate_bg_esti, create_bg_esticreate_bg_estiCreateBgEstiCreateBgEsticreate_bg_esti

Module

Foundation

ClassesClasses | | Operators