HALCON Reference Manual 10.0.2
Table of Contents / Tools / Background Estimator ClassesClassesClasses | | | Operators

get_bg_esti_paramsget_bg_esti_paramsget_bg_esti_paramsGetBgEstiParamsGetBgEstiParams (Operator)

Name

get_bg_esti_paramsget_bg_esti_paramsget_bg_esti_paramsGetBgEstiParamsGetBgEstiParams — Return the parameters of the data set.

Signature

get_bg_esti_params( : : BgEstiHandle : Syspar1, Syspar2, GainMode, Gain1, Gain2, AdaptMode, MinDiff, StatNum, ConfidenceC, TimeC)

Herror get_bg_esti_params(const Hlong BgEstiHandle, double* Syspar1, double* Syspar2, char* GainMode, double* Gain1, double* Gain2, char* AdaptMode, double* MinDiff, Hlong* StatNum, double* ConfidenceC, double* TimeC)

Herror T_get_bg_esti_params(const Htuple BgEstiHandle, Htuple* Syspar1, Htuple* Syspar2, Htuple* GainMode, Htuple* Gain1, Htuple* Gain2, Htuple* AdaptMode, Htuple* MinDiff, Htuple* StatNum, Htuple* ConfidenceC, Htuple* TimeC)

Herror get_bg_esti_params(const HTuple& BgEstiHandle, double* Syspar1, double* Syspar2, char* GainMode, double* Gain1, double* Gain2, char* AdaptMode, double* MinDiff, Hlong* StatNum, double* ConfidenceC, double* TimeC)

double HBgEsti::GetBgEstiParams(HTuple* Syspar2, HTuple* GainMode, HTuple* Gain1, HTuple* Gain2, HTuple* AdaptMode, HTuple* MinDiff, HTuple* StatNum, HTuple* ConfidenceC, HTuple* TimeC) const

void HOperatorSetX.GetBgEstiParams(
[in] VARIANT BgEstiHandle, [out] VARIANT* Syspar1, [out] VARIANT* Syspar2, [out] VARIANT* GainMode, [out] VARIANT* Gain1, [out] VARIANT* Gain2, [out] VARIANT* AdaptMode, [out] VARIANT* MinDiff, [out] VARIANT* StatNum, [out] VARIANT* ConfidenceC, [out] VARIANT* TimeC)

double HBgEstiX.GetBgEstiParams(
[out] double* Syspar2, [out] BSTR* GainMode, [out] double* Gain1, [out] double* Gain2, [out] BSTR* AdaptMode, [out] double* MinDiff, [out] Hlong* StatNum, [out] double* ConfidenceC, [out] double* TimeC)

static void HOperatorSet.GetBgEstiParams(HTuple bgEstiHandle, out HTuple syspar1, out HTuple syspar2, out HTuple gainMode, out HTuple gain1, out HTuple gain2, out HTuple adaptMode, out HTuple minDiff, out HTuple statNum, out HTuple confidenceC, out HTuple timeC)

double HBgEsti.GetBgEstiParams(out double syspar2, out string gainMode, out double gain1, out double gain2, out string adaptMode, out double minDiff, out int statNum, out double confidenceC, out double timeC)

Description

get_bg_esti_paramsget_bg_esti_paramsget_bg_esti_paramsGetBgEstiParamsGetBgEstiParams returns the parameters of the data set. The returned parameters are the same as in create_bg_esticreate_bg_esticreate_bg_estiCreateBgEstiCreateBgEsti and set_bg_esti_paramsset_bg_esti_paramsset_bg_esti_paramsSetBgEstiParamsSetBgEstiParams (see these for an explanation).

Parallelization

Parameters

BgEstiHandleBgEstiHandleBgEstiHandleBgEstiHandlebgEstiHandle (input_control)  bg_estimation → HBgEsti, HTupleHBgEsti, HTupleHBgEstiX, VARIANTHtuple (integer) (IntPtr) (Hlong) (Hlong) (Hlong)

ID of the BgEsti data set.

Syspar1Syspar1Syspar1Syspar1syspar1 (output_control)  real → HTupleHTupleVARIANTHtuple (real) (double) (double) (double) (double)

1. system matrix parameter.

Syspar2Syspar2Syspar2Syspar2syspar2 (output_control)  real → HTupleHTupleVARIANTHtuple (real) (double) (double) (double) (double)

2. system matrix parameter.

GainModeGainModeGainModeGainModegainMode (output_control)  string → HTupleHTupleVARIANTHtuple (string) (string) (char*) (BSTR) (char*)

Gain type.

Gain1Gain1Gain1Gain1gain1 (output_control)  real → HTupleHTupleVARIANTHtuple (real) (double) (double) (double) (double)

Kalman gain / foreground adaptation time.

Gain2Gain2Gain2Gain2gain2 (output_control)  real → HTupleHTupleVARIANTHtuple (real) (double) (double) (double) (double)

Kalman gain / background adaptation time.

AdaptModeAdaptModeAdaptModeAdaptModeadaptMode (output_control)  string → HTupleHTupleVARIANTHtuple (string) (string) (char*) (BSTR) (char*)

Threshold adaptation.

MinDiffMinDiffMinDiffMinDiffminDiff (output_control)  real → HTupleHTupleVARIANTHtuple (real) (double) (double) (double) (double)

Foreground / background threshold.

StatNumStatNumStatNumStatNumstatNum (output_control)  integer → HTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong)

Number of statistic data sets.

ConfidenceCConfidenceCConfidenceCConfidenceCconfidenceC (output_control)  real → HTupleHTupleVARIANTHtuple (real) (double) (double) (double) (double)

Confidence constant.

TimeCTimeCTimeCTimeCtimeC (output_control)  real → HTupleHTupleVARIANTHtuple (real) (double) (double) (double) (double)

Constant for decay time.

Example (HDevelop)

* read Init-Image:
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,Region1,BgEstiHandle)
* display the foreground region:
disp_region(Region1,WindowHandle)
* read the next image in sequence:
read_image(Image2,'Image_2')
* estimate the Background:
run_bg_esti(Image2,Region2,BgEstiHandle)
* display the foreground region:
disp_region(Region2,WindowHandle)
* etc.
* change only the gain parameter in dataset:
get_bg_esti_params(BgEstiHandle,par1,par2,par3,par4, \
                   par5,par6,par7,par8,par9,par10)
set_bg_esti_params(BgEstiHandle,par1,par2,par3,0.004, \
                   0.08,par6,par7,par8,par9,par10)
* read the next image in sequence:
read_image(Image3,'Image_3')
* estimate the Background:
run_bg_esti(Image3,Region3,BgEstiHandle)
* display the foreground region:
disp_region(Region3,WindowHandle)
* etc.

Example (C)

/* read Init-Image:*/
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,&Region1,BgEstiHandle) ;
/* display the foreground region: */
disp_region(Region1,WindowHandle) ;
/* read the next image in sequence: */
read_image(&Image2,"Image_2") ;
/* estimate the Background: */
run_bg_esti(Image2,&Region2,BgEstiHandle) ;
/* display the foreground region: */
disp_region(Region2,WindowHandle) ;
/* etc. */
/* change only the gain parameter in dataset: */
get_bg_esti_params(BgEstiHandle,&par1,&par2,&par3,&par4,
                   &par5,&par6,&par7,&par8,&par9,&par10);
set_bg_esti_params(BgEstiHandle,par1,par2,par3,0.004,
                   0.08,par6,par7,par8,par9,par10) ;
/* read the next image in sequence: */
read_image(&Image3,"Image_3") ;
/* estimate the Background: */
run_bg_esti(Image3,&Region3,BgEstiHandle) ;
/* display the foreground region: */
disp_region(Region3,WindowHandle) ;
/* etc. */

Example (HDevelop)

* read Init-Image:
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,Region1,BgEstiHandle)
* display the foreground region:
disp_region(Region1,WindowHandle)
* read the next image in sequence:
read_image(Image2,'Image_2')
* estimate the Background:
run_bg_esti(Image2,Region2,BgEstiHandle)
* display the foreground region:
disp_region(Region2,WindowHandle)
* etc.
* change only the gain parameter in dataset:
get_bg_esti_params(BgEstiHandle,par1,par2,par3,par4, \
                   par5,par6,par7,par8,par9,par10)
set_bg_esti_params(BgEstiHandle,par1,par2,par3,0.004, \
                   0.08,par6,par7,par8,par9,par10)
* read the next image in sequence:
read_image(Image3,'Image_3')
* estimate the Background:
run_bg_esti(Image3,Region3,BgEstiHandle)
* display the foreground region:
disp_region(Region3,WindowHandle)
* etc.

Example (HDevelop)

* read Init-Image:
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,Region1,BgEstiHandle)
* display the foreground region:
disp_region(Region1,WindowHandle)
* read the next image in sequence:
read_image(Image2,'Image_2')
* estimate the Background:
run_bg_esti(Image2,Region2,BgEstiHandle)
* display the foreground region:
disp_region(Region2,WindowHandle)
* etc.
* change only the gain parameter in dataset:
get_bg_esti_params(BgEstiHandle,par1,par2,par3,par4, \
                   par5,par6,par7,par8,par9,par10)
set_bg_esti_params(BgEstiHandle,par1,par2,par3,0.004, \
                   0.08,par6,par7,par8,par9,par10)
* read the next image in sequence:
read_image(Image3,'Image_3')
* estimate the Background:
run_bg_esti(Image3,Region3,BgEstiHandle)
* display the foreground region:
disp_region(Region3,WindowHandle)
* etc.

Example (HDevelop)

* read Init-Image:
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,Region1,BgEstiHandle)
* display the foreground region:
disp_region(Region1,WindowHandle)
* read the next image in sequence:
read_image(Image2,'Image_2')
* estimate the Background:
run_bg_esti(Image2,Region2,BgEstiHandle)
* display the foreground region:
disp_region(Region2,WindowHandle)
* etc.
* change only the gain parameter in dataset:
get_bg_esti_params(BgEstiHandle,par1,par2,par3,par4, \
                   par5,par6,par7,par8,par9,par10)
set_bg_esti_params(BgEstiHandle,par1,par2,par3,0.004, \
                   0.08,par6,par7,par8,par9,par10)
* read the next image in sequence:
read_image(Image3,'Image_3')
* estimate the Background:
run_bg_esti(Image3,Region3,BgEstiHandle)
* display the foreground region:
disp_region(Region3,WindowHandle)
* etc.

Result

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

Possible Predecessors

create_bg_esticreate_bg_esticreate_bg_estiCreateBgEstiCreateBgEsti

Possible Successors

run_bg_estirun_bg_estirun_bg_estiRunBgEstiRunBgEsti

See also

set_bg_esti_paramsset_bg_esti_paramsset_bg_esti_paramsSetBgEstiParamsSetBgEstiParams

Module

Foundation

Table of Contents / Tools / Background Estimator ClassesClassesClasses | | | Operators
HALCON Reference Manual 10.0.2 Copyright © 1996-2011 MVTec Software GmbH