#### clear val, other data fields ####
-------------------------------------------
funct: "Clear Real/Imag DataVals (val,val2) (left-click-CLR)"
  clear_values
-------------------------------------------
funct: "Clear Stat Values (stat) (shift-left-clk-CLR)"
  clear_stat
-------------------------------------------
functs: "Clearall (val,val2,valbaks,stat,pval,uniq) (mid-clk-CLR)"
   clear_values
   clear_valbaks
   clear_stats
   clear_pvals
   clear_uniqvoxdata
-------------------------------------------


Detailed Description of val "CLR" Button Actions

-------------------------------------------
funct: "Clear Real/Imag DataVals (val,val2) (left-click-CLR)"
  clear_values
-------------------------------------------

Uses the tcl function clear_values to clear .val
and .val2 fields to zero.  This clears any
visible data off the surface (real or complex
data).

N.B.: this will leave the stat field (.stat) and
the invisible data on the stack bottom (.valbak,
.val2bak) intact.  Use middle-click (see below)
to clear those.

N.B. this will not clear vertex color labels
("paint" that ignores data and color scale
controls, fmid/fslope, etc).  Do a middle-click
on the *label* CLR button to clear vertex color
labels.

-------------------------------------------
funct: "Clear Stat Values (stat) (shift-left-clk-CLR)"
  clear_stat
-------------------------------------------

Uses the tcl function clear_stat to clear the
.stat field to zero.  The .stat field is
not directly visible, but usually used to mask
visible data in the .val/.val2 fields.

-------------------------------------------
functs: "Clearall (vals,valbaks,stat,pval,uniq) (mid-clk-CLR)"
   clear_values
   clear_valbaks
   clear_stats
   clear_pvals
   clear_uniqvoxdata
-------------------------------------------

If the "CLR" button is middle-clicked (instead of
default left-clicked), an alternate, full data
clear is done using these five clear functions:

   clear_values
   clear_valbaks
   clear_stats
   clear_pvals
   clear_uniqdata

This clears all of these 8 vertex data fields:

   vertex[i].val
   vertex[i].val2
   vertex[i].valbak
   vertex[i].val2bak
   vertex[i].stat
   vertex[i].pval
   vertex[i].uniqvoxnum
   vertex[i].uniqvoxcnt

N.B. this will *not* clear vertex color labels.
Use the "CLR" button on the "label:" line
(middle-click).

