As soon as a SLOG-2 file is selected in Main window and ready for visualization, the Legend window like the one shown in Figure 3.5 will be displayed. All the features that are going to be discussed in the Legend window affects both the Timeline and Histogram windows.
The Legend window contains mainly a 4-columns legend table. The 4 columns are labeled as Topo, Name, V and S as in Table 3.6.
|
Table 3.6 also lists out all defined mouse operations that are provided in each column. The operations are (1) left mouse clicking on the column title icon and on the column cell as well as (2) right mouse clicking in any column cell.
Figure 3.6 is the Color Chooser dialog that will pop up when one of the icon buttons in column Topo is pressed. The color editor provides 3 different ways of choosing a new color. After selecting a new color from the dialog, the new color will be used to update the icon button. The update won't be carried out in the timeline canvas automatically, explicit screen redraw is needed.
Figure 3.7 shows the popup dialog box either when the title icon of column Name is pressed or when right mouse button is clicked somewhere in the column. There are altogether 6 different sort orders. The first 4 orderings are various combination of alphabetical and case sensitive order, e.g. z...a Z...A refers reverse case sensitive alphabetical ordering. The second last order in the list is called Creation Order which refers to the order in which categories are stored in slog2 file when they are being created. The 4 alphabetical ordering has 2 hidden sort orders. One is called Preview Order which puts the preview drawable category before all the real drawable categories of the same topology. The other is Topo Order which refers to topological ordering, i.e arrow is ahead of state. The preview and topo sort orders can be turned on or off through the Preference window as shown in Table 3.22.
|
Figure 3.8 shows a popup dialog box when the title icon of column V (Visibility) or S (Searchability) is pressed or when right mouse button is clicked somewhere in either columns. The rule of selection in the legend table follows the standard practice of other graphical user interfaces as in the Table 3.10. Together with this standard selection rules, the operations provided in checkbox operation menu allow easy enabling and disabling of visibility as well as searchability checkboxes. With the help of continuous selection of the category rows in the legend table and various sort ordering available, users can easily make a huge number of categories disappear in the Timeline or Histogram window. For instance, in CLOG converted SLOG-2 file where upper case name always refers to MPI names, the case sensitive alphabetical ordering allows all MPI names to be put before all user-defined categories. With continuous mouse selection, user can easily toggle the visibility of user-defined states in the Timeline or Histogram window. Also, every element in the column Name is editable. This allows user to correct undesirable category names set during logfile creation or even facilitate sorting of the names for selection purposes.
|
NOTE: Any changes done in the Legend window that alters the appearance of drawables won't be automatically updated in the timeline canvas until the CanvasReDraw button in the Timeline window is pressed.