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.
5 #ifndef CC_OUTPUT_RENDERER_H_
6 #define CC_OUTPUT_RENDERER_H_
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"
15 class CompositorFrameAck
;
16 class CompositorFrameMetadata
;
19 struct RendererCapabilitiesImpl
{
20 RendererCapabilitiesImpl();
21 ~RendererCapabilitiesImpl();
23 // Capabilities copied to main thread.
24 ResourceFormat best_texture_format
;
25 bool allow_partial_texture_updates
;
26 bool using_offscreen_context3d
;
28 bool using_shared_memory_resources
;
30 // Capabilities used on compositor thread only.
31 bool using_partial_swap
;
33 bool avoid_pow2_textures
;
35 bool using_discard_framebuffer
;
36 bool allow_rasterize_on_demand
;
38 RendererCapabilities
MainThreadCapabilities() const;
41 class CC_EXPORT RendererClient
{
43 virtual void SetFullRootLayerDamage() = 0;
46 class CC_EXPORT Renderer
{
48 virtual ~Renderer() {}
50 virtual const RendererCapabilitiesImpl
& Capabilities() const = 0;
52 virtual bool CanReadPixels() const = 0;
54 virtual void DecideRenderPassAllocationsForFrame(
55 const RenderPassList
& render_passes_in_draw_order
) {}
56 virtual bool HasAllocatedResourcesForTesting(RenderPass::Id id
) const;
58 // This passes ownership of the render passes to the renderer. It should
59 // consume them, and empty the list. The parameters here may change from frame
60 // to frame and should not be cached.
61 // The |device_viewport_rect| and |device_clip_rect| are in non-y-flipped
63 virtual void DrawFrame(RenderPassList
* render_passes_in_draw_order
,
64 ContextProvider
* offscreen_context_provider
,
65 float device_scale_factor
,
66 const gfx::Rect
& device_viewport_rect
,
67 const gfx::Rect
& device_clip_rect
,
68 bool disable_picture_quad_image_filtering
) = 0;
70 // Waits for rendering to finish.
71 virtual void Finish() = 0;
73 virtual void DoNoOp() {}
75 // Puts backbuffer onscreen.
76 virtual void SwapBuffers(const CompositorFrameMetadata
& metadata
) = 0;
77 virtual void ReceiveSwapBuffersAck(const CompositorFrameAck
& ack
) {}
79 virtual void GetFramebufferPixels(void* pixels
, const gfx::Rect
& rect
) = 0;
81 virtual bool IsContextLost();
83 virtual void SetVisible(bool visible
) = 0;
85 virtual void SendManagedMemoryStats(size_t bytes_visible
,
86 size_t bytes_visible_and_nearby
,
87 size_t bytes_allocated
) = 0;
90 explicit Renderer(RendererClient
* client
, const LayerTreeSettings
* settings
)
91 : client_(client
), settings_(settings
) {}
93 RendererClient
* client_
;
94 const LayerTreeSettings
* settings_
;
97 DISALLOW_COPY_AND_ASSIGN(Renderer
);
102 #endif // CC_OUTPUT_RENDERER_H_