VTK
vtkChartXY.h
Go to the documentation of this file.
1 /*=========================================================================
2 
3  Program: Visualization Toolkit
4  Module: vtkChartXY.h
5 
6  Copyright (c) Ken Martin, Will Schroeder, Bill Lorensen
7  All rights reserved.
8  See Copyright.txt or http://www.kitware.com/Copyright.htm for details.
9 
10  This software is distributed WITHOUT ANY WARRANTY; without even
11  the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
12  PURPOSE. See the above copyright notice for more information.
13 
14 =========================================================================*/
15 
33 #ifndef vtkChartXY_h
34 #define vtkChartXY_h
35 
36 #include "vtkChartsCoreModule.h" // For export macro
37 #include "vtkChart.h"
38 #include "vtkSmartPointer.h" // For SP ivars
39 #include "vtkVector.h" // For vtkVector2f in struct
40 #include "vtkContextPolygon.h" // For vtkContextPolygon
41 
42 class vtkPlot;
43 class vtkAxis;
44 class vtkPlotGrid;
45 class vtkChartLegend;
46 class vtkTooltipItem;
47 class vtkChartXYPrivate; // Private class to keep my STL vector in...
48 
49 class VTKCHARTSCORE_EXPORT vtkChartXY : public vtkChart
50 {
51 public:
52  vtkTypeMacro(vtkChartXY, vtkChart);
53  virtual void PrintSelf(ostream &os, vtkIndent indent);
54 
58  static vtkChartXY *New();
59 
65  virtual void Update();
66 
70  virtual bool Paint(vtkContext2D *painter);
71 
75  virtual vtkPlot * AddPlot(int type);
76 
80  virtual vtkIdType AddPlot(vtkPlot* plot);
81 
86  virtual bool RemovePlot(vtkIdType index);
87 
91  virtual void ClearPlots();
92 
96  virtual vtkPlot* GetPlot(vtkIdType index);
97 
102  virtual vtkIdType GetPlotIndex(vtkPlot*);
103 
109  vtkIdType RaisePlot(vtkPlot* plot);
110 
117  virtual vtkIdType StackPlotAbove(vtkPlot* plot, vtkPlot* under);
118 
124  vtkIdType LowerPlot(vtkPlot* plot);
125 
132  virtual vtkIdType StackPlotUnder(vtkPlot* plot, vtkPlot* above);
133 
137  virtual vtkIdType GetNumberOfPlots();
138 
142  int GetPlotCorner(vtkPlot *plot);
143 
147  void SetPlotCorner(vtkPlot *plot, int corner);
148 
154  virtual vtkAxis* GetAxis(int axisIndex);
155 
159  virtual void SetShowLegend(bool visible);
160 
164  virtual vtkChartLegend* GetLegend();
165 
169  virtual void SetTooltip(vtkTooltipItem *tooltip);
170 
174  virtual vtkTooltipItem* GetTooltip();
175 
179  virtual vtkIdType GetNumberOfAxes();
180 
185  virtual void RecalculateBounds();
186 
194  virtual void SetSelectionMethod(int method);
195 
197 
200  vtkSetMacro(DrawAxesAtOrigin, bool);
201  vtkGetMacro(DrawAxesAtOrigin, bool);
202  vtkBooleanMacro(DrawAxesAtOrigin, bool);
204 
206 
210  vtkSetMacro(AutoAxes, bool);
211  vtkGetMacro(AutoAxes, bool);
212  vtkBooleanMacro(AutoAxes, bool);
214 
216 
219  vtkSetMacro(HiddenAxisBorder, int);
220  vtkGetMacro(HiddenAxisBorder, int);
222 
224 
229  vtkSetMacro(ForceAxesToBounds, bool);
230  vtkGetMacro(ForceAxesToBounds, bool);
231  vtkBooleanMacro(ForceAxesToBounds, bool);
233 
235 
242  vtkSetMacro(BarWidthFraction, float);
243  vtkGetMacro(BarWidthFraction, float);
245 
247 
253  vtkSetMacro(ZoomWithMouseWheel, bool);
254  vtkGetMacro(ZoomWithMouseWheel, bool);
255  vtkBooleanMacro(ZoomWithMouseWheel, bool);
257 
259 
264  vtkSetMacro(AdjustLowerBoundForLogPlot, bool);
265  vtkGetMacro(AdjustLowerBoundForLogPlot, bool);
266  vtkBooleanMacro(AdjustLowerBoundForLogPlot, bool);
268 
272  virtual void SetTooltipInfo(const vtkContextMouseEvent &,
273  const vtkVector2d &,
274  vtkIdType, vtkPlot*,
275  vtkIdType segmentIndex = -1);
276 
280  virtual bool Hit(const vtkContextMouseEvent &mouse);
281 
285  virtual bool MouseEnterEvent(const vtkContextMouseEvent &mouse);
286 
290  virtual bool MouseMoveEvent(const vtkContextMouseEvent &mouse);
291 
295  virtual bool MouseLeaveEvent(const vtkContextMouseEvent &mouse);
296 
300  virtual bool MouseButtonPressEvent(const vtkContextMouseEvent &mouse);
301 
305  virtual bool MouseButtonReleaseEvent(const vtkContextMouseEvent &mouse);
306 
310  virtual bool MouseWheelEvent(const vtkContextMouseEvent &mouse, int delta);
311 
315  virtual bool KeyPressEvent(const vtkContextKeyEvent &key);
316 
317 protected:
318  vtkChartXY();
319  ~vtkChartXY();
320 
324  void RecalculatePlotTransforms();
325 
330  void RecalculatePlotBounds();
331 
337  virtual bool UpdateLayout(vtkContext2D* painter);
338 
344  virtual int GetLegendBorder(vtkContext2D* painter, int axisPosition);
345 
350  virtual void SetLegendPosition(const vtkRectf& rect);
351 
356 
361 
366 
371 
375  bool DrawBox;
376 
382 
387 
392 
399 
403  bool AutoAxes;
404 
409 
415 
421 
428 
434 
440 
441 private:
442  vtkChartXY(const vtkChartXY &) VTK_DELETE_FUNCTION;
443  void operator=(const vtkChartXY &) VTK_DELETE_FUNCTION;
444 
445  vtkChartXYPrivate *ChartPrivate; // Private class where I hide my STL containers
446 
450  void CalculateBarPlots();
451 
457  bool LocatePointInPlots(const vtkContextMouseEvent &mouse,
458  int invokeEvent = -1);
459 
460  int LocatePointInPlot(const vtkVector2f &position,
461  const vtkVector2f &tolerance, vtkVector2f &plotPos,
462  vtkPlot *plot, vtkIdType &segmentIndex);
463 
467  bool RemovePlotFromCorners(vtkPlot *plot);
468 
469  void ZoomInAxes(vtkAxis *x, vtkAxis *y, float *orign, float *max);
470 
474  void TransformBoxOrPolygon(bool polygonMode, vtkTransform2D *transform,
475  const vtkVector2f &mousePosition,
476  vtkVector2f &min, vtkVector2f &max,
477  vtkContextPolygon &polygon);
478 
479 };
480 
482 
488 {
492  int Index;
493 };
495 
496 #endif //vtkChartXY_h
bool DrawAxesAtOrigin
Keep the axes drawn at the origin? This will attempt to keep the axes drawn at the origin...
Definition: vtkChartXY.h:398
Wrapper around std::string to keep symbols short.
Definition: vtkStdString.h:47
data structure to represent key events.
virtual void SetShowLegend(bool visible)
Set/get whether the chart should draw a legend.
virtual bool MouseButtonPressEvent(const vtkContextMouseEvent &mouse)
Mouse button down event Return true if the item holds the event, false if the event can be propagated...
bool AdjustLowerBoundForLogPlot
Property to adjust the minimum of a logarithmic axis to be greater than 0, regardless of the minimum ...
Definition: vtkChartXY.h:439
vtkContextPolygon SelectionPolygon
The polygon created as the mouse is dragged around the screen when in polygonal selection mode...
Definition: vtkChartXY.h:381
virtual vtkIdType GetNumberOfAxes()
Get the number of axes in the current chart.
bool ForceAxesToBounds
Property to force the axes to have their Minimum and Maximum properties inside the plot boundaries...
Definition: vtkChartXY.h:427
virtual void RecalculateBounds()
Request that the chart recalculates the range of its axes.
virtual void PrintSelf(ostream &os, vtkIndent indent)
Methods invoked by print to print information about the object including superclasses.
int vtkIdType
Definition: vtkType.h:287
int HiddenAxisBorder
Size of the border when an axis is hidden.
Definition: vtkChartXY.h:408
bool DrawSelectionPolygon
Should the selection polygon be drawn.
Definition: vtkChartXY.h:386
vtkRectf MouseBox
The box created as the mouse is dragged around the screen.
Definition: vtkChartXY.h:370
vtkStdString SeriesName
Definition: vtkChartXY.h:489
virtual void ClearPlots()
Remove all plots from the chart.
Class for drawing 2D primitives to a graphical context.
Definition: vtkContext2D.h:57
Factory class for drawing 2D charts.
Definition: vtkChart.h:50
virtual bool RemovePlot(vtkIdType index)
Remove the plot at the specified index, returns true if successful, false if the index was invalid...
virtual bool MouseWheelEvent(const vtkContextMouseEvent &mouse, int delta)
Mouse wheel event, positive delta indicates forward movement of the wheel.
takes care of drawing 2D axes
Definition: vtkAxis.h:71
data structure to represent mouse events.
vtkVector2i ScreenPosition
Definition: vtkChartXY.h:491
virtual vtkChartLegend * GetLegend()
Get the legend for the chart, if available.
a simple class to control print indentation
Definition: vtkIndent.h:39
bool DrawBox
Should the box be drawn (could be selection, zoom etc).
Definition: vtkChartXY.h:375
Some derived classes for the different vectors commonly used.
Definition: vtkVector.h:327
virtual bool MouseButtonReleaseEvent(const vtkContextMouseEvent &mouse)
Mouse button release event.
virtual vtkIdType GetNumberOfPlots()
Get the number of plots the chart contains.
describes linear transformations via a 3x3 matrix
Abstract class for 2D plots.
Definition: vtkPlot.h:52
vtkVector2f Position
Definition: vtkChartXY.h:490
virtual bool KeyPressEvent(const vtkContextKeyEvent &key)
Key press event.
vtkSmartPointer< vtkChartLegend > Legend
The legend for the chart.
Definition: vtkChartXY.h:355
virtual bool MouseEnterEvent(const vtkContextMouseEvent &mouse)
Mouse enter event.
vtkSetMacro(IgnoreDriverBugs, bool)
When set known driver bugs are ignored during driver feature detection.
Factory class for drawing XY charts.
Definition: vtkChartXY.h:49
draw the chart legend
virtual bool Paint(vtkContext2D *painter)=0
Paint event for the chart, called whenever the chart needs to be drawn.
Small struct used by InvokeEvent to send some information about the point that was clicked on...
Definition: vtkChartXY.h:487
virtual bool MouseMoveEvent(const vtkContextMouseEvent &mouse)
Mouse move event.
takes care of drawing the plot grid
Definition: vtkPlotGrid.h:38
virtual bool Hit(const vtkContextMouseEvent &mouse)
Return true if the supplied x, y coordinate is inside the item.
virtual vtkPlot * GetPlot(vtkIdType index)
Get the plot at the specified index, returns null if the index is invalid.
bool LayoutChanged
Indicate if the layout has changed in some way that would require layout code to be called...
Definition: vtkChartXY.h:420
bool ZoomWithMouseWheel
Property to enable zooming the chart with the mouse wheel.
Definition: vtkChartXY.h:433
takes care of drawing 2D axes
vtkBooleanMacro(IgnoreDriverBugs, bool)
When set known driver bugs are ignored during driver feature detection.
bool AutoAxes
Should axes be turned on and off automatically - defaults to on.
Definition: vtkChartXY.h:403
static vtkObject * New()
Create an object with Debug turned off, modified time initialized to zero, and reference counting on...
vtkSmartPointer< vtkTooltipItem > Tooltip
The tooltip item for the chart - can be used to display extra information.
Definition: vtkChartXY.h:360
float BarWidthFraction
The fraction of the interval taken up along the x axis by any bars that are drawn on the chart...
Definition: vtkChartXY.h:414
virtual void SetSelectionMethod(int method)
Set the selection method, which controls how selections are handled by the chart. ...
virtual void Update()
Perform any updates to the item that may be necessary before rendering.
virtual bool MouseLeaveEvent(const vtkContextMouseEvent &mouse)
Mouse leave event.
virtual vtkPlot * AddPlot(int type)
Add a plot to the chart, defaults to using the name of the y column.
#define max(a, b)
virtual vtkAxis * GetAxis(int axisIndex)
Get the axis specified by axisIndex.
bool DrawNearestPoint
Should we draw the location of the nearest point on the plot?
Definition: vtkChartXY.h:391
bool PlotTransformValid
Does the plot area transform need to be recalculated?
Definition: vtkChartXY.h:365