Provided by: ivtools-bin_1.2.11a2-4build2_amd64 bug

NAME

       idraw - drawing editor

SYNOPSIS

       idraw [options] [file]

DESCRIPTION

       Idraw  is a drawing editor that lets you create and edit drawings made up of graphics like
       text, lines, splines, rectangles, polygons, and ellipses.  Drawings are  stored  in  files
       that  can  be  printed on a PostScript printer.  You can can open an existing drawing when
       starting up idraw by typing a file name on the command line.

       Idraw displays a portrait or landscape view of an 8.5 by 11 inch page in its drawing area.
       In  a  column along the drawing area's left side is a set of drawing tool icons, and above
       the drawing area is a set of pull-down menus containing commands.  A panner in  the  lower
       left  corner  lets  you  pan  and  zoom  the  the drawing area.  Along the top is a set of
       indicators that display editing information.

DRAWING TOOLS

       You must engage a tool before you can use it.  You engage a tool by clicking on  its  icon
       or  by  typing  the character below and to the right of its icon.  The icon of the drawing
       tool that's engaged appears in inverted  colors.   Once  engaged,  you  use  the  tool  by
       clicking the left mouse button in the drawing area.

       The  Select,  Move,  Scale, Stretch, Rotate, and Alter tools manipulate existing graphics.
       Magnify makes a part of the view expand to fill the entire view.  Text,  Line,  Multiline,
       Open  Spline,  Ellipse,  Rectangle,  Polygon, and Closed Spline create new graphics.  Each
       tool works as follows:

       Select         Select a graphic, unselecting all others.  A graphic  is  selected  if  its
                      handles  are  visible.  Handles are small inverse-video squares that either
                      surround the graphic  or  demarcate  its  important  points  (such  as  the
                      endpoints  of  a  line). If you hold down the shift key, Select extends the
                      selection: it selects the unselected graphic  (or  unselects  the  selected
                      graphic)  you  clicked on but does not unselect other selections.  Clicking
                      anywhere other than on a graphic unselects everything; you may also drag  a
                      rubberband  rectangle  around  a group of graphics to select all of them at
                      once.  Shortcut: the right mouse button invokes Select while the  mouse  is
                      in the drawing area.

       Move           Move  graphics from one spot to another.  Shortcut: the middle mouse button
                      invokes Move while the mouse is in the drawing area.

       Scale          Scale graphics about their centers.

       Stretch        Stretch graphics vertically or horizontally while tying down  the  opposite
                      edge.

       Rotate         Rotate  graphics  about  their  centers  according to the angle between two
                      radii: the one defined by the original clicking point and the  one  defined
                      by the current dragging point.

       Alter          Modify  a  graphic's  structure.  This tool's effect is described below for
                      each graphic.

       Magnify        Magnify a portion of the drawing specified by sweeping  out  a  rectangular
                      area.   Idraw  will  magnify  the  area  to  occupy  the  entire screen, if
                      possible.

       Text           Create some text.  Left-click to position the first line of text, and  then
                      type  as much text as you want.  You may use emacs-style keystrokes to edit
                      the text as well as enter it.  You can leave text editing  mode  by  typing
                      ESC or by simply clicking somewhere else.  The Alter tool lets you edit the
                      text in an existing text graphic.

       Line           Create a line.  The shift key constrains the line  to  lie  on  either  the
                      vertical or the horizontal axis.  You may left-click with the Alter tool on
                      either endpoint of a line to move the endpoint to a new location.

       Multiline      Create a set of connected lines.  The shift key constrains each segment  to
                      lie  on either the vertical or the horizontal axis.  Each left-click starts
                      a new segment (i.e., adds a vertex);  each  right-click  removes  the  last
                      vertex  added.   The middle button finalizes the multiline.  The Alter tool
                      lets you move, add, and remove vertices from an existing multiline.

       Open Spline    Create an open B-spline.  The shift key constrains each  control  point  to
                      lie on either the vertical or the horizontal axis with the preceding point.
                      Each left-click adds a control point; each  right-click  removes  the  last
                      control  point  added.   The middle button finalizes the spline.  The Alter
                      tool lets you move, add, and remove control points from  an  existing  open
                      spline.

       Ellipse        Create  an ellipse.  The shift key constrains the ellipse to the shape of a
                      circle.  The Alter tool does not affect ellipses.

       Rectangle      Create a rectangle.  The shift key constrains the rectangle to the shape of
                      a   square.    The  Alter  tool  lets  you  move  the  rectangle's  corners
                      independently to form a four-sided polygon.

       Polygon        Create a polygon.  The shift key constrains each side to lie on either  the
                      vertical  or  the  horizontal  axis.   Each left-click starts a new segment
                      (i.e., adds a vertex); each right-click removes the last vertex added.  The
                      middle  button  finalizes  the polygon.  The Alter tool lets you move, add,
                      and remove vertices from an existing polygon.

       Closed Spline  Create a closed B-spline.  The shift key constrains each control  point  to
                      lie on either the vertical or the horizontal axis with the preceding point.
                      Each left-click adds a control point; each  right-click  removes  the  last
                      control  point  added.   The middle button finalizes the spline.  The Alter
                      tool lets you move, add, and remove control points from an existing  closed
                      spline.

PULL-DOWN MENUS

       The  pull-down menus File, Edit, Structure, Font, Brush, Pattern, FgColor, BgColor, Align,
       and View above the  drawing  area  contain  commands  for  editing  the  drawing  and  for
       controlling  idraw's  execution.  The File menu contains the following commands to operate
       on files:

       New            Destroy the current drawing and replace it with an unnamed blank drawing.

       Revert         Reread the current drawing, destroying any unsaved changes.

       Open...        Specify an existing drawing to edit through a FileChooser(3I),  which  lets
                      you browse the file system easily.

       Save As...     Save the current drawing in a file with a specific name.

       Save           Save the current drawing in the file it came from.

       Print...       Send  a  PostScript  version of the drawing to a printer or to a file.  The
                      bold rectangular outline  (called  the  page  boundary)  appearing  in  the
                      drawing  area  indicates the portion of the drawing that will appear on the
                      printed page.

       Import Graphic...
                      Create a graphic from the information in a file  and  insert  it  into  the
                      current  drawing.   Idraw  can  import  images  from files in the following
                      formats: TIFF; PostScript generated  by  pgmtops,  ppmtops,  and  idraw;  X
                      bitmap format; and Unidraw format.

       Quit           Quit idraw.

       The Edit menu contains the following commands for editing graphics:

       Undo           Undo the last editing operation.  Successive Undo commands undo earlier and
                      earlier editing operations.

       Redo           Redo the last editing operation.  Successive Redo commands redo  later  and
                      later  editing operations up to the first operation undone by Undo.  Undone
                      operations that have not been redone are lost as soon as a new operation is
                      performed.

       Cut            Remove the selected graphics from the drawing and place them in a temporary
                      storage area called the clipboard.

       Copy           Copy the selected graphics into the clipboard.

       Paste          Paste copies of the graphics in the clipboard into the drawing.   Together,
                      Cut,  Copy,  and Paste let you transfer graphics between drawings simply by
                      cutting graphics out of one view and pasting them into another.

       Duplicate      Duplicate the selected graphics and add the copies to the drawing.

       Delete         Destroy the selected graphics.

       Select All     Select every graphic in the drawing.

       Flip Horizontal, Flip Vertical
                      Flip the selected graphics into their mirror images along the horizontal or
                      vertical axes.

       90 Clockwise, 90 CounterCW
                      Rotate the selected graphics 90 degrees clockwise or counterclockwise.

       Precise Move..., Precise Scale..., Precise Rotate...
                      Move,  scale, or rotate graphics by exact amounts that you type in a dialog
                      box.  You can specify movements in pixels, points, centimeters, or  inches.
                      Scalings  are specified in terms of magnification factors in the horizontal
                      and vertical dimensions. Rotations are in degrees.

       The Structure menu contains the following commands to modify the structure of the drawing,
       that is, the order in which  graphics are drawn:

       Group          Nest the selected graphics in a newly created picture.  A picture is just a
                      graphic  that  contains  other  graphics.   Group  allows  you   to   build
                      hierarchies of graphics.

       Ungroup        Dissolve any selected pictures.

       Bring To Front Bring  the  selected  graphics to the front of the drawing so that they are
                      drawn on top of (after) other graphics.

       Send To Back   Send the selected graphics to the back of the  drawing  so  that  they  are
                      drawn behind (before) other graphics.

       The  Font menu contains a set of fonts in which to display text.  When you set the current
       font from the menu, you will also set all the selected graphics' fonts to  that  font.   A
       font indicator in the upper right corner displays the current font.

       The  Brush  menu  contains  a  set  of brushes with which to draw lines.  When you set the
       current brush from the menu, you will also set all the selected graphics' brushes to  that
       brush.   The  nonexistent  brush  draws  invisible  lines  and non-outlined graphics.  The
       arrowhead brushes add arrowheads to either or both ends of  lines,  multilines,  and  open
       splines. A brush indicator in the upper left corner displays the current brush.

       The  Pattern  menu  contains  a  set of patterns with which to fill graphics but not text.
       Text always appears solid, but you can use a different color than black to get a halftoned
       shade.  When you set the current pattern from the menu, you will also set all the selected
       graphics' patterns to that pattern.  The  nonexistent  pattern  draws  unfilled  graphics,
       while the other patterns draw graphics filled with a bitmap or a halftoned shade.

       The  FgColor  and  BgColor  menus contains a set of colors with which to draw graphics and
       text.  When you set the current foreground or background color from the FgColor or BgColor
       menu,  you  will also set all the selected graphics' foreground or background colors.  The
       ``on'' bits in the bitmaps for dashed lines and fill patterns  appear  in  the  foreground
       color  while  the  ``off'' bits appear in the background color.  A black and white printer
       will print a halftoned shade of gray for any color other than black or white.  The  brush,
       pattern, and font indicators all reflect the current colors.

       The Align menu contains commands to align graphics with other graphics.  The first graphic
       selected stays fixed while the other  graphics  move  in  the  order  they  were  selected
       according  to the type of alignment chosen.  The last Align command, Align to Grid, aligns
       a key point on each selected graphic to the nearest point on idraw's grid (see below).

       The View menu contains the following commands:

       New View       Create a duplicate idraw window containing a second  view  of  the  current
                      drawing.   The  second view may be panned, zoomed, and edited independently
                      of the first.  Any number of additional views may be made in  this  manner.
                      Changes  made  to  a  drawing  through one view appear synchronously in all
                      other views of the same drawing.  You may also view another drawing in  any
                      idraw window via the Open command.

       Close View     Close  the  current  idraw  window.   Closing  the  last  idraw  window  is
                      equivalent to issuing a Quit command.

       Normal Size    Set the magnification to unity so the drawing appears at actual size.

       Reduce to Fit  Reduce the magnification until the drawing fits entirely within the view.

       Center Page    Center the view over the center of the 8.5 by 11 inch page.

       Orientation    Toggle the drawing's orientation.  If the editor  was  formerly  showing  a
                      portrait  view  of  the  drawing,  it will now show a landscape view of the
                      drawing and vice versa.

       Grid on/off    Toggle idraw's grid on or off.  When the grid is on, idraw draws a grid  of
                      equally spaced points behind the drawing.

       Grid Spacing...
                      Change  the  grid  spacing  by  specifying  one  or two values in the units
                      desired (pixels, points, centimeters, or inches).  If two values are  given
                      (separated  by  a  space),  the  first specifies the horizontal spacing and
                      second the vertical spacing.  One value will specify equal  horizontal  and
                      vertical spacing.

       Gravity on/off Toggle  gravity  on or off.  Gravity constrains tool operation to the grid,
                      whether or not the grid is visible.

X DEFAULTS

       You can customize the number of undoable changes and the font, brush,  pattern,  or  color
       menus  by  setting  resources  in  your  X  defaults  database.   Each  string of the form
       ``idraw.resource:definition'' sets a resource.  For example, to customize any of the paint
       menus, set a resource given by the concatenation of the menu's name and the entry's number
       (e.g., ``idraw.pattern8'') for each entry that you want to override.  All  menus  use  the
       number 1 for the first entry.

       You  must  set  resources only for the entries that you want to override, not all of them.
       If you want to add entries to the menus, simply set resources for  them.   However,  don't
       skip  any  numbers  after  the  end  of  the  menu, because the menu will end at the first
       undefined resource.  To shorten a menu instead of extending it, specify a blank string  as
       the resource for the entry following the last.

       Idraw understands the following resources:

       history        Set the maximum number of undoable changes (20 by default).

       initialfont    Specify  the  font  that  will  be active on startup.  Supply a number that
                      identifies the font by its position in the Font menu starting  from  1  for
                      the first entry.

       fonti          Define a custom font to use for the ith entry in the Font menu.  Give three
                      strings separated by whitespace.  The first string defines the font's name,
                      the  second  string  the corresponding print font, and the third string the
                      print size.  For example, ``idraw.font3:8x13bold Courier-Bold 13''  defines
                      the third font entry.

       initialbrush   Specify  the  brush  that  will  be  active on startup.  Give a number that
                      identifies the brush by its position in the Brush menu starting from 1  for
                      the first entry.

       brushi         Define  a  custom  brush  to  use for the ith entry in the Brush menu.  The
                      definition requires two numbers: a 16-bit hexadecimal number to define  the
                      brush's line style (each 1 bit draws a dash and each 0 bit produces a gap),
                      and a decimal integer to define the brush's width in pixels.  For  example,
                      ``idraw.brush2:ffff  1''  defines  a  single  pixel wide solid line. If the
                      definition  specifies  only  the  string  ``none'',  then  it  defines  the
                      nonexistent brush.

       initialpattern Specify  the  pattern  that  will be active on startup.  Give a number that
                      identifies the pattern by its position in the Pattern menu starting from  1
                      for the first entry.

       patterni       Define  a custom pattern to use for the ith entry in the Pattern menu.  You
                      can specify the pattern from a 16x16 bitmap, a 8x8 bitmap, a 4x4 bitmap,  a
                      grayscale  number,  or  the  string ``none''.  You specify the 16x16 bitmap
                      with sixteen 16-bit hexadecimal numbers, the 8x8 bitmap  with  eight  8-bit
                      hexadecimal  numbers,  the  4x4  bitmap  with  a  single 16-bit hexadecimal
                      number, and the grayscale number with a single floating point number.   The
                      floating  point number must contain a period to distinguish itself from the
                      single hexadecimal number, and it must lie between 0.0 and 1.0,  where  0.0
                      corresponds to a solid pattern and 1.0 to a clear pattern.  On the printer,
                      the bitmap patterns appear as bitmaps, the  grayscale  patterns  appear  as
                      halftoned  shades,  and  the ``none'' patterns never obscure any underlying
                      graphics.   For  example,  ``idraw.pattern8:8421''  defines  a   diagonally
                      hatched pattern.

       initialfgcolor Specify the foreground color that will be active on startup.  Give a number
                      that identifies the color by its position in the FgColor menu starting from
                      1 for the first entry.

       fgcolori       Define a custom color to use for the ith entry in the FgColor menu.  Give a
                      string defining the name of the color and optionally three decimal  numbers
                      between  0  and 65535 following the name to define the red, green, and blue
                      components of the color's intensity.  The intensities  override  the  name;
                      that  is, idraw will look the name up in a window system database of common
                      colors only if you omit the intensities.  You can define shades of gray  by
                      using   equal   proportions   of   each   primary   color.    For  example,
                      ``idraw.fgcolor8:Indigo 48896 0 65280'' defines a color that is  a  mixture
                      of red and blue.

       initialbgcolor Specify the background color that will be active on startup.  Give a number
                      that identifies the color by its position in the BgColor menu starting from
                      1 for the first entry.

       bgcolori       Define  a  custom  color to use for the ith entry in the BgColor menu.  The
                      same rules apply to background colors as to foreground colors.

SEE ALSO

       drawtool(1)

                                                                                         idraw(1)