cc/output/renderer.h

   1 // Copyright 2012 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 CC_OUTPUT_RENDERER_H_
   6 #define CC_OUTPUT_RENDERER_H_
   7
   8 #include "base/basictypes.h"
   9 #include "cc/base/cc_export.h"
  10 #include "cc/quads/render_pass.h"
  11 #include "cc/trees/layer_tree_host.h"
  12
  13 namespace cc {
  14
  15 class CompositorFrameAck;
  16 class CompositorFrameMetadata;
  17 class ScopedResource;
  18
  19 struct RendererCapabilitiesImpl {
  20   RendererCapabilitiesImpl();
  21   ~RendererCapabilitiesImpl();
  22
  23   // Capabilities copied to main thread.
  24   ResourceFormat best_texture_format;
  25   bool allow_partial_texture_updates;
  26   int max_texture_size;
  27   bool using_shared_memory_resources;
  28
  29   // Capabilities used on compositor thread only.
  30   bool using_partial_swap;
  31   bool using_egl_image;
  32   bool avoid_pow2_textures;
  33   bool using_map_image;
  34   bool using_discard_framebuffer;
  35   bool allow_rasterize_on_demand;
  36
  37   RendererCapabilities MainThreadCapabilities() const;
  38 };
  39
  40 class CC_EXPORT RendererClient {
  41  public:
  42   virtual void SetFullRootLayerDamage() = 0;
  43 };
  44
  45 class CC_EXPORT Renderer {
  46  public:
  47   virtual ~Renderer() {}
  48
  49   virtual const RendererCapabilitiesImpl& Capabilities() const = 0;
  50
  51   virtual bool CanReadPixels() const = 0;
  52
  53   virtual void DecideRenderPassAllocationsForFrame(
  54       const RenderPassList& render_passes_in_draw_order) {}
  55   virtual bool HasAllocatedResourcesForTesting(RenderPass::Id id) const;
  56
  57   // This passes ownership of the render passes to the renderer. It should
  58   // consume them, and empty the list. The parameters here may change from frame
  59   // to frame and should not be cached.
  60   // The |device_viewport_rect| and |device_clip_rect| are in non-y-flipped
  61   // window space.
  62   virtual void DrawFrame(RenderPassList* render_passes_in_draw_order,
  63                          float device_scale_factor,
  64                          const gfx::Rect& device_viewport_rect,
  65                          const gfx::Rect& device_clip_rect,
  66                          bool disable_picture_quad_image_filtering) = 0;
  67
  68   // Waits for rendering to finish.
  69   virtual void Finish() = 0;
  70
  71   virtual void DoNoOp() {}
  72
  73   // Puts backbuffer onscreen.
  74   virtual void SwapBuffers(const CompositorFrameMetadata& metadata) = 0;
  75   virtual void ReceiveSwapBuffersAck(const CompositorFrameAck& ack) {}
  76
  77   virtual void GetFramebufferPixels(void* pixels, const gfx::Rect& rect) = 0;
  78
  79   virtual bool IsContextLost();
  80
  81   bool visible() const { return visible_; }
  82   void SetVisible(bool visible);
  83
  84   virtual void SendManagedMemoryStats(size_t bytes_visible,
  85                                       size_t bytes_visible_and_nearby,
  86                                       size_t bytes_allocated) = 0;
  87
  88  protected:
  89   explicit Renderer(RendererClient* client, const LayerTreeSettings* settings)
  90       : client_(client), settings_(settings), visible_(true) {}
  91
  92   virtual void DidChangeVisibility() = 0;
  93
  94   RendererClient* client_;
  95   const LayerTreeSettings* settings_;
  96   bool visible_;
  97
  98  private:
  99   DISALLOW_COPY_AND_ASSIGN(Renderer);
 100 };
 101
 102 }  // namespace cc
 103
 104 #endif  // CC_OUTPUT_RENDERER_H_