Provided by: libg20-perl_0.72-11_amd64 bug

NAME

       G2 - A simple graphics library ported to Perl.

SYNOPSIS

         use G2;

         $dev1 = newX11 G2::Device(775, 575);
         $dev2 = newGD  G2::Device("test.png",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 PNG 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, PNG, 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 PNG,
       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 PNG 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.  Please see g2 documentation (C interface) for up to
       date version.

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.

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

            open a new GD device width,height: width and height of the image in pixels filename:
            name of the output file.  type: file type, 0-jpeg, 1-png returns : a new GD device

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

            Create a new Virtual Device.  An arbitrary number of physical devices (such as PNG,
            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 PNG 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/users-sourceforge.net) and Ljubomir Milanovic
       (ljubo/users-sourceforge-net)

COPYRIGHT

       Copyright (C) 1998-2001  Ljubomir Milanovic & Horst Wagner This file is part of the g2
       library

       This library 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 (at your option) any later version.

       This library 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 this
       library; if not, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330,
       Boston, MA  02111-1307  USA