------------------------------------------------
 Surfer -- display surface and activation data
------------------------------------------------
Surfer reads a surface file, and optionally,
functional data, and then renders a view of the
surface. 

home field: subject directory
surf field: surface that is displayed.  
            To view a different surface, enter
            the surface and press RETURN  

READ/WRITE
curv field: cortical curvature file
  READ	read curvature file
  WRITE	write curvature file
patch field: cortical patch file 
  READ	read cortical patch
  WRITE	write cortical patch
label field: not supported - future functionality   
  READ	 
  WRITE	 
fieldsign field: Not supported. Future
                 functionality 
  READ	 
  WRITE	 
val field: val file - same format as *.w files
  READ	read val file
  WRITE	write val file
rgb field:	rgb file 
  WRITE	write rgb file of current surfer window.

Viewing orientation
REDRAW	redraw screen - redraw is not always
        automatic
RESTORE	restore original viewing orientation 
ROTATE
	slider (horizontal)  rotate view around
			     vertical axis 
	slider (vertical)    rotate view around
                             left-right axis
	yrot field	     rotate around y axis 
	xrot field	     rotate around x axis 
	zrot field	     rotate around z axis 
TRANSLATE
	slider (horizontal)  translate left-right 
	slider (vertical)    translate up-down
	x field		     translate in x axis
	y field		     translate in y axis
SCALE
	slider (vertical)    scale larger-smaller
	% field		     scale in percent

Surface Display
BackgroundColor 		
  none radiobutton  do not display curvature
               information (uniformly gray brain) 
  curv radiobutton  display curvature information
               (specified in curv field)
MESH button	display actual vertices and mesh
	r, g, b fields	set color of mesh
cm button	display scale bars 
		(size scale bar = 1cm)

Functional Display
ColScl	color scale of functional data
  w1 radiobutton  not supported - future
                  functionality  
  ht radiobutton  yellow/red for positive values, 
                  blue/green for negative values
  BRw radiobutton not supported - future 
		  functionality
  fs radiobutton  not supported - future 
                  functionality
truncphase	only display positive values
                (red/yellow) 
revphase   not supported - future functionality 
invphase   reverses positive and negative values 
overlay	   displays functional data when checked 
complexval not supported - future functionality 
fthresh field  statistical threshold (for values
  below the threshold, the underlying curvature
  is displayed).  This is equivalent to Stat Hard 
Thresh in Setup Rendering Parameters 
fslope field	color slope from fmid (red/blue)
  to the maximum color (yellow/green).  Maximum
  color (yellow, green) represents a statistical 
  value of fmid + 1/ fslope.  This is equivalent
  to Stat Color Contrast. 
fmid field	statistical value for full
  red/blue.  Equivalent to Stat Color Midpoint  
cslope	contrast of curvature
cmid	     mid-point of curvature colorscale
anglecycle   not supported - future functionality 
angleoffset  not supported - future functionality 
SMOOTH button	smooth curvature or values
                (functional data) 
	field	number of smooth iterations
	curv	smooth curvature
	val	smooth values (functional data)

Cutting Surface
CUTAREA	cuts a close line from selected
	LEFT-CLICKs 
FILL	fills in a region from a selected
	LEFT-CLICK defined by cuts 
CUTPLANE  planar cut.  First 3 LEFT-CLICKs define 
          plane, 4th LEFT-CLICK defines surface
      	  to keep  
CUTLINE	  cuts an open line from selected
	  LEFT-CLICKs	
FILL ROI  fills in a region defined by
    	  statistical values 
UNDO CUT  undoes the most recent cut
RECONNECTALL	undoes all cuts

Standalone Operation

Tksurfer can also be run as a standalone program
from anywhere in the directory tree from the
command line:

Usage: tksurfer -name hemi surf [-tcl script]
       tksurfer -help, -h

   name:  subjname (no dash => read MRI imgs)
   hemi:  lh,rh
   surf:  orig,smoothwm,plump,inflated
