Index

label text

Tag subsequent frames in the archive with a specified string label.

Arguments:
String text
The text to write to the mount.frame.label register. This can be any string from 0 up to 12 characters in length.

Example:
The following example would have the string "test" recorded in the mount.frame.label register of subsequent archive frames.
  label "test"

Context:
The label command provides a way for schedules to tag archive frames with arbitrary labels that have some meaning to the offline analysis. For example, a point procedure might record the word "point" in this register, such that offline pointing analysis software could look for frames that have this label.

Note that the mark command provides a similar facility, using single bits to indicate one or more features of interest in a frame. The label and mark mark commands can productively be used together, with the label command providing a way to specify the overall task that is being performed, while the mark command is used to indicate specific stages within this procedure.


Martin Shepherd (6-May-2010)