ABSTRACT:This file contains the routines used to display a mask on FSAO through TCL.
Or when using a TCL procedure -
DESCRIPTION:The saoMaskDisplay command will display the specified mask, using FSAOimage. The following must be true before attempting to display a mask -
The values of BOTTOMCOLOR and TOPCOLOR are defined in imtool.h.
See also Generating the mask colors.
SYNTAX: saoMaskDisplay <name> [-t TCL script | -p TCL procedure] [-s FSAO #] <name> Name of mask to display. [-t TCL script | -p TCL procedure] Optional TCL script or procedure used to translate the mask values into color values for display. The default is to assume that the mask associated with the region already specifies the color values. These values must be between 1 and 8. For an example of the TCL script see the top of this page. The TCL procedure can be any user written procedure that takes as a parameter an index into the mask and returns the value of the mask which must be between BOTTOMCOLOR and TOPCOLOR. [-s FSAO #] Optional FSAOimage program to display mask in. The default is to draw the glyph in the lowest numbered FSAOimage program belonging to the current DERVISH process.
DESCRIPTION:The saoMaskColorSet command allows the user to specify the colors to be used when displaying the mask in FSAO. The color names should be those recognized by X (e.g. RED, BLUE, GREEN...) and are not case sensitive. It should be noted that X color names may differ from machine to machine. An exact color match is not guaranteed. An attempt will be made to get the closest available color to the requested color. The specified colors will be used to display all masks until this command is entered with new color values.
Eight colors (plus transparent) can be used to display a mask. By default, the mask color on a monochrome display is white.
SYNTAX: saoMaskColorSet <tclColorList> <tclColorList> TCL list of colors to be used when displaying a mask. Must contain 8 color values. For example, {RED BLUE GREEN YELLOW RED BLUE GREEN YELLOW}
DESCRIPTION:The saoMaskGlyphSet command allows the user to specify the glyph to be used when displaying the mask in FSAO. The glyph is displayed when the image is magnified larger than lifesize. The possible glyphs are "x" or "box". saoMaskGlyphSet can be called only after FSAO is started with saoMaskDisplay and applies only to that particular FSAOimage. By default, FSAO uses the "x" glyph.
SYNTAX: saoMaskGlyphSet <glyph> [-s FSAO #] <glyph> The glyph name -- either X or BOX. [-s FSAO #] Optional FSAOimage program to display mask in. The default is to draw the glyph in the lowest numbered FSAOimage program belonging to the current DERVISH process.