Difference between revisions of "TAChart"

From Lazarus wiki
Jump to navigationJump to search
(46 intermediate revisions by 13 users not shown)
Line 2: Line 2:
  
 
=== About ===
 
=== About ===
TAChart is a charting LGPL component for Lazarus (TeeChart like).
+
TAChart is the principal component of a TeeChart-like charting framework for Lazarus offered under an LGPL licence. TeeChart is the charting component installed with recent Delphi versions.
It contains the functions that Philippe Martinole developed for the TeleAuto project and lots
+
 
of changes introduced by Luis Rodrigues while porting the Epanet application from Delphi to Lazarus.
+
It contains functions developed by Philippe Martinole for his TeleAuto project which were revised extensively by Luis Rodrigues when porting the Epanet application from Delphi to Lazarus.
The code was then extensively rewritten, expanded and is now maintained by Alexander Klenin.
+
Alexander Klenin rewrote and expanded much of the code, and is its current maintainer.
  
 
If you have questions, bug reports or feature requests, please post them to the  
 
If you have questions, bug reports or feature requests, please post them to the  
[http://lists.lazarus.freepascal.org/mailman/listinfo Lazarus mailing list].
+
[http://lists.lazarus.freepascal.org/mailman/listinfo Lazarus mailing list]
 +
or [http://www.lazarus.freepascal.org/index.php/board,55.0.html TAChart board of the Lazarus forum].
 +
 
 +
=== Documentation ===
 +
 
 +
Many features of TAChart are demonstrated in examples installed at (Lazarus Install Dir)/components/tachart/demo/. See [[TAChart_Demos|TAChart Demos]] for a short description and screenshots.
 +
 
 +
Some TAChart classes and properties have been provided with FPDoc documentation (accessed via [F1] in the IDE).
 +
 
 +
An overview of most of TAChart's concepts and features can be found in the [[TAChart documentation]].
 +
 
 +
For beginners, the following tutorials may be helpful:
 +
* [[TAChart Tutorial: Getting started]];
 +
* [[TAChart Tutorial: ListChartSource, Logarithmic Axis, Fitting]].
 +
* [[TAChart Tutorial: Userdefined ChartSource]]
 +
* [[TAChart Tutorial: BarSeries]]
 +
* [[TAChart Tutorial: Stacked BarSeries]]
 +
* [[TAChart Tutorial: Dual y axis, Legend]]
 +
* [[TAChart Tutorial: Multiple Panes in one Chart]]
 +
* [[TAChart Tutorial: Function Series]]
 +
* [[TAChart Tutorial: ColorMapSeries, Zooming]]
 +
* [[TAChart Tutorial: Chart Tools]]
 +
* [[TAChart Tutorial: Background design]]
 +
* [[TAChart Runtime FAQ]]
 +
 
 +
The rendering may be improved with another library :
 +
* [[BGRABitmap tutorial TAChart|Rendering with BGRABitmap]].
  
 
=== Features ===
 
=== Features ===
* Pie Series
+
* More than 15 different series, including pie, bar, area, line and point series
* Bar Series
+
* Function series with domain support
* Area Series
+
* No limit to the number of series, points or axes on a graph
* Line Series (can work as Point Series)
+
* Flexible chart sources, including design-time editing, and random, dynamic and database-aware sources.
* Function Series with domain support
 
* Unlimited number of series and points on graph
 
* Flexible chart sources, including design-time editable, random, dynamic and db-aware sources.
 
 
* Graph legend, title and footer
 
* Graph legend, title and footer
* Axis labels and marks, manually set or auto-generated
+
* Axis labels and marks can be set manually or auto-generated
* Arbitrary number of axises per chart
 
 
* Axis inversion, independent scale and offset, logarithmic scale
 
* Axis inversion, independent scale and offset, logarithmic scale
* Interactive zoom
+
* Interactive tools, including zoom, panning and crosshairs
* Reticule or vertical reticule with point measure
+
* Automatic or manual graph limits
* Auto or manual graph limits
 
 
* Smart marks drawing
 
* Smart marks drawing
* Vertical and horizontal lines
+
* Easily extensible with new custom series
* Easily extensible with new graph types
+
* Output to SVG, OpenGL, printer, WMF, [http://www.crossgl.com/aggpas/ AggPas], [[BGRABitmap]], [[fpvectorial]]
 +
* Can be used in non-GUI applications, such as web services
 +
* Being actively developed, see [[TAChart_Roadmap|roadmap]]
  
 
=== Screenshot ===
 
=== Screenshot ===
Line 41: Line 64:
  
 
=== Download ===
 
=== Download ===
The latest stable release can be found on the in the Lazarus SVN repository (The components are on the Chart Tab)
+
The latest stable release can be found in the Lazarus SVN repository (the components are on the Chart Tab in Lazarus).
 
 
The old code developed by Philippe is Here: [http://sourceforge.net/project/showfiles.php?group_id=92177&package_id=177586 Lazarus CCR Files page].
 
 
 
=== Usage ===
 
See included examples in Lazarus source in (Lazarus Install Dir)/components/tachart/demo/
 
 
 
=== Roadmap ===
 
Below is a list of items that would be good to have in TAChart.
 
Some of them are planned for implementation by the current maintainer,
 
others will require patches from interested contributors.
 
 
 
==== Editors ====
 
 
 
* TChartExtent editor
 
* axis index editor
 
* series index list editor
 
* ListSource.DataPoints editor
 
* marks.format/style editor
 
* subcomponent editor
 
** add shortcuts, use actions
 
** convert to grid/checklist, show enabled/active checkboxes
 
** child auto-renaming
 
* bug: series editor hides on double-click: 17077
 
* bug: AV on Delete
 
 
 
==== Axises/Transformations ====
 
 
 
* finish multiaxis
 
** auto-scaling to percent range
 
** non-monotonic (?)
 
** user-defined transform
 
** partial-linear transform (?) partial zoom demo
 
** inverted as transformation (?)
 
** logBase 0 => e ?
 
* finish TIntervalChartSource
 
* various axis marks steps -- logarithmic etc.
 
* "center" aligned axis
 
* test/fix inverted axis
 
* axis.autoscale as a shortcut(?)
 
* axis.DateTimeFormat(?)
 
* axis.Depth
 
* walls
 
 
 
==== Series ====
 
 
 
* 3-d series: pie, bubble, box-and-whiskers(?)
 
* top-down and right-to-left series
 
* Z axis
 
* FuncSeries.AxisIndexX
 
* rotated func series
 
* polar axis and series
 
* moving series between charts
 
* splines
 
* LineStyle -> AxisIndex for TConstantLine (?)
 
* TConstantLine.Source -- use X only
 
* 3-d surface, color-coding & isolines
 
* range bar series
 
* Gantt series (bar.starty, bar.startx, bar.endx)
 
* stacked/donut pie series (?)
 
* labels for stacked series
 
 
 
==== Legend ====
 
 
 
* multiple blocks per legend line
 
* legend line: per point, per stack item
 
* draw pie slices in the legend
 
 
 
==== Tools ====
 
 
 
* userdefined tool
 
* test/fix many charts per toolset
 
* decouple reticule from TChart
 
 
 
==== Optimization ====
 
 
 
* caches
 
** graphpoints
 
** imagepoints
 
** layers/barriers
 
 
 
==== Sources ====
 
 
 
* YList in Marks.Format
 
* calculated sources: range=0 -- from the start, optimization, sliding median
 
* bug: db-source does not auto-refresh after dataset changes (?)
 
 
 
==== Labels ====
 
 
 
* rotated chart title support (? title is multi-line)
 
* frame shapes: rounded rects, ellipses, callouts
 
* fix/improve pie series label positioning
 
* auto-position labels: two-level, generic, GA
 
* free labels (notes)
 
* control label attachment (top, bottom, center, ...)
 
 
 
==== Presentation ====
 
 
 
* striped background
 
* embellishments: antialiasing, gradient, shadow, glow(?)
 
** color->embellishment mapping(?)
 
* transparency
 
* Generic drawer: TCanvas/AggPas/OpenGL
 
* panes
 
* styles: usepen/usebrush, apply to more series, usecolor
 
 
 
==== Other ====
 
 
 
* more documentation
 
* more tests
 
* oscilloscope demo
 
* printing
 
* better icons
 
* lazreport integration
 
* export to pdf/svg
 
* tutorials
 
* wizards
 
 
 
==== Internal ====
 
 
 
* AddSubcomponent => SetParentComponent
 
* extract TSubcomponentClassRegistry
 
  
 
=== See also ===
 
=== See also ===
 +
* [[RingChart and AnalogWatch]]
 +
* [[PlotPanel]]
 +
* [[Comparing_TAChart_with_Delphi's_TeeChart_Standard|Comparing TAChart with Delphi's TeeChart Standard]]
  
* [[RingChart and AnalogWatch]]
+
{{LCL Components}}
  
 +
[[Category:Lazarus]]
 
[[Category:Components]]
 
[[Category:Components]]
 +
[[Category:Graphics]]
 +
[[Category:TAChart]]

Revision as of 19:03, 15 June 2018

Deutsch (de) English (en) español (es) français (fr) português (pt) русский (ru) українська (uk) 中文(中国大陆)‎ (zh_CN)

About

TAChart is the principal component of a TeeChart-like charting framework for Lazarus offered under an LGPL licence. TeeChart is the charting component installed with recent Delphi versions.

It contains functions developed by Philippe Martinole for his TeleAuto project which were revised extensively by Luis Rodrigues when porting the Epanet application from Delphi to Lazarus. Alexander Klenin rewrote and expanded much of the code, and is its current maintainer.

If you have questions, bug reports or feature requests, please post them to the Lazarus mailing list or TAChart board of the Lazarus forum.

Documentation

Many features of TAChart are demonstrated in examples installed at (Lazarus Install Dir)/components/tachart/demo/. See TAChart Demos for a short description and screenshots.

Some TAChart classes and properties have been provided with FPDoc documentation (accessed via [F1] in the IDE).

An overview of most of TAChart's concepts and features can be found in the TAChart documentation.

For beginners, the following tutorials may be helpful:

The rendering may be improved with another library :

Features

  • More than 15 different series, including pie, bar, area, line and point series
  • Function series with domain support
  • No limit to the number of series, points or axes on a graph
  • Flexible chart sources, including design-time editing, and random, dynamic and database-aware sources.
  • Graph legend, title and footer
  • Axis labels and marks can be set manually or auto-generated
  • Axis inversion, independent scale and offset, logarithmic scale
  • Interactive tools, including zoom, panning and crosshairs
  • Automatic or manual graph limits
  • Smart marks drawing
  • Easily extensible with new custom series
  • Output to SVG, OpenGL, printer, WMF, AggPas, BGRABitmap, fpvectorial
  • Can be used in non-GUI applications, such as web services
  • Being actively developed, see roadmap

Screenshot

Here is an example of TAChart displaying a Line Series, Bar Series and Pie Series

tachart.png

Authors

Luís Rodrigues, Philippe Martinole, Alexander Klenin

Download

The latest stable release can be found in the Lazarus SVN repository (the components are on the Chart Tab in Lazarus).

See also


LCL Components
Component Tab Components
Standard TMainMenu • TPopupMenu • TButton • TLabel • TEdit • TMemo • TToggleBox • TCheckBox • TRadioButton • TListBox • TComboBox • TScrollBar • TGroupBox • TRadioGroup • TCheckGroup • TPanel • TFrame • TActionList
Additional TBitBtn • TSpeedButton • TStaticText • TImage • TShape • TBevel • TPaintBox • TNotebook • TLabeledEdit • TSplitter • TTrayIcon • TControlBar • TFlowPanel • TMaskEdit • TCheckListBox • TScrollBox • TApplicationProperties • TStringGrid • TDrawGrid • TPairSplitter • TColorBox • TColorListBox • TValueListEditor
Common Controls TTrackBar • TProgressBar • TTreeView • TListView • TStatusBar • TToolBar • TCoolBar • TUpDown • TPageControl • TTabControl • THeaderControl • TImageList • TPopupNotifier • TDateTimePicker
Dialogs TOpenDialog • TSaveDialog • TSelectDirectoryDialog • TColorDialog • TFontDialog • TFindDialog • TReplaceDialog • TTaskDialog • TOpenPictureDialog • TSavePictureDialog • TCalendarDialog • TCalculatorDialog • TPrinterSetupDialog • TPrintDialog • TPageSetupDialog
Data Controls TDBNavigator • TDBText • TDBEdit • TDBMemo • TDBImage • TDBListBox • TDBLookupListBox • TDBComboBox • TDBLookupComboBox • TDBCheckBox • TDBRadioGroup • TDBCalendar • TDBGroupBox • TDBGrid • TDBDateTimePicker
Data Access TDataSource • TCSVDataSet • TSdfDataSet • TBufDataset • TFixedFormatDataSet • TDbf • TMemDataset
System TTimer • TIdleTimer • TLazComponentQueue • THTMLHelpDatabase • THTMLBrowserHelpViewer • TAsyncProcess • TProcessUTF8 • TProcess • TSimpleIPCClient • TSimpleIPCServer • TXMLConfig • TEventLog • TServiceManager • TCHMHelpDatabase • TLHelpConnector
Misc TColorButton • TSpinEdit • TFloatSpinEdit • TArrow • TCalendar • TEditButton • TFileNameEdit • TDirectoryEdit • TDateEdit • TTimeEdit • TCalcEdit • TFileListBox • TFilterComboBox • TComboBoxEx • TCheckComboBox • TButtonPanel • TShellTreeView • TShellListView • TXMLPropStorage • TINIPropStorage • TJSONPropStorage • TIDEDialogLayoutStorage • TMRUManager • TStrHolder
LazControls TCheckBoxThemed • TDividerBevel • TExtendedNotebook • TListFilterEdit • TListViewFilterEdit • TLvlGraphControl • TShortPathEdit • TSpinEditEx • TFloatSpinEditEx • TTreeFilterEdit • TExtendedTabControl •
RTTI TTIEdit • TTIComboBox • TTIButton • TTICheckBox • TTILabel • TTIGroupBox • TTIRadioGroup • TTICheckGroup • TTICheckListBox • TTIListBox • TTIMemo • TTICalendar • TTIImage • TTIFloatSpinEdit • TTISpinEdit • TTITrackBar • TTIProgressBar • TTIMaskEdit • TTIColorButton • TMultiPropertyLink • TTIPropertyGrid • TTIGrid
SQLdb TSQLQuery • TSQLTransaction • TSQLScript • TSQLConnector • TMSSQLConnection • TSybaseConnection • TPQConnection • TPQTEventMonitor • TOracleConnection • TODBCConnection • TMySQL40Connection • TMySQL41Connection • TMySQL50Connection • TMySQL51Connection • TMySQL55Connection • TMySQL56Connection • TMySQL57Connection • TSQLite3Connection • TIBConnection • TFBAdmin • TFBEventMonitor • TSQLDBLibraryLoader
Pascal Script TPSScript • TPSScriptDebugger • TPSDllPlugin • TPSImport_Classes • TPSImport_DateUtils • TPSImport_ComObj • TPSImport_DB • TPSImport_Forms • TPSImport_Controls • TPSImport_StdCtrls • TPSCustomPlugin
SynEdit TSynEdit • TSynCompletion • TSynAutoComplete • TSynMacroRecorder • TSynExporterHTML • TSynPluginSyncroEdit • TSynPasSyn • TSynFreePascalSyn • TSynCppSyn • TSynJavaSyn • TSynPerlSyn • TSynHTMLSyn • TSynXMLSyn • TSynLFMSyn • TSynDiffSyn • TSynUNIXShellScriptSyn • TSynCssSyn • TSynPHPSyn • TSynTeXSyn • TSynSQLSyn • TSynPythonSyn • TSynVBSyn • TSynAnySyn • TSynMultiSyn • TSynBatSyn • TSynIniSyn • TSynPoSyn
Chart TChart • TListChartSource • TRandomChartSource • TUserDefinedChartSource • TCalculatedChartSource • TDbChartSource • TChartToolset • TChartAxisTransformations • TChartStyles • TChartLegendPanel • TChartNavScrollBar • TChartNavPanel • TIntervalChartSource • TDateTimeIntervalChartSource • TChartListBox • TChartExtentLink • TChartImageList
IPro TIpFileDataProvider • TIpHtmlDataProvider • TIpHttpDataProvider • TIpHtmlPanel
Virtual Controls TVirtualDrawTree • TVirtualStringTree • TVTHeaderPopupMenu