Add support to send optimal format as part of ScheduleOverlayPlane

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/callback.h"
 #include "base/memory/ref_counted.h"
 #include "build/build_config.h"
+#include "ui/gfx/buffer_types.h"
 #include "ui/gfx/geometry/rect.h"
 #include "ui/gfx/geometry/rect_f.h"
 #include "ui/gfx/geometry/size.h"
 #include "ui/gfx/native_widget_types.h"
 #include "ui/gfx/overlay_transform.h"
 #include "ui/gfx/swap_result.h"
 #include "ui/gl/gl_export.h"
 #include "ui/gl/gl_implementation.h"
 
 namespace gl {
@@ skipping 124 matching lines @@
   // of screen refresh. If unavailable, returns NULL.
   virtual VSyncProvider* GetVSyncProvider();
 
   // Schedule an overlay plane to be shown at swap time, or on the next
   // CommitOverlayPlanes call.
   // |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.
+  // |storage_format| gives a hint about the optimal storage format supported
+  // by the platform for this overlay plane. This can be used to process native
+  // pixmap and store pixel data in that format before scheduling the overlay
+  // plane.
   // |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|.
+  // |handle_scaling| hints if surface needs to handle any required scaling
+  // before scheduling the plane. The value is set to true if scaling needs to
+  // be handled by the surface.
   virtual bool ScheduleOverlayPlane(int z_order,
                                     OverlayTransform transform,
+                                    gfx::BufferFormat storage_format,
                                     gl::GLImage* image,
                                     const Rect& bounds_rect,
-                                    const RectF& crop_rect);
+                                    const RectF& crop_rect,
+                                    bool handle_scaling);
 
   // Schedule a CALayer to be shown at swap time.
   // All arguments correspond to their CALayer properties.
   virtual bool ScheduleCALayer(gl::GLImage* contents_image,
                                const RectF& contents_rect,
                                float opacity,
                                unsigned background_color,
                                const SizeF& size,
                                const Transform& transform);
 
@@ skipping 72 matching lines @@
   bool OnMakeCurrent(GLContext* context) override;
   bool SetBackbufferAllocation(bool allocated) override;
   void SetFrontbufferAllocation(bool allocated) override;
   void* GetShareHandle() override;
   void* GetDisplay() override;
   void* GetConfig() override;
   unsigned GetFormat() override;
   VSyncProvider* GetVSyncProvider() override;
   bool ScheduleOverlayPlane(int z_order,
                             OverlayTransform transform,
+                            gfx::BufferFormat storage_format,
                             gl::GLImage* image,
                             const Rect& bounds_rect,
-                            const RectF& crop_rect) override;
+                            const RectF& crop_rect,
+                            bool handle_scaling) override;
   bool IsSurfaceless() const override;
 
   GLSurface* surface() const { return surface_.get(); }
 
  protected:
   ~GLSurfaceAdapter() override;
 
  private:
   scoped_refptr<GLSurface> surface_;
 
   DISALLOW_COPY_AND_ASSIGN(GLSurfaceAdapter);
 };
 
 }  // namespace gfx
 
 #endif  // UI_GL_GL_SURFACE_H_