
|
You are here: Home Delphi Stuffs NiceChart
NiceChart Component
Version: 1.10
Release Date: January 12nd, 2008
Introduction
Once I need a chart component that can shows interpolated lines for one of my
project. I don't need a sophisticated full-featured
chart, I just need a simple one with basic functionalities. Don't find a way to
do it with standard Delphi TChart component, I decided to write my own.
Currently it has three graph styles: lines, smooth lines with B-Splines, and
bars. It has multilined title, legend, automatic y-axis, and supports multiple
series. It also can produce a monochrome version of the graph using monochromatic
brushes. Those features are sufficient for my programming needs.
I learned a lot from creating this component. I learned the algorithm to pick
axis value range that are aligned to zero from an arbitrary set of values. I
also learned some linear interpolation algoritms, although currently only B-splines
that is accomodated in this component. And finally I understand why there's
only a handful chart component out there.

Version History
Version 1.1 (January 12nd, 2008)
- bug fixed: title not centered
- bug fixed: empty series
- soft colors
Version 1.0 (May 26th, 2007)
Initial Release
License
This library is released under Mozilla Public License. You can use it in your
freeware, shareware or commercial softwares. You can send your modification
to me, and if I decide to include it in the main distribution, I will add your
name as a contributor. You can read full licensing information here.
Installation
There is no special process to install it on Delphi. Just open NiceChartD7.dpk
on Delphi IDE and press Install button. I use Delphi 7. If you use another Delphi
version, you may have to make some minor changes.
The component will appear in priyatna.org tab.
Methods
There are some main methods of the component:
- procedure BeginUpdate;
Call this method to prevent control updating its content. This is useful when
you want to add bulky data to the chart. Don't forget to call EndUpdate when
you are done supplying data.
- procedure EndUpdate;
Call this method to reenable update. You must call BeginUpdate prior to call
this method.
- function AddSeries(AKind: TSeriesKind): TNiceSeries;
Add a new series to the chart. A series can be a bar, line or smooth line
type.
- function ClientToChart(const X, Y: Integer; var AX, AY: Double):
Boolean;
Call this function to get X-axis and Y-axis value from mouse position. The
X and Y parameters are the mouse position, and the corresponding X-axis and
Y-axis values are stored in AX and AY variables. This function returns True
if the supplied mouse position is within the X-axis and Y-axis range. Otherwise,
it returns False.
- procedure RemoveSeries(ASeries: TNiceSeries);
Removes a series from the chart.
- procedure Clear;
Removes all series from the chart.
- function CreateMetafile: TMetafile;
Creates metafile (WMF) from the chart. This function is useful when you want
to save the content of the chart to a file.
- procedure CopyToClipboard;
Copies the content of the chart to the clipboard. The content can be pasted
in any application as a graphic image.
Properties
There are some main properties of the component:
- property Series[Index: Integer]: TNiceSeries;
A collection of series that is contained in the chart.
- property SeriesCount: Integer;
Specifies how many series are in the chart.
- property ShowLegend: Boolean;
Shows or hides legend. Set to True to show the legend, or set to False to
hide it.
- property ShowTitle: Boolean;
Shows or hides title. Set to True to show the title, or set to False to hide
it.
- property ShowXGrid: Boolean;
Shows or hides horizontal grid. Set to True to show the gris, or set to False
to hide it.
- property ShowYGrid: Boolean;
Shows or hides vertical grid. Set to True to show the gris, or set to False
to hide it.
- property Title: string;
Specifies title of the chart. You can use a multilined title separated by
#13 (carriage return).
- property TitleFont: TFont;
Specifies title font name, size, color and styles (bold, italic, underline
or strike-out).
- property AxisXTitle: string;
Specifies horizontal axis title.
- property AxisYTitle: string;
Specifies vertical axis title.
- property AxisXOnePerValue: Boolean;
Forces the chart to treat each x-axis value as a different value, so all point
or bar can be viewed even though they have same x value.
- property AxisXScale: Single;
You can scale the horizontal axis so it shows different values than the original
data. This is useful, for example, if you want to supply the data in real
values, but want to show the axis in thousands. In this case, simply set this
property to 1000.
- property AxisYScale: Single;
Same as the above, but this is for vertical axis.
- property Monochrome: Boolean;
If set to True, the chart will be drawn in monochrome, using different brush
pattern for bars. Otherwise, it will be drawn in color. Colors and brush patterns
for each series are automatically choosen by the component.
Download
Download full source code and demo here:
 |
NiceChart.zip
260 KB
Version: 1.10
Release Date: January 12nd, 2008 |
|