Add GetScrollOffset function to PPB_View

ppapi/api/ppb_view.idl

 /* 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.
  */
 
 /**
  * This file defines the <code>PPB_View</code> struct representing the state
  * of the view of an instance.
  */
 
 [generate_thunk]
 
 label Chrome {
   M18 = 1.0,
-  M28 = 1.1
+  M28 = 1.1,
+  [channel=dev] M37 = 1.2
 };
 
 /**
  * <code>PPB_View</code> represents the state of the view of an instance.
  * You will receive new view information using
  * <code>PPP_Instance.DidChangeView</code>.
  */
 [macro="PPB_VIEW_INTERFACE"]
 interface PPB_View {
   /**
@@ skipping 55 matching lines @@
    * would not be visible to the user, but IsVisible() will return true.
    *
    * Use the result to speed up or stop updates for invisible module
    * instances.
    *
    * This function performs the duties of GetRect() (determining whether the
    * module instance is scrolled into view and the clip rectangle is nonempty)
    * and IsPageVisible() (whether the page is visible to the user).
    *
    * @param resource A <code>PP_Resource</code> corresponding to a
-   * <code>PPB_View</code> resource. 
+   * <code>PPB_View</code> resource.
    *
    * @return <code>PP_TRUE</code> if the instance might be visible to the
    * user, <code>PP_FALSE</code> if it is definitely not visible.
    */
   PP_Bool IsVisible([in] PP_Resource resource);
 
   /**
    * IsPageVisible() determines if the page that contains the module instance
    * is visible. The most common cause of invisible pages is that
    * the page is in a background tab in the browser.
    *
    * Most applications should use IsVisible() instead of this function since
    * the module instance could be scrolled off of a visible page, and this
    * function will still return true. However, depending on how your module
    * interacts with the page, there may be certain updates that you may want to
    * perform when the page is visible even if your specific module instance is
    * not visible.
    *
    * @param resource A <code>PP_Resource</code> corresponding to a
-   * <code>PPB_View</code> resource. 
+   * <code>PPB_View</code> resource.
    *
    * @return <code>PP_TRUE</code> if the instance is plausibly visible to the
    * user, <code>PP_FALSE</code> if it is definitely not visible.
    */
   PP_Bool IsPageVisible([in] PP_Resource resource);
 
   /**
    * GetClipRect() returns the clip rectangle relative to the upper-left corner
    * of the module instance. This rectangle indicates the portions of the module
    * instance that are scrolled into view.
@@ skipping 22 matching lines @@
    * it is likely that the previous backing store of the module instance will
    * be used for the first paint, and will be updated later when your
    * application generates new content with the new clip. This may cause
    * flickering at the boundaries when scrolling. If you do choose to do
    * partial updates, you may want to think about what color the invisible
    * portions of your backing store contain (be it transparent or some
    * background color) or to paint a certain region outside the clip to reduce
    * the visual distraction when this happens.
    *
    * @param resource A <code>PP_Resource</code> corresponding to a
-   * <code>PPB_View</code> resource. 
+   * <code>PPB_View</code> resource.
    *
    * @param clip Output argument receiving the clip rect on success.
    *
    * @return Returns <code>PP_TRUE</code> if the resource was valid and the
    * clip rect was filled in, <code>PP_FALSE</code> if not.
    */
   PP_Bool GetClipRect([in] PP_Resource resource,
                       [out] PP_Rect clip);
 
   /**
@@ skipping 21 matching lines @@
    * pixel coordinates used for Web content.
    *
    * @param[in] resource A <code>PP_Resource</code> corresponding to a
    * <code>PPB_View</code> resource.
    *
    * @return css_scale A <code>float</code> value representing the number of
    * DIPs per CSS pixel. If the resource is invalid, the value will be 0.0.
    */
   [version=1.1]
   float_t GetCSSScale([in] PP_Resource resource);
+
+  /**
+   * GetScrollOffset returns the scroll offset of the window containing the
+   * plugin.
+   *
+   * @param[in] resource A <code>PP_Resource</code> corresponding to a
+   * <code>PPB_View</code> resource.
+   *
+   * @param[out] offset A <code>PP_Point</code> which will be set to the value
+   * of the scroll offset in CSS pixels.
+   *
+   * @return Returns <code>PP_TRUE</code> if the resource was valid and the
+   * offset was filled in, <code>PP_FALSE</code> if not.
+   */
+  [version=1.2]
+  PP_Bool GetScrollOffset([in] PP_Resource resource,
+                          [out] PP_Point offset);
 };