• saoDrawCircle
  • saoDrawEllipse
  • saoDrawBox
  • saoDrawPolygon
  • saoDrawArrow
  • saoDrawText
  • saoDrawPoint
  • saoReset
  • saoLabel
  • saoGlyph
  • tclSaoDraw.c

    	This file contains TCL verb routines used
    	to draw objects on FSAOimage displays.
    

    saoDrawCircle

    DESCRIPTION:
      The saoCircleDraw TCl command enables the DERVISH user to place a circle of
      user defined size on the FSAOimage display.  All 'glyphs' drawn on the
      display by any saoDraw command can be saved into a file and then
      redrawn on a future display.  This saving and restoring of glyphs is
      done through the FSAOimage cursor read and write commands available on the
      FSAOimage button panel.
    
    TCL SYNTAX:
      saoDrawCircle  row column radius [...] [-ei] [-s num]
         row      Row coordinates for center of circle. (May be a Tcl list.)
         column   Column coordinates for center of circle. (May be a Tcl list.)
         radius   Radius of the circle. (May be a Tcl list.)
         [-e]     Mark this glyph as an exclude glyph.  Same as exclude
                  for SAOimage cursor regions.
         [-i]     Mark this glyph as an include glyph.  Same as include
                  for SAOimage cursor regions. This is the default.
         [-s]     Optional, FSAOimage program in which to draw glyph.
                  The default is to draw the glyph in the lowest
                  numbered FSAOimage program belonging to the current
                  DERVISH process.
      The "..." in the above definition symbolizes additional radius values. 
      When more than one radius value is specified, an annulus is drawn for each
      radius centered at the row and column coordinates.  The resulting annulus
      is treated as a single glyph.
    
      When any of the parameters are passed as a Tcl list, all of the parameters
      must consist of Tcl lists with the same number or arguments.  The drawing
      of the glyphs represented in the lists are treated as separate glyphs (not
      annuli) butare drawn on the display all at once.  This method allows many
      glyphs to be drawn without a display redraw in between each one.
    

    saoDrawEllipse

    DESCRIPTION:
      The saoEllipseDraw TCL command enables the DERVISH user to place a ellipse of
      user defined size on the FSAOimage display.  All 'glyphs' drawn on the 
      display by any saoDraw command can be saved into a file and then redrawn
      on a future display.  This saving and restoring of glyphs is done through
      the FSAOimage cursor read and write commands available on the FSAOimage
      button panel.
    
    TCL SYNTAX:
      saoDrawEllipse  row column rowradius colradius [...] angle [-ei] [-s num]
         row       Row coordinates for center of ellipse. (May be a Tcl list.)
         column    Column coordinates for center of ellipse. (May be a Tcl list.)
         rowradius Number of rows for radius of ellipse. (May be a Tcl list.)
         colradius Number of columns for radius of ellipse. (May be a Tcl list.)
         angle     Rotation angle of ellipse. (May be a Tcl list.)
         [-e]      Mark this glyph as an exclude glyph.  Same as exclude
                   for SAOimage cursor regions.
         [-i]      Mark this glyph as an include glyph.  Same as include
                   for SAOimage cursor regions. This is the default.
         [-s]      Optional, FSAOimage program in which to draw glyph.
                   The default is to draw the glyph in the lowest
                   numbered FSAOimage program belonging to the current
                   DERVISH process. 
    
      The "..." in the above definition symbolizes additional pairs of rowradius
      and colradius values.  When more than one pair of radius values is
      specified, an ellipse is drawn for each pair centered at the row and column
      coordinates.  The resulting series of ellipses is treated as a single glyph.
    
      When any of the parameters are passed as a Tcl list, all of the parameters
      mustconsist of Tcl lists with the same number or arguments.  The drawing
      of the glyphs represented in the lists are treated as separate glyphs (not
      annuli) but are drawn on the display all at once.  This method allows many
      glyphs to be drawn without a display redraw in between each one.
    

    saoDrawBox

    DESCRIPTION:
      The saoBoxDraw TCL command enables the DERVISH user to place a box of  
      user defined size on the FSAOimage display.  All 'glyphs' drawn on the
      display by any saoDraw command can be saved into a file and then redrawn on
      a future display.  This saving and restoring of glyphs is done through the
      FSAOimage cursor read and write commands available on the FSAOimage button
      panel. 
    
    TCL SYNTAX:
      saoDrawBox  row column rowdiam coldiam [...] angle [-ei] [-s num]
         row         Row coordinates for center of box. (May be a Tcl list.)
         column      Column coordinates for center of box.(May be a Tcl list.)
         rowdiam     Number of rows for diameter of box. (May be a Tcl list.)
         coldiam     Number of columns for diameter of box. (May be a Tcl list).
         angle       Rotation angle of box. (May be a Tcl list.)
         [-e]        Mark this glyph as an exclude glyph.  Same as exclude
                     for SAOimage cursor regions.
         [-i]        Mark this glyph as an include glyph.  Same as include
                     for SAOimage cursor regions. This is the default.
         [-s]        Optional, FSAOimage program in which to draw glyph.
                     The default is to draw the glyph in the lowest
                     numbered FSAOimage program belonging to the current
                     DERVISH process. 
    
      The "..." in the above definition symbolizes additional pairs of rowdiam
      and coldiam values.  When more than one pair of diameter values is
      specified, a box is drawn for each pair centered at the row and column
      coordinates.  The resulting series of boxes is treated as a single glyph.
    
      When any of the parameters are passed as a Tcl list, all of the parameters
      mustconsist of Tcl lists with the same number or arguments.  The drawing
      of the glyphs represented in the lists are treated as separate glyphs (not
      annuli) but are drawn on the display all at once.  This method allows many
      glyphs to be drawn without a display redraw in between each one.
    

    saoDrawPolygon

    DESCRIPTION:
      The saoPolygonDraw TCL command enables the dervish user to place a polygon of
      user defined size on the FSAOimage display.  All 'glyphs' drawn on the  
      display by any saoDraw command can saved into a file and then redrawn on a 
      future display.  This saving and restoring of glyphs is done through the
      FSAOimage cursor read and write commands available on the FSAOimage button
      panel.
    
    TCL SYNTAX:
      saoDrawPolygon  row column ... [-ei] [-s num]
         row          Row coordinate for polygon. (May be a Tcl list.)
         column       Column coordinate for polygon. (May be a Tcl list.)
         ...          Additional row and column pairs specifying the polygon.
                      The polygon will be closed automatically.
         [-e]         Mark this glyph as an exclude glyph.  Same as exclude
                      for SAOimage cursor regions.
         [-i]         Mark this glyph as an include glyph.  Same as include
                      for SAOimage cursor regions. This is the default.
         [-s]         Optional, FSAOimage program in which to draw glyph.
                      The default is to draw the glyph in the lowest
                      numbered FSAOimage program belonging to the current
                      DERVISH process. 
    
      When any of the parameters are passed as a Tcl list, all of the parameters
      mustconsist of Tcl lists with the same number or arguments.  The drawing
      of the glyphs represented in the lists are treated as separate glyphs
      but are drawn on the display all at once.  This method allows many
      glyphs to be drawn without a display redraw in between each one.
    

    saoDrawArrow

    DESCRIPTION:
      The saoArrowDraw TCL command enables the DERVISH user to place an arrow of
      user defined size on the FSAOimage display.  All 'glyphs' drawn on the
      display by any saoDraw command can be saved into a file and then redrawn
      on a future display.  This saving and restoring of glyphs is done through
      the FSAOimage cursor read and write commands available on the FSAOimage
      button panel.
    
    TCL SYNTAX:
      saoDrawArrow  row column length angle [-ei] [-s num]
        row       Row coordinates for center of arrow. (May be a Tcl list.)
        column    Column coordinates for center of arrow. (May be a Tcl list.)
        length    Length of arrow. (May be a Tcl list.)
        angle     Rotation angle of arrow. (May be a Tcl list.)
        [-e]      Mark this glyph as an exclude glyph.  Same as exclude
                  for SAOimage cursor regions.
        [-i]      Mark this glyph as an include glyph.  Same as include
                  for SAOimage cursor regions. This is the default.
        [-s]      Optional, FSAOimage program in which to draw glyph.
                  The default is to draw the glyph in the lowest
                  numbered FSAOimage program belonging to the current
                  DERVISH process.
    
      When any of the parameters are passed as a Tcl list, all of the parameters
      mustconsist of Tcl lists with the same number or arguments.  The drawing
      of the glyphs represented in the lists are treated as separate glyphs but
      are drawn on the display all at once.  This method allows many glyphs to
      be drawn without a display redraw in between each one.
    

    saoDrawText

    DESCRIPTION:
      The saoTextDraw TCl command enables the DERVISH user to place text on the
      FSAOimage display.  All 'glyphs' drawn on the display by any saoDraw
      command can be saved into a file and then redrawn on a future display.
      This saving and restoring of glyphs is done through the FSAOimage cursor
      read and write commands available on the FSAOimage button panel.
    
    TCL SYNTAX:
      saoDrawText  row column text [-ei] [-s num]
         row          Row coordinates for lower left corner of text start.
                      (May be a Tcl list.)
         column       Column coordinates for lower left corner of text start.
                      (May be a Tcl list.)
         text         The text, must be enclosed in quotation marks.
                      (May be a Tcl list.)
         [-e]         Mark this glyph as an exclude glyph.  Same as exclude
                      for SAOimage cursor regions.
         [-i]         Mark this glyph as an include glyph.  Same as include
                      for SAOimage cursor regions. This is the default.
         [-s]         Optional, FSAOimage program in which to draw glyph.
                      The default is to draw the glyph in the lowest
                      numbered FSAOimage program belonging to the current
                      DERVISH process.
    
      When any of the parameters are passed as a Tcl list, all of the parameters
      mustconsist of Tcl lists with the same number or arguments.  The drawing
      of the glyphs represented in the lists are treated as separate glyphs
      but are drawn on the display all at once.  This method allows many
      glyphs to be drawn without a display redraw in between each one.
    

    saoDrawPoint

    TCL SYNTAX:
      saoDrawPoint  row column [...] [-ei] [-s num]
         row          Row coordinates for point. (May be a Tcl list.)
         column       Column coordinates for point. (May be a Tcl list.)
         [-e]         Mark this glyph as an exclude glyph.  Same as exclude
                      for SAOimage cursor regions.
         [-i]         Mark this glyph as an include glyph.  Same as include
                      for SAOimage cursor regions. This is the default.
         [-s]         Optional, FSAOimage program in which to draw glyph.
                      The default is to draw the glyph in the lowest
                      numbered FSAOimage program belonging to the current
                      DERVISH process.
    
      The "..." in the above definition symbolizes additional pairs of row
      and column values.  When more than one pair of values is
      specified, a point is drawn for each pair of coordinates.  
      Each point is treated as a separate glyph.
    
      When any of the parameters are passed as a Tcl list, all of the parameters
      mustconsist of Tcl lists with the same number or arguments.  The drawing
      of the glyphs represented in the lists are treated as separate glyphs (not
      annuli) but are drawn on the display all at once.  This method allows many
      glyphs to be drawn without a display redraw in between each one.
    

    saoReset

    DESCRIPTION:
      The saoResetDraw TCL command enables the DERVISH user to reset the FSAOimage
      display by erasing all the previously drawn glyphs.  This command performs
      the same fuchtion as the SAOimage cursor reset button.
    
    TCL SYNTAX:
      saoReset  [-s num]
         [-s]         Optional, FSAOimage program.  The default is to send
                      the command to the lowest numbered FSAOimage program
                      belonging to the current DERVISH process. 
    

    saoLabel

    DESCRIPTION:
      The saoLabel TCL command enables the DERVISH user to toggle the displaying
      of the labels for drawn glyphs on the FSAOimage display.  This command
      performs the same function as the SAOimage cursor label button.  If no
      parameters are passed, the saoLabel command acts as a toggle.
    
    TCL SYNTAX:
      saoLabel  [on] [off] [-s num]
         on           Turns the labeling on
         off          Turns the labeling off
         [-s]         Optional, FSAOimage program.  The default is to send
                      the command to the lowest numbered FSAOimage program
                      belonging to the current DERVISH process.
    

    saoGlyph

    DESCRIPTION:
      The saoGlyph TCL command enables the DERVISH user to toggle the displaying
      of the glyphs on the FSAOimage display. If no
      parameters are passed, the saoGlyph command acts as a toggle.
    
    TCL SYNTAX:
      saoGlyph  [on] [off] [-s num]
         on           Turns the glyphs on
         off          Turns the glyphs off
         [-s]         Optional, FSAOimage program.  The default is to send
                      the command to the lowest numbered FSAOimage program
                      belonging to the current DERVISH process.