-------------------------------------------
var,funct (left-click): read 3D volume into "im"
  set inim <infile>
  read_images
-------------------------------------------

The "im:" entry (not visible on fn-F2 smaller
interface), shows the name of the first volume
data set.  This data set can be used for surface
operations such as SHRINK (when "ckMRI" is
ticked) or direct_paint (adjacent "P" button).

A default startup of tksurfer from csurf (far
right "load2surf" not ticked) will *not* load
this data set.

The initial part of the path will be abbreviated
using a tidle (~) to represent the current
$SUBJECTS_DIR.

To read (or re-read) that data set, click the "R"
to the right of the entry.

To read in a different data set, enter either:

(1) a COR dir (containing 256 256x256x1byte
    or 512 512x512x1byte COR-??? images in
    coronal orientation, and COR-.info file)

       *or*

(2) an .mgh/.mgh format file (with similar
    orientation, datasize, and imagesize)

and click the "R" to the right of the entry.

The file name can be entered as a relative,
abbreviated, or absolute path.  Assuming
SUBJECTS_DIR equals /usr0/subjects, the following
3 names refer to the same COR dir data set:

  orig
  ~/mri/orig
  /usr0/subjects/martys/mri/orig

and the following 3 names refer to the same .mgz
data set:

  orig.mgz
  ~/mri/orig.mgz
  /usr0/subjects/martys/mri/orig.mgz

A <Return> is same as "R".

To write out the initial dataset, use SAVEIMG or
"W".  Change the name in the entry before
clicking "W" to write out edited data set with a
different name.

Tcl script operation

Here is an example of how to perform these
operations in a tcl script:

  setfile inim ~/mri/orig.mgz
  read_images

The "setfile" command expands the abbreviation
before setting the variable.  Alternatively, the
absolute path can be set directly:

  setfile inim /full/path/to/marty/mri/orig.mgz
  read_images

