Polyline Displayer

A polyline displayer has the following basic characteristics:

Class	IlvPolylineChartDisplayer
Category	Single
Number of real data sets displayed	1
Can be used with all types of projections	Yes
Items drawn	Polyline

The following property is specific to a polyline displayer:

Property	Methods	Default Value
Projected Points Palette	getProjectedPointsPalette setProjectedPointsPalette	0

By default, any data points that should appear outside of the data display area (if such data points exist) are not drawn. The parts of the polyline extending outside of the data display area are simply clipped by the data display area. The drawing on the left in Out-of-Bounds Data Point Projection shows how a polyline can be clipped. The screen points corresponding to the data points to be displayed are represented by black squares. Only the parts of the polyline displayed in bold will appear on the screen.

The data points that should appear outside of the data display area can be projected onto the limits of the data display area if desired. Data points that are outside of the data display area (out-of-bounds data points) are projected only if a horizontal projection and/or a vertical projection of out-of-bounds data points are requested at the level of the chart object that uses the displayer. A horizontal projection can be requested on a chart by the method IlvChartGraphic::setProjectHorizontally. A vertical projection can be requested on a chart by the method IlvChartGraphic::setProjectVertically.

The drawing on the right in Out-of-Bounds Data Point Projection shows how out-of-bounds data points are handled. The parts of the polyline extending outside of the data display area are projected. Points are added (those shown by white circles) in order to close the polyline that was truncated in the drawing on the left. The polyline then appears to be continuous with the projected parts following the limits of the data display area.

These projected parts are displayed with the palette returned by the IlvPolylineChartDisplayer::getProjectedPointsPalette method.This method returns a pointer to the palette object that has been set to display out-of-bounds data points for the current polyline displayer, if such a palette has been set. Otherwise, it returns a pointer to the palette object that has been set to display out-of-bounds data points in the chart object that uses the current polyline displayer.

Out-of-Bounds Data Point Projection

Polyline Displayers in a Cartesian Chart and in a Polar Chart illustrates the fact that a polyline displayer can be used with all types of projections. Data sets are represented by polyline displayers in a Cartesian chart (using a Cartesian projection) and in a polar chart (using a polar projection).

Polyline Displayers in a Cartesian Chart and in a Polar Chart

We can use the polyline displayer displaying the blue polyline as an example. We can create this displayer by using the following code:

IlvPolylineChartDisplayer* displayer = new IlvPolylineChartDisplayer(); displayer->setForeground(dpy->getColor("blue"));

Note The Drawn Filled property has no meaning for the polyline displayer. The polyline is simply drawn with the foreground color of the defined palette.