Index: cc/surfaces/surface_factory.h |
diff --git a/cc/surfaces/surface_factory.h b/cc/surfaces/surface_factory.h |
index 94119e0922c67658a290b473dbb7f013d4dd05a8..b6487411f16aff54915af9a9249ac5aec8f7af6a 100644 |
--- a/cc/surfaces/surface_factory.h |
+++ b/cc/surfaces/surface_factory.h |
@@ -7,7 +7,6 @@ |
#include <memory> |
#include <set> |
-#include <unordered_map> |
#include "base/callback_forward.h" |
#include "base/macros.h" |
@@ -25,11 +24,14 @@ class Surface; |
class SurfaceFactoryClient; |
class SurfaceManager; |
-// A SurfaceFactory is used to create surfaces that may share resources and |
-// receive returned resources for frames submitted to those surfaces. Resources |
-// submitted to frames created by a particular factory will be returned to that |
-// factory's client when they are no longer being used. This is the only class |
-// most users of surfaces will need to directly interact with. |
+// This class is used for creating surfaces and submitting compositor frames to |
+// them. Surfaces are created lazily each time SubmitCompositorFrame is |
+// called with a local frame id that is different from the last call. Only one |
+// surface is owned by this class at a time, and upon constructing a new surface |
+// the old one will be destructed. Resources submitted to surfaces created by a |
+// particular factory will be returned to that factory's client when they are no |
+// longer being used. This is the only class most users of surfaces will need to |
+// directly interact with. |
class CC_SURFACES_EXPORT SurfaceFactory { |
public: |
using DrawCallback = base::Callback<void()>; |
@@ -41,34 +43,30 @@ class CC_SURFACES_EXPORT SurfaceFactory { |
const FrameSinkId& frame_sink_id() const { return frame_sink_id_; } |
- void Create(const LocalFrameId& local_frame_id); |
- void Destroy(const LocalFrameId& local_frame_id); |
+ // Destroys the current surface. You need to call this method before the |
+ // factory is destroyed, or when you would like to get rid of the surface as |
+ // soon as possible (otherwise, the next time you call SubmitCompositorFrame |
+ // the old surface will be dealt with). |
+ void EvictSurface(); |
- // Destroys all surfaces. |
- void DestroyAll(); |
- |
- // Destroys and disown all surfaces, and reset all resource references. This |
- // is useful when resources are invalid (e.g. lost context). |
+ // Destroys and disowns the current surface, and resets all resource |
+ // references. This is useful when resources are invalid (e.g. lost context). |
void Reset(); |
- // Set that the current frame on new_id is to be treated as the successor to |
- // the current frame on old_id for the purposes of calculating damage. |
- void SetPreviousFrameSurface(const LocalFrameId& new_id, |
- const LocalFrameId& old_id); |
- |
- // A frame can only be submitted to a surface created by this factory, |
- // although the frame may reference surfaces created by other factories. |
- // The callback is called the first time this frame is used to draw, or if |
- // the frame is discarded. |
+ // Submits the frame to the current surface being managed by the factory if |
+ // the local frame ids match, or creates a new surface with the given local |
+ // frame id, destroys the old one, and submits the frame to this new surface. |
+ // The frame can contain references to any surface, regardless of which |
+ // factory owns it. The callback is called the first time this frame is used |
+ // to draw, or if the frame is discarded. |
void SubmitCompositorFrame(const LocalFrameId& local_frame_id, |
CompositorFrame frame, |
const DrawCallback& callback); |
- void RequestCopyOfSurface(const LocalFrameId& local_frame_id, |
- std::unique_ptr<CopyOutputRequest> copy_request); |
+ void RequestCopyOfSurface(std::unique_ptr<CopyOutputRequest> copy_request); |
// Evicts the current frame on the surface. All the resources |
// will be released and Surface::HasFrame will return false. |
- void ClearSurface(const LocalFrameId& local_frame_id); |
+ void ClearSurface(); |
void WillDrawSurface(const LocalFrameId& id, const gfx::Rect& damage_rect); |
@@ -91,17 +89,15 @@ class CC_SURFACES_EXPORT SurfaceFactory { |
void DidDestroySurfaceManager() { manager_ = nullptr; } |
private: |
- FrameSinkId frame_sink_id_; |
+ std::unique_ptr<Surface> Create(const LocalFrameId& local_frame_id); |
+ void Destroy(std::unique_ptr<Surface> surface); |
+ |
+ const FrameSinkId frame_sink_id_; |
SurfaceManager* manager_; |
SurfaceFactoryClient* client_; |
SurfaceResourceHolder holder_; |
- |
bool needs_sync_points_; |
- |
- using OwningSurfaceMap = std:: |
- unordered_map<LocalFrameId, std::unique_ptr<Surface>, LocalFrameIdHash>; |
- OwningSurfaceMap surface_map_; |
- |
+ std::unique_ptr<Surface> current_surface_; |
base::WeakPtrFactory<SurfaceFactory> weak_factory_; |
DISALLOW_COPY_AND_ASSIGN(SurfaceFactory); |