Click here to Skip to main content
15,860,859 members
Articles / Desktop Programming / MFC
Article

Scientific charting control

Rate me:
Please Sign up or sign in to vote.
4.84/5 (122 votes)
17 Jan 20055 min read 1.3M   42.6K   405   380
Multi-purpose scientific charting control.

Image 1

Image 2

Image 3

Introduction

Displaying large amounts of technical data in a chart can be a frustrating task. You can find tons of charting controls with fancy effects and useless features, but when it comes to displaying many curves at once, independently scaled on different axes, most of them fail. Maybe CXGraph is the solution:

CXGraph can display unlimited series of data on multiple axes.

The documentation is sparse, because I do not have the time to write documentation. However, the included demo is hopefully a help in understanding how to use the control.

Features

  • unlimited data series
  • unlimited axes (your monitor is the limit)
  • logarithmic scales
  • autoscaling
  • automatic/manual axis placement
  • nearly every visual aspect can be customized
  • legends
  • bitmaps
  • cursor (add data notation marks by clicking)
  • zoom
  • pan
  • color ranges
  • object selection with the mouse
  • linear trend
  • cubic trend
  • nth order polynomial trend
  • data notation marks
  • moving average (simple, linear, sine-weighted ...)
  • property persistence (save and load properties, data and axes)
  • Support for Windows CE
  • axis markers
  • UNICODE support
  • polygon filling between curves
  • cursor synchronization
  • data editing
  • measuring mode

Classes

CXGraph

CXGraphDataSerie& SetData(TDataPoint* pValues, long nCount, int nCurve, int nXAxis, int nYAxis, bool bAutoDelete)Adds/sets a data series.
CXGraphAxis& GetXAxis(int nAxis)Returns reference to specified X-axis.
CXGraphAxis& GetYAxis(int nAxis)Returns reference to specified y-axis.
CXGraphDataSerie& GetCurve(int nCurve)Returns reference to specified curve.
bool SelectCurve(int nCurve)Selects the specified curve.
bool SelectXAxis(int nAxis)Selects the specified x-axis.
bool SelectYAxis(int nAxis)Selects the specified y-axis.
int GetXAxisCount()Returns x-axis count.
int GetYAxisCount()Returns y-axis count.
int GetCurveCount()Returns curve count.
void Zoom()Zoom-mode. User can zoom into the graph with the mouse.
void ResetZoom()Resets all axes to optimal values.
void Pan()Pan-mode. User can pan the graph with the mouse.
void NoOp()Select-mode. User can select objects with the mouse.
void Cursor()Cursor-mode. A cursor is being displayed showing the values at the current mouse position.
void Measure()Measuring mode. User can measure the distance between two data points.
void Edit()Editing mode. User can edit the curve data.
CXGraphLabel& InsertLabel(CString cText)Inserts a text-label. Returns reference to a CXGraphLabel object.
void PrintGraph(CDC *pDC)Prints the graph.
void SetBackColor(COLORREF color)Sets the chart's backcolor.
void SetGraphColor(COLORREF color)Sets the chart's exterior color.
void SetInnerColor(COLORREF color)Sets the chart's interior color.
void SetDoubleBuffer(bool bValue)Sets double buffering on/off.
void SetShowLegend(bool bValue)Sets legend display on/off.
void SetLegendAlignment(EAlignment align)Sets the legend alignment (left, right).
void SetSnapCursor(bool bValue)Sets snap cursor mode (on/off).
void SetInteraction(bool bValue)Enable/disable interaction.
bool GetInteraction()
void SetSnapRange(int nValue)Sets snap cursor range.
bool Save(const CString cFile, UINT nFlags)

Stores chart properties, data and axes. Use one or more of the following values to specify what to be stored:

  • PERSIST_PROPERTIES: store chart properties.
  • PERSIST_DATA: store chart data and axes.
  • PERSIST_OBJECTS: store chart objects (labels, ...).
bool Load(const CString cFile)Loads chart properties, data and axes.
bool SaveBitmap(const CString cFile)Saves the chart as bitmap.
bool DeleteCurve(int nCurve)Deletes the specified curve.
bool DeleteYAxis(int nAxis)Removes the specified y-axis.
bool DeleteXAxis(int nAxis)Removes the specified x-axis.
int GetZoomDepth()Determines the zoom depth (history).
void RestoreLastZoom()Restores the last zoom stage.
void SetBackgroundBitmap(CBitmap* pBitmap, UINT nFlags)Sets a background image.
void InsertBitmap(CRect rect, CBitmapEx* pBitmap)Inserts a bitmap-object.

CXGraphLabel

SetFont(LOGFONT* pLogFont)Sets the label's font.
SetText(CString cText)Sets the label's text.
SetColor(COLORREF color)Sets the label's background color.
SetTextColor(COLORREF color)Sets the label's text color.
SetBorder(bool bValue)Sets the label's border.
SetTransparent(bool bValue)Sets the label's transparency.
SetAlignment(UINT nValue)Sets the label's text alignment.
SetCurve(int nCurve)Links the label to the specified curve.
CString GetText()Returns the label's text.
COLORREF GetColor()Returns the label's background color.
COLORREF GetTextColor()Returns the label's text color.
bool GetBorder()Returns true if label has a border, otherwise false.
bool GetTransparent()Returns true if label is transparent. otherwise false.
UINT GetAlignment()Returns the label's text alignment.
int GetCurve()Returns the label's associated curve (or -1 if not associated).

CXGraphAxis

See source code

CXGraphDataSerie

See source code

Notifications

  • XG_YAXISCLICK
  • XG_XAXISCLICK
  • XG_CURVECLICK
  • XG_YAXISDBLCLICK
  • XG_XAXISDBLCLICK
  • XG_CURVEDBLCLICK
  • XG_GRAPHDBLCLICK
  • XG_RBUTTONUP
  • XG_CURSORMOVED

Usage

To use this control in your own application, add XGraph10.lib to your project and make sure XGraph10.dll is accessible. Create an instance of CXGraph and call Create on it. Take a look at the sample application for further details.

Credits

  • James White - Color button.
  • Chris Maunder, Alexander Bischofberger - Color popup.
  • Dennis Crain (MSDN) - Routines for line-hit testing.
  • Keith Rule - CMemDC.
  • Ishay Sivan (bug fixing).
  • Pavel Klocek (bug fixing).
  • J.G. Hattingh (parts of Device Context Utilities).
  • Jörg Blattner (bug fixing, improvements).

History & Bug fixes

DateVersionComment
21 Mar 20021.00
  • First release.
25 Mar 20021.01
  • Fixed DateTime-bug in cursor mode.
  • Fixed crash when adding trend or moving average.
17 Apr 20021.02
  • Panning in cursor mode added.
  • Added support for very large and very small numbers.
  • Values greater/less than 10E6/10E-6 are now automatically shown in exponential format.
  • Completely redesigned autoscaling (only for normal axes, DateTime types follow).
  • Added data notation marks.
  • Added Get/Set member functions.
  • Added nth-order-polynomial trend.
20 Sep 20021.03
  • Now compiles under VC7.
  • Load/save for properties/data/object persistence.
  • Lots of bug fixes.
20 Nov 20031.04
  • Added Unicode support.
  • Fixed crash when resizing chart to small dimensions.
  • Corrected tab-order in property pages.
  • Added background bitmaps.
  • Added gradient color ranges.
  • Added axis markers.
  • Added bitmap objects.
13 Jan 20051.05
  • Added support for Windows CE (needs improvement).
  • Logarithmic axes (thanks to ...).
  • Added polygon filling between two curves.
  • Several bugs fixed by Joerg Blattner.
  • Added Cursor-Synchronization.
  • Curve editing mode.
  • Measuring mode.

Known issues

  • Clipping in print preview still doesn't work.

License

This article has no explicit license attached to it but may contain usage terms in the article text or the download files themselves. If in doubt please contact the author via the discussion board below.

A list of licenses authors might use can be found here


Written By
Web Developer
Germany Germany
This member has not yet provided a Biography. Assume it's interesting and varied, and probably something to do with programming.

Comments and Discussions

 
GeneralThe problem of OnPaint() in XGraph.cpp Pin
Paul_Yang2410-Jul-06 2:55
Paul_Yang2410-Jul-06 2:55 
Question"OnLButtonDblClk " do not work? Pin
zhys6-Jul-06 1:08
zhys6-Jul-06 1:08 
Generalbug found:marker & curve not matched. Pin
jingtaozf22-Jun-06 17:25
jingtaozf22-Jun-06 17:25 
GeneralRe: bug found:marker & curve not matched. Pin
jingtaozf22-Jun-06 17:26
jingtaozf22-Jun-06 17:26 
GeneralSome bugs [modified] Pin
MarsV4-Jun-06 16:39
MarsV4-Jun-06 16:39 
Generalmissing xgraph10d.dll Pin
hello_angel24-May-06 5:55
hello_angel24-May-06 5:55 
GeneralRe: missing xgraph10d.dll Pin
MarsV30-May-06 17:45
MarsV30-May-06 17:45 
GeneralRe: missing xgraph10d.dll Pin
bruno leclerc30-Sep-06 7:39
bruno leclerc30-Sep-06 7:39 
GeneralRe: missing xgraph10d.dll Pin
bruno leclerc30-Sep-06 22:37
bruno leclerc30-Sep-06 22:37 
QuestionHow to make X-Label support time format? Pin
SAMZC16-Apr-06 18:10
SAMZC16-Apr-06 18:10 
GeneralDebug Dll Pin
NichEdgington14-Apr-06 5:40
NichEdgington14-Apr-06 5:40 
GeneralXGraphdemo use XGraph release dll error happened Pin
supportyou22-Mar-06 16:36
supportyou22-Mar-06 16:36 
GeneralXGraphdemo to use XGraph release dll Pin
supportyou22-Mar-06 16:35
supportyou22-Mar-06 16:35 
GeneralAutoscale Pin
Rene Desgagnes2-Mar-06 9:22
Rene Desgagnes2-Mar-06 9:22 
GeneralVS2005 Pin
BlueScoo24-Feb-06 11:08
BlueScoo24-Feb-06 11:08 
GeneralRe: VS2005 Pin
alexsurkov16-Apr-06 23:13
alexsurkov16-Apr-06 23:13 
GeneralPrint & PrintPreView Pin
soft_raider15-Feb-06 23:55
professionalsoft_raider15-Feb-06 23:55 
GeneralNew to VC Pin
Balmark_130-Jan-06 1:14
Balmark_130-Jan-06 1:14 
Questionis there update on this project???? Pin
SAMZC8-Jan-06 17:18
SAMZC8-Jan-06 17:18 
AnswerRealyy expect more update on this project. But seems no any improvement from the author. :( :( :( Pin
SAMZC9-Mar-06 18:45
SAMZC9-Mar-06 18:45 
QuestionGraphs not plotting in color Pin
satishmirle1-Jan-06 14:03
satishmirle1-Jan-06 14:03 
AnswerRe: Graphs not plotting in color Pin
haibo280628-Dec-10 6:32
haibo280628-Dec-10 6:32 
QuestionBitmap functions Pin
soft_raider30-Nov-05 0:25
professionalsoft_raider30-Nov-05 0:25 
AnswerRe: Bitmap functions Pin
soft_raider30-Nov-05 21:38
professionalsoft_raider30-Nov-05 21:38 
GeneralI want to use this chart as a trend please help me Pin
gsheladia9-Nov-05 17:58
gsheladia9-Nov-05 17:58 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Praise Praise    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.