ui/ozone/public/overlay_candidates_ozone.h

   1 // Copyright 2014 The Chromium Authors. All rights reserved.
   2 // Use of this source code is governed by a BSD-style license that can be
   3 // found in the LICENSE file.
   4
   5 #ifndef UI_OZONE_PUBLIC_OVERLAY_CANDIDATES_OZONE_H_
   6 #define UI_OZONE_PUBLIC_OVERLAY_CANDIDATES_OZONE_H_
   7
   8 #include <vector>
   9
  10 #include "base/basictypes.h"
  11 #include "ui/gfx/geometry/rect_f.h"
  12 #include "ui/ozone/ozone_base_export.h"
  13 #include "ui/ozone/public/surface_factory_ozone.h"
  14
  15 namespace ui {
  16
  17 // This class can be used to answer questions about possible overlay
  18 // configurations for a particular output device. We get an instance of this
  19 // class from SurfaceFactoryOzone given an AcceleratedWidget.
  20 class OZONE_BASE_EXPORT OverlayCandidatesOzone {
  21  public:
  22   struct OverlaySurfaceCandidate {
  23     OverlaySurfaceCandidate();
  24     ~OverlaySurfaceCandidate();
  25
  26     // Transformation to apply to layer during composition.
  27     gfx::OverlayTransform transform = gfx::OVERLAY_TRANSFORM_NONE;
  28     // Format of the buffer to composite.
  29     gfx::BufferFormat format = gfx::BufferFormat::BGRA_8888;
  30     // Size of the buffer, in pixels.
  31     gfx::Size buffer_size;
  32     // Rect on the display to position the overlay to. Input rectangle may
  33     // not have integer coordinates, but when accepting for overlay, must
  34     // be modified by CheckOverlaySupport to output integer values.
  35     gfx::RectF display_rect;
  36     // Crop within the buffer to be placed inside |display_rect|.
  37     gfx::RectF crop_rect;
  38     // Stacking order of the overlay plane relative to the main surface,
  39     // which is 0. Signed to allow for "underlays".
  40     int plane_z_order = 0;
  41
  42     // To be modified by the implementer if this candidate can go into
  43     // an overlay.
  44     bool overlay_handled = false;
  45   };
  46
  47   typedef std::vector<OverlaySurfaceCandidate> OverlaySurfaceCandidateList;
  48
  49   // A list of possible overlay candidates is presented to this function.
  50   // The expected result is that those candidates that can be in a separate
  51   // plane are marked with |overlay_handled| set to true, otherwise they are
  52   // to be traditionally composited. When setting |overlay_handled| to true,
  53   // the implementation must also snap |display_rect| to integer coordinates
  54   // if necessary.
  55   virtual void CheckOverlaySupport(OverlaySurfaceCandidateList* surfaces);
  56
  57   virtual ~OverlayCandidatesOzone();
  58 };
  59
  60 }  // namespace ui
  61
  62 #endif  // UI_OZONE_PUBLIC_OVERLAY_CANDIDATES_OZONE_H_