Index TableOfContents
Issues: tksufrer label/annotation edit features
Note
Currently (2008-02-24) this description is incomplete -- still accumulating notes.
Summary
In tksurfer, labels can be created via the Custom Fill dialog, and labeled regions can be edited in various ways with the Labels dialog. These features have unexpected effects on the annotation data, which in turn leads to unexpected results if saved in an annotation file, and further unexpected results later when that annotation file is loaded back into tksurfer.
Details
First an orientation to the Labels and Custom Fill dialogs, then an examination of the issues.
Label dialog
Below is an image of the Label dialog on which I have indicated names for its components to faciliate discussion. (These are names from the tksurfer.tcl.)
attachment:tksurfer_labels_dlog_comps.jpg
In general, the controls on the right side of the dialog can be used to set new values for properties of the selected label on the left side. Editing moves are sketched in the figure below:
attachment:tksurfer_labels_dlog_edits.jpg
Custom Fill dialog
The custom fill dialog allows various "fill" operations: Labeling a set of vertices: Ie: giving a set of vertices a new structure code, corresponding name, and color.
Issues
The heart of the problem likely has the following bases:
- Custom Fill dialog: Creation of a new label does not seem to create a corresponding entry (including color) in tksurfer's in-memory LUT
- Label dialog: Applying a color to the selected label updates vertex color in the surface view, but not vertex annotation. Applying a new label to the selected label (using the seemingly ill-named "Apply Name" button) indeed updates the label (and its name) as seen in the surface view and tool window, but not the annotation.
There are a number of symptoms/consequences that relate to this.