rwlogo
Rogue Wave Views 5.6

Rogue Wave Views
Charts Package API Reference Guide

Product Documentation:

Rogue Wave Views
Documentation Home

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:
IlvAbstractProjector

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:

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.
 All Classes Files Functions Variables Typedefs Enumerations Enumerator Friends Defines

© Copyright 2012, Rogue Wave Software, Inc. All Rights Reserved.
Rogue Wave is a registered trademark of Rogue Wave Software, Inc. in the United States and other countries. All other trademarks are the property of their respective owners.