vtkChart.h

Go to the documentation of this file.

/*=========================================================================

  Program:   Visualization Toolkit
  Module:    vtkChart.h

  Copyright (c) Ken Martin, Will Schroeder, Bill Lorensen
  All rights reserved.
  See Copyright.txt or http://www.kitware.com/Copyright.htm for details.

     This software is distributed WITHOUT ANY WARRANTY; without even
     the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
     PURPOSE.  See the above copyright notice for more information.

=========================================================================*/

#ifndef vtkChart_h
#define vtkChart_h

#include "vtkChartsCoreModule.h" // For export macro
#include "vtkContextItem.h"
#include "vtkRect.h"         // For vtkRectf
#include "vtkStdString.h"    // For vtkStdString ivars
#include "vtkSmartPointer.h" // For SP ivars

class vtkTransform2D;
class vtkContextScene;
class vtkPlot;
class vtkAxis;
class vtkBrush;
class vtkTextProperty;
class vtkChartLegend;

class vtkInteractorStyle;
class vtkAnnotationLink;

class VTKCHARTSCORE_EXPORT vtkChart : public vtkContextItem
{
public:
  vtkTypeMacro(vtkChart, vtkContextItem);
  virtual void PrintSelf(ostream &os, vtkIndent indent);

  enum {
    LINE,
    POINTS,
    BAR,
    STACKED,
    BAG,
    FUNCTIONALBAG,
    AREA};

  enum {
    PAN = 0,
    ZOOM,
    ZOOM_AXIS,
    SELECT,
    SELECT_RECTANGLE = SELECT,
    SELECT_POLYGON,
    NOTIFY
  };

  enum EventIds {
    UpdateRange = 1002
  };

  virtual bool Paint(vtkContext2D *painter) = 0;

  virtual vtkPlot* AddPlot(int type);

  virtual vtkIdType AddPlot(vtkPlot* plot);

  virtual bool RemovePlot(vtkIdType index);

  virtual bool RemovePlotInstance(vtkPlot* plot);

  virtual void ClearPlots();

  virtual vtkPlot* GetPlot(vtkIdType index);

  virtual vtkIdType GetNumberOfPlots();

  virtual vtkAxis* GetAxis(int axisIndex);

  virtual vtkIdType GetNumberOfAxes();

  virtual void RecalculateBounds();

  enum {
    SELECTION_ROWS,
    SELECTION_PLOTS,
    SELECTION_COLUMNS
  };


  virtual void SetSelectionMethod(int method);
  virtual int GetSelectionMethod();

  virtual void SetAnnotationLink(vtkAnnotationLink *link);


  vtkGetObjectMacro(AnnotationLink, vtkAnnotationLink);


  vtkSetVector2Macro(Geometry, int);
  vtkGetVector2Macro(Geometry, int);


  vtkSetVector2Macro(Point1, int);
  vtkGetVector2Macro(Point1, int);


  vtkSetVector2Macro(Point2, int);
  vtkGetVector2Macro(Point2, int);


  virtual void SetShowLegend(bool visible);
  virtual bool GetShowLegend();

  virtual vtkChartLegend * GetLegend();


  virtual void SetTitle(const vtkStdString &title);
  virtual vtkStdString GetTitle();


  vtkGetObjectMacro(TitleProperties, vtkTextProperty);


  void SetBottomBorder(int border);
  void SetTopBorder(int border);
  void SetLeftBorder(int border);
  void SetRightBorder(int border);

  void SetBorders(int left, int bottom, int right, int top);

  void SetSize(const vtkRectf &rect);

  vtkRectf GetSize();

  enum {
    FILL_SCENE,  // Attempt to fill the entire scene.
    FILL_RECT,   // Attempt to supply the supplied vtkRectf in Size.
    AXES_TO_RECT // Put the corners of the axes on the vtkRectf in Size.
  };


  vtkSetMacro(LayoutStrategy, int);
  vtkGetMacro(LayoutStrategy, int);


  virtual void SetAutoSize(bool isAutoSized)
  {
    this->LayoutStrategy = isAutoSized ? vtkChart::FILL_SCENE :
                                         vtkChart::FILL_RECT;
  }
  virtual bool GetAutoSize()
  {
    return this->LayoutStrategy == vtkChart::FILL_SCENE ? true : false;
  }


  vtkSetMacro(RenderEmpty, bool);
  vtkGetMacro(RenderEmpty, bool);

  virtual void SetActionToButton(int action, int button);

  virtual int GetActionToButton(int action);

  virtual void SetClickActionToButton(int action, int button);

  virtual int GetClickActionToButton(int action);


  void SetBackgroundBrush(vtkBrush *brush);
  vtkBrush* GetBackgroundBrush();


  virtual void SetSelectionMode(int);
  vtkGetMacro(SelectionMode, int);

protected:
  vtkChart();
  ~vtkChart();

  bool CalculatePlotTransform(vtkAxis *x, vtkAxis *y,
                              vtkTransform2D *transform);

  bool CalculateUnscaledPlotTransform(vtkAxis *x, vtkAxis *y,
                                      vtkTransform2D *transform);

  void AttachAxisRangeListener(vtkAxis*);

  void AxisRangeForwarderCallback(vtkObject*,unsigned long, void*);

  vtkAnnotationLink *AnnotationLink;

  int Geometry[2];

  int Point1[2];

  int Point2[2];

  bool ShowLegend;

  vtkStdString Title;

  vtkTextProperty* TitleProperties;

  vtkRectf Size;
  // The layout strategy to employ when fitting the chart into the space.
  int LayoutStrategy;
  bool RenderEmpty;

  vtkSmartPointer<vtkBrush> BackgroundBrush;

  // The mode when the chart is doing selection.
  int SelectionMode;

  // How plot selections are handled, SELECTION_ROWS (default) or
  // SELECTION_PLOTS - based on the plot that created the selection.
  int SelectionMethod;


  class MouseActions
  {
  public:
    MouseActions();
    enum { MaxAction = 5 };
    short& Pan() { return Data[0]; }
    short& Zoom() { return Data[1]; }
    short& ZoomAxis() { return Data[2]; }
    short& Select() { return Data[3]; }
    short& SelectPolygon() { return Data[4]; }
    short& operator[](int index) { return Data[index]; }
    short Data[MaxAction];
  };
  class MouseClickActions
  {
  public:
    MouseClickActions();
    short& Notify() { return Data[0]; }
    short& Select() { return Data[1]; }
    short& operator[](int index) { return Data[index]; }
    short Data[2];
  };

  MouseActions Actions;
  MouseClickActions ActionsClick;

private:
  vtkChart(const vtkChart &) VTK_DELETE_FUNCTION;
  void operator=(const vtkChart &) VTK_DELETE_FUNCTION;
};

#endif //vtkChart_h