NiceChart
The following text is based on the readme.html file which is included in the NiceChart installation directory. It is written by the original author of the component, Priyatna. The text was also published on the author's web site which, however, is not available any more.
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 multi-lined 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 2.0
Released: June 2023 - Ported to Lazarus, cross-platform - Some new properties: ShowXAxisLine, ShowYAxisLine, GridColor, AxisLineWidth, TickLength, NiceSeries.LineWidth
Version 1.1
Released: January 12nd, 2008 - bug fixed: title not centered - bug fixed: empty series - soft colors
Version 1.0
Released: 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 in the file "License.txt" in the NiceChart installation folder.
Download and installation
The easiest way for Lazarus users is to get the package from the Online Package Manager (OPM) which is installed with newer Lazarus versions. Simply open its menu item, check "NiceChart" in the tree list, and click "Install". Then OPM will take care of the download and the installation.
Since the OPM version may not always be up-to-date, you can also download the development version from the "Lazarus Component and Code Repository" (CCR) where a zipped snapshot is provided (https://sourceforge.net/p/lazarus-ccr/svn/HEAD/tree/components/nicechart/)) Alternatively, if you use SVN you can use the following SVN command in a console window:
svn checkout svn://svn.code.sf.net/p/lazarus-ccr/svn/components/nicechart nicechart
This applies also for Delphi users.
In Lazarus, open the NiceChartLaz.lpk file in the package editor ("Package" > "Open Package File (.lpk)"), click "Use" > "Install", and let the IDE recompile itself.
In Delphi, open NiceChartD7.dpk in the IDE and press the "Install" button. Another package is provided in the download for newer Delphi versions, named NiceChartXE11; although tested under Delphi XE11 (Alexandria) it should work in other Delphi versions as well.
If you switch between several Delphi versions it may be required to delete the .res file of your project.
The component will appear on the priyatna.org component palette tab.
Documentation
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 <bb>EndUpdate</bb> 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 a metafile (WMF) from the chart. This function is useful when you want to save the content of the chart to a file. Not available in the Lazarus version.
procedure`` CopyToClipboard;
Copies the content of the chart to the clipboard. The content can be pasted in any application as a graphic image. Not available in Lazarus.
Properties
These are the 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 grid, or set to False to hide it.
property`` ShowYGrid: Boolean;
Shows or hides vertical grid. Set to True to show the grid, or set to False to hide it.
property`` Title: string;
Specifies title of the chart. You can use a multi-lined 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.
New properties in v2.0
property`` AxisLineWidth: Integer;
Width of the pen (in pixels) used to draw the labelled x and y axes at the bottom and left sides of the chart, respectively.
property`` ShowXAxisLine: boolean;
If set to true, the logical x axis will be drawn as a horizontal line at y=0.
property`` ShowYAxisLine: boolean;
If set to true, the logical y axis will be drawn as a vertical line at x=0.
property`` GridColor: TColor;
Color of the grid lines.
property`` TrickLength: Integer;
Length of the labelled tick marks at the chart axes.
Contacts
Don't hesitate to report any bug or whish to me:
Priyatna Bandung - Indonesia
Note: The http address is no longer available. You may report bugs also in the Lazarus bug tracker for the CCR project.
From the Free Pascal wiki, page "NiceChart", as it stood on 2023-06-25 after a change by Wp, out of the wiki's dump of 2024-05-26. Copyright stays with the author who wrote it, according to the old wiki's Licensing page. If you have concerns about this material, message the admin.
Talk about this page
Nobody has opened a bench for this page yet. Sign in to open one.