ui: Add ScheduleOverlayPlane API to GLImage.

ui/gl/gl_surface.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 UI_GL_GL_SURFACE_H_
 #define UI_GL_GL_SURFACE_H_
 
 #include <string>
 
 #include "base/memory/ref_counted.h"
@@ skipping 88 matching lines @@
   // Get the platfrom specific configuration for this surface, if available.
   virtual void* GetConfig();
 
   // Get the GL pixel format of the surface, if available.
   virtual unsigned GetFormat();
 
   // Get access to a helper providing time of recent refresh and period
   // of screen refresh. If unavailable, returns NULL.
   virtual VSyncProvider* GetVSyncProvider();
 
-  // Schedule an overlay plane to be shown at swap time.
-  // |z_order| specifies the stacking order of the plane relative to the
-  // main framebuffer located at index 0. For the case where there is no
-  // main framebuffer, overlays may be scheduled at 0, taking its place.
-  // |transform| specifies how the buffer is to be transformed during
-  // composition.
-  // |image| to be presented by the overlay.
-  // |bounds_rect| specify where it is supposed to be on the screen in pixels.
-  // |crop_rect| specifies the region within the buffer to be placed inside
-  // |bounds_rect|.
-  virtual bool ScheduleOverlayPlane(int z_order,

[achaulk, 2014/07/30 18:29:51]

We still need a way to get something surface-specific to show the overlay. After
talking with alexst, we think the best approach is to add a "virtual
gfx::AcceleratedWidget GetAcceleratedWidget()" function here. You can add it in
here or I can upload another CL when this goes in

[reveman, 2014/07/30 18:56:11]

Not sure but it seems like it would be more appropriate to get to whatever
surface specific handle you need at a lower level from within the ozone
implementation of ScheduleOverlayPlane. If you actually need  some addition to
the GLSurface API then let's do that separately.

-                                    OverlayTransform transform,
-                                    GLImage* image,
-                                    const Rect& bounds_rect,
-                                    const RectF& crop_rect);
-
   // Create a GL surface that renders directly to a view.
   static scoped_refptr<GLSurface> CreateViewGLSurface(
       gfx::AcceleratedWidget window);
 
   // Create a GL surface used for offscreen rendering.
   static scoped_refptr<GLSurface> CreateOffscreenGLSurface(
       const gfx::Size& size);
 
   static GLSurface* GetCurrent();
 
@@ skipping 34 matching lines @@
   virtual void* GetHandle() OVERRIDE;
   virtual unsigned int GetBackingFrameBufferObject() OVERRIDE;
   virtual bool OnMakeCurrent(GLContext* context) OVERRIDE;
   virtual bool SetBackbufferAllocation(bool allocated) OVERRIDE;
   virtual void SetFrontbufferAllocation(bool allocated) OVERRIDE;
   virtual void* GetShareHandle() OVERRIDE;
   virtual void* GetDisplay() OVERRIDE;
   virtual void* GetConfig() OVERRIDE;
   virtual unsigned GetFormat() OVERRIDE;
   virtual VSyncProvider* GetVSyncProvider() OVERRIDE;
-  virtual bool ScheduleOverlayPlane(int z_order,
-                                    OverlayTransform transform,
-                                    GLImage* image,
-                                    const Rect& bounds_rect,
-                                    const RectF& crop_rect) OVERRIDE;
 
   GLSurface* surface() const { return surface_.get(); }
 
  protected:
   virtual ~GLSurfaceAdapter();
 
  private:
   scoped_refptr<GLSurface> surface_;
 
   DISALLOW_COPY_AND_ASSIGN(GLSurfaceAdapter);
 };
 
 }  // namespace gfx
 
 #endif  // UI_GL_GL_SURFACE_H_