AxisStyle.hpp

Go to the documentation of this file.

#pragma ident "$Id: AxisStyle.hpp 1644 2009-01-27 19:26:14Z ckiesch $"


//============================================================================
//
//  This file is part of GPSTk, the GPS Toolkit.
//
//  The GPSTk is free software; you can redistribute it and/or modify
//  it under the terms of the GNU Lesser General Public License as published
//  by the Free Software Foundation; either version 2.1 of the License, or
//  any later version.
//
//  The GPSTk is distributed in the hope that it will be useful,
//  but WITHOUT ANY WARRANTY; without even the implied warranty of
//  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
//  GNU Lesser General Public License for more details.
//
//  You should have received a copy of the GNU Lesser General Public
//  License along with GPSTk; if not, write to the Free Software Foundation,
//  Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
//  
//  Copyright 2004, The University of Texas at Austin
//
//============================================================================

#ifndef VPLOT_AXISSTYLE_H
#define VPLOT_AXISSTYLE_H

#include "StrokeStyle.hpp"
#include "TextStyle.hpp"

namespace vplot
{
  /*
   * I probably need a class for the following things:
   *
   * - Axis setup
   *   - This would be in the middle (on 0) or on an edge as a border
   *     of the plot/frame.
   *   * StrokeStyle for everything
   *   * Length of ticks 
   *   * Alignment of ticks
   *     -  --|   Left
   *     -   -|-  Center
   *     -    |-- Right
   *     -   |     |  
   *     -  ---   ---   --- 
   *     -         |     |
   *     - Above Center Below
   *   - Placement of ticks
   *     - Evenly space n across the line (to bounds)
   *     - or evenly space them a given amount to wherever
   *     - Start at 0 or side
   *   - Tick recursion for najor/minor ticks
   *   - Tick recursion for labels
   *   - Label placement
   *   - Label formatting?
   *   * TextStyle for label
   *   - Direction for axis
   *   - Bounds!
   *     - Bound generation from min/max (with buffer area? round?)
   * - If this is a seperate class it needs a set of COPY commands
   *   that copy to a different orientation.  Or a mirror setting that
   *   does so automagically.
   */

  class AxisStyle
  {
    public:
      static const int ABOVE  = -1;
      static const int CENTER = 0;
      static const int BELOW  = 1;

      /*
       * Tick settings
       */

      bool logarithmic;

      int tick_position;

      vdraw::StrokeStyle tick_style;

      double major_tick_length;

      bool tight_bounds;

      // TODO: Start labelling from some specific place?
      bool start_ticks_on_zero;

      double tick_depth_multiplier;

      int tick_recursion_depth;

      int subticks_per_tick;

      /*
       * Label settings
       */
      
      bool draw_labels;

      // TODO: Special labels?
      // std::vector<std::string> labels
      // or
      // Map from value to label:
      // std::map<double,std::string> labels
      // for example
      // labels.put(10,"Elevation mask");

      vdraw::TextStyle label_style;

      // The depth of tick recursion to draw labels
      // NOTE: This isn't really necessary, though maybe for log plots
      //int tick_label_depth;

      int label_position;

      std::string label_format;

      /*
       * General settings
       */

      vdraw::StrokeStyle line_style;

      /*
       * Constructor/Destructor
       */

      AxisStyle()
      {
        logarithmic = false;
        tick_position = CENTER;
        tick_style = vdraw::StrokeStyle();
        major_tick_length = 10;
        tight_bounds = false;
        start_ticks_on_zero = true;
        tick_depth_multiplier = 0.7;
        tick_recursion_depth = 2;
        subticks_per_tick = 1;
        draw_labels = true;
        label_style = vdraw::TextStyle();
        label_position = ABOVE;
        label_format = "";
        line_style = vdraw::StrokeStyle();
      }

      ~AxisStyle()
      {
      }
  };
}

#endif //VPLOT_AXISSTYLE_H

---