Deprecate and remove unused PPB_Flash functions.

ppapi/c/private/ppb_flash.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.
  */
 
-/* From private/ppb_flash.idl modified Mon Oct  8 13:03:27 2012. */
+/* From private/ppb_flash.idl modified Tue Nov 20 10:12:16 2012. */
 
 #ifndef PPAPI_C_PRIVATE_PPB_FLASH_H_
 #define PPAPI_C_PRIVATE_PPB_FLASH_H_
 
 #include "ppapi/c/dev/ppb_font_dev.h"
 #include "ppapi/c/pp_array_output.h"
 #include "ppapi/c/pp_bool.h"
 #include "ppapi/c/pp_instance.h"
 #include "ppapi/c/pp_macros.h"
 #include "ppapi/c/pp_module.h"
 #include "ppapi/c/pp_point.h"
 #include "ppapi/c/pp_rect.h"
 #include "ppapi/c/pp_resource.h"
 #include "ppapi/c/pp_size.h"
 #include "ppapi/c/pp_stdint.h"
 #include "ppapi/c/pp_time.h"
 #include "ppapi/c/pp_var.h"
 
-#define PPB_FLASH_INTERFACE_12_0 "PPB_Flash;12.0"
-#define PPB_FLASH_INTERFACE_12_1 "PPB_Flash;12.1"
-#define PPB_FLASH_INTERFACE_12_2 "PPB_Flash;12.2"
-#define PPB_FLASH_INTERFACE_12_3 "PPB_Flash;12.3"
 #define PPB_FLASH_INTERFACE_12_4 "PPB_Flash;12.4"
 #define PPB_FLASH_INTERFACE_12_5 "PPB_Flash;12.5"
 #define PPB_FLASH_INTERFACE_12_6 "PPB_Flash;12.6"
-#define PPB_FLASH_INTERFACE PPB_FLASH_INTERFACE_12_6
+#define PPB_FLASH_INTERFACE_13_0 "PPB_Flash;13.0"
+#define PPB_FLASH_INTERFACE PPB_FLASH_INTERFACE_13_0
 
 /**
  * @file
  * This file contains the <code>PPB_Flash</code> interface.
  */
 
 
 /**
  * @addtogroup Enums
  * @{
@@ skipping 79 matching lines @@
  */
 
 /**
  * @addtogroup Interfaces
  * @{
  */
 /**
  * The <code>PPB_Flash</code> interface contains pointers to various functions
  * that are only needed to support Pepper Flash.
  */
-struct PPB_Flash_12_6 {
+struct PPB_Flash_13_0 {
   /**
    * Sets or clears the rendering hint that the given plugin instance is always
    * on top of page content. Somewhat more optimized painting can be used in
    * this case.
    */
   void (*SetInstanceAlwaysOnTop)(PP_Instance instance, PP_Bool on_top);
   /**
    * Draws the given pre-laid-out text. It is almost equivalent to Windows'
    * ExtTextOut with the addition of the transformation (a 3x3 matrix given the
    * transform to apply before drawing). It also adds the allow_subpixel_aa
@@ skipping 18 matching lines @@
    */
   struct PP_Var (*GetProxyForURL)(PP_Instance instance, const char* url);
   /**
    * Navigate to the URL given by the given URLRequestInfo. (This supports GETs,
    * POSTs, and javascript: URLs.) May open a new tab if target is not "_self".
    */
   int32_t (*Navigate)(PP_Resource request_info,
                       const char* target,
                       PP_Bool from_user_action);
   /**
-   * Runs a nested message loop. The plugin will be reentered from this call.
-   * This function is used in places where Flash would normally enter a nested
-   * message loop (e.g., when displaying context menus), but Pepper provides
-   * only an asynchronous call. After performing that asynchronous call, call
-   * |RunMessageLoop()|. In the callback, call |QuitMessageLoop()|.
-   */
-  void (*RunMessageLoop)(PP_Instance instance);
-  /* Posts a quit message for the outermost nested message loop. Use this to
-   * exit and return back to the caller after you call RunMessageLoop.
-   */
-  void (*QuitMessageLoop)(PP_Instance instance);
-  /**
    * Retrieves the local time zone offset from GM time for the given UTC time.
    */
   double (*GetLocalTimeZoneOffset)(PP_Instance instance, PP_Time t);
   /**
    * Gets a (string) with "command-line" options for Flash; used to pass
    * run-time debugging parameters, etc.
    */
   struct PP_Var (*GetCommandLineArgs)(PP_Module module);
   /**
    * Loads the given font in a more priviledged process on Windows. Call this if
    * Windows is giving errors for font calls. See
    * content/renderer/font_cache_dispatcher_win.cc
    *
    * The parameter is a pointer to a LOGFONTW structure.
    *
    * On non-Windows platforms, this function does nothing.
    */
   void (*PreloadFontWin)(const void* logfontw);
   /**
    * Returns whether the given rectangle (in the plugin) is topmost, i.e., above
    * all other web content.
    */
   PP_Bool (*IsRectTopmost)(PP_Instance instance, const struct PP_Rect* rect);
   /**
-   * Does nothing, deprecated. See PPB_Flash_Print.
-   */
-  int32_t (*InvokePrinting)(PP_Instance instance);
-  /**
    * Indicates that there's activity and, e.g., the screensaver shouldn't kick
    * in.
    */
   void (*UpdateActivity)(PP_Instance instance);
   /**
-   * Returns the device ID as a string. Returns a PP_VARTYPE_UNDEFINED on error.
-   * Deprecated, use GetDeviceIDAsync.
-   */
-  struct PP_Var (*GetDeviceID)(PP_Instance instance);
-  /**
-   * Deprecated. See GetSetting().
-   */
-  int32_t (*GetSettingInt)(PP_Instance instance, PP_FlashSetting setting);
-  /**
    * Returns the value associated with the given setting. Invalid enums will
    * result in an undefined PP_Var return value.
    */
   struct PP_Var (*GetSetting)(PP_Instance instance, PP_FlashSetting setting);
   /**
    * Allows setting breakpad crash data which will be included in plugin crash
    * reports. Returns PP_FALSE if crash data could not be set.
    */
   PP_Bool (*SetCrashData)(PP_Instance instance,
                           PP_FlashCrashKey key,
                           struct PP_Var value);
   /**
    * Enumerates video capture devices. |video_capture| is a valid
    * PPB_VideoCapture_Dev resource. Once the operation has completed
    * successfully, |devices| will be set up with an array of
    * PPB_DeviceRef_Dev resources.
    *
    * PP_OK is returned on success and different pepper error code on failure.
    * The ref count of the returned |devices| has already been increased by 1 for
    * the caller.
    *
    * NOTE: This method is a synchronous version of |EnumerateDevices| in
    * PPB_VideoCapture_Dev.
    */
   int32_t (*EnumerateVideoCaptureDevices)(PP_Instance instance,
                                           PP_Resource video_capture,
                                           struct PP_ArrayOutput devices);
 };
 
-typedef struct PPB_Flash_12_6 PPB_Flash;
+typedef struct PPB_Flash_13_0 PPB_Flash;
 
-struct PPB_Flash_12_0 {
+struct PPB_Flash_12_4 {
   void (*SetInstanceAlwaysOnTop)(PP_Instance instance, PP_Bool on_top);
   PP_Bool (*DrawGlyphs)(PP_Instance instance,
                         PP_Resource pp_image_data,
-                        const struct PP_FontDescription_Dev* font_desc,
-                        uint32_t color,
-                        const struct PP_Point* position,
-                        const struct PP_Rect* clip,
-                        const float transformation[3][3],
-                        PP_Bool allow_subpixel_aa,
-                        uint32_t glyph_count,
-                        const uint16_t glyph_indices[],
-                        const struct PP_Point glyph_advances[]);
-  struct PP_Var (*GetProxyForURL)(PP_Instance instance, const char* url);
-  int32_t (*Navigate)(PP_Resource request_info,
-                      const char* target,
-                      PP_Bool from_user_action);
-  void (*RunMessageLoop)(PP_Instance instance);
-  void (*QuitMessageLoop)(PP_Instance instance);
-  double (*GetLocalTimeZoneOffset)(PP_Instance instance, PP_Time t);
-  struct PP_Var (*GetCommandLineArgs)(PP_Module module);
-  void (*PreloadFontWin)(const void* logfontw);
-};
-
-struct PPB_Flash_12_1 {
-  void (*SetInstanceAlwaysOnTop)(PP_Instance instance, PP_Bool on_top);
-  PP_Bool (*DrawGlyphs)(PP_Instance instance,
-                        PP_Resource pp_image_data,
-                        const struct PP_FontDescription_Dev* font_desc,
-                        uint32_t color,
-                        const struct PP_Point* position,
-                        const struct PP_Rect* clip,
-                        const float transformation[3][3],
-                        PP_Bool allow_subpixel_aa,
-                        uint32_t glyph_count,
-                        const uint16_t glyph_indices[],
-                        const struct PP_Point glyph_advances[]);
-  struct PP_Var (*GetProxyForURL)(PP_Instance instance, const char* url);
-  int32_t (*Navigate)(PP_Resource request_info,
-                      const char* target,
-                      PP_Bool from_user_action);
-  void (*RunMessageLoop)(PP_Instance instance);
-  void (*QuitMessageLoop)(PP_Instance instance);
-  double (*GetLocalTimeZoneOffset)(PP_Instance instance, PP_Time t);
-  struct PP_Var (*GetCommandLineArgs)(PP_Module module);
-  void (*PreloadFontWin)(const void* logfontw);
-  PP_Bool (*IsRectTopmost)(PP_Instance instance, const struct PP_Rect* rect);
-  int32_t (*InvokePrinting)(PP_Instance instance);
-  void (*UpdateActivity)(PP_Instance instance);
-};
-
-struct PPB_Flash_12_2 {
-  void (*SetInstanceAlwaysOnTop)(PP_Instance instance, PP_Bool on_top);
-  PP_Bool (*DrawGlyphs)(PP_Instance instance,
-                        PP_Resource pp_image_data,
-                        const struct PP_FontDescription_Dev* font_desc,
-                        uint32_t color,
-                        const struct PP_Point* position,
-                        const struct PP_Rect* clip,
-                        const float transformation[3][3],
-                        PP_Bool allow_subpixel_aa,
-                        uint32_t glyph_count,
-                        const uint16_t glyph_indices[],
-                        const struct PP_Point glyph_advances[]);
-  struct PP_Var (*GetProxyForURL)(PP_Instance instance, const char* url);
-  int32_t (*Navigate)(PP_Resource request_info,
-                      const char* target,
-                      PP_Bool from_user_action);
-  void (*RunMessageLoop)(PP_Instance instance);
-  void (*QuitMessageLoop)(PP_Instance instance);
-  double (*GetLocalTimeZoneOffset)(PP_Instance instance, PP_Time t);
-  struct PP_Var (*GetCommandLineArgs)(PP_Module module);
-  void (*PreloadFontWin)(const void* logfontw);
-  PP_Bool (*IsRectTopmost)(PP_Instance instance, const struct PP_Rect* rect);
-  int32_t (*InvokePrinting)(PP_Instance instance);
-  void (*UpdateActivity)(PP_Instance instance);
-  struct PP_Var (*GetDeviceID)(PP_Instance instance);
-};
-
-struct PPB_Flash_12_3 {
-  void (*SetInstanceAlwaysOnTop)(PP_Instance instance, PP_Bool on_top);
-  PP_Bool (*DrawGlyphs)(PP_Instance instance,
-                        PP_Resource pp_image_data,
                         const struct PP_FontDescription_Dev* font_desc,
                         uint32_t color,
                         const struct PP_Point* position,
                         const struct PP_Rect* clip,
                         const float transformation[3][3],
                         PP_Bool allow_subpixel_aa,
                         uint32_t glyph_count,
                         const uint16_t glyph_indices[],
                         const struct PP_Point glyph_advances[]);
   struct PP_Var (*GetProxyForURL)(PP_Instance instance, const char* url);
   int32_t (*Navigate)(PP_Resource request_info,
                       const char* target,
                       PP_Bool from_user_action);
   void (*RunMessageLoop)(PP_Instance instance);
   void (*QuitMessageLoop)(PP_Instance instance);
   double (*GetLocalTimeZoneOffset)(PP_Instance instance, PP_Time t);
   struct PP_Var (*GetCommandLineArgs)(PP_Module module);
   void (*PreloadFontWin)(const void* logfontw);
   PP_Bool (*IsRectTopmost)(PP_Instance instance, const struct PP_Rect* rect);
   int32_t (*InvokePrinting)(PP_Instance instance);
   void (*UpdateActivity)(PP_Instance instance);
   struct PP_Var (*GetDeviceID)(PP_Instance instance);
   int32_t (*GetSettingInt)(PP_Instance instance, PP_FlashSetting setting);
+  struct PP_Var (*GetSetting)(PP_Instance instance, PP_FlashSetting setting);
 };
 
-struct PPB_Flash_12_4 {
+struct PPB_Flash_12_5 {
   void (*SetInstanceAlwaysOnTop)(PP_Instance instance, PP_Bool on_top);
   PP_Bool (*DrawGlyphs)(PP_Instance instance,
                         PP_Resource pp_image_data,
                         const struct PP_FontDescription_Dev* font_desc,
                         uint32_t color,
                         const struct PP_Point* position,
                         const struct PP_Rect* clip,
                         const float transformation[3][3],
                         PP_Bool allow_subpixel_aa,
                         uint32_t glyph_count,
                         const uint16_t glyph_indices[],
                         const struct PP_Point glyph_advances[]);
   struct PP_Var (*GetProxyForURL)(PP_Instance instance, const char* url);
   int32_t (*Navigate)(PP_Resource request_info,
                       const char* target,
                       PP_Bool from_user_action);
   void (*RunMessageLoop)(PP_Instance instance);
   void (*QuitMessageLoop)(PP_Instance instance);
   double (*GetLocalTimeZoneOffset)(PP_Instance instance, PP_Time t);
   struct PP_Var (*GetCommandLineArgs)(PP_Module module);
   void (*PreloadFontWin)(const void* logfontw);
   PP_Bool (*IsRectTopmost)(PP_Instance instance, const struct PP_Rect* rect);
   int32_t (*InvokePrinting)(PP_Instance instance);
   void (*UpdateActivity)(PP_Instance instance);
   struct PP_Var (*GetDeviceID)(PP_Instance instance);
   int32_t (*GetSettingInt)(PP_Instance instance, PP_FlashSetting setting);
   struct PP_Var (*GetSetting)(PP_Instance instance, PP_FlashSetting setting);
+  PP_Bool (*SetCrashData)(PP_Instance instance,
+                          PP_FlashCrashKey key,
+                          struct PP_Var value);
 };
 
-struct PPB_Flash_12_5 {
+struct PPB_Flash_12_6 {
   void (*SetInstanceAlwaysOnTop)(PP_Instance instance, PP_Bool on_top);
   PP_Bool (*DrawGlyphs)(PP_Instance instance,
                         PP_Resource pp_image_data,
                         const struct PP_FontDescription_Dev* font_desc,
                         uint32_t color,
                         const struct PP_Point* position,
                         const struct PP_Rect* clip,
                         const float transformation[3][3],
                         PP_Bool allow_subpixel_aa,
                         uint32_t glyph_count,
@@ skipping 10 matching lines @@
   void (*PreloadFontWin)(const void* logfontw);
   PP_Bool (*IsRectTopmost)(PP_Instance instance, const struct PP_Rect* rect);
   int32_t (*InvokePrinting)(PP_Instance instance);
   void (*UpdateActivity)(PP_Instance instance);
   struct PP_Var (*GetDeviceID)(PP_Instance instance);
   int32_t (*GetSettingInt)(PP_Instance instance, PP_FlashSetting setting);
   struct PP_Var (*GetSetting)(PP_Instance instance, PP_FlashSetting setting);
   PP_Bool (*SetCrashData)(PP_Instance instance,
                           PP_FlashCrashKey key,
                           struct PP_Var value);
+  int32_t (*EnumerateVideoCaptureDevices)(PP_Instance instance,
+                                          PP_Resource video_capture,
+                                          struct PP_ArrayOutput devices);
 };
 /**
  * @}
  */
 
 #endif  /* PPAPI_C_PRIVATE_PPB_FLASH_H_ */