packages icon



 DRAWTOOL(1)                      DrawTool                       DRAWTOOL(1)
 DrawTool                                                           DrawTool

                               April 11th 1998



 NAME
      drawtool - vector based drawing in gtk

 SYNOPSIS
      drawtool [-g, --geometry WWxHH+XX+YY] [-o, --outfile filename] [-i, --
      infile filename] [-r, --rcfile rcfilename]

      drawtool -h, --help
      drawtool -t, --throughput
      drawtool -b, --nobuttons


 SYNOPSIS
      drawtool Drawtool is a simple application that reads in simple vector
      geometry from stdin and displays it in a gtk window. Similarly, it will
      write data onto stdout as generated by click-drag mouse movements.


 DESCRIPTION
      Drawtool takes newline separated, lines of vector data in a
      proprietary format from stdin by default. It will output data
      corresponding to the actions of the user in an identical format to
      stdout.  Macros can be added in order to extend the program.


 OPTIONS
      -h, --help
           Show the help screen

      -t, --throughput
           Pipe all incoming data to the output stream.

      -g, --geometry
           WWxHH+XX+YY Specify the initial window position in terms of Width
           Height XCoordinate YCoordinate

      -b, --nobuttons
           Omit the buttons from the main window

      -o, --outfile
           filename Use a file for output rather than stdout.

      -i, --infile
           filename Use a file for input rather than stdin.

      -r, --rcfile
           filename Use filename as the config file, rather than the default
           ~/.drawtoolrc




                                    - 1 -         Formatted:  April 26, 2024






 DRAWTOOL(1)                      DrawTool                       DRAWTOOL(1)
 DrawTool                                                           DrawTool

                               April 11th 1998



 MACROS
      drawtool can take advantage of external scripts and binaries that
      generate data.  Macros are called with seven command line arguments,
      x1 y1 x2 y2 r g b where (x1,y1),(x2,y2) specifies the bounding box
      selected by the user, and (r,g,b) are three integers representing the
      red, green and blue components of the current user selected colour. If
      the script is deemed as type 1, then it will be passed all 7
      parameters, but x2,y2 cannot be relied on (this is for operations that
      only require one spot).  Type 2 scripts will be passed the full 7,
      meaning that they are able to determine the bounding box selected by
      the user.


 DATA FORMAT
      where: (x1,y2) or (x2,y2) are integer coordinates and (r,g,b) are
      integer red, green and blue colour values.

      point
           0,x1,y1,r,g,b

      line 1,x1,y1,x2,y2,r,g,b

      empty rectangle
           2,x1,y1,x2,y2,r,g,b

      filled rectangle
           3,x1,y1,x2,y2,r,g,b

      empty circle
           4,x1,y1,radius,r,g,b

      filled circle
           5,x1,y1,radius,r,g,b

      empty ellipse
           6,x1,y1,x2,y2,r,g,b

      filled ellipse
           7,x1,y1,x2,y2,r,g,b


 SEE ALSO (for scripting)
      sh, perl, awk, bc


 BUGS
      tags Too slow, too ugly, totally unreadable source, too memory hungry,
      it uses X.




                                    - 2 -         Formatted:  April 26, 2024






 DRAWTOOL(1)                      DrawTool                       DRAWTOOL(1)
 DrawTool                                                           DrawTool

                               April 11th 1998



      If it crashes on you, please compile it with the -g flag and send me a
      core file (if there is one). Also, if you want the problem fixed, I
      need to be able to reproduce it, so please be clear.


 AUTHOR
      Toby Jaffey <psystrj@granby.nottingham.ac.uk>

      Please mail me with your experiences of using drawtool especially if
      you have extended it in some way, either through hacking the source,
      or preferably by writing nifty macros that do amazing things.









































                                    - 3 -         Formatted:  April 26, 2024