KiCad PCB EDA Suite
PARAM_CFG_INT_WITH_SCALE Class Reference

Configuration parameter - Integer Class with unit conversion. More...

#include <config_params.h>

Inheritance diagram for PARAM_CFG_INT_WITH_SCALE:
PARAM_CFG_INT PARAM_CFG_BASE

Public Member Functions

 PARAM_CFG_INT_WITH_SCALE (const wxString &ident, int *ptparam, int default_val=0, int min=std::numeric_limits< int >::min(), int max=std::numeric_limits< int >::max(), const wxChar *group=NULL, double aBiu2cfgunit=1.0)
 
 PARAM_CFG_INT_WITH_SCALE (bool Insetup, const wxString &ident, int *ptparam, int default_val=0, int min=std::numeric_limits< int >::min(), int max=std::numeric_limits< int >::max(), const wxChar *group=NULL, double aBiu2cfgunit=1.0)
 
virtual void ReadParam (wxConfigBase *aConfig) const override
 Function ReadParam reads the value of the parameter stored in aConfig. More...
 
virtual void SaveParam (wxConfigBase *aConfig) const override
 Function SaveParam saves the value of the parameter stored in aConfig. More...
 

Public Attributes

double m_BIU_to_cfgunit
 the factor to convert the saved value in internal value More...
 
int * m_Pt_param
 Pointer to the parameter value. More...
 
int m_Min
 
int m_Max
 Minimum and maximum values of the param type. More...
 
int m_Default
 The default value of the parameter. More...
 
wxString m_Ident
 Keyword in config data. More...
 
paramcfg_id m_Type
 Type of parameter. More...
 
wxString m_Group
 Group name (this is like a path in the config data) More...
 
bool m_Setup
 Install or Project based parameter, true == install. More...
 

Detailed Description

Configuration parameter - Integer Class with unit conversion.

Mainly used to store an integer value in millimeters (or inches) and retrieve it in internal units the stored value is a floating number

Definition at line 157 of file config_params.h.

Constructor & Destructor Documentation

PARAM_CFG_INT_WITH_SCALE::PARAM_CFG_INT_WITH_SCALE ( const wxString &  ident,
int *  ptparam,
int  default_val = 0,
int  min = std::numeric_limits<int>::min(),
int  max = std::numeric_limits<int>::max(),
const wxChar *  group = NULL,
double  aBiu2cfgunit = 1.0 
)

Definition at line 195 of file config_params.cpp.

References m_BIU_to_cfgunit, PARAM_CFG_BASE::m_Type, and PARAM_INT_WITH_SCALE.

197  :
198  PARAM_CFG_INT( ident, ptparam, default_val, min, max, group )
199 {
201  m_BIU_to_cfgunit = aBiu2cfgunit;
202 }
double m_BIU_to_cfgunit
the factor to convert the saved value in internal value
PARAM_CFG_INT(const wxString &ident, int *ptparam, int default_val=0, int min=std::numeric_limits< int >::min(), int max=std::numeric_limits< int >::max(), const wxChar *group=NULL)
#define max(a, b)
Definition: auxiliary.h:86
paramcfg_id m_Type
Type of parameter.
Definition: config_params.h:98
#define min(a, b)
Definition: auxiliary.h:85
PARAM_CFG_INT_WITH_SCALE::PARAM_CFG_INT_WITH_SCALE ( bool  Insetup,
const wxString &  ident,
int *  ptparam,
int  default_val = 0,
int  min = std::numeric_limits<int>::min(),
int  max = std::numeric_limits<int>::max(),
const wxChar *  group = NULL,
double  aBiu2cfgunit = 1.0 
)

Definition at line 205 of file config_params.cpp.

References m_BIU_to_cfgunit, PARAM_CFG_BASE::m_Type, and PARAM_INT_WITH_SCALE.

208  :
209  PARAM_CFG_INT( Insetup, ident, ptparam, default_val, min, max, group )
210 {
212  m_BIU_to_cfgunit = aBiu2cfgunit;
213 }
double m_BIU_to_cfgunit
the factor to convert the saved value in internal value
PARAM_CFG_INT(const wxString &ident, int *ptparam, int default_val=0, int min=std::numeric_limits< int >::min(), int max=std::numeric_limits< int >::max(), const wxChar *group=NULL)
#define max(a, b)
Definition: auxiliary.h:86
paramcfg_id m_Type
Type of parameter.
Definition: config_params.h:98
#define min(a, b)
Definition: auxiliary.h:85

Member Function Documentation

void PARAM_CFG_INT_WITH_SCALE::ReadParam ( wxConfigBase *  aConfig) const
overridevirtual

Function ReadParam reads the value of the parameter stored in aConfig.

Parameters
aConfig= the wxConfigBase that holds the parameter

Reimplemented from PARAM_CFG_INT.

Definition at line 216 of file config_params.cpp.

References KiROUND(), m_BIU_to_cfgunit, PARAM_CFG_INT::m_Default, PARAM_CFG_BASE::m_Ident, PARAM_CFG_INT::m_Max, PARAM_CFG_INT::m_Min, and PARAM_CFG_INT::m_Pt_param.

217 {
218  if( !m_Pt_param || !aConfig )
219  return;
220 
221  double dtmp = (double) m_Default * m_BIU_to_cfgunit;
222  aConfig->Read( m_Ident, &dtmp );
223 
224  int itmp = KiROUND( dtmp / m_BIU_to_cfgunit );
225 
226  if( (itmp < m_Min) || (itmp > m_Max) )
227  itmp = m_Default;
228 
229  *m_Pt_param = itmp;
230 }
static int KiROUND(double v)
KiROUND rounds a floating point number to an int using "round halfway cases away from zero"...
Definition: common.h:107
int m_Default
The default value of the parameter.
int * m_Pt_param
Pointer to the parameter value.
double m_BIU_to_cfgunit
the factor to convert the saved value in internal value
int m_Max
Minimum and maximum values of the param type.
wxString m_Ident
Keyword in config data.
Definition: config_params.h:97
void PARAM_CFG_INT_WITH_SCALE::SaveParam ( wxConfigBase *  aConfig) const
overridevirtual

Function SaveParam saves the value of the parameter stored in aConfig.

Parameters
aConfig= the wxConfigBase that can store the parameter

Reimplemented from PARAM_CFG_INT.

Definition at line 233 of file config_params.cpp.

References ConfigBaseWriteDouble(), m_BIU_to_cfgunit, PARAM_CFG_BASE::m_Ident, and PARAM_CFG_INT::m_Pt_param.

234 {
235  if( !m_Pt_param || !aConfig )
236  return;
237 
238  // We cannot use aConfig->Write for a double, because
239  // this function uses a format with very few digits in mantissa,
240  // and truncature issues are frequent.
241  // We uses our function.
243 }
int * m_Pt_param
Pointer to the parameter value.
double m_BIU_to_cfgunit
the factor to convert the saved value in internal value
void ConfigBaseWriteDouble(wxConfigBase *aConfig, const wxString &aKey, double aValue)
Function ConfigBaseWriteDouble This is a helper function to write doubles in config We cannot use wxC...
wxString m_Ident
Keyword in config data.
Definition: config_params.h:97

Member Data Documentation

double PARAM_CFG_INT_WITH_SCALE::m_BIU_to_cfgunit

the factor to convert the saved value in internal value

Definition at line 160 of file config_params.h.

Referenced by PARAM_CFG_INT_WITH_SCALE(), ReadParam(), and SaveParam().

int PARAM_CFG_INT::m_Default
inherited

The default value of the parameter.

Definition at line 132 of file config_params.h.

Referenced by PARAM_CFG_INT::PARAM_CFG_INT(), PARAM_CFG_INT::ReadParam(), and ReadParam().

wxString PARAM_CFG_BASE::m_Group
inherited

Group name (this is like a path in the config data)

Definition at line 99 of file config_params.h.

Referenced by PARAM_CFG_BASE::PARAM_CFG_BASE().

int PARAM_CFG_INT::m_Max
inherited

Minimum and maximum values of the param type.

Definition at line 131 of file config_params.h.

Referenced by PARAM_CFG_INT::PARAM_CFG_INT(), PARAM_CFG_INT::ReadParam(), and ReadParam().

int PARAM_CFG_INT::m_Min
inherited
int* PARAM_CFG_INT::m_Pt_param
inherited

Pointer to the parameter value.

Definition at line 130 of file config_params.h.

Referenced by PARAM_CFG_INT::PARAM_CFG_INT(), PARAM_CFG_INT::ReadParam(), ReadParam(), PARAM_CFG_INT::SaveParam(), and SaveParam().

bool PARAM_CFG_BASE::m_Setup
inherited
paramcfg_id PARAM_CFG_BASE::m_Type
inherited

Type of parameter.

Definition at line 98 of file config_params.h.

Referenced by PARAM_CFG_BASE::PARAM_CFG_BASE(), and PARAM_CFG_INT_WITH_SCALE().


The documentation for this class was generated from the following files: