###################################################################
LATEST EMAIL UPDATE: 19 Jul 2013
###################################################################

here are the latest csurf updates.

  zakros:/home/inverse/freesurfer/tarballs/FreeSurfer0.8-130719.tgz
  zakros:/home/inverse/freesurfer/tarballs/csurf0.8-mac-130719.tgz
  zakros:/home/inverse/freesurfer/tarballs/csurf0.8-linux-130719.tgz

The new main useful things are the new vertex
color label (suffix $hemi-<name>.cols)
and the linear ramp in angle_offset and
angle_cycles function.  I might have
mentioned this in a previous email (my
memory is slowly going down!).  Anyway,
this version is slightly updated.

Vertex Color Labels

A standard label contains vertex numbers,
original surface coords of that vertex,
and data (real or complex).  This will
be rendered using the current color
settings.

A vertex color label contains only
colors, so you can read in some
"paint" for any subset of vertices
that ignores/overrides the current
color scale.

The (help-documented) interface to this
in tksurfer is to middle-click (rather
than default left-clicking) the following
buttons on the "label:" interface line:

  R
  W
  CLR
  [unlabeled check at far left to toggle vtx col labels]

To use this, you would typically

  1) read in some data to the surface
  2) cut out a cortical region using cut and fill
  3) play with the color scale parameters til it looks good
  4) write out a vertex color label

It will auto-replace the suffix in
the label entry .label -> .cols,
so just leave it .label when writing
out a vertex color label.

Linear Ramp in Phase Coloring

The other main thing is the new tksurfer/tcl
function (not currently exposed in interface,
so you have to use a tcl script to use it) for
adding a linear ramp in angle_cycles and
angle_offset (what I did so long ago by hacking
a thousand bitmaps with SGI
utilities...).

The syntax is:

  linrampphase2vtxcol <off1> <cyc1> <off2> <cyc2>

You first have to click twice on
the folded inflated or flattened
surface.  The first click defines
the beginning of the ramp and the
second click the end.  It applies
the linear ramp in angle_offset and
angle_cycles along the line between
the two clicks.  The angle_offset
and angle_cycles beyond the ends of
the line segment are flat (whatever
each end is).

Note that this sets the vertex color fields
(this is how it ignored the current color scale).

The result can be saved to tiff like
any other rendering.

Details of updates appended.

cheers,
marty

##############
UPDATE DETAILS
##############

### UPDATE: 19 Jul 2013
--tksurfer.c: fixed ancient canceled winxdsp-subst-for-winydsp bug:do_one_gl..
--tksurfer.c: print clicked window pix for script use (N.B.: GL-res dependent!)
--tkmedit.c: unoverlap F2 window GL following
--tksurfer.c, surflib.c: added (currently unused) .area2 to vertex structure
--lib/help/csurf/{setupfunct,tkmedit} updated
--csurf: debugged options passed for write_label_timecourses
--tksurfer.c: linrampphase2vtxcol (N.B.: don't wrap func args, use 0.9->1.1)
--tksurfer.c: fix non-unique dump all timecourses along normal
--tksurfer.tcl: fix bug in load scripts to scripts combo, add setfile vclabel
--tksurfer.tcl: rm readdrawvtxcols, middle-clk label CLR button clears vtxcols
--tksurfer.c: remove/unexport read_draw_vtxcol_label, clear_vtxcol_labels
--lib/help/tksurfer/{label_toggle,label_read2val,label_write,label_clear} new
--tksurfer.tcl: middle-click labelflag button toggles vtxcolflag
--tksurfer.tcl: change middle-click "R" to read_vtxcol_label, add a redraw
--tksurfer.tcl: testreplace vtxcols imitates label_to_vtxcol filename create
--tksurfer.c: each subsequent vtxcol polygon set 0.001 above previous
--tksurfer.c: read_vtxcol_label: faster: re-color vertex inside draw_surface
--lib/help/csurf/setupfunct updated
--csurf: rearrange funct:NormSearch parms before tcourseflags, mv CentOffset up
--csurf: add "tALLdx" for -normdsampallflag, BlkCntOff->Cent,PaintAllVtx->PntAll
--tksurfer.c: opt -normdsampallflag to dump multiple timecourses per vertex
--csurf: add INIT/FLIP button to addalignscan panel for standard tkregister flip

### UPDATE: 07 Jun 2013
--tkmedit.tcl: cmd-period toggle WMTRUNC, cmd-K toggle cursor visibility
...




