NAME

       drawtool - idraw with extensions

SYNOPSIS

       drawtool -import n ['X-params'] [file]

DESCRIPTION

       drawtool  is  an extended version of idraw (originally from the InterViews 3.1).  Based on
       the ivtools OverlayUnidraw library, it adds the following features:

              - double-buffered graphics drawing

              - 3d Motif-like menus and buttons

              - readable text save/restore

              - polygon intersection and clipping tools

              - graphical object attribute annotations

       drawtool is derived from idraw, and implements the  same  set  of  pulldown  commands  and
       palette  of toolbuttons.  Read the idraw man page for details on that part of the drawtool
       user interface.  This page lists only the extensions to idraw embodied in drawtool.

       drawtool saves and restores documents in a readable text format.  This allows  for  manual
       or  programmatic creation of drawtool files.  idraw-format documents can still be imported
       with the "Import Graphic" command, and exported with the Print  command  (both  under  the
       File menu).

       In  addition  to  idraw  format,  the  "Import  Graphic" command supports the importing of
       encapsulated drawtool files, and the following image file formats: TIFF, X11 Bitmap,  PBM,
       PGM,  and PPM.  Compression via compress (.Z) and gzip (.gz) is recognized and handled for
       the script files themselves and the PBM, PGM, and PPM image formats.

       There is also support for opening (via command line or dialog box) and importing  via  the
       net (to the -import port) any arbitrary PostScript file using the pstoedit filter, and any
       GIF, TIFF, or JPEG image, using respectively the giftopnm, tifftopnm, or djpeg filters.

       The "Export Clipboard" command writes the contents  of  the  clipboard  out  in  idraw  or
       drawtool format.

       Commands  have  been  added  to  the Edit menu for selecting by attributes (on the graphic
       objects) and clipping one polygon against another.

       The View menu has been expanded with zoom and pan commands,  plus  commands  to  hide/show
       graphics  and  fix  graphic  sizes  and  locations.   In addition the viewer's panning and
       zooming can be chained to other viewers,  and  the  pointer  device  can  be  put  into  a
       continuous "scribble" mode useful when drawing multilines or polygons.

       The tools have been extended with a possible six new tools: Annotate, Attribute, ClipRect,
       ClipPoly, ConvexHull, and GraphicLoc.  Annotate brings up a text editor in which  graphic-
       specific  text  can  be  entered  and/or  edited.   Attribute  brings  up  a dialog box to
       create/edit property lists for the selected graphic.  ClipRect and ClipPoly clip polygons,
       rectangles,  lines,  and  multilines  if drawtool has been built with the clippoly library
       (otherwise just lines and rectangles). ConvexHull is a convex hull drawing tool  available
       if  qhull can be found in your path.  GraphicLoc displays the coordinates of a mouse-click
       relative to the graphic that has been clicked on.  This is relative to the original screen
       coordinates  of  the  graphic  when  created  (or  the  origin of the raster if an image).
       Subsequent rotations and transformations can give this a non-obvious value.

OPTIONS

       "-import n"
              specifies the port number to run the import service on.  The import service accepts
              connections  over  the  net and reads drawtool or idraw documents and pbmplus image
              formats (PBM/PGM/PPM), plus  JPEG,  GIF,  TIFF,  and  the  non-raster  portions  of
              arbitrary  PostScript  if  appropriate  filters  are  available  (djpeg,  giftopnm,
              tifftopnm, pstoedit).  "-color5" selects a colormap with 5 values per color or  125
              entries (5 cubed).

       "-nocolor6"  overrides  the selection of a colormap with 6 values per color or 216 entries
       (6 cubed).

       "-gray5" selects a colormap with 5 bits of gray-level intensity (32 gray-levels)  arranged
       to maximize rubberband visibility.

       "-gray6" selects a colormap with 6 bits of gray-level intensity (64 gray-levels)  arranged
       to maximize rubberband visibility.

       "-gray7" selects a colormap with 7 bits of gray-level intensity (128 gray-levels) arranged
       to maximize rubberband visibility.

       "-dithermap"  causes  imported  JPEG  rasters  to  be mapped to the standard colormap (the
       default without -nocolor6) and dithered to avoid color banding.

       "-opaque_off" (or "-opoff") disables the opaque (visible) interactive  transformations  of
       graphics.

       "-pagecols" (or "-ncols") sets the horizontal page extent in pixels.

       "-pagerows" (or "-nrows") sets the vertical page extent in pixels.

       "-panner_align  tl|tc|tr|cl|c|cr|cl|bl|br|l|r|t|b|hc|vc"  (or  "-pal  ...")   selects  the
       alignment of the panner display.

       "-panner_off" (or "-poff") disables the panner display.

       "-slider_off" (or "-soff") disables the slider display.

       "-zoomer_off" (or "-zoff") disables the zoomer display.

       "-ptrloc" enables display of the current pointer location.

       "-scribble_pointer (or "-scrpt") enables continuous line drawing.

       "-toolbarloc r|l" (or "-tbl ...") selects the toolbar location.

       Also see "-help" and the idraw man page for more options.

SEE ALSO

            idraw(1)

WEB PAGE

             http://www.ivtools.org/ivtools/drawtool.html

                                                                                      drawtool(1)