sysperfana/perfinvestigator/com.nokia.carbide.cpp.pi.doc.user/html/reference/analyzer/context_menu.htm
changeset 2 b9ab3b238396
child 5 844b047e260d
equal deleted inserted replaced
1:1050670c6980 2:b9ab3b238396
       
     1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
       
     2 "http://www.w3.org/TR/html4/loose.dtd">
       
     3 <html>
       
     4 <head>
       
     5 	<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
       
     6 	<title></title>
       
     7     <link href="../../../book.css" rel="stylesheet" type="text/css">
       
     8     <style type="text/css">
       
     9 <!--
       
    10 .style1 {
       
    11 	font-family: Georgia, "Times New Roman", Times, serif;
       
    12 	font-weight: bold;
       
    13 }
       
    14 -->
       
    15     </style>
       
    16 </head>
       
    17 
       
    18 <body>
       
    19 <h2>Context Menu Options </h2>
       
    20 <p>Right-clicking within the Analyzer graph and tables will display context popup menus that will vary slightly depending on where you initiated the popup menu. The following table lists and defines Analyzer context menu options.</p>
       
    21 <p class="note"><strong>Note </strong>Several menu options allow you to save information to a .csv file that can be opened in a text editor or system editor (such as Excel). Beware that the default filename to save information is <span class="style1">new_file.csv</span>. Specify a unique filename if you do not want the default file to be overwritten each time you save information. </p>
       
    22 <h5>Table 1. Analyzer context menu options</h5>
       
    23 <table width="90%" border="0" cellpadding="2" cellspacing="0" >
       
    24   <tr>
       
    25     <th width="25%" scope="col">Menu Option </th>
       
    26     <th width="581" scope="col">Description</th>
       
    27   </tr>
       
    28   <tr>
       
    29     <td><b>Binary -&gt; Function -&gt; Thread </b></td>
       
    30     <td>Displays the Binary, Function, and Thread tables. The graph will display the Threads from which the selected binaries were executed. The functions within the binaries that were called are listed in the functions table. </td>
       
    31   </tr>
       
    32   <tr>
       
    33     <td><b>Binary -&gt; Thread </b></td>
       
    34     <td>Displays the Binary and Thread tables. The graph will display the threads where the selected binaries were executed.</td>
       
    35   </tr>
       
    36   <tr>
       
    37     <td><b>Binary -&gt; Thread -&gt; Function </b></td>
       
    38     <td>Displays the Binary, Thread, and Function tables. The graph will display the functions that were called in the selected binaries. The threads table lists the threads where the selected binaries were executed.</td>
       
    39   </tr>
       
    40   <tr>
       
    41     <td><b>Binary -&gt;Function </b></td>
       
    42     <td>Displays the Binary and Function tables. The graph will display the functions that were called from within the selected binaries. </td>
       
    43   </tr>
       
    44   <tr>
       
    45     <td><b>Binary Only </b></td>
       
    46     <td>Displays the Binary table and all selected binaries in the graph view. </td>
       
    47   </tr>
       
    48   <tr>
       
    49     <td><span class="style1">Change Event Information...</span> </td>
       
    50     <td>Right-click on a button event marker in the Thread Load, Binary Load, or Function Load graph and select this menu option to display a dialog to <a href="../../tasks/analyser/btn_press_change.htm">change related event information</a>.</td>
       
    51   </tr>
       
    52   <tr>
       
    53     <td><b>Change Threshold Limits... </b></td>
       
    54     <td>Displays the <a href="threshold.htm">Set Thread, Binary, or Function Thresholds</a> dialog box.</td>
       
    55   </tr>
       
    56   <tr>
       
    57     <td><b>Check All Rows </b></td>
       
    58     <td>All rows will be checked and represented on the graph.</td>
       
    59   </tr>
       
    60   <tr>
       
    61     <td><b>Check Highlighted Rows </b></td>
       
    62     <td>This option will place a check mark in all highlighted rows. You can use the shift key and mouse button to select and highlight a continuous sequence  of rows. Use the control key to select and highlight random rows. Checked rows will be visible on the graph.</td>
       
    63   </tr>
       
    64   <tr>
       
    65     <td><b>Copy</b></td>
       
    66     <td>Copies the contents of the selected data from the table to the clipboard.  </td>
       
    67   </tr>
       
    68   <tr>
       
    69     <td><b>Copy Drilldown Tables</b></td>
       
    70     <td>Copies the contents of the entire drilldown table to the clipboard including column titles for easy identification when pasted into a spreadsheet for analysis. </td>
       
    71   </tr>
       
    72   <tr>
       
    73     <td><b>Copy Table</b></td>
       
    74     <td>Copies the contents of the entire table in the current pane to the clipboard including column titles for easy identification when pasted into a spreadsheet for analysis. The table contents do not have to be selected for the table copy to occur.</td>
       
    75   </tr>
       
    76   <tr>
       
    77     <td><span class="style1">Dynamically Rescale Based on Selected Threads </span></td>
       
    78     <td>Right-click in Memory Usage graph and select this option to rescale the graph based on selected threads. </td>
       
    79   </tr>
       
    80   <tr>
       
    81     <td><span class="style1">Function Only </span></td>
       
    82     <td>Displays Functions only. </td>
       
    83   </tr>
       
    84   <tr>
       
    85     <td class="style1">Function -&gt; Thread </td>
       
    86     <td>Displays Functions and related Threads. The graph will display threads containing the function calls. </td>
       
    87   </tr>
       
    88   <tr>
       
    89     <td class="style1">Function -&gt; Thread -&gt; Binary </td>
       
    90     <td>Displays Functions and related Threads and Binaries containing the functions called.</td>
       
    91   </tr>
       
    92   <tr>
       
    93     <td><span class="style1">Memory Usage Statistics </span></td>
       
    94     <td>Right-click in Memory Usage graph and select this menu option to open a Memory Usage Statistics dialog box that reports memory use for the selected time interval.</td>
       
    95   </tr>
       
    96   <tr>
       
    97     <td class="style1">Open Source for Function </td>
       
    98     <td>Opens the source code file containing the selected function in the editor window.</td>
       
    99   </tr>
       
   100   <tr>
       
   101     <td><span class="style1">Power Usage Settings...</span></td>
       
   102     <td>Right-click in the Power Usage graph and select this menu option to display a dialog box that reports the voltage and battery capacity. The values can be modifed as mentioned in <a href="wnd_power_graph_settings.htm">Power Usage Settings</a>.</td>
       
   103   </tr>
       
   104   <tr>
       
   105     <td><span class="style1">Power Usage Statistics </span></td>
       
   106     <td>Right-click in the Power Usage graph and select this option to display a dialog that reports detailed power information for the selected time interval.</td>
       
   107   </tr>
       
   108   <tr>
       
   109     <td><b>Recolor Highlighted Binaries...</b></td>
       
   110     <td>Displays a color swatch for you to choose a different color for a highlighted row. If multiple rows are selected, then multiple color swatch windows will appear. Change or accept current color for each row selected. Selected rows appear grey.</td>
       
   111   </tr>
       
   112   <tr>
       
   113     <td><b>Recolor Highlighted Functions...</b></td>
       
   114     <td>Displays a color swatch for you to choose a different color for a highlighted row. If multiple rows are selected, then multiple color swatch windows will appear. Change or accept current color for each row selected. Selected rows appear grey.</td>
       
   115   </tr>
       
   116   <tr>
       
   117     <td><b>Recolor Highlighted Threads...</b></td>
       
   118     <td>Displays a color swatch for you to choose a different color for a highlighted row. If multiple rows are selected, then multiple color swatch windows will appear. Change or accept current color for each row selected. Selected rows appear grey.</td>
       
   119   </tr>
       
   120   <tr>
       
   121     <td class="style1">Save All Call Samples for Interval... </td>
       
   122     <td>Right-click in one of the Function Call Analysis tables (when Function Calls tab is selected) and choose this option to save all function calls to a .csv file for the selected time interval. Information provided includes the time, caller address, caller function, caller binary, callee address, callee function, and callee binary.</td>
       
   123   </tr>
       
   124   <tr>
       
   125     <td class="style1">Save All Event Samples for Interval... </td>
       
   126     <td>Right-click on a button event marker in the Thread Load, Binary Load, or Function Load graph and choose this option to save all button events for the selected time interval. </td>
       
   127   </tr>
       
   128   <tr>
       
   129     <td><span class="style1">Save All Power Samples for Interval... </span></td>
       
   130     <td>Right-click in the Power Usage graph and select this option to save all collected power samples for the selected time interval.</td>
       
   131   </tr>
       
   132   <tr>
       
   133     <td class="style1">Save Data for Selected Function... </td>
       
   134     <td>Select a function in the Select One Function table (when Function Calls tab is selected) and right-click to choose this option. Detailed information is saved to a .csv file for the selected function. </td>
       
   135   </tr>
       
   136   <tr>
       
   137     <td><b>Save Drilldown Tables...</b></td>
       
   138     <td>Saves the contents of the entire drilldown table (e.g. Thread -&gt; Binary -&gt; Function) to a specified file including column titles for easy identification when opened in a spreadsheet for analysis.</td>
       
   139   </tr>
       
   140   <tr>
       
   141     <td><span class="style1">Save Priority Samples for Checked Threads...</span></td>
       
   142     <td>Saves the priority setting for Threads that are checked in the Thread table. The first entry in the file shows the last value recorded before entering the selected time interval. Subsequent entries show a change in the priority during the interval. Priority settings are detected when a change is made; thus they are not sampled every millisecond.</td>
       
   143   </tr>
       
   144   <tr>
       
   145     <td><span class="style1">Save Samples for Checked Binaries... </span></td>
       
   146     <td>Right-click in the Binary table (when Binaries tab is selected) and choose this option to save samples for binaries that are checked.</td>
       
   147   </tr>
       
   148   <tr>
       
   149     <td><span class="style1">Save Samples for Checked Threads... </span></td>
       
   150     <td>When Threads tab is selected, save samples for Threads that are checked in the Thread table to a .csv file.</td>
       
   151   </tr>
       
   152   <tr>
       
   153     <td><span class="style1">Save Memory Samples for Checked Table Entries...</span> </td>
       
   154     <td>This option is enabled when a time interval is selected. Save memory samples that are checked in the Memory Usage table to a .csv file. The first entry in the file shows the last value recorded before entering the selected time interval. Subsequent entries show changes made during the interval. Memory samples are detected when a change is made; thus they are not sampled every millisecond.</td>
       
   155   </tr>
       
   156   <tr>
       
   157     <td><b>Save Table...</b></td>
       
   158     <td>Saves the contents of the entire table in the current pane to a specified file including column titles for easy identification when opened in a spreadsheet for analysis. The table contents do not have to be selected for the table to be saved.</td>
       
   159   </tr>
       
   160   <tr>
       
   161     <td><b>Select All</b></td>
       
   162     <td>Selects the entire table in the current pane.</td>
       
   163   </tr>
       
   164   <tr>
       
   165     <td><b>Show Entire Graph </b></td>
       
   166     <td>Displays all profiled data in graph.</td>
       
   167   </tr>
       
   168   <tr>
       
   169     <td><b>Show highlighted function's call info </b></td>
       
   170     <td>This context menu option appears in the top and bottom tables of the Function Calls table - <strong>Functions calling the selected function</strong> and <strong>Functions called by the selected function</strong>. Select a function in one of these two tables, right-click and select this option to move the selected function into middle table labeled <strong>Select One Function</strong>. Functions calling and called by the selected function will be displayed in top and bottom tables.</td>
       
   171   </tr>
       
   172   <tr>
       
   173     <td class="style1">Show Selected Interval Average Power Line </td>
       
   174     <td>This option appears when you right-click in the Power Usage graph. Check this option to display the average power for the selected time interval.</td>
       
   175   </tr>
       
   176   <tr>
       
   177     <td><b>Sort by Binary Path, then Binary Name </b></td>
       
   178     <td>In the Binaries and Functions table views, this option will alphabetically sort the path of binaries, then alphabetically sort the binary files by name. Binary path and binary file names are listed in the Binary and Path columns (Binaries table), and In Binary and Path of Binary columns (Functions table). </td>
       
   179   </tr>
       
   180   <tr>
       
   181     <td><strong>Switch Key Press Profile</strong> </td>
       
   182     <td>Opens a dialog that allows you to change the<a href="../../tasks/analyser/key_profile_switch.htm"> key map profile</a> associated with the current NPI file.</td>
       
   183   </tr>
       
   184   <tr>
       
   185     <td><b>Thread -&gt; Binary</b></td>
       
   186     <td>Displays the Thread and Binary tables. The graph will display the binaries that have executed in the selected Thread(s); in relation to the selected time interval. </td>
       
   187   </tr>
       
   188   <tr>
       
   189     <td><b>Thread -&gt; Binary -&gt; Function </b></td>
       
   190     <td>Displays the Thread, Binary, and Function tables. The graph will display the functions that have been called in the selected binaries that exist in the selected threads. </td>
       
   191   </tr>
       
   192   <tr>
       
   193     <td><b>Thread -&gt; Function</b></td>
       
   194     <td>Displays the Thread and Function tables. The graph will display the functions that have been called in the selected threads; in relation to the selected time interval. </td>
       
   195   </tr>
       
   196   <tr>
       
   197     <td><b>Thread -&gt; Function -&gt; Binary </b></td>
       
   198     <td>Displays the Thread, Function, and Binary tables. The graph will display the binaries executed in the selected threads. The functions within the binaries that were called are listed in the functions table.</td>
       
   199   </tr>
       
   200   <tr>
       
   201     <td><b>Thread Only </b></td>
       
   202     <td>Displays the Thread table and all selected threads in the graph view.</td>
       
   203   </tr>
       
   204   <tr>
       
   205     <td><b>Uncheck All Rows </b></td>
       
   206     <td>All rows will be unchecked and all related items will be removed from the graph. </td>
       
   207   </tr>
       
   208   <tr>
       
   209     <td><b>Uncheck Highlighted Rows </b></td>
       
   210     <td>Unchecks highlighted rows and removes the  represented item(s) from the graph. </td>
       
   211   </tr>
       
   212   <tr>
       
   213     <td><b>Zoom In </b></td>
       
   214     <td>Zooms in on the graph view to display more detail. </td>
       
   215   </tr>
       
   216   <tr>
       
   217     <td><b>Zoom Out </b></td>
       
   218     <td>In the graph view, zooms out to display less detail of the selected time interval. </td>
       
   219   </tr>
       
   220   <tr>
       
   221     <td><b>Zoom to Selected Time Interval </b></td>
       
   222     <td>Locates the graph's selected time interval and displays it in center of graph. </td>
       
   223   </tr>
       
   224 </table>
       
   225 <div id="footer">Copyright &copy; 2009 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. <br>License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div>
       
   226 </body>
       
   227 </html>