RhodeCode

 * provided that this copyright notice appears in all copies. For

 * precise terms see the accompanying LICENSE file.

 *

 * This software is provided "AS IS" with no warranty of any kind,

 * express or implied, and with no claim as to its suitability for any

 * purpose.

 *

 */

/// \ingroup demos

/// \file

/// \brief Demo of the graph grawing function \ref graphToEps()

///

/// This demo program shows examples how to  use the function \ref

/// graphToEps(). It takes no input but simply creates  six

/// <tt>.eps</tt> files demonstrating the capability of \ref

/// graphToEps(), and showing how to draw directed/graphs,

/// how to handle parallel egdes, how to change the properties (like

/// color, shape, size, title etc.) of nodes and arcs individually

/// using appropriate \ref maps-page "graph maps".

///

/// \include graph_to_eps_demo.cc

#include <lemon/math.h>

#include<lemon/graph_to_eps.h>

#include<lemon/list_graph.h>

#include<lemon/graph_utils.h>

using namespace std;

using namespace lemon;

int main()

{

  Palette palette;

  Palette paletteW(true);

  ListDigraph g;

  typedef ListDigraph::Node Node;

  typedef ListDigraph::NodeIt NodeIt;

  typedef ListDigraph::Arc Arc;

  typedef dim2::Point<int> Point;

  Node n1=g.addNode();

  Node n2=g.addNode();

  Node n3=g.addNode();

  Node n4=g.addNode();

  Node n5=g.addNode();

  ListDigraph::NodeMap<Point> coords(g);

  ListDigraph::NodeMap<double> sizes(g);

  ListDigraph::NodeMap<int> colors(g);

  ListDigraph::NodeMap<int> shapes(g);

  ListDigraph::ArcMap<int> ecolors(g);

  ListDigraph::ArcMap<int> widths(g);

  coords[n1]=Point(50,50);  sizes[n1]=1; colors[n1]=1; shapes[n1]=0;

  coords[n2]=Point(50,70);  sizes[n2]=2; colors[n2]=2; shapes[n2]=2;

  coords[n3]=Point(70,70);  sizes[n3]=1; colors[n3]=3; shapes[n3]=0;

  coords[n4]=Point(70,50);  sizes[n4]=2; colors[n4]=4; shapes[n4]=1;

  coords[n5]=Point(85,60);  sizes[n5]=3; colors[n5]=5; shapes[n5]=2;

  Arc e;

  e=g.addArc(n1,n2); ecolors[e]=0; widths[e]=1;

  e=g.addArc(n2,n3); ecolors[e]=0; widths[e]=1;

  e=g.addArc(n3,n5); ecolors[e]=0; widths[e]=3;

  e=g.addArc(n5,n4); ecolors[e]=0; widths[e]=1;

  e=g.addArc(n4,n1); ecolors[e]=0; widths[e]=1;

  e=g.addArc(n2,n4); ecolors[e]=1; widths[e]=2;

  e=g.addArc(n3,n4); ecolors[e]=2; widths[e]=1;

  IdMap<ListDigraph,Node> id(g);

  cout << "Create 'graph_to_eps_demo_out_pure.eps'" << endl;

  graphToEps(g,"graph_to_eps_demo_out_pure.eps").

    //scale(10).

    coords(coords).

    title("Sample .eps figure").

    copyright("(C) 2003-2007 LEMON Project").

    run();

  cout << "Create 'graph_to_eps_demo_out.eps'" << endl;

  graphToEps(g,"graph_to_eps_demo_out.eps").

    //scale(10).

    coords(coords).

    title("Sample .eps figure").

    copyright("(C) 2003-2007 LEMON Project").

    absoluteNodeSizes().absoluteArcWidths().

    nodeScale(2).nodeSizes(sizes).

    nodeShapes(shapes).

    nodeColors(composeMap(palette,colors)).

    arcColors(composeMap(palette,ecolors)).

    arcWidthScale(.4).arcWidths(widths).

    nodeTexts(id).nodeTextSize(3).

    run();

  cout << "Create 'graph_to_eps_demo_out_arr.eps'" << endl;

  graphToEps(g,"graph_to_eps_demo_out_arr.eps").

    //scale(10).

    title("Sample .eps figure (with arrowheads)").

    copyright("(C) 2003-2007 LEMON Project").

    absoluteNodeSizes().absoluteArcWidths().

    nodeColors(composeMap(palette,colors)).

    coords(coords).

    nodeScale(2).nodeSizes(sizes).

    nodeShapes(shapes).

    arcColors(composeMap(palette,ecolors)).

    arcWidthScale(.4).arcWidths(widths).

    nodeTexts(id).nodeTextSize(3).

    drawArrows().arrowWidth(1).arrowLength(1).

    run();

  e=g.addArc(n1,n4); ecolors[e]=2; widths[e]=1;

  e=g.addArc(n4,n1); ecolors[e]=1; widths[e]=2;

  e=g.addArc(n1,n2); ecolors[e]=1; widths[e]=1;

  e=g.addArc(n1,n2); ecolors[e]=2; widths[e]=1;

  e=g.addArc(n1,n2); ecolors[e]=3; widths[e]=1;

  e=g.addArc(n1,n2); ecolors[e]=4; widths[e]=1;

  e=g.addArc(n1,n2); ecolors[e]=5; widths[e]=1;

  e=g.addArc(n1,n2); ecolors[e]=6; widths[e]=1;

  e=g.addArc(n1,n2); ecolors[e]=7; widths[e]=1;

  cout << "Create 'graph_to_eps_demo_out_par.eps'" << endl;

  graphToEps(g,"graph_to_eps_demo_out_par.eps").

    //scale(10).

    title("Sample .eps figure (parallel arcs)").

    copyright("(C) 2003-2007 LEMON Project").

    absoluteNodeSizes().absoluteArcWidths().

    nodeShapes(shapes).

    coords(coords).

    nodeScale(2).nodeSizes(sizes).

    nodeColors(composeMap(palette,colors)).

    arcColors(composeMap(palette,ecolors)).

    arcWidthScale(.4).arcWidths(widths).

    nodeTexts(id).nodeTextSize(3).

    enableParallel().parArcDist(1.5).

    run();

  cout << "Create 'graph_to_eps_demo_out_par_arr.eps'" << endl;

  graphToEps(g,"graph_to_eps_demo_out_par_arr.eps").

    //scale(10).

    title("Sample .eps figure (parallel arcs and arrowheads)").

    copyright("(C) 2003-2007 LEMON Project").

    absoluteNodeSizes().absoluteArcWidths().

    nodeScale(2).nodeSizes(sizes).

    coords(coords).

    nodeShapes(shapes).

    nodeColors(composeMap(palette,colors)).

    arcColors(composeMap(palette,ecolors)).

    arcWidthScale(.3).arcWidths(widths).

    nodeTexts(id).nodeTextSize(3).

    enableParallel().parArcDist(1).

    drawArrows().arrowWidth(1).arrowLength(1).

    run();

  cout << "Create 'graph_to_eps_demo_out_a4.eps'" << endl;

  graphToEps(g,"graph_to_eps_demo_out_a4.eps").scaleToA4().

    title("Sample .eps figure (fits to A4)").

    copyright("(C) 2003-2007 LEMON Project").

    absoluteNodeSizes().absoluteArcWidths().

    nodeScale(2).nodeSizes(sizes).

    coords(coords).

    nodeShapes(shapes).

    nodeColors(composeMap(palette,colors)).

    arcColors(composeMap(palette,ecolors)).

    arcWidthScale(.3).arcWidths(widths).

    nodeTexts(id).nodeTextSize(3).

    enableParallel().parArcDist(1).

    drawArrows().arrowWidth(1).arrowLength(1).

    run();

  ListDigraph h;

  ListDigraph::NodeMap<int> hcolors(h);

  ListDigraph::NodeMap<Point> hcoords(h);

  int cols=int(sqrt(double(palette.size())));

  for(int i=0;i<int(paletteW.size());i++) {

    Node n=h.addNode();

    hcoords[n]=Point(i%cols,i/cols);

    hcolors[n]=i;

  }

  cout << "Create 'graph_to_eps_demo_out_colors.eps'" << endl;

  graphToEps(h,"graph_to_eps_demo_out_colors.eps").

    //scale(60).

    title("Sample .eps figure (Palette demo)").

    copyright("(C) 2003-2007 LEMON Project").

    coords(hcoords).

    absoluteNodeSizes().absoluteArcWidths().

    distantColorNodeTexts().

    //    distantBWNodeTexts().

    nodeTexts(hcolors).nodeTextSize(.6).

    nodeColors(composeMap(paletteW,hcolors)).

    run();

}

/* -*- C++ -*-

 *

 * This file is a part of LEMON, a generic C++ optimization library

 *

 * Copyright (C) 2003-2008

 * Egervary Jeno Kombinatorikus Optimalizalasi Kutatocsoport

 * (Egervary Research Group on Combinatorial Optimization, EGRES).

 *

 * Permission to use, modify and distribute this software is granted

 * provided that this copyright notice appears in all copies. For

 * precise terms see the accompanying LICENSE file.

 *

 * This software is provided "AS IS" with no warranty of any kind,

 * express or implied, and with no claim as to its suitability for any

 * purpose.

 *

 */

#ifndef LEMON_GRAPH_TO_EPS_H

#define LEMON_GRAPH_TO_EPS_H

#include <sys/time.h>

#ifdef WIN32

#include <lemon/bits/mingw32_time.h>

#endif

#include<iostream>

#include<fstream>

#include<sstream>

#include<algorithm>

#include<vector>

#include<ctime>

#include<lemon/math.h>

#include<lemon/bits/invalid.h>

#include<lemon/dim2.h>

#include<lemon/maps.h>

#include<lemon/color.h>

#include<lemon/bits/bezier.h>

///\ingroup eps_io

///\file

///\brief Simple graph drawer

///

///\author Alpar Juttner

namespace lemon {

  namespace _graph_to_eps_bits {

    template<class MT>

    class _NegY {

    public:

      typedef typename MT::Key Key;

      typedef typename MT::Value Value;

      const MT ↦

      int yscale;

      _NegY(const MT &m,bool b) : map(m), yscale(1-b*2) {}

      Value operator[](Key n) { return Value(map[n].x,map[n].y*yscale);}

    };

  }

///Default traits class of \ref GraphToEps

///Default traits class of \ref GraphToEps

///

///\c G is the type of the underlying graph.

template<class G>

struct DefaultGraphToEpsTraits

{

  typedef G Graph;

  typedef typename Graph::Node Node;

  typedef typename Graph::NodeIt NodeIt;

  typedef typename Graph::Arc Arc;

  typedef typename Graph::ArcIt ArcIt;

  typedef typename Graph::InArcIt InArcIt;

  typedef typename Graph::OutArcIt OutArcIt;

  const Graph &g;

  std::ostream& os;

  typedef ConstMap<typename Graph::Node,dim2::Point<double> > CoordsMapType;

  CoordsMapType _coords;

  ConstMap<typename Graph::Node,double > _nodeSizes;

  ConstMap<typename Graph::Node,int > _nodeShapes;

  ConstMap<typename Graph::Node,Color > _nodeColors;

  ConstMap<typename Graph::Arc,Color > _arcColors;

  ConstMap<typename Graph::Arc,double > _arcWidths;

  double _arcWidthScale;

  double _nodeScale;

  double _xBorder, _yBorder;

  double _scale;

  double _nodeBorderQuotient;

  bool _drawArrows;

  double _arrowLength, _arrowWidth;

  bool _showNodes, _showArcs;

  bool _enableParallel;

  double _parArcDist;

  bool _showNodeText;

  ConstMap<typename Graph::Node,bool > _nodeTexts;  

  double _nodeTextSize;

  bool _showNodePsText;

  ConstMap<typename Graph::Node,bool > _nodePsTexts;  

  char *_nodePsTextsPreamble;

  bool _undirected;

  bool _pleaseRemoveOsStream;

  bool _scaleToA4;

  std::string _title;

  std::string _copyright;

  enum NodeTextColorType 

    { DIST_COL=0, DIST_BW=1, CUST_COL=2, SAME_COL=3 } _nodeTextColorType;

  ConstMap<typename Graph::Node,Color > _nodeTextColors;

  bool _autoNodeScale;

  bool _autoArcWidthScale;

  bool _absoluteNodeSizes;

  bool _absoluteArcWidths;

  bool _negY;

  bool _preScale;

  ///Constructor

  ///Constructor

  ///\param _g is a reference to the graph to be printed

  ///\param _os is a reference to the output stream.

  ///\param _os is a reference to the output stream.

  ///\param _pros If it is \c true, then the \c ostream referenced by \c _os

  ///will be explicitly deallocated by the destructor.

  ///By default it is <tt>std::cout</tt>

  DefaultGraphToEpsTraits(const G &_g,std::ostream& _os=std::cout,

			  bool _pros=false) :

    g(_g), os(_os),

    _nodeColors(WHITE), _arcColors(BLACK),

    _arcWidths(1.0), _arcWidthScale(0.003),

    _nodeBorderQuotient(.1),

    _drawArrows(false), _arrowLength(1), _arrowWidth(0.3),

    _showNodes(true), _showArcs(true),

    _enableParallel(false), _parArcDist(1),

    _showNodeText(false), _nodeTexts(false), _nodeTextSize(1),

    _showNodePsText(false), _nodePsTexts(false), _nodePsTextsPreamble(0),

    _undirected(lemon::UndirectedTagIndicator<G>::value),

    _pleaseRemoveOsStream(_pros), _scaleToA4(false),

    _nodeTextColorType(SAME_COL), _nodeTextColors(BLACK),

    _autoNodeScale(false),

    _autoArcWidthScale(false),

    _absoluteNodeSizes(false),

    _absoluteArcWidths(false),

    _negY(false),

    _preScale(true)

  {}

};

///Helper class to implement the named parameters of \ref graphToEps()

///Helper class to implement the named parameters of \ref graphToEps()

///\todo Is 'helper class' a good name for this?

///

///\todo Follow PostScript's DSC.

/// Use own dictionary.

///\todo Useful new features.

/// - Linestyles: dotted, dashed etc.

/// - A second color and percent value for the lines.

template<class T> class GraphToEps : public T 

{

  // Can't believe it is required by the C++ standard

  using T::g;

  using T::os;

  using T::_coords;

  using T::_nodeSizes;

  using T::_nodeShapes;

  using T::_nodeColors;

  using T::_arcColors;

  using T::_arcWidths;

  using T::_arcWidthScale;

  using T::_nodeScale;

  using T::_xBorder;

  using T::_yBorder;

  using T::_scale;

  using T::_nodeBorderQuotient;

  using T::_drawArrows;

  using T::_arrowLength;

  using T::_arrowWidth;

  using T::_showNodes;

  using T::_showArcs;

  using T::_enableParallel;

  using T::_parArcDist;

  using T::_showNodeText;

  using T::_nodeTexts;  

  using T::_nodeTextSize;

  using T::_showNodePsText;

  using T::_nodePsTexts;  

  using T::_nodePsTextsPreamble;

  using T::_undirected;

  using T::_pleaseRemoveOsStream;

  using T::_scaleToA4;

  using T::_title;

  using T::_copyright;

  using T::NodeTextColorType;

  using T::CUST_COL;

  using T::DIST_COL;

  using T::DIST_BW;

  using T::_nodeTextColorType;

  using T::_nodeTextColors;

  using T::_autoNodeScale;

  using T::_autoArcWidthScale;

  using T::_absoluteNodeSizes;

  using T::_absoluteArcWidths;

  using T::_negY;

  using T::_preScale;

  // dradnats ++C eht yb deriuqer si ti eveileb t'naC

  typedef typename T::Graph Graph;

  typedef typename Graph::Node Node;

  typedef typename Graph::NodeIt NodeIt;

  typedef typename Graph::Arc Arc;

  typedef typename Graph::ArcIt ArcIt;

  typedef typename Graph::InArcIt InArcIt;

  typedef typename Graph::OutArcIt OutArcIt;

  static const int INTERPOL_PREC;

  static const double A4HEIGHT;

  static const double A4WIDTH;

  static const double A4BORDER;

  bool dontPrint;

public:

  ///Node shapes

  ///Node shapes

  ///

  enum NodeShapes { 

    /// = 0

    ///\image html nodeshape_0.png

    ///\image latex nodeshape_0.eps "CIRCLE shape (0)" width=2cm

    CIRCLE=0, 

    /// = 1

    ///\image html nodeshape_1.png

    ///\image latex nodeshape_1.eps "SQUARE shape (1)" width=2cm

    ///

    SQUARE=1, 

    /// = 2

    ///\image html nodeshape_2.png

    ///\image latex nodeshape_2.eps "DIAMOND shape (2)" width=2cm

    ///

    DIAMOND=2,

    /// = 3

    ///\image html nodeshape_3.png

    ///\image latex nodeshape_2.eps "MALE shape (4)" width=2cm

    ///

    MALE=3,

    /// = 4

    ///\image html nodeshape_4.png

    ///\image latex nodeshape_2.eps "FEMALE shape (4)" width=2cm

    ///

    FEMALE=4

  };

private:

  class arcLess {

    const Graph &g;

  public:

    arcLess(const Graph &_g) : g(_g) {}

    bool operator()(Arc a,Arc b) const 

    {

      Node ai=std::min(g.source(a),g.target(a));

      Node aa=std::max(g.source(a),g.target(a));

      Node bi=std::min(g.source(b),g.target(b));

      Node ba=std::max(g.source(b),g.target(b));

      return ai<bi ||

	(ai==bi && (aa < ba || 

		    (aa==ba && ai==g.source(a) && bi==g.target(b))));

    }

  };

  bool isParallel(Arc e,Arc f) const

  {

    return (g.source(e)==g.source(f)&&

	    g.target(e)==g.target(f)) ||

      (g.source(e)==g.target(f)&&

       g.target(e)==g.source(f));

  }

  template<class TT>

  static std::string psOut(const dim2::Point<TT> &p) 

    {

      std::ostringstream os;	

      os << p.x << ' ' << p.y;

      return os.str();

    }

  static std::string psOut(const Color &c) 

    {

      std::ostringstream os;	

      os << c.red() << ' ' << c.green() << ' ' << c.blue();

      return os.str();

    }

public:

  GraphToEps(const T &t) : T(t), dontPrint(false) {};

  template<class X> struct CoordsTraits : public T {

  typedef X CoordsMapType;

    const X &_coords;

    CoordsTraits(const T &t,const X &x) : T(t), _coords(x) {}

  };

  ///Sets the map of the node coordinates

  ///Sets the map of the node coordinates.

  ///\param x must be a node map with dim2::Point<double> or

  ///\ref dim2::Point "dim2::Point<int>" values. 

  template<class X> GraphToEps<CoordsTraits<X> > coords(const X &x) {

    dontPrint=true;

    return GraphToEps<CoordsTraits<X> >(CoordsTraits<X>(*this,x));

  }

  template<class X> struct NodeSizesTraits : public T {

    const X &_nodeSizes;

    NodeSizesTraits(const T &t,const X &x) : T(t), _nodeSizes(x) {}

  };

  ///Sets the map of the node sizes

  ///Sets the map of the node sizes

  ///\param x must be a node map with \c double (or convertible) values. 

  template<class X> GraphToEps<NodeSizesTraits<X> > nodeSizes(const X &x)

  {

    dontPrint=true;

    return GraphToEps<NodeSizesTraits<X> >(NodeSizesTraits<X>(*this,x));

  }

  template<class X> struct NodeShapesTraits : public T {

    const X &_nodeShapes;

    NodeShapesTraits(const T &t,const X &x) : T(t), _nodeShapes(x) {}

  };

  ///Sets the map of the node shapes

  ///Sets the map of the node shapes.

  ///The availabe shape values

  ///can be found in \ref NodeShapes "enum NodeShapes".

  ///\param x must be a node map with \c int (or convertible) values. 

  ///\sa NodeShapes

  template<class X> GraphToEps<NodeShapesTraits<X> > nodeShapes(const X &x)

  {

    dontPrint=true;

    return GraphToEps<NodeShapesTraits<X> >(NodeShapesTraits<X>(*this,x));

  }

  template<class X> struct NodeTextsTraits : public T {

    const X &_nodeTexts;

    NodeTextsTraits(const T &t,const X &x) : T(t), _nodeTexts(x) {}

  };

  ///Sets the text printed on the nodes

  ///Sets the text printed on the nodes

  ///\param x must be a node map with type that can be pushed to a standard

  ///ostream. 

  template<class X> GraphToEps<NodeTextsTraits<X> > nodeTexts(const X &x)

  {

    dontPrint=true;

    _showNodeText=true;

    return GraphToEps<NodeTextsTraits<X> >(NodeTextsTraits<X>(*this,x));

  }

  template<class X> struct NodePsTextsTraits : public T {

    const X &_nodePsTexts;

    NodePsTextsTraits(const T &t,const X &x) : T(t), _nodePsTexts(x) {}

  };

  ///Inserts a PostScript block to the nodes

  ///With this command it is possible to insert a verbatim PostScript

  ///block to the nodes.

  ///The PS current point will be moved to the centre of the node before

  ///the PostScript block inserted.

  ///

  ///Before and after the block a newline character is inserted so you

  ///don't have to bother with the separators.

  ///

  ///\param x must be a node map with type that can be pushed to a standard

  ///ostream.

  ///

  ///\sa nodePsTextsPreamble()

  ///\todo Offer the choise not to move to the centre but pass the coordinates

  ///to the Postscript block inserted.

  template<class X> GraphToEps<NodePsTextsTraits<X> > nodePsTexts(const X &x)

  {

    dontPrint=true;

    _showNodePsText=true;

    return GraphToEps<NodePsTextsTraits<X> >(NodePsTextsTraits<X>(*this,x));

  }

  template<class X> struct ArcWidthsTraits : public T {

    const X &_arcWidths;

    ArcWidthsTraits(const T &t,const X &x) : T(t), _arcWidths(x) {}

  };

  ///Sets the map of the arc widths

  ///Sets the map of the arc widths

  ///\param x must be a arc map with \c double (or convertible) values. 

  template<class X> GraphToEps<ArcWidthsTraits<X> > arcWidths(const X &x)

  {

    dontPrint=true;

    return GraphToEps<ArcWidthsTraits<X> >(ArcWidthsTraits<X>(*this,x));

  }

  template<class X> struct NodeColorsTraits : public T {

    const X &_nodeColors;

    NodeColorsTraits(const T &t,const X &x) : T(t), _nodeColors(x) {}

  };

  ///Sets the map of the node colors

  ///Sets the map of the node colors

  ///\param x must be a node map with \ref Color values.

  ///

  ///\sa Palette

  template<class X> GraphToEps<NodeColorsTraits<X> >

  nodeColors(const X &x)

  {

    dontPrint=true;

    return GraphToEps<NodeColorsTraits<X> >(NodeColorsTraits<X>(*this,x));

  }

  template<class X> struct NodeTextColorsTraits : public T {

    const X &_nodeTextColors;

    NodeTextColorsTraits(const T &t,const X &x) : T(t), _nodeTextColors(x) {}

  };

  ///Sets the map of the node text colors

  ///Sets the map of the node text colors

  ///\param x must be a node map with \ref Color values. 

  ///

  ///\sa Palette

  template<class X> GraphToEps<NodeTextColorsTraits<X> >

  nodeTextColors(const X &x)

  {

    dontPrint=true;

    _nodeTextColorType=CUST_COL;

    return GraphToEps<NodeTextColorsTraits<X> >

      (NodeTextColorsTraits<X>(*this,x));

  }

  template<class X> struct ArcColorsTraits : public T {

    const X &_arcColors;

    ArcColorsTraits(const T &t,const X &x) : T(t), _arcColors(x) {}

  };

  ///Sets the map of the arc colors

  ///Sets the map of the arc colors

  ///\param x must be a arc map with \ref Color values. 

  ///

  ///\sa Palette

  template<class X> GraphToEps<ArcColorsTraits<X> >

  arcColors(const X &x)

  {

    dontPrint=true;

    return GraphToEps<ArcColorsTraits<X> >(ArcColorsTraits<X>(*this,x));

  }

  ///Sets a global scale factor for node sizes

  ///Sets a global scale factor for node sizes.

  /// 

  /// If nodeSizes() is not given, this function simply sets the node

  /// sizes to \c d.  If nodeSizes() is given, but

  /// autoNodeScale() is not, then the node size given by

  /// nodeSizes() will be multiplied by the value \c d.

  /// If both nodeSizes() and autoNodeScale() are used, then the

  /// node sizes will be scaled in such a way that the greatest size will be

  /// equal to \c d.

  /// \sa nodeSizes()

  /// \sa autoNodeScale()

  ///Turns on/off the automatic node width scaling.

  ///Turns on/off the automatic node width scaling.

  ///

  ///\sa nodeScale()

  ///

  GraphToEps<T> &autoNodeScale(bool b=true) {

    _autoNodeScale=b;return *this;

  }

  ///Turns on/off the absolutematic node width scaling.

  ///Turns on/off the absolutematic node width scaling.

  ///

  ///\sa nodeScale()

  ///

  GraphToEps<T> &absoluteNodeSizes(bool b=true) {

    _absoluteNodeSizes=b;return *this;

  }

  ///Negates the Y coordinates.

  ///Negates the Y coordinates.

  ///

  ///\todo More docs.

  ///

  GraphToEps<T> &negateY(bool b=true) {

    _negY=b;return *this;

  }

  ///Turn on/off prescaling

  ///By default graphToEps() rescales the whole image in order to avoid

  ///very big or very small bounding boxes.

  ///

  ///This (p)rescaling can be turned off with this function.

  ///

  GraphToEps<T> &preScale(bool b=true) {

    _preScale=b;return *this;

  }

  ///Sets a global scale factor for arc widths

  /// Sets a global scale factor for arc widths.

  ///

  /// If arcWidths() is not given, this function simply sets the arc

  /// widths to \c d.  If arcWidths() is given, but

  /// autoArcWidthScale() is not, then the arc withs given by

  /// arcWidths() will be multiplied by the value \c d.

  /// If both arcWidths() and autoArcWidthScale() are used, then the

  /// arc withs will be scaled in such a way that the greatest width will be

  /// equal to \c d.

  ///Turns on/off the automatic arc width scaling.

  ///Turns on/off the automatic arc width scaling.

  ///

  ///\sa arcWidthScale()

  ///

  GraphToEps<T> &autoArcWidthScale(bool b=true) {

    _autoArcWidthScale=b;return *this;

  }

  ///Turns on/off the absolutematic arc width scaling.

  ///Turns on/off the absolutematic arc width scaling.

  ///

  ///\sa arcWidthScale()

  ///

  GraphToEps<T> &absoluteArcWidths(bool b=true) {

    _absoluteArcWidths=b;return *this;

  }

  ///Sets a global scale factor for the whole picture

  ///Sets a global scale factor for the whole picture

  ///

  GraphToEps<T> &scale(double d) {_scale=d;return *this;}

  ///Sets the width of the border around the picture

  ///Sets the width of the border around the picture

  ///

  GraphToEps<T> &border(double b) {_xBorder=_yBorder=b;return *this;}

  ///Sets the width of the border around the picture

  ///Sets the width of the border around the picture

  ///

  GraphToEps<T> &border(double x, double y) {

    _xBorder=x;_yBorder=y;return *this;

  }

  ///Sets whether to draw arrows

  ///Sets whether to draw arrows

  ///

  GraphToEps<T> &drawArrows(bool b=true) {_drawArrows=b;return *this;}

  ///Sets the length of the arrowheads

  ///Sets the length of the arrowheads

  ///

  GraphToEps<T> &arrowLength(double d) {_arrowLength*=d;return *this;}

  ///Sets the width of the arrowheads

  ///Sets the width of the arrowheads

  ///

  GraphToEps<T> &arrowWidth(double d) {_arrowWidth*=d;return *this;}

  ///Scales the drawing to fit to A4 page

  ///Scales the drawing to fit to A4 page

  ///

  GraphToEps<T> &scaleToA4() {_scaleToA4=true;return *this;}

  ///Enables parallel arcs

  ///Enables parallel arcs

  GraphToEps<T> &enableParallel(bool b=true) {_enableParallel=b;return *this;}

  ///Sets the distance 

  ///Sets the distance 

  ///

  GraphToEps<T> &parArcDist(double d) {_parArcDist*=d;return *this;}

  ///Hides the arcs

  ///Hides the arcs

  ///

  GraphToEps<T> &hideArcs(bool b=true) {_showArcs=!b;return *this;}

  ///Hides the nodes

  ///Hides the nodes

  ///

  GraphToEps<T> &hideNodes(bool b=true) {_showNodes=!b;return *this;}

  ///Sets the size of the node texts

  ///Sets the size of the node texts

  ///

  GraphToEps<T> &nodeTextSize(double d) {_nodeTextSize=d;return *this;}

  ///Sets the color of the node texts to be different from the node color

  ///Sets the color of the node texts to be as different from the node color

  ///as it is possible

  ///

  GraphToEps<T> &distantColorNodeTexts()

  {_nodeTextColorType=DIST_COL;return *this;}

  ///Sets the color of the node texts to be black or white and always visible.

  ///Sets the color of the node texts to be black or white according to

  ///which is more 

  ///different from the node color

  ///

  GraphToEps<T> &distantBWNodeTexts()

  {_nodeTextColorType=DIST_BW;return *this;}

  ///Gives a preamble block for node Postscript block.

  ///Gives a preamble block for node Postscript block.

  ///

  ///\sa nodePsTexts()

  GraphToEps<T> & nodePsTextsPreamble(const char *str) {

    _nodePsTextsPreamble=str ;return *this;

  }

  ///Sets whether the the graph is undirected

  ///Sets whether the the graph is undirected

  ///

  GraphToEps<T> &undirected(bool b=true) {_undirected=b;return *this;}

  ///Sets whether the the graph is directed

  ///Sets whether the the graph is directed.

  ///Use it to show the edges as a pair of directed ones.

  GraphToEps<T> &directed(bool b=true) {_undirected=!b;return *this;}

  ///Sets the title.

  ///Sets the title of the generated image,

  ///namely it inserts a <tt>%%Title:</tt> DSC field to the header of

  ///the EPS file.

  GraphToEps<T> &title(const std::string &t) {_title=t;return *this;}

  ///Sets the copyright statement.

  ///Sets the copyright statement of the generated image,

  ///namely it inserts a <tt>%%Copyright:</tt> DSC field to the header of

  ///the EPS file.

  ///\todo Multiline copyright notice could be supported.

  GraphToEps<T> &copyright(const std::string &t) {_copyright=t;return *this;}

protected:

  bool isInsideNode(dim2::Point<double> p, double r,int t) 

  {

    switch(t) {

    case CIRCLE:

    case MALE:

    case FEMALE:

      return p.normSquare()<=r*r;

    case SQUARE:

      return p.x<=r&&p.x>=-r&&p.y<=r&&p.y>=-r;

    case DIAMOND:

      return p.x+p.y<=r && p.x-p.y<=r && -p.x+p.y<=r && -p.x-p.y<=r;

    }

    return false;

  }

public:

  ~GraphToEps() { }

  ///Draws the graph.

  ///Like other functions using

  ///\ref named-templ-func-param "named template parameters",

  ///this function calles the algorithm itself, i.e. in this case

  ///it draws the graph.

  void run() {

    ///\todo better 'epsilon' would be nice here.

    const double EPSILON=1e-9;

    if(dontPrint) return;

    _graph_to_eps_bits::_NegY<typename T::CoordsMapType>

      mycoords(_coords,_negY);

    os << "%!PS-Adobe-2.0 EPSF-2.0\n";

    if(_title.size()>0) os << "%%Title: " << _title << '\n';

     if(_copyright.size()>0) os << "%%Copyright: " << _copyright << '\n';

//        << "%%Copyright: XXXX\n"

    os << "%%Creator: LEMON, graphToEps()\n";

    {

      char cbuf[50];

      timeval tv;

      gettimeofday(&tv, 0);

      ctime_r(&tv.tv_sec,cbuf);

      os << "%%CreationDate: " << cbuf;

    }

    if (_autoArcWidthScale) {

      double max_w=0;

      for(ArcIt e(g);e!=INVALID;++e)

	max_w=std::max(double(_arcWidths[e]),max_w);

      ///\todo better 'epsilon' would be nice here.

      if(max_w>EPSILON) {

	_arcWidthScale/=max_w;

      }

    }