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

give_bg_estigive_bg_estiGiveBgEstigive_bg_estiGiveBgEstiGiveBgEsti (Operator)

Name

give_bg_estigive_bg_estiGiveBgEstigive_bg_estiGiveBgEstiGiveBgEsti — Return the estimated background image.

Signature

give_bg_esti( : BackgroundImage : BgEstiHandle : )

Herror give_bg_esti(Hobject* BackgroundImage, const Hlong BgEstiHandle)

Herror T_give_bg_esti(Hobject* BackgroundImage, const Htuple BgEstiHandle)

Herror give_bg_esti(Hobject* BackgroundImage, const HTuple& BgEstiHandle)

HImage HImage::GiveBgEsti(const HBgEsti& BgEstiHandle)

HImage HBgEsti::GiveBgEsti() const

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

void HImage::GiveBgEsti(const HBgEsti& BgEstiHandle)

HImage HBgEsti::GiveBgEsti() const

void HOperatorSetX.GiveBgEsti(
[out] IHUntypedObjectX** BackgroundImage, [in] VARIANT BgEstiHandle)

void HImageX.GiveBgEsti([in] IHBgEstiX* BgEstiHandle)

IHImageX* HBgEstiX.GiveBgEsti()

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

void HImage.GiveBgEsti(HBgEsti bgEstiHandle)

HImage HBgEsti.GiveBgEsti()

Description

give_bg_estigive_bg_estiGiveBgEstigive_bg_estiGiveBgEstiGiveBgEsti 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_estiCreateBgEsticreate_bg_estiCreateBgEstiCreateBgEsti.

Parallelization

Parameters

BackgroundImageBackgroundImageBackgroundImageBackgroundImageBackgroundImagebackgroundImage (output_object)  image → objectHImageHImageHImageHImageXHobject * (byte / real)

Estimated background image of the current data set.

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

ID of the BgEsti data set.

Example (HDevelop)

* Read image for initialization:
read_image(InitImage,'Init_Image')
* 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(Image1,'Image_1')
* Estimate the background:
run_bg_esti(Image1,ForegroundRegion1,BgEstiHandle)
* Give the background image from the aktive dataset:
give_bg_esti(BgImage,BgEstiHandle)
* Display the background image:
dev_display(BgImage)

Example (C)

/* Read image for initialization: */
read_image(&InitImage,"Init_Image") ;
/* 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(&Image1,"Image_1") ;
/* Estimate the Background: */
run_bg_esti(Image1,&Region1,BgEstiHandle) ;
/* Give the background image from the aktive dataset: */
give_bg_esti(&BgImage,BgEstiHandle) ;
/* Display the background image: */
disp_image(BgImage,WindowHandle) ;

Example (HDevelop)

* Read image for initialization:
read_image(InitImage,'Init_Image')
* 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(Image1,'Image_1')
* Estimate the background:
run_bg_esti(Image1,ForegroundRegion1,BgEstiHandle)
* Give the background image from the aktive dataset:
give_bg_esti(BgImage,BgEstiHandle)
* Display the background image:
dev_display(BgImage)

Example (HDevelop)

* Read image for initialization:
read_image(InitImage,'Init_Image')
* 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(Image1,'Image_1')
* Estimate the background:
run_bg_esti(Image1,ForegroundRegion1,BgEstiHandle)
* Give the background image from the aktive dataset:
give_bg_esti(BgImage,BgEstiHandle)
* Display the background image:
dev_display(BgImage)

Example (HDevelop)

* Read image for initialization:
read_image(InitImage,'Init_Image')
* 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(Image1,'Image_1')
* Estimate the background:
run_bg_esti(Image1,ForegroundRegion1,BgEstiHandle)
* Give the background image from the aktive dataset:
give_bg_esti(BgImage,BgEstiHandle)
* Display the background image:
dev_display(BgImage)

Example (HDevelop)

* Read image for initialization:
read_image(InitImage,'Init_Image')
* 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(Image1,'Image_1')
* Estimate the background:
run_bg_esti(Image1,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_estiGiveBgEstigive_bg_estiGiveBgEstiGiveBgEsti 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, create_bg_esticreate_bg_estiCreateBgEsticreate_bg_estiCreateBgEstiCreateBgEsti, update_bg_estiupdate_bg_estiUpdateBgEstiupdate_bg_estiUpdateBgEstiUpdateBgEsti

See also

run_bg_estirun_bg_estiRunBgEstirun_bg_estiRunBgEstiRunBgEsti, update_bg_estiupdate_bg_estiUpdateBgEstiupdate_bg_estiUpdateBgEstiUpdateBgEsti, create_bg_esticreate_bg_estiCreateBgEsticreate_bg_estiCreateBgEstiCreateBgEsti

Module

Foundation

ClassesClassesClassesClasses | | | | Operators
HALCON Operator Reference 12.0.2 Copyright © 1996-2016 MVTec Software GmbH