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: October 26, 2025
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: October 26, 2025
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: October 26, 2025
