IlvPolarProjector Class Reference

Class for projection of data expressed in a polar system of coordinates. More...

#include <ilviews/charts/common.h>

Inheritance diagram for IlvPolarProjector:

List of all members.

Public Member Functions
	IlvPolarProjector (IlDouble startingAngle, IlDouble range, IlBoolean orientedClockwise)
	Constructor.
	IlvPolarProjector (IlDouble startingAngle=0.0, IlBoolean orientedClockwise=IlFalse)
	Constructor.
IlBoolean	getOrientedClockwise () const
	Indicates whether the polar system of coordinates is oriented clockwise.
IlDouble	getRange () const
	Returns the angle range.
IlDouble	getStartingAngle () const
	Returns the starting angle.
void	setOrientedClockwise (IlBoolean b)
	Specifies whether the polar system of coordinates is oriented clockwise.
void	setRange (IlDouble range)
	Sets the angle range.
void	setStartingAngle (IlDouble angle)
	Sets the starting angle.

---

Detailed Description

Class for projection of data expressed in a polar system of coordinates.

Library: ilvcharts

This class is a subclass of IlvAbstractProjector that handles the projection into screen coordinates for data expressed in a polar system of coordinates (theta, rho). Such a projector allows you to display data in a circular way. The abscissa values theta are mapped along a circular scale. The ordinate scale (or scales), which represent the rho values, are rectangular and are displayed radially. The polar system of coordinates can be oriented clockwise or counterclockwise.

Two constructors are provided:

• one to create a polar projector object that allows you to project in a circular way data with their abscissa values expressed in degrees. (See the constructor IlvPolarProjector::IlvPolarProjector(IlDouble, IlBoolean).)
• one to create a polar projector object that allows you to project in a circular way data with their abscissa values not expressed in degrees. (See the constructor IlvPolarProjector::IlvPolarProjector(IlDouble, IlDouble, IlBoolean).)

See also:

IlvAbstractProjector.

---

Constructor & Destructor Documentation

IlvPolarProjector::IlvPolarProjector	(	IlDouble	startingAngle = 0.0,
		IlBoolean	orientedClockwise = IlFalse
	)

Constructor.

Initializes a new IlvPolarProjector object allowing to project in a circular way data with their abscissa values that are expressed in degrees.

Parameters:

	startingAngle	The angle at which the data item with the minimum abscissa value will be displayed. This angle must be expressed in degrees. The other data items will be then displayed at the angle corresponding to their abscissa values, taking into account the fact that the angle corresponding to the minimum abscissa value is displayed at the angle startingAngle.
	orientedClockwise	A Boolean indicating whether the polar system of coordinates is oriented clockwise.

Warning:

[note] The range of the projector is meaningless when the projector is initialized so that to be able to project data with their abscissa values expressed in degrees. It is set to 0 by default and should be let to 0, otherwise the projector will behave as if it was initialized to project data with their abscissa values that are not expressed in degrees (see the constructor IlvPolarProjector::IlvPolarProjector(IlDouble, IlDouble, IlBoolean)).

IlvPolarProjector::IlvPolarProjector	(	IlDouble	startingAngle,
		IlDouble	range,
		IlBoolean	orientedClockwise
	)

Constructor.

Initializes a new IlvPolarProjector object allowing to project in a circular way data with their abscissa values that are not expressed in degrees.

Parameters:

	startingAngle	The angle at which the minimum data that will be represented will be displayed. This angle must be expressed in degrees.
	range	The angle range within which the data will be displayed. This range must be expressed in degrees.
	orientedClockwise	A Boolean indicating whether the the polar system of coordinates is oriented clockwise.

Warning:

[note] It is possible to define a polar projector that allows you to project in a circular way data with their abscissa values that are expressed in degrees. The constructor IlvPolarProjector::IlvPolarProjector(IlDouble, IlBoolean) allows you to initialize such a projector.

---

Member Function Documentation

IlBoolean IlvPolarProjector::getOrientedClockwise

(

)

const

Indicates whether the polar system of coordinates is oriented clockwise.

Returns:

IlTrue if the polar system of coordinates is oriented clockwise and IlFalse if it is oriented counterclockwise.

See also:

setOrientedClockwise.

IlDouble IlvPolarProjector::getRange

(

)

const

Returns the angle range.

Returns:

The angle range.

Warning:

[note] The angle range is meaningful only for a projector used to project in a circular way data with their abscissa that are not expressed in degrees. (See the constructor IlvPolarProjector::IlvPolarProjector(IlDouble, IlDouble, IlBoolean) for more details.) Otherwise, the range is set to 0 by default and so the returned value is 0.

See also:

setRange.

IlDouble IlvPolarProjector::getStartingAngle

(

)

const

Returns the starting angle.

Returns:

The starting angle.

Warning:

[note] See the constructors IlvPolarProjector::IlvPolarProjector(IlDouble, IlBoolean) and IlvPolarProjector::IlvPolarProjector(IlDouble, IlDouble, IlBoolean) for more details.

See also:

setStartingAngle.

void IlvPolarProjector::setOrientedClockwise

(

IlBoolean

b

)

Specifies whether the polar system of coordinates is oriented clockwise.

Parameters:

b

The new value of the Boolean indicating whether the polar system of coordinates is oriented clockwise. If b is equal to IlTrue, the polar system will be oriented clockwise. If b is equal to IlFalse, the polar system of coordinates will be oriented counterclockwise.

void IlvPolarProjector::setRange

(

IlDouble

range

)

Sets the angle range.

Parameters:

range

The new angle range. This range must be expressed in degrees.

Warning:

[note] The angle range is meaningful only for a projector used to project in a circular way data with their abscissa that are not expressed in degrees. (See the constructor IlvPolarProjector::IlvPolarProjector(IlDouble, IlDouble, IlBoolean) for more details.) So, this method must not be used if the data have their abscissa that are expressed in degrees. Otherwise, the data will be displayed as if their abscissa were not expressed in degrees.

void IlvPolarProjector::setStartingAngle

(

IlDouble

angle

)

Sets the starting angle.

Parameters:

angle

The new starting angle. This angle must be expressed in degrees.

Warning:

[note] See the constructors IlvPolarProjector::IlvPolarProjector(IlDouble, IlBoolean) and IlvPolarProjector::IlvPolarProjector(IlDouble, IlDouble, IlBoolean) for more details.