OLD | NEW |
1 // Copyright 2012 The Chromium Authors. All rights reserved. | 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 | 2 // Use of this source code is governed by a BSD-style license that can be |
3 // found in the LICENSE file. | 3 // found in the LICENSE file. |
4 | 4 |
5 #ifndef CC_OUTPUT_OUTPUT_SURFACE_H_ | 5 #ifndef CC_OUTPUT_COMPOSITOR_FRAME_SINK_H_ |
6 #define CC_OUTPUT_OUTPUT_SURFACE_H_ | 6 #define CC_OUTPUT_COMPOSITOR_FRAME_SINK_H_ |
7 | 7 |
8 #include <deque> | 8 #include <deque> |
9 #include <memory> | 9 #include <memory> |
10 | 10 |
11 #include "base/macros.h" | 11 #include "base/macros.h" |
12 #include "base/memory/ref_counted.h" | 12 #include "base/memory/ref_counted.h" |
13 #include "base/memory/weak_ptr.h" | 13 #include "base/memory/weak_ptr.h" |
14 #include "base/threading/thread_checker.h" | 14 #include "base/threading/thread_checker.h" |
15 #include "base/trace_event/memory_dump_provider.h" | 15 #include "base/trace_event/memory_dump_provider.h" |
16 #include "cc/base/cc_export.h" | 16 #include "cc/base/cc_export.h" |
(...skipping 13 matching lines...) Expand all Loading... |
30 class ColorSpace; | 30 class ColorSpace; |
31 class Rect; | 31 class Rect; |
32 class Size; | 32 class Size; |
33 class Transform; | 33 class Transform; |
34 } | 34 } |
35 | 35 |
36 namespace cc { | 36 namespace cc { |
37 | 37 |
38 class CompositorFrame; | 38 class CompositorFrame; |
39 struct ManagedMemoryPolicy; | 39 struct ManagedMemoryPolicy; |
40 class OutputSurfaceClient; | 40 class CompositorFrameSinkClient; |
41 | 41 |
42 // Represents the output surface for a compositor. The compositor owns | 42 // Represents the output surface for a compositor. The compositor owns |
43 // and manages its destruction. Its lifetime is: | 43 // and manages its destruction. Its lifetime is: |
44 // 1. Created on the main thread by the LayerTreeHost through its client. | 44 // 1. Created on the main thread by the LayerTreeHost through its client. |
45 // 2. Passed to the compositor thread and bound to a client via BindToClient. | 45 // 2. Passed to the compositor thread and bound to a client via BindToClient. |
46 // From here on, it will only be used on the compositor thread. | 46 // From here on, it will only be used on the compositor thread. |
47 // 3. If the 3D context is lost, then the compositor will delete the output | 47 // 3. If the 3D context is lost, then the compositor will delete the output |
48 // surface (on the compositor thread) and go back to step 1. | 48 // surface (on the compositor thread) and go back to step 1. |
49 class CC_EXPORT OutputSurface : public base::trace_event::MemoryDumpProvider { | 49 class CC_EXPORT CompositorFrameSink |
| 50 : public base::trace_event::MemoryDumpProvider { |
50 public: | 51 public: |
51 // Constructor for GL-based and/or software compositing. | 52 // Constructor for GL-based and/or software compositing. |
52 explicit OutputSurface(scoped_refptr<ContextProvider> context_provider, | 53 explicit CompositorFrameSink( |
53 scoped_refptr<ContextProvider> worker_context_provider, | 54 scoped_refptr<ContextProvider> context_provider, |
54 std::unique_ptr<SoftwareOutputDevice> software_device); | 55 scoped_refptr<ContextProvider> worker_context_provider, |
| 56 std::unique_ptr<SoftwareOutputDevice> software_device); |
55 | 57 |
56 // Constructor for Vulkan-based compositing. | 58 // Constructor for Vulkan-based compositing. |
57 explicit OutputSurface( | 59 explicit CompositorFrameSink( |
58 scoped_refptr<VulkanContextProvider> vulkan_context_provider); | 60 scoped_refptr<VulkanContextProvider> vulkan_context_provider); |
59 | 61 |
60 ~OutputSurface() override; | 62 ~CompositorFrameSink() override; |
61 | 63 |
62 struct Capabilities { | 64 struct Capabilities { |
63 Capabilities() | 65 Capabilities() |
64 : delegated_rendering(false), | 66 : delegated_rendering(false), |
65 max_frames_pending(1), | 67 max_frames_pending(1), |
66 adjust_deadline_for_parent(true), | 68 adjust_deadline_for_parent(true), |
67 uses_default_gl_framebuffer(true), | 69 uses_default_gl_framebuffer(true), |
68 flipped_output_surface(false), | 70 flipped_compositor_frame_sink(false), |
69 can_force_reclaim_resources(false), | 71 can_force_reclaim_resources(false), |
70 delegated_sync_points_required(true) {} | 72 delegated_sync_points_required(true) {} |
71 bool delegated_rendering; | 73 bool delegated_rendering; |
72 int max_frames_pending; | 74 int max_frames_pending; |
73 // This doesn't handle the <webview> case, but once BeginFrame is | 75 // This doesn't handle the <webview> case, but once BeginFrame is |
74 // supported natively, we shouldn't need adjust_deadline_for_parent. | 76 // supported natively, we shouldn't need adjust_deadline_for_parent. |
75 bool adjust_deadline_for_parent; | 77 bool adjust_deadline_for_parent; |
76 // Whether this output surface renders to the default OpenGL zero | 78 // Whether this output surface renders to the default OpenGL zero |
77 // framebuffer or to an offscreen framebuffer. | 79 // framebuffer or to an offscreen framebuffer. |
78 bool uses_default_gl_framebuffer; | 80 bool uses_default_gl_framebuffer; |
79 // Whether this OutputSurface is flipped or not. | 81 // Whether this CompositorFrameSink is flipped or not. |
80 bool flipped_output_surface; | 82 bool flipped_compositor_frame_sink; |
81 // Whether ForceReclaimResources can be called to reclaim all resources | 83 // Whether ForceReclaimResources can be called to reclaim all resources |
82 // from the OutputSurface. | 84 // from the CompositorFrameSink. |
83 bool can_force_reclaim_resources; | 85 bool can_force_reclaim_resources; |
84 // True if sync points for resources are needed when swapping delegated | 86 // True if sync points for resources are needed when swapping delegated |
85 // frames. | 87 // frames. |
86 bool delegated_sync_points_required; | 88 bool delegated_sync_points_required; |
87 }; | 89 }; |
88 | 90 |
89 // ============== DISPLAY COMPOSITOR ONLY ======================= | 91 // ============== DISPLAY COMPOSITOR ONLY ======================= |
90 | 92 |
91 virtual void EnsureBackbuffer(); | 93 virtual void EnsureBackbuffer(); |
92 virtual void DiscardBackbuffer(); | 94 virtual void DiscardBackbuffer(); |
(...skipping 35 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
128 // currently in use. | 130 // currently in use. |
129 virtual void ForceReclaimResources() {} | 131 virtual void ForceReclaimResources() {} |
130 | 132 |
131 virtual void BindFramebuffer(); | 133 virtual void BindFramebuffer(); |
132 // Gives the GL internal format that should be used for calling CopyTexImage2D | 134 // Gives the GL internal format that should be used for calling CopyTexImage2D |
133 // when the framebuffer is bound via BindFramebuffer(). | 135 // when the framebuffer is bound via BindFramebuffer(). |
134 virtual uint32_t GetFramebufferCopyTextureFormat() = 0; | 136 virtual uint32_t GetFramebufferCopyTextureFormat() = 0; |
135 | 137 |
136 // Support for a pull-model where draws are requested by the output surface. | 138 // Support for a pull-model where draws are requested by the output surface. |
137 // | 139 // |
138 // OutputSurface::Invalidate is called by the compositor to notify that | 140 // CompositorFrameSink::Invalidate is called by the compositor to notify that |
139 // there's new content. | 141 // there's new content. |
140 virtual void Invalidate() {} | 142 virtual void Invalidate() {} |
141 | 143 |
142 // ============== BOTH TYPES OF COMPOSITOR ====================== | 144 // ============== BOTH TYPES OF COMPOSITOR ====================== |
143 | 145 |
144 // Called by the compositor on the compositor thread. This is a place where | 146 // Called by the compositor on the compositor thread. This is a place where |
145 // thread-specific data for the output surface can be initialized, since from | 147 // thread-specific data for the output surface can be initialized, since from |
146 // this point to when DetachFromClient() is called the output surface will | 148 // this point to when DetachFromClient() is called the output surface will |
147 // only be used on the compositor thread. | 149 // only be used on the compositor thread. |
148 // The caller should call DetachFromClient() on the same thread before | 150 // The caller should call DetachFromClient() on the same thread before |
149 // destroying the OutputSurface, even if this fails. And BindToClient should | 151 // destroying the CompositorFrameSink, even if this fails. And BindToClient |
150 // not be called twice for a given OutputSurface. | 152 // should not be called twice for a given CompositorFrameSink. |
151 virtual bool BindToClient(OutputSurfaceClient* client); | 153 virtual bool BindToClient(CompositorFrameSinkClient* client); |
152 | 154 |
153 // Called by the compositor on the compositor thread. This is a place where | 155 // Called by the compositor on the compositor thread. This is a place where |
154 // thread-specific data for the output surface can be uninitialized. | 156 // thread-specific data for the output surface can be uninitialized. |
155 virtual void DetachFromClient(); | 157 virtual void DetachFromClient(); |
156 | 158 |
157 bool HasClient() { return !!client_; } | 159 bool HasClient() { return !!client_; } |
158 | 160 |
159 const Capabilities& capabilities() const { return capabilities_; } | 161 const Capabilities& capabilities() const { return capabilities_; } |
160 | 162 |
161 // Obtain the 3d context or the software device associated with this output | 163 // Obtain the 3d context or the software device associated with this output |
(...skipping 23 matching lines...) Expand all Loading... |
185 base::trace_event::ProcessMemoryDump* pmd) override; | 187 base::trace_event::ProcessMemoryDump* pmd) override; |
186 | 188 |
187 protected: | 189 protected: |
188 // This is used by both display and delegating implementations. | 190 // This is used by both display and delegating implementations. |
189 void PostSwapBuffersComplete(); | 191 void PostSwapBuffersComplete(); |
190 | 192 |
191 // This is how LayerTreeHostImpl hears about context loss when the Display | 193 // This is how LayerTreeHostImpl hears about context loss when the Display |
192 // is the one listening for context loss. Also used internally for the | 194 // is the one listening for context loss. Also used internally for the |
193 // context provider to inform the LayerTreeHostImpl or Display about loss. | 195 // context provider to inform the LayerTreeHostImpl or Display about loss. |
194 // It would become display-compositor-only when LayerTreeHostImpl receives | 196 // It would become display-compositor-only when LayerTreeHostImpl receives |
195 // its contexts independently from the "OutputSurface". | 197 // its contexts independently from the "CompositorFrameSink". |
196 virtual void DidLoseOutputSurface(); | 198 virtual void DidLoseCompositorFrameSink(); |
197 | 199 |
198 OutputSurfaceClient* client_ = nullptr; | 200 CompositorFrameSinkClient* client_ = nullptr; |
199 | 201 |
200 struct OutputSurface::Capabilities capabilities_; | 202 struct CompositorFrameSink::Capabilities capabilities_; |
201 scoped_refptr<ContextProvider> context_provider_; | 203 scoped_refptr<ContextProvider> context_provider_; |
202 scoped_refptr<ContextProvider> worker_context_provider_; | 204 scoped_refptr<ContextProvider> worker_context_provider_; |
203 scoped_refptr<VulkanContextProvider> vulkan_context_provider_; | 205 scoped_refptr<VulkanContextProvider> vulkan_context_provider_; |
204 std::unique_ptr<SoftwareOutputDevice> software_device_; | 206 std::unique_ptr<SoftwareOutputDevice> software_device_; |
205 gfx::Size surface_size_; | 207 gfx::Size surface_size_; |
206 float device_scale_factor_ = -1; | 208 float device_scale_factor_ = -1; |
207 gfx::ColorSpace device_color_space_; | 209 gfx::ColorSpace device_color_space_; |
208 bool has_alpha_ = true; | 210 bool has_alpha_ = true; |
209 gfx::ColorSpace color_space_; | 211 gfx::ColorSpace color_space_; |
210 base::ThreadChecker client_thread_checker_; | 212 base::ThreadChecker client_thread_checker_; |
211 | 213 |
212 private: | 214 private: |
213 void DetachFromClientInternal(); | 215 void DetachFromClientInternal(); |
214 | 216 |
215 base::WeakPtrFactory<OutputSurface> weak_ptr_factory_; | 217 base::WeakPtrFactory<CompositorFrameSink> weak_ptr_factory_; |
216 | 218 |
217 DISALLOW_COPY_AND_ASSIGN(OutputSurface); | 219 DISALLOW_COPY_AND_ASSIGN(CompositorFrameSink); |
218 }; | 220 }; |
219 | 221 |
220 } // namespace cc | 222 } // namespace cc |
221 | 223 |
222 #endif // CC_OUTPUT_OUTPUT_SURFACE_H_ | 224 #endif // CC_OUTPUT_COMPOSITOR_FRAME_SINK_H_ |
OLD | NEW |