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 void DecideRenderPassAllocationsForFrame(
  52       const RenderPassList& render_passes_in_draw_order) {}
  53   virtual bool HasAllocatedResourcesForTesting(RenderPass::Id id) const;
  54
  55   // This passes ownership of the render passes to the renderer. It should
  56   // consume them, and empty the list. The parameters here may change from frame
  57   // to frame and should not be cached.
  58   // The |device_viewport_rect| and |device_clip_rect| are in non-y-flipped
  59   // window space.
  60   virtual void DrawFrame(RenderPassList* render_passes_in_draw_order,
  61                          float device_scale_factor,
  62                          const gfx::Rect& device_viewport_rect,
  63                          const gfx::Rect& device_clip_rect,
  64                          bool disable_picture_quad_image_filtering) = 0;
  65
  66   // Waits for rendering to finish.
  67   virtual void Finish() = 0;
  68
  69   virtual void DoNoOp() {}
  70
  71   // Puts backbuffer onscreen.
  72   virtual void SwapBuffers(const CompositorFrameMetadata& metadata) = 0;
  73   virtual void ReceiveSwapBuffersAck(const CompositorFrameAck& ack) {}
  74
  75   virtual bool IsContextLost();
  76
  77   bool visible() const { return visible_; }
  78   void SetVisible(bool visible);
  79
  80   virtual void SendManagedMemoryStats(size_t bytes_visible,
  81                                       size_t bytes_visible_and_nearby,
  82                                       size_t bytes_allocated) = 0;
  83
  84  protected:
  85   explicit Renderer(RendererClient* client, const LayerTreeSettings* settings)
  86       : client_(client), settings_(settings), visible_(true) {}
  87
  88   virtual void DidChangeVisibility() = 0;
  89
  90   RendererClient* client_;
  91   const LayerTreeSettings* settings_;
  92   bool visible_;
  93
  94  private:
  95   DISALLOW_COPY_AND_ASSIGN(Renderer);
  96 };
  97
  98 }  // namespace cc
  99
 100 #endif  // CC_OUTPUT_RENDERER_H_