
###################################################################
UPDATE: 25 Jan 2018
###################################################################


SHRINK, REG parameters documented

36 new tksurfer helpfiles (R-click help for bottom
of tksurfer large F3 panel) were added documenting
adjustable parameters for SHRINK (shrink,
area_shrink, shrink_2d, etc) and REG
(sphere_morph, including data/map-influenced
morph).


Display vertex normals in tksurfer

A control-middle click on the tixbox at the bottom
of the phasecontours box ("phc") toggles display
of vertex normals as yellow lines with ball ends.
The adjoining entry controls the normal line
length (default=2.0).  This turns the brain into a
hairbrush :-}

At initial magnification, the high density of the
vertex normals will merely turn the brain yellow.
You have to zoom in a lot to be able to see
the individual normals.


Divergent/Convergent stereo display

A middle-click on the REDRAW button toggles
between normal and divergent stereo viewing.  The
brain is drawn twice, side-by-side, for stereo
viewing by divergent fixation.  That means, left
copy is viewed by left eye, and right copy is
viewed by right eye.  You can also tape a Google
Daydream to the screen to make fusion easier...


A shift-middle-click on REDRAW toggles convergent
(cross-eyed) stereo.  In this case, the right eye
looks at the left copy and vice versa.  Because
convergent eye position normally goes with close-up
focus, some people find this method of free viewing
easier to achieve (not for stereo glasses).

It is easiest to achieve stereo fusion when there
is single high-contrast target (e.g., brain at
initial magnification), but it is harder to make
out details that way.  If you zoom (shift-R-click
drag up/down) after fusing, you won't break stereo
fusion.  To do that, have your left finger on the
shift key *before* you fuse, since you will break
fusion if you look away at the keyboard.

Stereo viewing is particularly good for
appreciating the orientation of the surface normal
display, and for inspecting the extremely complex
shape of sulci in folded view.


Make exploding brain movie

New tcl script, $CSURF/lib/tcl/explodemovie.tcl,
to explode current surf/hemi and save tiff movie
frames.  This is original cortex explosion that
was presented at SFN 1992 in Anaheim (yup).


-----------------------------------------------
Bug fixes, small changes
-----------------------------------------------

locklabelflag also affects sphere_morph()

allow change arrow/normals diameter

allow change stereo rotation degrees




##########################################################################
UPDATE: 25 Jan 2018
##########################################################################
--lib/help/tksurfer/redraw: update
--tksurfer.c: fix stereo cursor, export stereo_rot_deg
--tksurfer.tcl: shift-middle-click REDRAW toggles convergent stereo
--tksurfer.c: add/export convergentflag for convergent stereo
--tksurfer.tcl: middle-click REDRAW toggles stereoflag
--tksurfer.c: add/export stereoflag: divergent stereo by rotate 4 deg
--tksurfer.tcl: Shift-Return in $arrowscale entry also sets $arrowline to val
--lib/help/tksurfer/arrownorm: update
--tksurfer.tcl: 3rd overload tick bott phasecontour box: toggle display normals
--tksurfer.c: add/export normalsflag/arrowline, allow draw vtx normal vectors
--csurf: add 36 new helpfiles to All Help Contents
--lib/help/tksurfer, mk0{.csh}: add helpfiles: shrink_{wcrv,wsta,wcpx,wa,wbn}
--tksurfer.tcl: rearrange widgets in 3 rows: self/selfd/ck3rd/ar/2d/ck3:{lo,hi}
--lib/help/tksurfer, mk0{.csh}: add helpfiles: shrink_{cthk,whitemid,graymid}
--lib/help/tksurfer, mk0{.csh}: add helpfiles: shrink_{mstrength,mslope}
--lib/help/tksurfer, mk0{.csh}: add helpfiles: shrink_{expand,explode}
--lib/help/tksurfer, mk0{.csh}: add helpfiles: shrink_{update,decay,momentum}
--lib/help/tksurfer, mk0{.csh}: add helpfiles: shrink_{ncthr,ncthr_ck}
--tksurfer.c: locklabelflag also affects sphere_morph()
--tksurfer.tcl: add bindings for 14 new F3 help panels
--lib/help/tksurfer, mk0{.csh}: add helpfiles: shrink_{locklabel}
--lib/help/tksurfer, mk0{.csh}: add helpfiles: shrink_{selfd,areaflag,2dflag}
--lib/help/tksurfer, mk0{.csh}: add helpfiles: shrink_{clearself,writeself}
--lib/help/tksurfer, mk0{.csh}: add helpfiles: shrink_{ckself,ckfill,ckgr,ck3rd}
--lib/help/tksurfer, mk0{.csh}: add helpfiles: shrink_{ws,wn}
--tksurfer.tcl: forcemode errors (on <Ret>)
--lib/help/tksurfer, mk0{.csh}: add helpfiles: shrink_{forcemode,shrink_mmid}
--lib/help/tksurfer, mk0{.csh}: add helpfiles: shrink_{steps,cyc,ckMRI,adj}
--lib/help/csurf/spheresurface: add dist/parea/corr parameter explanations
--lib/tcl/explodemovie.tcl, add to mk0{.csh}
--tksurfer.c: fix explodeflag (by ripfaces), expandflag force: 0.1->$mstrength
--lib/help/tksurfer/outsurf: update for new output formats
--lib/help/csurf/{rc-surfaces,rc-subjects,rc-SURFACE}: help update
--csurf: load non-pre-appended *.vtk, catch/warn on click SURFACE (CHROMA)

##########################################################################
PREVIOUS UPDATE: 18 Oct 2017
##########################################################################
--tksurfer.tcl auto-append .asc/.vtk/.off/.stl/.glb: testreplace warn overwrite
--lib/help/tksurfer/outsurfglb_write: update
--tksurfer.c: write_glb_surface(): uses curr displayed/cached colors
--tksurfer.tcl: add ctrl-shift-right-click prune_annotbord overload label tick
--tksurfer.c: prune_annotbord() if neigh annotbord's >= total neighbors-1 (OK)
--lib/help/tksurfer/label_toggle: update
--tksurfer.tcl: add ctrl-shift-mid-click $annotborddotflag overload label tick
--tksurfer.c: add annotborddotflag (add white dots on label border vertices)
--mk0{.csh}: insttmp: AFNI-req'd libXp .deb in $CSURF_DIR/lib/deb for user inst
--dist/precompiled/deb/{libxp6_1.0.2-2_amd64.deb,libxp6_NOTES.txt}
--fourier.c: read rawdata float BRIK to floatbuff to avoid >32768 overflow
...

