source: trunk/lib/Graph.h @ 878

#ifndef _theplu_svndigest_graph_
#define _theplu_svndigest_graph_

// $Id: Graph.h 878 2009-11-23 22:40:49Z jari $

/*
  Copyright (C) 2009 Jari Häkkinen

  This file is part of svndigest, http://dev.thep.lu.se/svndigest

  svndigest is free software; you can redistribute it and/or modify it
  under the terms of the GNU General Public License as published by
  the Free Software Foundation; either version 3 of the License, or
  (at your option) any later version.

  svndigest 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
  General Public License for more details.

  You should have received a copy of the GNU General Public License
  along with svndigest. If not, see <http://www.gnu.org/licenses/>.
*/

#include <string>
#include <vector>

#include <plplot/plstream.h>

namespace theplu {
namespace svndigest {

  class Graph 
  {
  public:

    /**
       \brief Constructor

       \a filename to be defined depending on whether we'll support
       more output formats than SVG.
    */
    explicit Graph(const std::string& filename);

    /**
       \brief Destructor
    */
    ~Graph(void);

    static bool date_xticks(void);

    /**
       \brief Set the pen colour to use in next drawing call
    */
    void current_colour(unsigned char r, unsigned char g, unsigned char b);

    /**
       \brief Plot \a data using \a timeformat for x-axis values when
       dates are used.
    */
    void plot(const std::vector<unsigned int>& data, const std::string& legend,
              const std::string& timeformat="%y-%b");

    /**
       \brief Function setting the dates.

       The date strings must be in svn format since underlying time
       conversion are done with the Date class.

       \see Date::svntime(std::string)
    */
    static void set_dates(const std::vector<std::string>& date);

    static const std::vector<std::string>& xticks(void);

    /**
       \brief Set max y value in the plot

       The plot area is (xstart,0) to (xend,\a ymax) where xend is
       either the length of vector to plot (corresponds to latest
       revision number) or the date of the last revision commit,
       xstart is 0 or the date of the first commit.
    */
    double yrange(double ymax=0.0);

  private:
    void print_legend(PLFLT xmin, PLFLT ymin, PLFLT xmax, PLFLT ymax,
                      const std::string& legend);
    unsigned int tick_spacing(const double range) const;

    unsigned int plots_; // keep track of number of plots drawn
    plstream pls_;
    std::string title_;
    static std::vector<std::string> xticks_;
    double yrange_;
  };

}} // end of namespace svndigest and namespace theplu

#endif