tclSaoDraw.c
This file contains TCL verb routines used
to draw objects on FSAOimage displays.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.