Free worker context resources on idle.

gpu/command_buffer/client/context_support.h

 // Copyright 2013 The Chromium Authors. All rights reserved.
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
 #ifndef GPU_COMMAND_BUFFER_CLIENT_CONTEXT_SUPPORT_H_
 #define GPU_COMMAND_BUFFER_CLIENT_CONTEXT_SUPPORT_H_
 
 #include <stdint.h>
 
 #include "base/callback.h"
 #include "ui/gfx/overlay_transform.h"
 
+namespace base {
+class SingleThreadTaskRunner;
+}
+
 namespace gfx {
 class Rect;
 class RectF;
 }
 
 namespace gpu {
 
 struct SyncToken;
 
 class ContextSupport {
  public:
   // Runs |callback| when a sync token is signalled.
   virtual void SignalSyncToken(const SyncToken& sync_token,
                                const base::Closure& callback) = 0;
 
   // Runs |callback| when a query created via glCreateQueryEXT() has cleared
   // passed the glEndQueryEXT() point.
   virtual void SignalQuery(uint32_t query, const base::Closure& callback) = 0;
 
   // Indicates whether the context should aggressively free allocated resources.
   // If set to true, the context will purge all temporary resources when
   // flushed.
   virtual void SetAggressivelyFreeResources(
       bool aggressively_free_resources) = 0;
 
+  // Similar to temporarily calling SetAggressivelyFreeResources(true), this

[danakj, 2016/08/23 01:26:24]

We now have 3 functions we can call to free things, one with a toggle. How can
we consolidate? I can't actually explain this anymore :/

+  // causes a one-time purge of all temporary resources.
+  virtual void TrimResources() = 0;
+
   virtual void Swap() = 0;
   virtual void PartialSwapBuffers(const gfx::Rect& sub_buffer) = 0;
   virtual void CommitOverlayPlanes() = 0;
 
   // Schedule a texture to be presented as an overlay synchronously with the
   // primary surface during the next buffer swap or CommitOverlayPlanes.
   // This method is not stateful and needs to be re-scheduled every frame.
   virtual void ScheduleOverlayPlane(int plane_z_order,
                                     gfx::OverlayTransform plane_transform,
                                     unsigned overlay_texture_id,
                                     const gfx::Rect& display_bounds,
                                     const gfx::RectF& uv_rect) = 0;
 
   // Returns an ID that can be used to globally identify the share group that
   // this context's resources belong to.
   virtual uint64_t ShareGroupTracingGUID() const = 0;
 
   // Sets a callback to be run when an error occurs.
   virtual void SetErrorMessageCallback(
       const base::Callback<void(const char*, int32_t)>& callback) = 0;
 
   class ScopedVisibility {};
   virtual std::unique_ptr<ScopedVisibility> ClientBecameVisible() = 0;
   virtual void ClientBecameNotVisible(
       std::unique_ptr<ScopedVisibility> visibility) = 0;
   virtual bool AnyClientsVisible() const = 0;
 
+  class ScopedBusy {};
+  virtual std::unique_ptr<ScopedBusy> ClientBecameBusy() = 0;
+  virtual void ClientBecameNotBusy(std::unique_ptr<ScopedBusy> busy) = 0;
+
+  // A callback which will be invoked when the context is considered idle. The
+  // callback will be invoked on the provided callback_task_runner.
+  virtual void SetIdleCallback(
+      const base::Closure& callback,
+      scoped_refptr<base::SingleThreadTaskRunner> callback_task_runner) = 0;
+
  protected:
   ContextSupport() {}
   virtual ~ContextSupport() {}
 };
 
 }
 
 #endif  // GPU_COMMAND_BUFFER_CLIENT_CONTEXT_SUPPORT_H_