Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

drawtool(1) [xfree86 man page]

drawtool(1)						      General Commands Manual						       drawtool(1)

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 interace.  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 prop-
       erty 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 transfor-
       mations 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)
Man Page