Send screenshots back to the client for debugging

chrome/common/automation_messages_internal.h

 // Copyright (c) 2011 The Chromium Authors. All rights reserved.
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
 // Defines the IPC messages used by the automation interface.
 
 #include <string>
 #include <vector>
 
 #include "base/string16.h"
@@ skipping 1409 matching lines @@
 // Waits for the autocomplete edit to receive focus.
 IPC_SYNC_MESSAGE_CONTROL1_1(AutomationMsg_WaitForAutocompleteEditFocus,
                             int /* autocomplete edit handle */,
                             bool /* success */)
 
 // Loads all blocked plug-ins on the page.
 IPC_SYNC_MESSAGE_CONTROL1_1(AutomationMsg_LoadBlockedPlugins,
                             int /* tab handle */,
                             bool /* success */)
 
+// TODO(phajdan.jr): Remove this message.
 // Captures the entire page for the tab, including those portions not in
 // view, and saves the image as a PNG in the given file location.
+// This message is deprecated, use the JSON testing interface for
+// similar functionality.
 // Request:
 //   -int: Tab handle
 //   -FilePath: Path to save the captured image to
 // Response:
 //   -bool: Whether the method succeeded
-IPC_SYNC_MESSAGE_CONTROL2_1(AutomationMsg_CaptureEntirePageAsPNG,
+IPC_SYNC_MESSAGE_CONTROL2_1(AutomationMsg_CaptureEntirePageAsPNG_Deprecated,
                             int,
                             FilePath,
                             bool)
 
 // Notify the JavaScript engine in the render to change its parameters
 // while performing stress testing.
 IPC_MESSAGE_CONTROL3(AutomationMsg_JavaScriptStressTestControl,
                      int /* tab handle */,
                      int /* command */,
                      int /* type or run */)
 
 // This message posts a task to the PROCESS_LAUNCHER thread. Once processed
 // the response is sent back. This is useful when you want to make sure all
 // changes to the number of processes have completed.
 IPC_SYNC_MESSAGE_CONTROL0_0(AutomationMsg_WaitForProcessLauncherThreadToGoIdle)
 
 // Gets a handle of the browser that owns the given tab.
 IPC_SYNC_MESSAGE_CONTROL1_2(AutomationMsg_GetParentBrowserOfTab,
                             int /* tab handle */,
                             int /* browser handle */,
                             bool /* success */)