This class provides facilities to convert Cartesian data to various measurement units. More...

#include <ilviews/maps/unitconv.h>

Public Member Functions
	IlvUnitConverter (IlDouble toMeters, const char unit, const char description=0)
	Initializes a new `IlvUnitConverter` instance using the specified coefficient to convert the measurement unit to meters, and the specified unit name and description. More...

IlvUnitConverter *	copy () const
	Returns a copy of this instance of unit converter. More...

IlDouble	fromMeters (IlDouble meters) const
	This method converts a measurement expressed in meters to a measurement unit. More...

const char *	getDescription () const
	This method returns the description of the measurement unit of this converter. More...

IlDouble	getToMeters () const
	Returns the coefficient used to convert a measurement unit to meters. More...

const char *	getUnit () const
	This method returns the name of the measurement unit of this converter. More...

void	save (IlvOutputFile &file) const
	This method saves an instance of `IlvUnitConverter` to an output file. More...

IlDouble	toMeters (IlDouble units) const
	This method converts a measurement unit to meters. More...

Static Public Member Functions
static const IlvUnitConverter *	FT ()
	The unit converter for feet. More...

static const IlvUnitConverter *	GetRegisteredConverter (const char *unit)
	Returns the registered `IlvUnitConverter` whose name is specified. More...

static const IlvUnitConverter const	GetRegisteredConverters (IlUInt &count)
	Returns the list of all registered unit converters. More...

static const IlvUnitConverter *	KILOMETERS ()
	The unit converter for kilometers. More...

static const IlvUnitConverter *	KMI ()
	The unit converter for international nautical miles. More...

static IlvUnitConverter *	Load (IlvInputFile &file, IlvMapsError *status=0)
	Loads an `IlvUnitConverter` from an input file. More...

static const IlvUnitConverter *	METERS ()
	The unit converter for meters. More...

static const IlvUnitConverter *	MI ()
	The unit converter for international statute miles. More...

Detailed Description

This class provides facilities to convert Cartesian data to various measurement units.

Library: ilvmaps

See also: IlvMaps.

Constructor & Destructor Documentation

◆ IlvUnitConverter()

IlvUnitConverter::IlvUnitConverter	(	IlDouble	toMeters,
		const char *	unit,
		const char *	description = `0`
	)

Initializes a new IlvUnitConverter instance using the specified coefficient to convert the measurement unit to meters, and the specified unit name and description.

Parameters

toMeters	The coefficient used to convert the measurement unit to meters.
unit	The name of the measurement unit.
description	The description of the measurement unit.

Member Function Documentation

◆ copy()

IlvUnitConverter* IlvUnitConverter::copy ( ) const

Returns a copy of this instance of unit converter.

Returns: A copy of this unit converter.

◆ fromMeters()

IlDouble IlvUnitConverter::fromMeters ( IlDouble meters ) const

This method converts a measurement expressed in meters to a measurement unit.

Parameters

meters The measurement to be converted, expressed in meters.

Returns: The measurement expressed in the units of this converter.

◆ FT()

static const IlvUnitConverter* IlvUnitConverter::FT ( )

static

The unit converter for feet.

Returns: The unit converter for feet.

◆ getDescription()

const char* IlvUnitConverter::getDescription ( ) const

This method returns the description of the measurement unit of this converter.

Returns: A string representing the description of the unit.

◆ GetRegisteredConverter()

static const IlvUnitConverter* IlvUnitConverter::GetRegisteredConverter ( const char * unit )

static

Returns the registered IlvUnitConverter whose name is specified.

This static member method returns the registered unit converter whose name is specified as the unit argument.

Parameters

unit	The name of the unit converter to be retrieved.

Returns: A pointer to the registerd converter or 0 if the unit converter is not registered.

◆ GetRegisteredConverters()

static const IlvUnitConverter* const* IlvUnitConverter::GetRegisteredConverters ( IlUInt & count )

static

Returns the list of all registered unit converters.

This static member function returns an array of count converters that includes all the registered unit converters.

Parameters

count Returns the total number of registered unit converters.

Returns: An array of all registered unit converters.

◆ getToMeters()

IlDouble IlvUnitConverter::getToMeters ( ) const

Returns the coefficient used to convert a measurement unit to meters.

Returns: The coefficient used to convert the measurement unit to meters.

◆ getUnit()

const char* IlvUnitConverter::getUnit ( ) const

This method returns the name of the measurement unit of this converter.

Returns: A string representing the name of the unit.

◆ KILOMETERS()

static const IlvUnitConverter* IlvUnitConverter::KILOMETERS ( )

static

The unit converter for kilometers.

Returns: The unit converter for kilometers.

◆ KMI()

static const IlvUnitConverter* IlvUnitConverter::KMI ( )

static

The unit converter for international nautical miles.

Returns: The unit converter for international nautical miles.

◆ Load()

static IlvUnitConverter* IlvUnitConverter::Load	(	IlvInputFile &	file,
		IlvMapsError *	status = `0`
	)

static

Loads an IlvUnitConverter from an input file.

This static member method loads an instance of IlvUnitConverter from the specified input file. It can be used, for example, within the read() method of a subclass of IlvNamedProperty.

Parameters

file	The `IlvInputFile` to read a converter from.
status	A status holder. If this parameter is specified, it will contain `IlvMaps::NoError()` if no error occurs, an error code otherwise.

Returns: The read unit converter or a null pointer if an error occurs while reading.

◆ METERS()

static const IlvUnitConverter* IlvUnitConverter::METERS ( )

static

The unit converter for meters.

Returns: The unit converter for meters.

◆ MI()

static const IlvUnitConverter* IlvUnitConverter::MI ( )

static

The unit converter for international statute miles.

Returns: The unit converter for international statute miles.

◆ save()

void IlvUnitConverter::save ( IlvOutputFile & file ) const

This method saves an instance of IlvUnitConverter to an output file.

It can be used, for example, within the write() method of a subclass of IlvNamedProperty.

Parameters

file	The `IlvOutputFile` this converter is to be saved in.

◆ toMeters()

IlDouble IlvUnitConverter::toMeters ( IlDouble units ) const

This method converts a measurement unit to meters.

Parameters

units The measurement to be converted.

Returns: The measurement converted to meters.

Public Member Functions

Static Public Member Functions

Detailed Description

Constructor & Destructor Documentation

◆ IlvUnitConverter()

Member Function Documentation

◆ copy()

◆ fromMeters()

◆ FT()

◆ getDescription()

◆ GetRegisteredConverter()

◆ GetRegisteredConverters()

◆ getToMeters()

◆ getUnit()

◆ KILOMETERS()

◆ KMI()

◆ Load()

◆ METERS()

◆ MI()

◆ save()

◆ toMeters()