The UnitsAPI global functions are used to
convert a value from any unit into another unit.
Principles
Conversion is executed among three unit systems:
More...

#include <UnitsAPI.hxx>

Static Public Member Functions
static Standard_Real	CurrentToLS (const Standard_Real aData, const Standard_CString aQuantity)
	Converts the current unit value to the local system units value. <br> Example: CurrentToLS(1.,"LENGTH") returns 1000. if the current length unit is meter and LocalSystem is MDTV. More...

static Standard_Real	CurrentToSI (const Standard_Real aData, const Standard_CString aQuantity)
	Converts the current unit value to the SI system units value. <br> Example: CurrentToSI(1.,"LENGTH") returns 0.001 if current length unit is millimeter. More...

static Standard_Real	CurrentFromLS (const Standard_Real aData, const Standard_CString aQuantity)
	Converts the local system units value to the current unit value. <br> Example: CurrentFromLS(1000.,"LENGTH") returns 1. if current length unit is meter and LocalSystem is MDTV. More...

static Standard_Real	CurrentFromSI (const Standard_Real aData, const Standard_CString aQuantity)
	Converts the SI system units value to the current unit value. <br> Example: CurrentFromSI(0.001,"LENGTH") returns 1 if current length unit is millimeter. More...

static Standard_Real	AnyToLS (const Standard_Real aData, const Standard_CString aUnit)
	Converts the local unit value to the local system units value. <br> Example: AnyToLS(1.,"in.") returns 25.4 if the LocalSystem is MDTV. More...

static Standard_Real	AnyToLS (const Standard_Real aData, const Standard_CString aUnit, Handle< Units_Dimensions > &aDim)
	Converts the local unit value to the local system units value. and gives the associated dimension of the unit More...

static Standard_Real	AnyToSI (const Standard_Real aData, const Standard_CString aUnit)
	Converts the local unit value to the SI system units value. <br> Example: AnyToSI(1.,"in.") returns 0.0254 More...

static Standard_Real	AnyToSI (const Standard_Real aData, const Standard_CString aUnit, Handle< Units_Dimensions > &aDim)
	Converts the local unit value to the SI system units value. and gives the associated dimension of the unit More...

static Standard_Real	AnyFromLS (const Standard_Real aData, const Standard_CString aUnit)
	Converts the local system units value to the local unit value. <br> Example: AnyFromLS(25.4,"in.") returns 1. if the LocalSystem is MDTV. Note: aUnit is also used to identify the type of physical quantity to convert. More...

static Standard_Real	AnyFromSI (const Standard_Real aData, const Standard_CString aUnit)
	Converts the SI system units value to the local unit value. <br> Example: AnyFromSI(0.0254,"in.") returns 0.001 Note: aUnit is also used to identify the type of physical quantity to convert. More...

static Standard_Real	CurrentToAny (const Standard_Real aData, const Standard_CString aQuantity, const Standard_CString aUnit)
	Converts the aData value expressed in the <br> current unit for the working environment, as defined for the physical quantity aQuantity by the last call to the SetCurrentUnit function, into the unit aUnit. More...

static Standard_Real	CurrentFromAny (const Standard_Real aData, const Standard_CString aQuantity, const Standard_CString aUnit)
	Converts the aData value expressed in the unit <br> aUnit, into the current unit for the working environment, as defined for the physical quantity aQuantity by the last call to the SetCurrentUnit function. More...

static Standard_Real	AnyToAny (const Standard_Real aData, const Standard_CString aUnit1, const Standard_CString aUnit2)
	Converts the local unit value to another local unit value. <br> Example: AnyToAny(0.0254,"in.","millimeter") returns 1. ; More...

static Standard_Real	LSToSI (const Standard_Real aData, const Standard_CString aQuantity)
	Converts the local system units value to the SI system unit value. <br> Example: LSToSI(1.,"LENGTH") returns 0.001 if the local system length unit is millimeter. More...

static Standard_Real	SIToLS (const Standard_Real aData, const Standard_CString aQuantity)
	Converts the SI system unit value to the local system units value. <br> Example: SIToLS(1.,"LENGTH") returns 1000. if the local system length unit is millimeter. More...

static void	SetLocalSystem (const UnitsAPI_SystemUnits aSystemUnit=UnitsAPI_SI)
	Sets the local system units. <br> Example: SetLocalSystem(UnitsAPI_MDTV) More...

static UnitsAPI_SystemUnits	LocalSystem ()
	Returns the current local system units. More...

static void	SetCurrentUnit (const Standard_CString aQuantity, const Standard_CString aUnit)
	Sets the current unit dimension <aUnit> to the unit quantity <aQuantity>. <br> Example: SetCurrentUnit("LENGTH","millimeter") More...

static Standard_CString	CurrentUnit (const Standard_CString aQuantity)
	Returns the current unit dimension <aUnit> from the unit quantity <aQuantity>. More...

static void	Save ()
	saves the units in the file .CurrentUnits of the directory pointed by the CSF_CurrentUnitsUserDefaults environment variable. More...

static void	Reload ()

static Handle_Units_Dimensions	Dimensions (const Standard_CString aQuantity)
	return the dimension associated to the quantity More...

static Handle_Units_Dimensions	DimensionLess ()

static Handle_Units_Dimensions	DimensionMass ()

static Handle_Units_Dimensions	DimensionLength ()

static Handle_Units_Dimensions	DimensionTime ()

static Handle_Units_Dimensions	DimensionElectricCurrent ()

static Handle_Units_Dimensions	DimensionThermodynamicTemperature ()

static Handle_Units_Dimensions	DimensionAmountOfSubstance ()

static Handle_Units_Dimensions	DimensionLuminousIntensity ()

static Handle_Units_Dimensions	DimensionPlaneAngle ()

static Handle_Units_Dimensions	DimensionSolidAngle ()
	Returns the basic dimensions. More...

static Standard_Boolean	Check (const Standard_CString aQuantity, const Standard_CString aUnit)
	Checks the coherence between the quantity <aQuantity> and the unit <aUnits> in the current system and returns FALSE when it's WRONG. More...

Detailed Description

The UnitsAPI global functions are used to
convert a value from any unit into another unit.
Principles
Conversion is executed among three unit systems:

the SI System
the user's Local System
the user's Current System.
The SI System is the standard international unit
system. It is indicated by SI in the synopses of
the UnitsAPI functions.
The MDTV System corresponds to the SI
international standard but the length unit and all
its derivatives use millimeters instead of the meters.
Both systems are proposed by Open CASCADE;
the SI System is the standard option. By
selecting one of these two systems, the user
defines his Local System through the
SetLocalSystem function. The Local System is
indicated by LS in the synopses of the UnitsAPI functions.
The user's Local System units can be modified in
the working environment. The user defines his
Current System by modifying its units through
the SetCurrentUnit function. The Current
System is indicated by Current in the synopses
of the UnitsAPI functions.

Member Function Documentation

static Standard_Real UnitsAPI::AnyFromLS	(	const Standard_Real	aData,
		const Standard_CString	aUnit
	)

static

 Converts the local system units value to the local unit value. <br>

Example: AnyFromLS(25.4,"in.") returns 1. if the LocalSystem is MDTV.
Note: aUnit is also used to identify the type of physical quantity to convert.

static Standard_Real UnitsAPI::AnyFromSI	(	const Standard_Real	aData,
		const Standard_CString	aUnit
	)

static

 Converts the SI system units value to the local unit value. <br>

Example: AnyFromSI(0.0254,"in.") returns 0.001
Note: aUnit is also used to identify the type of physical quantity to convert.

static Standard_Real UnitsAPI::AnyToAny	(	const Standard_Real	aData,
		const Standard_CString	aUnit1,
		const Standard_CString	aUnit2
	)

static

Converts the local unit value to another local unit value. <br>

Example: AnyToAny(0.0254,"in.","millimeter") returns 1. ;

static Standard_Real UnitsAPI::AnyToLS	(	const Standard_Real	aData,
		const Standard_CString	aUnit
	)

static

Converts the local unit value to the local system units value. <br>

Example: AnyToLS(1.,"in.") returns 25.4 if the LocalSystem is MDTV.

static Standard_Real UnitsAPI::AnyToLS	(	const Standard_Real	aData,
		const Standard_CString	aUnit,
		Handle< Units_Dimensions > &	aDim
	)

static

Converts the local unit value to the local system units value.
and gives the associated dimension of the unit

static Standard_Real UnitsAPI::AnyToSI	(	const Standard_Real	aData,
		const Standard_CString	aUnit
	)

static

Converts the local unit value to the SI system units value. <br>

Example: AnyToSI(1.,"in.") returns 0.0254

static Standard_Real UnitsAPI::AnyToSI	(	const Standard_Real	aData,
		const Standard_CString	aUnit,
		Handle< Units_Dimensions > &	aDim
	)

static

Converts the local unit value to the SI system units value.
and gives the associated dimension of the unit

static Standard_Boolean UnitsAPI::Check	(	const Standard_CString	aQuantity,
		const Standard_CString	aUnit
	)

static

Checks the coherence between the quantity <aQuantity>
and the unit <aUnits> in the current system and
returns FALSE when it's WRONG.

static Standard_Real UnitsAPI::CurrentFromAny	(	const Standard_Real	aData,
		const Standard_CString	aQuantity,
		const Standard_CString	aUnit
	)

static

 Converts the aData value expressed in the unit <br>

aUnit, into the current unit for the working
environment, as defined for the physical quantity
aQuantity by the last call to the SetCurrentUnit function.

static Standard_Real UnitsAPI::CurrentFromLS	(	const Standard_Real	aData,
		const Standard_CString	aQuantity
	)

static

Converts the local system units value to the current unit value. <br>

Example: CurrentFromLS(1000.,"LENGTH") returns 1. if current length unit
is meter and LocalSystem is MDTV.

static Standard_Real UnitsAPI::CurrentFromSI	(	const Standard_Real	aData,
		const Standard_CString	aQuantity
	)

static

Converts the SI system units value to the current unit value. <br>

Example: CurrentFromSI(0.001,"LENGTH") returns 1 if current length unit
is millimeter.

static Standard_Real UnitsAPI::CurrentToAny	(	const Standard_Real	aData,
		const Standard_CString	aQuantity,
		const Standard_CString	aUnit
	)

static

 Converts the aData value expressed in the <br>

current unit for the working environment, as
defined for the physical quantity aQuantity by the
last call to the SetCurrentUnit function, into the unit aUnit.

static Standard_Real UnitsAPI::CurrentToLS	(	const Standard_Real	aData,
		const Standard_CString	aQuantity
	)

static

Converts the current unit value to the local system units value. <br>

Example: CurrentToLS(1.,"LENGTH") returns 1000. if the current length unit
is meter and LocalSystem is MDTV.

static Standard_Real UnitsAPI::CurrentToSI	(	const Standard_Real	aData,
		const Standard_CString	aQuantity
	)

static

Converts the current unit value to the SI system units value. <br>

Example: CurrentToSI(1.,"LENGTH") returns 0.001 if current length unit
is millimeter.

static Standard_CString UnitsAPI::CurrentUnit ( const Standard_CString aQuantity )

static

Returns the current unit dimension <aUnit> from the unit quantity <aQuantity>.

static Handle_Units_Dimensions UnitsAPI::DimensionAmountOfSubstance ( )

static

static Handle_Units_Dimensions UnitsAPI::DimensionElectricCurrent ( )

static

static Handle_Units_Dimensions UnitsAPI::DimensionLength ( )

static

static Handle_Units_Dimensions UnitsAPI::DimensionLess ( )

static

static Handle_Units_Dimensions UnitsAPI::DimensionLuminousIntensity ( )

static

static Handle_Units_Dimensions UnitsAPI::DimensionMass ( )

static

static Handle_Units_Dimensions UnitsAPI::DimensionPlaneAngle ( )

static

static Handle_Units_Dimensions UnitsAPI::Dimensions ( const Standard_CString aQuantity )

static

return the dimension associated to the quantity

static Handle_Units_Dimensions UnitsAPI::DimensionSolidAngle ( )

static

Returns the basic dimensions.

static Handle_Units_Dimensions UnitsAPI::DimensionThermodynamicTemperature ( )

static

static Handle_Units_Dimensions UnitsAPI::DimensionTime ( )

static

static UnitsAPI_SystemUnits UnitsAPI::LocalSystem ( )

static

Returns the current local system units.

static Standard_Real UnitsAPI::LSToSI	(	const Standard_Real	aData,
		const Standard_CString	aQuantity
	)

static

Converts the local system units value to the SI system unit value. <br>

Example: LSToSI(1.,"LENGTH") returns 0.001 if the local system
length unit is millimeter.

static void UnitsAPI::Reload ( )

static

static void UnitsAPI::Save ( )

static

saves the units in the file .CurrentUnits of the directory pointed by the
CSF_CurrentUnitsUserDefaults environment variable.

static void UnitsAPI::SetCurrentUnit	(	const Standard_CString	aQuantity,
		const Standard_CString	aUnit
	)

static

Sets the current unit dimension <aUnit> to the unit quantity <aQuantity>. <br>

Example: SetCurrentUnit("LENGTH","millimeter")

static void UnitsAPI::SetLocalSystem ( const UnitsAPI_SystemUnits aSystemUnit = UnitsAPI_SI )

static

Sets the local system units. <br>

Example: SetLocalSystem(UnitsAPI_MDTV)

static Standard_Real UnitsAPI::SIToLS	(	const Standard_Real	aData,
		const Standard_CString	aQuantity
	)

static

Converts the SI system unit value to the local system units value. <br>

Example: SIToLS(1.,"LENGTH") returns 1000. if the local system
length unit is millimeter.

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

UnitsAPI.hxx

Static Public Member Functions

Detailed Description

Member Function Documentation