EDA_UNIT_UTILS::UI Namespace Reference

Functions
KICOMMON_API double	ToUserUnit (const EDA_IU_SCALE &aIuScale, EDA_UNITS aUnit, double aValue)
	Convert aValue in internal units to the appropriate user units defined by aUnit.
KICOMMON_API wxString	StringFromValue (const EDA_IU_SCALE &aIuScale, EDA_UNITS aUnits, double aValue, bool aAddUnitsText=false, EDA_DATA_TYPE aType=EDA_DATA_TYPE::DISTANCE)
	Return the string from aValue according to aUnits (inch, mm ...) for display.
KICOMMON_API wxString	MessageTextFromValue (const EDA_IU_SCALE &aIuScale, EDA_UNITS aUnits, double aValue, bool aAddUnitsText=true, EDA_DATA_TYPE aType=EDA_DATA_TYPE::DISTANCE)
	A helper to convert the double length aValue to a string in inches, millimeters, or unscaled units.
KICOMMON_API wxString	MessageTextFromValue (const EDA_IU_SCALE &aIuScale, EDA_UNITS aUnits, int aValue, bool aAddUnitLabel=true, EDA_DATA_TYPE aType=EDA_DATA_TYPE::DISTANCE)
KICOMMON_API wxString	MessageTextFromValue (const EDA_IU_SCALE &aIuScale, EDA_UNITS aUnits, long long int aValue, bool aAddUnitLabel=true, EDA_DATA_TYPE aType=EDA_DATA_TYPE::DISTANCE)
KICOMMON_API wxString	MessageTextFromValue (EDA_ANGLE aValue, bool aAddUnitLabel=true)
KICOMMON_API wxString	MessageTextFromMinOptMax (const EDA_IU_SCALE &aIuScale, EDA_UNITS aUnits, const MINOPTMAX< int > &aValue)
KICOMMON_API double	FromUserUnit (const EDA_IU_SCALE &aIuScale, EDA_UNITS aUnit, double aValue)
	Return in internal units the value aValue given in a real unit such as "in", "mm", or "deg".
KICOMMON_API double	DoubleValueFromString (const EDA_IU_SCALE &aIuScale, EDA_UNITS aUnits, const wxString &aTextValue, EDA_DATA_TYPE aType=EDA_DATA_TYPE::DISTANCE)
	Convert aTextValue to a double.
KICOMMON_API double	DoubleValueFromString (const wxString &aTextValue)
KICOMMON_API bool	DoubleValueFromString (const EDA_IU_SCALE &aIuScale, const wxString &aTextValue, double &aDoubleValue)
KICOMMON_API long long int	ValueFromString (const EDA_IU_SCALE &aIuScale, EDA_UNITS aUnits, const wxString &aTextValue, EDA_DATA_TYPE aType=EDA_DATA_TYPE::DISTANCE)
	Convert aTextValue in aUnits to internal units used by the application.
KICOMMON_API long long int	ValueFromString (const wxString &aTextValue)

Function Documentation

DoubleValueFromString() [1/3]

bool EDA_UNIT_UTILS::UI::DoubleValueFromString	(	const EDA_IU_SCALE &	aIuScale,
		const wxString &	aTextValue,
		double &	aDoubleValue )

Definition at line 724 of file eda_units.cpp.

References CM, FromUserUnit(), FS, INCH, M_PI, MILS, MM, PS, PS_PER_CM, PS_PER_INCH, PS_PER_MM, and UM.

DoubleValueFromString() [2/3]

double EDA_UNIT_UTILS::UI::DoubleValueFromString	(	const EDA_IU_SCALE &	aIuScale,
		EDA_UNITS	aUnits,
		const wxString &	aTextValue,
		EDA_DATA_TYPE	aType = EDA_DATA_TYPE::DISTANCE )

Convert aTextValue to a double.

Warning

This utilizes the current locale and will break if decimal formats differ.

Parameters

aIuScale	The internal units scale for the current frame/app.
aUnits	The units of aTextValue.
aTextValue	A reference to a wxString object containing the string to convert.

Returns

A double representing that value in internal units.

Definition at line 604 of file eda_units.cpp.

References AREA, CM, DEGREES, DISTANCE, FromUserUnit(), FS, INCH, KI_FALLTHROUGH, LENGTH_DELAY, M_PI, MILS, MM, PS, PS_PER_CM, PS_PER_INCH, PS_PER_MM, TIME, UM, UNITLESS, and VOLUME.

Referenced by UNITS_PROVIDER::AngleValueFromString(), PCBEXPR_UNIT_RESOLVER::Convert(), PROPERTIES_FRAME::CopyPrmsFromPanelToItem(), PANEL_PREVIEW_3D_MODEL::doIncrementOffset(), PANEL_PREVIEW_3D_MODEL::doIncrementRotation(), PANEL_PREVIEW_3D_MODEL::doIncrementScale(), LIBEVAL::COMPILER::generateUCode(), UNIT_BINDER::GetDoubleValue(), PCBEXPR_VAR_REF::GetValue(), GRID::MessageText(), FOOTPRINT_PREVIEW_PANEL::New(), PANEL_PREVIEW_3D_MODEL::onMouseWheelOffset(), PANEL_PREVIEW_3D_MODEL::onMouseWheelRot(), PANEL_PREVIEW_3D_MODEL::onMouseWheelScale(), PANEL_PREVIEW_3D_MODEL::onUnitsChanged(), UNITS_PROVIDER::OptionalValueFromString(), COMMON_TOOLS::Reset(), rotationFromString(), GRID::ToDouble(), DIALOG_CREATE_ARRAY::TransferDataFromWindow(), DIALOG_IMPORT_GFX_SCH::TransferDataFromWindow(), DIALOG_IMPORT_GRAPHICS::TransferDataFromWindow(), PANEL_3D_RAYTRACING_OPTIONS::TransferDataFromWindow(), PANEL_PREVIEW_3D_MODEL::updateOrientation(), ValueFromString(), ValueFromString(), UNITS_PROVIDER::ValueFromString(), and DIALOG_IMPORT_GFX_SCH::~DIALOG_IMPORT_GFX_SCH().

DoubleValueFromString() [3/3]

double EDA_UNIT_UTILS::UI::DoubleValueFromString

(

const wxString &

aTextValue

)

Definition at line 567 of file eda_units.cpp.

FromUserUnit()

double EDA_UNIT_UTILS::UI::FromUserUnit	(	const EDA_IU_SCALE &	aIuScale,
		EDA_UNITS	aUnit,
		double	aValue )

Return in internal units the value aValue given in a real unit such as "in", "mm", or "deg".

Definition at line 544 of file eda_units.cpp.

References CM, DEGREES, FS, IN_TO_IU, INCH, MILS, MILS_TO_IU, MM, MM_TO_IU, PERCENT, PS, PS_PER_CM, PS_PER_INCH, PS_PER_MM, PS_PER_MM_TO_IU, PS_TO_IU, UM, and UNSCALED.

Referenced by PANEL_SETUP_TUNING_PROFILE_INFO::calculateDifferentialMicrostrip(), PANEL_SETUP_TUNING_PROFILE_INFO::calculateDifferentialStripline(), PANEL_SETUP_TUNING_PROFILE_INFO::calculateSingleMicrostrip(), PANEL_SETUP_TUNING_PROFILE_INFO::calculateSingleStripline(), DoubleValueFromString(), DoubleValueFromString(), fromMM(), FOOTPRINT_EDITOR_SETTINGS::MigrateFromLegacy(), PCBNEW_SETTINGS::MigrateFromLegacy(), UNIT_BINDER::setPrecision(), and UNIT_BINDER::Validate().

MessageTextFromMinOptMax()

wxString EDA_UNIT_UTILS::UI::MessageTextFromMinOptMax	(	const EDA_IU_SCALE &	aIuScale,
		EDA_UNITS	aUnits,
		const MINOPTMAX< int > &	aValue )

Definition at line 513 of file eda_units.cpp.

References _, MINOPTMAX< T >::HasMax(), MINOPTMAX< T >::HasMin(), MINOPTMAX< T >::HasOpt(), MINOPTMAX< T >::Max(), MessageTextFromValue(), MINOPTMAX< T >::Min(), and MINOPTMAX< T >::Opt().

Referenced by UNITS_PROVIDER::MessageTextFromMinOptMax().

MessageTextFromValue() [1/4]

wxString EDA_UNIT_UTILS::UI::MessageTextFromValue	(	const EDA_IU_SCALE &	aIuScale,
		EDA_UNITS	aUnits,
		double	aValue,
		bool	aAddUnitsText = true,
		EDA_DATA_TYPE	aType = EDA_DATA_TYPE::DISTANCE )

A helper to convert the double length aValue to a string in inches, millimeters, or unscaled units.

Should be used only to display a coordinate in status, but not in dialogs, files, etc., because the mantissa of the number displayed has 4 digits max for readability. The actual internal value could need up to 8 digits to preserve precision.

Parameters

aUnits	Units (IN, MM, ...)
aValue	The double value to convert.
aAddUnitsText	If true, adds the unit label to the end of the string.
aType	DISTANCE, AREA, or VOLUME.

Returns

The converted string for display in user interface elements.

Definition at line 417 of file eda_units.cpp.

References AREA, CM, DEGREES, DISTANCE, FS, EDA_UNIT_UTILS::GetText(), INCH, EDA_IU_SCALE::IU_PER_MM, KI_FALLTHROUGH, LENGTH_DELAY, MILS, MM, PS, PS_PER_CM, PS_PER_INCH, PS_PER_MM, SCH_IU_PER_MM, text, TIME, ToUserUnit(), UM, UNITLESS, UNSCALED, and VOLUME.

Referenced by EDIT_TOOL::DragArcTrack(), DRC_ENGINE::EvalRules(), DS_DRAW_ITEM_BASE::GetMsgPanelInfo(), GRID::MessageText(), MessageTextFromMinOptMax(), MessageTextFromValue(), MessageTextFromValue(), UNITS_PROVIDER::MessageTextFromValue(), UNITS_PROVIDER::MessageTextFromValue(), EDA_SHAPE::ShapeGetMsgPanelInfo(), PCB_TUNING_PATTERN::Update(), and BOARD_NETLIST_UPDATER::updateCopperZoneNets().

MessageTextFromValue() [2/4]

wxString EDA_UNIT_UTILS::UI::MessageTextFromValue	(	const EDA_IU_SCALE &	aIuScale,
		EDA_UNITS	aUnits,
		int	aValue,
		bool	aAddUnitLabel = true,
		EDA_DATA_TYPE	aType = EDA_DATA_TYPE::DISTANCE )

Definition at line 388 of file eda_units.cpp.

References MessageTextFromValue().

MessageTextFromValue() [3/4]

wxString EDA_UNIT_UTILS::UI::MessageTextFromValue	(	const EDA_IU_SCALE &	aIuScale,
		EDA_UNITS	aUnits,
		long long int	aValue,
		bool	aAddUnitLabel = true,
		EDA_DATA_TYPE	aType = EDA_DATA_TYPE::DISTANCE )

Definition at line 398 of file eda_units.cpp.

References MessageTextFromValue().

MessageTextFromValue() [4/4]

wxString EDA_UNIT_UTILS::UI::MessageTextFromValue	(	EDA_ANGLE	aValue,
		bool	aAddUnitLabel = true )

Definition at line 407 of file eda_units.cpp.

References EDA_ANGLE::AsDegrees().

StringFromValue()

wxString EDA_UNIT_UTILS::UI::StringFromValue	(	const EDA_IU_SCALE &	aIuScale,
		EDA_UNITS	aUnits,
		double	aValue,
		bool	aAddUnitsText = false,
		EDA_DATA_TYPE	aType = EDA_DATA_TYPE::DISTANCE )

Return the string from aValue according to aUnits (inch, mm ...) for display.

For readability, if the mantissa has 3 or more digits then any trailing 0's are removed. This function should be used to display values in dialogs because a value entered in mm (for instance 2.0 mm) could need up to 8 digits mantissa to preserve precision.

Parameters

aUnits	Units (INCHES, MILLIMETRE ..).
aValue	Value in internal units.
aAddUnitsText	Add units text with appropriate separators.
aType	DISTANCE, AREA, or VOLUME.

Returns

A wxString object containing value and optionally the symbol unit (like 2.000 mm).

Definition at line 323 of file eda_units.cpp.

References AREA, DEGREES, DISTANCE, EDA_UNIT_UTILS::GetText(), INCH, EDA_IU_SCALE::IU_PER_MM, KI_FALLTHROUGH, LENGTH_DELAY, MILS, PS_PER_CM, PS_PER_INCH, PS_PER_MM, removeTrailingZeros(), SCH_IU_PER_MM, text, TIME, ToUserUnit(), UNITLESS, and VOLUME.

Referenced by Build_Board_Characteristics_Table(), Build_Board_Stackup_Table(), BuildStackupReport(), UNIT_BINDER::getTextForDoubleValue(), UNIT_BINDER::getTextForValue(), PANEL_SETUP_FORMATTING::ImportSettingsFrom(), PCB_IO_EAGLE::loadClasses(), PANEL_3D_RAYTRACING_OPTIONS::loadSettings(), FOOTPRINT_EDITOR_SETTINGS::MigrateFromLegacy(), PCBNEW_SETTINGS::MigrateFromLegacy(), PANEL_SETUP_BOARD_STACKUP::onUnitsChanged(), UNIT_BINDER::SetDoubleValue(), UNIT_BINDER::SetValue(), UNITS_PROVIDER::StringFromOptionalValue(), UNITS_PROVIDER::StringFromValue(), UNITS_PROVIDER::StringFromValue(), DIALOG_GRID_SETTINGS::TransferDataFromWindow(), DIALOG_PLOT::TransferDataToWindow(), and UNIT_BINDER::Validate().

ToUserUnit()

double EDA_UNIT_UTILS::UI::ToUserUnit	(	const EDA_IU_SCALE &	aIuScale,
		EDA_UNITS	aUnit,
		double	aValue )

Convert aValue in internal units to the appropriate user units defined by aUnit.

Parameters

aUnit	The units to convert aValue to.
aValue	The value in internal units to convert.

Returns

The converted value, in double.

Definition at line 302 of file eda_units.cpp.

References CM, DEGREES, FS, INCH, IU_TO_IN, IU_TO_MILS, IU_TO_MM, IU_TO_PS, IU_TO_PS_PER_MM, MILS, MM, PS, PS_PER_CM, PS_PER_INCH, PS_PER_MM, and UM.

Referenced by ComboBoxUnits(), KIGFX::PREVIEW::DimensionLabel(), PL_EDITOR_FRAME::DisplayGridMsg(), RC_ITEM::GetJsonViolation(), GERBER_DRAW_ITEM::GetMsgPanelInfo(), PCB_DIMENSION_BASE::GetValueText(), MessageTextFromValue(), UNIT_BINDER::setPrecision(), StringFromValue(), toMM(), and PL_EDITOR_FRAME::UpdateStatusBar().

ValueFromString() [1/2]

long long int EDA_UNIT_UTILS::UI::ValueFromString	(	const EDA_IU_SCALE &	aIuScale,
		EDA_UNITS	aUnits,
		const wxString &	aTextValue,
		EDA_DATA_TYPE	aType = EDA_DATA_TYPE::DISTANCE )

Convert aTextValue in aUnits to internal units used by the application.

Warning

This utilizes the current locale and will break if decimal formats differ

Parameters

aIuScale	The internal units scale for the current frame/app.
aUnits	The units of aTextValue.
aTextValue	A reference to a wxString object containing the string to convert.

Returns

A long long int representing that value in internal units.

Definition at line 822 of file eda_units.cpp.

References DoubleValueFromString(), and KiROUND().

Referenced by DIALOG_BOARD_REANNOTATE::BuildFootprintList(), DIALOG_ANNOTATE::GetStartNumber(), UNIT_BINDER::GetValue(), UNIT_BINDER::onComboBox(), PANEL_SETUP_BOARD_STACKUP::onUnitsChanged(), UNIT_BINDER::onUnitsChanged(), PCB_VERTEX_EDITOR_PANE::parseCellValue(), and PANEL_EESCHEMA_ANNOTATION_OPTIONS::TransferDataFromWindow().

ValueFromString() [2/2]

long long int EDA_UNIT_UTILS::UI::ValueFromString

(

const wxString &

aTextValue

)

Definition at line 831 of file eda_units.cpp.

References DoubleValueFromString(), and KiROUND().