PPAPI: Move PPB_Console out of dev.

ppapi/cpp/instance.h

 // Copyright (c) 2012 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.
 
 #ifndef PPAPI_CPP_INSTANCE_H_
 #define PPAPI_CPP_INSTANCE_H_
 
 /// @file
 /// This file defines the C++ wrapper for an instance.
 
 #include <map>
 #include <string>
 
 #include "ppapi/c/pp_instance.h"
 #include "ppapi/c/pp_resource.h"
 #include "ppapi/c/pp_stdint.h"
+#include "ppapi/c/ppb_console.h"
 #include "ppapi/cpp/instance_handle.h"
 #include "ppapi/cpp/view.h"
 
 // Windows defines 'PostMessage', so we have to undef it.
 #ifdef PostMessage
 #undef PostMessage
 #endif
 
 struct PP_InputEvent;
 
@@ skipping 438 matching lines @@
   /// Refer to HandleMessage() for receiving events from JavaScript.
   ///
   /// @param[in] message A <code>Var</code> containing the data to be sent to
   /// JavaScript. Message can have a numeric, boolean, or string value; arrays
   /// and dictionaries are not yet supported. Ref-counted var types are copied,
   /// and are therefore not shared between the instance and the browser.
   void PostMessage(const Var& message);
 
   /// @}
 
+  /// @{
+  /// @name PPB_Console methods for logging to the console:
+
+  /// Logs the given message to the JavaScript console associated with the
+  /// given plugin instance with the given logging level. The name of the plugin
+  /// issuing the log message will be automatically prepended to the message.
+  /// The value may be any type of Var.
+  void LogToConsole(PP_LogLevel level, const Var& value);
+
+  /// Logs a message to the console with the given source information rather
+  /// than using the internal PPAPI plugin name. The name must be a string var.
+  ///
+  /// The regular log function will automatically prepend the name of your
+  /// plugin to the message as the "source" of the message. Some plugins may
+  /// wish to override this. For example, if your plugin is a Python
+  /// interpreter, you would want log messages to contain the source .py file
+  /// doing the log statement rather than have "python" show up in the console.
+  void LogToConsoleWithSource(PP_LogLevel level,
+                              const Var& source,
+                              const Var& value);
+
+  /// @}
+
   /// AddPerInstanceObject() associates an instance with an interface,
   /// creating an object.
   ///
   /// Many optional interfaces are associated with a plugin instance. For
   /// example, the find in PPP_Find interface receives updates on a per-instance
   /// basis. This "per-instance" tracking allows such objects to associate
   /// themselves with an instance as "the" handler for that interface name.
   ///
   /// In the case of the find example, the find object registers with its
   /// associated instance in its constructor and unregisters in its destructor.
@@ skipping 48 matching lines @@
  private:
   PP_Instance pp_instance_;
 
   typedef std::map<std::string, void*> InterfaceNameToObjectMap;
   InterfaceNameToObjectMap interface_name_to_objects_;
 };
 
 }  // namespace pp
 
 #endif  // PPAPI_CPP_INSTANCE_H_