dox/Charts/vtkAxis.h

Go to the documentation of this file.

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

  Program:   Visualization Toolkit
  Module:    vtkAxis.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 __vtkAxis_h
#define __vtkAxis_h

#include "vtkContextItem.h"
#include "vtkSmartPointer.h" // For vtkSmartPointer

class vtkContext2D;
class vtkPen;
class vtkFloatArray;
class vtkDoubleArray;
class vtkStringArray;
class vtkTextProperty;

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

//BTX

  enum {
    LEFT = 0,
    BOTTOM,
    RIGHT,
    TOP,
    PARALLEL
  };
//ETX

  static vtkAxis *New();


  vtkSetMacro(Position, int);
  vtkGetMacro(Position, int);


  vtkSetVector2Macro(Point1, float);


  vtkGetVector2Macro(Point1, float);


  vtkSetVector2Macro(Point2, float);


  vtkGetVector2Macro(Point2, float);


  vtkSetMacro(NumberOfTicks, int);


  vtkGetMacro(NumberOfTicks, int);


  vtkGetObjectMacro(LabelProperties, vtkTextProperty);

  virtual void SetMinimum(double minimum);


  vtkGetMacro(Minimum, double);

  virtual void SetMaximum(double maximum);


  vtkGetMacro(Maximum, double);

  virtual void SetRange(double minimum, double maximum);


  vtkSetStringMacro(Title);
  vtkGetStringMacro(Title);


  vtkGetObjectMacro(TitleProperties, vtkTextProperty);


  vtkSetMacro(LogScale, bool);
  vtkGetMacro(LogScale, bool);


  vtkSetMacro(GridVisible, bool);
  vtkGetMacro(GridVisible, bool);


  vtkSetMacro(LabelsVisible, bool);
  vtkGetMacro(LabelsVisible, bool);


  virtual void SetPrecision(int precision);
  vtkGetMacro(Precision, int);


  virtual void SetNotation(int notation);
  vtkGetMacro(Notation, int);


  vtkSetMacro(Behavior, int);
  vtkGetMacro(Behavior, int);


  vtkGetObjectMacro(Pen, vtkPen);


  vtkGetObjectMacro(GridPen, vtkPen);

  virtual void Update();

  virtual bool Paint(vtkContext2D *painter);

  virtual void AutoScale();

  virtual void RecalculateTickSpacing();

  virtual vtkDoubleArray* GetTickPositions();

  virtual void SetTickPositions(vtkDoubleArray*);

  virtual vtkFloatArray* GetTickScenePositions();

  virtual vtkStringArray* GetTickLabels();

  virtual void SetTickLabels(vtkStringArray*);

//BTX
protected:
  vtkAxis();
  ~vtkAxis();

  void GenerateTickLabels(double min, double max);

  double CalculateNiceMinMax(double &min, double &max);

  double NiceNumber(double number, bool roundUp);

  int Position;        // The position of the axis (LEFT, BOTTOM, RIGHT, TOP)
  float Point1[2];     // The position of point 1 (usually the origin)
  float Point2[2];     // The position of point 2 (usually the terminus)
  double TickInterval;  // Interval between tick marks in plot space
  int NumberOfTicks;   // The number of tick marks to draw
  vtkTextProperty* LabelProperties; // Text properties for the labels.
  double Minimum;       // Minimum value of the axis
  double Maximum;       // Maximum values of the axis
  char* Title;         // The text label drawn on the axis
  vtkTextProperty* TitleProperties; // Text properties for the axis title
  bool LogScale;       // Should the axis use a log scale
  bool GridVisible;    // Whether the grid for the axis should be drawn
  bool LabelsVisible;  // Should the axis labels be visible
  int Precision;       // Numerical precision to use, defaults to 2.
  int Notation;        // The notation to use (standard, scientific, mixed)
  int Behavior;       // The behaviour of the axis (auto, fixed, custom).

  vtkPen* Pen;

  vtkPen* GridPen;

  vtkSmartPointer<vtkDoubleArray> TickPositions;

  vtkSmartPointer<vtkFloatArray> TickScenePositions;

  vtkSmartPointer<vtkStringArray> TickLabels;

  bool UsingNiceMinMax;

  bool TickMarksDirty;

  vtkTimeStamp BuildTime;

private:
  vtkAxis(const vtkAxis &); // Not implemented.
  void operator=(const vtkAxis &);   // Not implemented.
//ETX
};

#endif //__vtkAxis_h

---