NMRWish Built-In TCL Functions
drawROI: Draw spectral data (a Region-of-Interest, or ROI) in a graphics area of the screen or a PostScript page.

Flag	Argument	Default	Description
`-roi`			roiID ID Number of ROI to Draw. Default is Current ROI.

Geometric Contour Level Parameters:

`-mult`	`mult`	`1.3`	Contour Level Factor.
`-hi`	`hi`	`Full`	First Contour Height. Use a Number, or a Keyword: Full = Full Dynamic Range. Auto = Use Auto Noise Estimate. Freeze = Use Previous Height Value.

Alternative Contour Level Parameters, or 1D Drawing:

`-fhi`			First Height (Minimum Height).
`-lhi`			Last Height (Maximum Height).

Other Contour Parameters:

`-plev`		`10`	Positive Contour Count.
`-nlev`		`10`	Negative Contour Count.

Contour Line Style:

`-dashPos`			Dashed Lines for Positive Data Only.
`-dashNeg`			Dashed Lines for Negative Data Only.
`-dash`			Dashed Lines for All Data.
`-nodash`			No Dashed Lines (Default).

Display Modes:

`-cont`			Draw Contour Display.
`-pix`			Draw PixMap Display.
`-dot`			Draw Dot Display.
`-stack`			Stack Plot Display.
`-scat`			ROI vs ROI Scatter Plot Display. Requires -roi2 option.

Stack Plot Parameters:

`-fill`	`f`	`0.8`	Width fraction of 1D plots.
`-rise`	`r`	`0.5`	Height fraction of 1D plots.
`-inc`	`i`	`1`	1D Index Increment.
`-yAux`	`yMin yMax`		Graphics limits for Stack Height.

1D Difference Plot Parameters:

`-roi1`	`roiID1`		ID Number of ROI 1 for Plot. Same as -roi option.
`-roi2`	`roiID2`		ID Number of ROI 2 for Plot.

Scatter Plot Parameters:

`-roi1`	`roiID1`	ID Number of ROI 1 for Plot. Same as -roi option.
`-roi2`	`roiID2`	ID Number of ROI 2 for Plot.
`-roi3`	`roiID3`	ID Number of Optional ROI 3, used to Colorize the Plot.

1D Drawing and Orientation:

`-top`			Horizontal 1D.
`-bottom`			Horizontal 1D.
`-left`			Vertical 1D.
`-right`			Vertical 1D.
`-zero`			Draw Zero Line.

Axis Drawing:

`-axis`	`axList`	`None`	Full-Axis Keyword List: Left Right Bottom Top None. Follow with comma-seperated Manual Axis keyword/values.
`-tic`	`axList`	`None`	Center-Tic Axis Keyword List: Left Right Bottom Top None
`-xGrid`	`axInfo`		Draw Grid for X-Axis. Follow with comma-seperated Manual Axis keyword/values.
`-yGrid`	`axInfo`		Draw Grid for X-Axis. Follow with comma-seperated Manual Axis keyword/values.
`-axisOnly`			Draw Axis Only, Without Plot.

TCL/TK Graphics Window Arguments:

`-win`	`wID`	`1`	Canvas Window ID.
`-update`			Flush graphics after drawing.
`-noupdate`			Don`t flush graphics after drawing.

Graphics Size and Justification:

`-xOff`	`xOff`	`0.0`	Additional X Offset. Default Unit is Character Size.
`-yOff`	`yOff`	`0.0`	Additional Y Offset. Default Unit is Character Size.
`-lw1d`	`lw`	`0`	Pixel Width for 1D Screen Drawing.
`-lwZero`	`lw`	`0`	Pixel Width for Zero Line Drawing.
`-thick`			Use thick line width.
`-thin`			Use thin line width.
`-big`			Use larger Font Size.
`-small`			Use smaller Font Size.

Graphics Coords In Terms of ROI Spectral Location:

`-roiX`	`roiXID`	ROI ID for Graphic X Coord.
`-roiY`	`roiYID`	ROI ID for Graphic Y Coord.
`-roiRef`	`roiID`	Sets Both -roiX and -roiY.
`-fold`		Use Folding of Coords (Default).
`-nofold`		No Folding of Coords.

Graphics Coords In Terms of Existing Cell:

`-cellX`	`cellXID`	Cell ID for Graphic X Coord.
`-cellY`	`cellYID`	Cell ID for Graphic Y Coord.
`-cell`	`cellID`	Sets Both -cellX and -cellY.
`-clip`		Clip to Extent of Cell.
`-noclip`		No Clipping.

Bounding Box:

`-box`			Draw Bounding Box.
`-nobox`			No Bounding Box.

Line Thickness, in Printer Points:

`-lw1`	`lw1`	`0.1`	Thin linewidth (grids).
`-lw2`	`lw2`	`1.0`	Thick linewidth (boxes).
`-lwPlus`	`lwp`	`0.1`	Positive contour width.
`-lwMinus`	`lwm`	`1.0`	Negative contour width.

Color and Overlay Options:

`-fg`	`fgClr`	`yellow`	Foreground Color Name.
`-bg`	`bgClr`	`none`	Background Color Name.
`-mask`	`mVal`	`-1`	Plane Mask. -1=All Planes.
`-x11GX`	`xID`	`copy`	X11 Draw Mode ID/Keyword.

ROI Drawing Color Parameters:

`-color1`	`pClr`	`Multi`	Color for Positive Levels.
`-color2`	`nClr`	`Multi`	Color for Negative Levels.
`-colorA`	`aClr`	`yellow`	Color for Axis Text Drawing.
`-colorS`	`sClr`	`black`	Color for Axis Text Shadow.
`-colorG`	`gClr`	`dimGray`	Color for Grid Drawing.
`-plane`		`0`	Overlay Plane to Use.

1D Drawing with Color Fill:

`-fillColor1`	`fc1`	`-1`	Positive Fill Color
`-fillColor2`	`fc2`	`-1`	Negative Fill Color
`-fillColor`	`fc`	`-1`	Sets Both Fill Colors.

Positive Level HSV Color Vector:

`-pcc`	`pCount`	`10`	Positive Color Count.
`-pHue1`	`hue`	`0.5`	First Hue (0-1).
`-pHueN`	`hue`	`0.7`	Last Hue (0-1).
`-pSat1`	`saturation`	`0.8`	First Saturation (0-1).
`-pSatN`	`saturation`	`1.0`	Last Saturation (0-1).
`-pVal1`	`value`	`1.0`	First Value (0-1).
`-pValN`	`value`	`1.0`	Last Value (0-1).

Negative Level HSV Color Vector:

`-ncc`	`nCount`	`10`	Negative Color Count.
`-nHue1`	`hue`	`0.5`	First Hue (0-1).
`-nHueN`	`hue`	`0.7`	Last Hue (0-1).
`-nSat1`	`saturation`	`0.8`	First Saturation (0-1).
`-nSatN`	`saturation`	`1.0`	Last Saturation (0-1).
`-nVal1`	`value`	`1.0`	First Value (0-1).
`-nValN`	`value`	`1.0`	Last Value (0-1).

Arguments for Report Generation:

`-noverb`			Verbose Mode Off.
`-verb`			Verbose Mode On.

Graphics Coordinates:
X Coord Increases from Left to Right.
Y Coord Increases from Top to Bottom.
No Label = Pixels, Absolute Coordinate.
pix = Pixels, Absolute Coordinate.
in = Inches, Relative to Cell.
cm = Centimeter, Relative to Cell.
mm = Millimeter, Relative to Cell.
c1 = Char Size of Small Font, Relative to Cell.
c2 = Char Size of Big Font, Relative to Cell.
% = Percent of Screen, Relative to Cell.
Display Region Aspect Ratios:
[ppm|Hz|Pts|%]/[Pix|In|cm|mm|c1|c2|%]
Manual Axis Keyword/Value Pairs:
units= Axis units keyword (PPM, etc).
orig= Axis origin value.
end= Axis endpoint value.
step= Axis step value.
tic= Axis tic count.
fmt= Axis print format (%f etc).
lab= Axis label.

Frank Delaglio, Ph.D.