G2(3)

NAME
G2 - A simple graphics library ported to Perl.

SYNOPSIS
  use G2;

  $dev1 = newX11 G2::Device(775, 575);
  $dev2 = newGIF G2::Device("test.gif",600,200);

  $dev1->rectangle(20,20,150,150);
  $dev1->circle(100,150,60);

  $dev2->circle(100,150,60);
  $dev2->string(100,50,"A circle in a GIF file");

DESCRIPTION
g2 is a simple to use graphics library for 2D graphical applications. This library provides a comprehensive set of functions for simultaneous generation of graphical output on different types of devices. Presently, following devices are currently supported by g2: X11, GIF, PostScript (xfig is in developement). One major feature of the g2_library is the concept of virtual devices. An arbitrary number of physical devices (such as GIF, or X11) can be grouped to create a so-called virtual device. Commands sent to such a virtual devices will automatically issued to all attached physical devices. This allows for example simultaneous output to a GIF file and a Postscript file. A virtual device in turn can be attached to another virtual device, allowing to construct trees of devices. Virtual devices can also be useful when using different user-coordinate systems. E.g. one X11 window showing an overview of a graphical output, and a second window showing a zoom of a more detailed area of the graphic. Drawing in both windows is performed by one single command to the virtual device.

Exported constants
  G2LD
  G2_H
  G2_VERSION

Exported functions

  Creating new devices

"newX11"
    "G2::Device::newX11(width,height)" class method

    opens an X11 window with width and height of X11 window given in pixels. returns : a new X11 device.

"newPS"
    "G2::Device::newPS(filename,paper,orientation)" class method

    opens a new PostScript device. file_name: name of PostScript file paper: Paper size (e.g. g2_A4, g2_Letter). See PostScript paper sizes for a full list of supported sizes. orientation: paper orientation. Either g2_PS_land for landscape or g2_PS_port for portrait returns : a new PostScript device.

"newGIF"
    "G2::Device::newGIF(filename,width,height)" class method

    open a new GIF device width,height: width and height of GIF image in pixels filename: name of GIF file. returns : a new GIF device

"newVD"
    G2::Device::newVD() class method

    Create a new Virtual Device. An arbitrary number of physical devices (such as GIF, or X11) can be grouped to create a so-called virtual device. Commands sent to such a virtual devices will automatically issued to all attached physical devices. This allows for example simultaneous output to a GIF file and a Postscript file. A virtual device in turn can be attached to another virtual device, allowing to construct trees of devices. Virtual devices can also be useful when using different user-coordinate systems. E.g. one X11 window showing an overview of a graphical output, and a second window showing a zoom of a more detailed area of the graphic. Drawing in both windows is performed by one single command to the virtual device.

  Device Functions

""  G2::Device::attach(dev) object method

""  G2::Device::detach(dev) object method

""  G2::Device::close() object method

"set_auto_flush"
    G2::Device::set_auto_flush(on_off) object method

"flush"
    G2::Device::flush() object method

"save"
    G2::Device::save() object method

"set_coordinate_system"
    "G2::Device::set_coordinate_system(x_origin, y_origin, x_mul, y_mul)" object method

"ld"
    G2::Device::ld() object method

"set_ld"
    G2::Device::set_ld( dev) object method

"ink"
    "G2::Device::ink( pd_dev, red, green, blue)" object method

"pen"
    G2::Device::pen(color) object method

"set_dash"
    "G2::Device::set_dash(N, *dashes)" object method

"set_font_size"
    G2::Device::set_font_size(size) object method

"set_line_width"
    G2::Device::set_line_width(w) object method

"clear_palette"
    G2::Device::clear_palette( dev) object method

"reset_palette"
    G2::Device::reset_palette( dev) object method

"allocate_basic_colors"
    G2::Device::allocate_basic_colors( dev) object method

"clear"
    G2::Device::clear( dev) object method

"set_background"
    G2::Device::set_background(color) object method

  Drawing Functions

"move"
    "G2::Device::move(x, y)" object method

"move_r"
    "G2::Device::move_r(dx, dy)" object method

"plot"
    "G2::Device::plot(x, y)" object method

"plot_r"
    "G2::Device::plot_r(dx, dy)" object method

"line"
    "G2::Device::line(x1, y1, x2, y2)" object method

"line_r"
    "G2::Device::line_r(dx, dy)" object method

"line_to"
    "G2::Device::line_to(x, y)" object method

"poly_line"
    "G2::Device::poly_line(N_pt, *pos)" object method

"triangle"
    "G2::Device::triangle(x1, y1, x2, y2, x3, y3)" object method

"filled_triangle"
    "G2::Device::filled_triangle(x1, y1, x2, y2, x3, y3)" object method

"rectangle"
    "G2::Device::rectangle(x1, y1, x2, y2)" object method

"filled_rectangle"
    "G2::Device::filled_rectangle(x1, y1, x2, y2)" object method

"polygon"
    "G2::Device::polygon(N_pt, *pos)" object method

"filled_polygon"
    "G2::Device::filled_polygon(N_pt, *pos)" object method

"circle"
    "G2::Device::circle(x, y, r)" object method

"filled_circle"
    "G2::Device::filled_circle(x, y, r)" object method

"ellipse"
    "G2::Device::ellipse(x, y, r1, r2)" object method
              Draw an ellipse on device dev
              x,y: center point
              r1,r2: x and y radius

"filled_ellipse"
    "G2::Device::filled_ellipse(x, y, r1, r2)" object method
              Draw a filled ellipse on device dev
              x,y: center point
              r1,r2: x and y radius

"arc"
    "G2::Device::arc(x, y, r1, r2, a1, a2)" object method

    Draw an arc with center point at (x,y), x and y radius given by r1,r2 and starting and ending angle in radians a1,a2

"filled_arc"
    "G2::Device::filled_arc(x, y, r1, r2, a1, a2)" object method
              Draw a filled arc on device dev
              x,y: center point
              r1,r2: x and y radius
              a1,a2: starting and ending angle in radians

"string"
    "G2::Device::string(x, y, char *text)" object method

""  "G2::Device::set_QP(d, enum QPshape shape)" object method

""  "G2::Device::plot_QP(x, y)" object method

AUTHORS
Horst Wagner (wagner@iap.tuwien.ac.at) and Ljubomir Milanovic (ljubo@ap.univie.ac.at)

COPYRIGHT
This program is covered with GNU General Public License (GPL) and not with GNU Library General Public License (LGPL)! It is allowed only for GPL programs to use (static/dynamic linkage or any other using of code) the g2 library. If you want to develop a non GPL application and want to use g2 please contact the authors.

See the GNU General Public License (GPL) for details.

POD ERRORS
Hey! The above document had some coding errors, which are explained below:

Around line 149:
    You forgot a '=back' before '=head2'

Around line 151:
    '=item' outside of any '=over'

Around line 227:
    You forgot a '=back' before '=head2'

Around line 230:
    '=item' outside of any '=over'

Around line 336:
    You forgot a '=back' before '=head1'