Not for review.

ui/gfx/ozone/dri/hardware_display_controller.h

 // Copyright 2013 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_GFX_OZONE_DRI_HARDWARE_DISPLAY_CONTROLLER_H_
 #define UI_GFX_OZONE_DRI_HARDWARE_DISPLAY_CONTROLLER_H_
 
 #include <stddef.h>
 #include <stdint.h>
 #include <xf86drmMode.h>
 #include <vector>
 
 #include "base/basictypes.h"
 #include "base/memory/scoped_ptr.h"
 #include "ui/gfx/gfx_export.h"
 #include "ui/gfx/ozone/dri/dri_wrapper.h"
+#include "ui/gfx/rect.h"
+#include "ui/gfx/size.h"
 
 namespace gfx {
 
-class DriSurface;
+class ScanoutSurface;
 
 // The HDCOz will handle modesettings and scannout operations for hardware
 // devices.
 //
 // In the DRM world there are 3 components that need to be paired up to be able
 // to display an image to the monitor: CRTC (cathode ray tube controller),
 // encoder and connector. The CRTC determines which framebuffer to read, when
 // to scanout and where to scanout. Encoders converts the stream from the CRTC
 // to the appropriate format for the connector. The connector is the physical
 // connection that monitors connect to.
@@ skipping 77 matching lines @@
   // Set the hardware configuration for this HDCO. Once this is set, the HDCO is
   // responsible for keeping track of the connector and CRTC and cleaning up
   // when it is destroyed.
   void SetControllerInfo(DriWrapper* drm,
                          uint32_t connector_id,
                          uint32_t crtc_id,
                          uint32_t dpms_property_id,
                          drmModeModeInfo mode);
 
   // Associate the HDCO with a surface implementation and initialize it.
-  bool BindSurfaceToController(scoped_ptr<DriSurface> surface);
+  bool BindSurfaceToController(scoped_ptr<ScanoutSurface> surface);
+
+  // Register the framebuffer with handle |handle| with the CRTC. On successful
+  // registration an ID will be associated with it. The ID will be stored in
+  // |framebuffer_id|. The ID will be used when the HDCO will scan out the
+  // framebuffer.
+  bool AddFramebuffer(uint8_t depth,
+                      uint8_t bpp,
+                      uint32_t stride,
+                      uint32_t handle,
+                      uint32_t* framebuffer_id);
+
+  // Remove the association for the framebuffer with ID |framebuffer_id|.
+  bool RemoveFramebuffer(uint32_t framebuffer_id);
 
   // Schedules the |surface_|'s framebuffer to be displayed on the next vsync
   // event. The event will be posted on the graphics card file descriptor |fd_|
   // and it can be read and processed by |drmHandleEvent|. That function can
   // define the callback for the page flip event. A generic data argument will
   // be presented to the callback. We use that argument to pass in the HDCO
   // object the event belongs to.
   //
   // Between this call and the callback, the framebuffer used in this call
   // should not be modified in any way as it would cause screen tearing if the
   // hardware performed the flip. Note that the frontbuffer should also not
   // be modified as it could still be displayed.
   //
   // Note that this function does not block. Also, this function should not be
   // called again before the page flip occurrs.
   //
   // Returns true if the page flip was successfully registered, false otherwise.
   bool SchedulePageFlip();
 
   // Called when the page flip event occurred. The event is provided by the
   // kernel when a VBlank event finished. This allows the controller to
   // update internal state and propagate the update to the surface.
   // The tuple (seconds, useconds) represents the event timestamp. |seconds|
   // represents the number of seconds while |useconds| represents the
   // microseconds (< 1 second) in the timestamp.
   void OnPageFlipEvent(unsigned int frame,
                        unsigned int seconds,
                        unsigned int useconds);
 
+  void SetOverlayPlaneInfo(gfx::Rect overlay_plane_rect,
+                           gfx::Size overlay_plane_size,
+                           unsigned overlay_plane_fb_id);
+
   State get_state() const { return state_; };
 
   int get_fd() const { return drm_->get_fd(); };
 
   const drmModeModeInfo& get_mode() const { return mode_; };
 
-  DriSurface* get_surface() const { return surface_.get(); };
+  ScanoutSurface* get_surface() const { return surface_.get(); };
 
   uint64_t get_time_of_last_flip() const {
     return time_of_last_flip_;
   };
 
  private:
   // Object containing the connection to the graphics device and wraps the API
   // calls to control it.
   DriWrapper* drm_;
 
   // TODO(dnicoara) Need to allow a CRTC to have multiple connectors.
   uint32_t connector_id_;
 
   uint32_t crtc_id_;
 
   uint32_t dpms_property_id_;
 
   // TODO(dnicoara) Need to store all the modes.
   drmModeModeInfo mode_;
 
   // Saved CRTC state from before we used it. Need it to restore state once we
   // are finished using this device.
   drmModeCrtc* saved_crtc_;
 
   State state_;
 
-  scoped_ptr<DriSurface> surface_;
+  scoped_ptr<ScanoutSurface> surface_;
 
   uint64_t time_of_last_flip_;
 
+  gfx::Rect overlay_plane_rect_;
+  gfx::Size overlay_plane_size_;
+  unsigned overlay_plane_fb_id_;
+  int overlay_plane_;
+
   DISALLOW_COPY_AND_ASSIGN(HardwareDisplayController);
 };
 
 }  // namespace gfx
 
 #endif  // UI_GFX_OZONE_DRI_HARDWARE_DISPLAY_CONTROLLER_H_