pgutil.h

//-*-C++-*-
/***************************************************************************
 *
 *   Copyright (C) 2008 by Willem van Straten
 *   Licensed under the Academic Free License version 2.1
 *
 ***************************************************************************/
 
// psrchive/Util/pgutil/pgutil.h
 
#ifndef __pgutil_H
#define __pgutil_H
 
#include <iostream>
 
namespace pgplot {
 
  /* UNITS: 0 => answer in normalized device coordinates
            1 => answer in inches
            2 => answer in mm
            3 => answer in absolute device coordinates (dots)
            4 => answer in world coordinates
            5 => answer as a fraction of the current viewport size
  */

  enum Units
    {
      Device = 0,
      Inches = 1,
      Millimetres = 2,
      Pixels = 3,
      World = 4,
      Viewport = 5,
    };

  std::ostream& operator << (std::ostream&, Units);

  std::istream& operator >> (std::istream&, Units&);

  float get_aspect_ratio ();

  float get_viewport_aspect_ratio ();

  void get_scale (Units from, Units to, float& width, float& height);

  void set_paper_size (float width_cm, float aspect_ratio);

  void set_dimensions (unsigned width_pixels, unsigned height_pixels);
 
}
 
#endif