docs/html/tools/help/am-screenshot.jd

page.title=Screen Capture
parent.title=Android Monitor
parent.link=android-monitor.html
meta.tags="android, performance, profiling, tools, monitor"
page.tags="android", "performance", "profiling", "tools", "monitor"
page.metaDescription=Use the Screen Capture tool to take a screenshot of the display on a hardware device or the emulator. Optionally display the screenshot within a graphic of a device.
page.image=tools/help/thumbnails/am_screenshot.png
page.article=true
@jd:body


<p>
  You can take a PNG screenshot of the display on a connected device or the emulator. You can use
  the images for your marketing materials as well as for debugging, for example.
</p>


<h2 id="screencapture">
  Taking a Screen Capture of the Device
</h2>


<p>
  To take a screen capture:
</p>
<ol>
  <li>Meet the <a href=
  "{@docRoot}tools/help/am-basics.html#byb">prerequisites and dependencies</a>.
  </li>
 <li>Open an app project.
  </li>
  <li><a href=
  "{@docRoot}tools/building/building-studio.html#RunningApp">Run the app</a> on
  a hardware device or emulator.
  </li>
  <li>
    <a href="{@docRoot}tools/help/am-basics.html#displaying">Display Android Monitor</a>.
  </li>

  <li>Interact with the display on the device or emulator to stage the image you want.
  </li>

  <li>Click Screen Capture <img src="{@docRoot}images/tools/am-iscreencapture.png"
    style="vertical-align:sub;margin:0;height:17px" alt="Screen Capture icon" /> in the
    Android Monitor toolbar.
  </li>
  <p>The screenshot appears in a <em>Screenshot Editor</em> window.</p>

<img src="{@docRoot}images/tools/am-screenshot.png" alt="Screen Capture" />

  <li>Optionally change the image:
    <ul>
      <li>
        <strong>Recapture</strong> - Click to take a new screenshot.
      </li>

      <li>
        <strong>Rotate</strong> - Click to rotate the image 90 degrees clockwise.
      </li>

      <li>
        <strong>Frame Screenshot</strong> - Select this option and choose a device to add an image
        of the device to the outside of the screenshot. Select <strong>Drop Shadow</strong>,
        <strong>Screen Glare</strong>, or both to add these effects to your image.
      </li>

      <li>
        <strong>Chessboard</strong> and <strong>Grid</strong> - Select an option to display these
        behind your image.
      </li>

      <li>
        <strong>Zoom In</strong>, <strong>Zoom Out</strong>, or <strong>Actual Size</strong> -
        Click these options to get different perspectives of your image without changing the image
        itself.
      </li>
    </ul>
    </li>
      <li>Click <strong>Save</strong> to save the image.
      </li>
      </li>
      <li>In the <em>Save as PNG</em> dialog, specify the location and filename,
      and then click <strong>OK</strong>.
      </li>
      <p>The screenshot file appears in the Code Editor area.</p>
</ol>