carbidecpp22devenv/configuration/org.eclipse.osgi/bundles/309/1/.cp/reference/cdt_u_memoryview.htm
changeset 5 684bf18fdedf
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/carbidecpp22devenv/configuration/org.eclipse.osgi/bundles/309/1/.cp/reference/cdt_u_memoryview.htm	Fri Dec 04 10:01:33 2009 -0600
@@ -0,0 +1,195 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
+<html lang="en">
+ 
+<head>
+<meta http-equiv="Content-Language" content="en-us">
+<meta name="GENERATOR" content="Microsoft FrontPage 5.0">
+<meta name="ProgId" content="FrontPage.Editor.Document">
+<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+<title>Memory view</title>
+<link rel="stylesheet" type="text/css" href="../help.css">
+</head>
+<body>
+
+<h1>Memory view</h1>
+
+<p>The <b>Memory</b> view of the Debug
+perspective lets you monitor and modify your process memory. The process memory
+is presented as a list of so called <b>memory monitors</b>. Each monitor represents
+a section of memory specified by it's location called <b>base address</b>. Each
+memory monitor can be displayed in different predefined data formats -- <b>memory
+renderings</b>. The debugger supports five rendering types -- <b>hexadecimal</b>
+(default), <b>ascii</b>, <b>signed integer</b> and <b>unsigned integer</b>. The
+default rendering is displayed automatically on the monitor creation.</p>
+<p><img src="../images/view_memory.png" width="718" height="235" alt="Memory View"></p>
+<p>The Memory view contains two
+panes -- the <b>Memory Monitors</b> pane and the <b>Memory Renderings</b> pane. The
+Memory Monitors pane displays the list of memory monitors added to the debug
+session currently selected in the Debug view. The content of the Memory
+Renderings pane is controlled by the selection in the Memory Monitors pane and
+consists of the tabs that display renderings. The Memory Renderings pane can be
+configured to display two renderings simultaneously.</p>
+
+<h3>Memory view toolbar icons</h3>
+<p>The table below lists the icons displayed in the Memory view toolbar.</p>
+<table border="1" cellpadding="5" cellspacing="0" style="border-collapse: collapse" bordercolor="#999999" width="600">
+  <tr>
+    <td width="16%" align="left"><div align="center"><b>Command</b></div></td>
+    <td width="32%"><div align="center"><b>Name</b></div></td>
+    <td width="52%"><div align="center"><b>Description</b></div></td>
+  </tr>
+  <tr>
+    <td valign="top"><div align="center"><img src="../images/icon_new_memory_view.png" width="22" height="21" alt="New Memory View icon"></div></td>
+    <td valign="top"><div align="left">New Memory View </div></td>
+    <td valign="top">Click to create a new memory view.</td>
+  </tr>
+  <tr>
+    <td valign="top"><div align="center"><img src="../images/icon_pin_memory.png" width="21" height="21" alt="Pin Memory Monitor icon"></div></td>
+    <td valign="top"><div align="left">Pin Memory Monitor </div></td>
+    <td valign="top">Select to pin the memory monitor on top of all other memory monitors. </td>
+  </tr>
+  <tr>
+    <td valign="top"><div align="center"><img src="../images/icon_toggle_memory_monitor.png" width="22" height="21" alt="Toggle Memory Monitors icon"></div></td>
+    <td valign="top"><div align="left">Toggle Memory Monitors Pane </div></td>
+    <td valign="top">Shows/hides the Memory Monitor pane.</td>
+  </tr>
+  <tr>
+    <td valign="top"><div align="center"><img src="../images/icon_toggle_split_pane.png" width="23" height="21" alt="Toggle Split Pane icon"></div></td>
+    <td valign="top"><div align="left">Toggle Split Pane </div></td>
+    <td valign="top">Toggles the Memory Renderings pane split.</td>
+  </tr>
+  <tr>
+    <td valign="top"><div align="center"><img src="../images/icon_link_mem_rendering.png" width="22" height="22" alt="Link Memory Rendering Panes icon"></div></td>
+    <td valign="top"><div align="left">Link Memory Rendering Panes </div></td>
+    <td valign="top">Synchronizes the selection of two memory renderings.</td>
+  </tr>
+  <tr>
+    <td valign="top"><div align="center"><img src="../images/icon_switch_mem_monitor.png" width="33" height="20" alt="Switch Memory Monitor icon"></div></td>
+    <td valign="top"><div align="left">Switch Memory Monitor </div></td>
+    <td valign="top">When more than one memory monitor is active, select a different memory monitor to view. </td>
+  </tr>
+  <tr>
+    <td valign="top">&nbsp;</td>
+    <td valign="top">Menu &gt; Layout </td>
+    <td valign="top">Switch  the Monitors and Rendering panes display between horizontal or vertical orientation. </td>
+  </tr>
+  <tr>
+    <td valign="top">&nbsp;</td>
+    <td valign="top">Menu &gt; Preferences </td>
+    <td valign="top"><p>Opens the Preferences window allowing you to set:</p>
+      <ul>
+	  <li><b>Reset Memory Monitor</b> - set to reset only visible or all renderings when reseting a memory monitor </li>
+	  <li><b>Padded String</b> - enter strings to show unretrievable memory </li>
+	  <li><b>Select Codepages</b> - specify the standard to convert memory to ASCII and EBCDIC strings </li>
+    </ul>  </tr>
+  <tr>
+    <td valign="top">&nbsp;</td>
+    <td valign="top">Menu &gt; Table Rendering Preferences </td>
+    <td valign="top">Specify the memory loading mode to use when rendering scrolls to the end of the buffer. </td>
+  </tr>
+</table>
+
+  <h3>Monitors pane context menu </h3>
+  <p>The Monitors pane context menu inside the Memory view  includes:</p>
+  <table border="1" cellpadding="5" cellspacing="0" style="border-collapse: collapse" bordercolor="#999999" width="600">
+    <tr>
+      <td width="19%" align="left"><div align="center"><b>Command</b></div></td>
+      <td width="35%"><div align="center"><b>Name</b></div></td>
+      <td width="46%"><div align="center"><b>Description</b></div></td>
+    </tr>
+    <tr>
+      <td valign="top"><div align="center"><img src="../images/icon_add_mem_monitor.png" width="18" height="18" alt="Add Memory Monitor icon"></div></td>
+      <td valign="top"><div align="left">Add Memory Monitor </div></td>
+      <td valign="top">Adds a new memory address or variable to the Memory Monitors pane.</td>
+    </tr>
+    <tr>
+      <td valign="top"><div align="center"><img src="../images/icon_remove.png" width="22" height="22" alt="Remote Memory Monitor icon"></div></td>
+      <td valign="top"><div align="left">Remove Memory Monitor </div></td>
+      <td valign="top">Removes the selected memory address or variable from the Memory Monitors pane.</td>
+    </tr>
+    <tr>
+      <td valign="top"><div align="center"><img src="../images/icon_reset_mem_monitor.png" width="24" height="22" alt="Reset icon"></div></td>
+      <td valign="top"><div align="left">Reset </div></td>
+      <td valign="top">Resets the current memory monitor  view. </td>
+    </tr>
+  </table>
+
+  <h3>Rendering pane context menu </h3>
+  <p>The Rendering pane context menu inside the Memory view  includes:</p>
+  <table border="1" cellpadding="5" cellspacing="0" style="border-collapse: collapse" bordercolor="#999999" width="600">
+    <tr>
+      <td width="19%" align="left"><div align="center"><b>Command</b></div></td>
+      <td width="35%"><div align="center"><b>Name</b></div></td>
+      <td width="46%"><div align="center"><b>Description</b></div></td>
+    </tr>
+    <tr>
+      <td valign="top"><div align="center"><img src="../images/icon_add_mem_monitor.png" width="18" height="18" alt="Add Rendering icon"></div></td>
+      <td valign="top"><div align="left">Add Rendering </div></td>
+      <td valign="top">Add a memory rendering pane to display a memory monitor item at a different address or in a different format.</td>
+    </tr>
+    <tr>
+      <td valign="top"><div align="center"><img src="../images/icon_remove.png" width="22" height="22" alt="Remote Rendering icon"></div></td>
+      <td valign="top"><div align="left">Remove Rendering </div></td>
+      <td valign="top">Removes the selected rendering from the Memory view.</td>
+    </tr>
+    <tr>
+      <td valign="top">&nbsp;</td>
+      <td valign="top">Panes</td>
+      <td valign="top">Enable or disable the showing of the Address, Binary, and Text portions of the rendering view. </td>
+    </tr>
+    <tr>
+      <td valign="top">&nbsp;</td>
+      <td valign="top">Endian</td>
+      <td valign="top">Toggle between the Little (default) and Big   Endian display of memory. </td>
+    </tr>
+    <tr>
+      <td valign="top">&nbsp;</td>
+      <td valign="top">Text</td>
+      <td valign="top">Choose the character encoding used to convert memory values into text for display. Choices include: ISO-8859-1 (default), US-ASCII, or UTF-8. </td>
+    </tr>
+    <tr>
+      <td valign="top">&nbsp;</td>
+      <td valign="top">Cell Size </td>
+      <td valign="top">Specify the cell size used to display values in the Binary column. Choices include: 1, 2, 4 (default), and 8 bytes. </td>
+    </tr>
+    <tr>
+      <td valign="top">&nbsp;</td>
+      <td valign="top">Radix</td>
+      <td valign="top">Specify the radix used to display the  values in the Binary column. Choices include: Hex, Decimal Signed, Decimal Unsigned (default), Octal, and Binary. </td>
+    </tr>
+    <tr>
+      <td valign="top"><div align="center"><img src="../images/icon_copy_to_clipboard.png" width="22" height="23" alt="Copy to Clipboard icon"></div></td>
+      <td valign="top">Copy To Clipboard </td>
+      <td valign="top">Copies the selected portion of the Rendering pane to the clipboard. </td>
+    </tr>
+    <tr>
+      <td valign="top">&nbsp;</td>
+      <td valign="top">Go To Address </td>
+      <td valign="top">Opens an edit box to type in a memory address. Press Enter to go to that address and show it in the Rendering pane. </td>
+    </tr>
+    <tr>
+      <td valign="top">&nbsp;</td>
+      <td valign="top">Reset To Base Address </td>
+      <td valign="top">Resets the Rendering pane to the original base address. </td>
+    </tr>
+    <tr>
+      <td valign="top"><div align="center"></div></td>
+      <td valign="top"><div align="left">Refresh</div></td>
+      <td valign="top">Refreshes the Rendering pane. </td>
+    </tr>
+  </table>
+
+<p><img border="0" src="../images/ngconcepts.gif" ALT="Related concepts" width="143" height="21">
+<br>
+<a href="../concepts/cdt_c_dbg_info.htm">Debug information</a></p>
+<p><img border="0" src="../images/ngtasks.gif" ALT="Related tasks" width="143" height="21">
+<br>
+<a href="../tasks/cdt_t_memory.htm">Working with memory</a></p>
+<p><img border="0" src="../images/ngref.gif" ALT="Related reference" width="143" height="21">
+<br>
+<a href="cdt_o_views.htm">Views</a></p>
+<img src="../images/ng00_04a.gif" ALT="IBM Copyright Statement" >
+
+</body>
+
+</html>