cc/trees/layer_tree_host_client.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_TREES_LAYER_TREE_HOST_CLIENT_H_
   6 #define CC_TREES_LAYER_TREE_HOST_CLIENT_H_
   7
   8 #include "base/memory/ref_counted.h"
   9 #include "base/memory/scoped_ptr.h"
  10 #include "base/time/time.h"
  11
  12 namespace gfx {
  13 class Vector2d;
  14 class Vector2dF;
  15 }
  16
  17 namespace cc {
  18 class ContextProvider;
  19 class InputHandlerClient;
  20 class OutputSurface;
  21 struct BeginFrameArgs;
  22
  23 class LayerTreeHostClient {
  24  public:
  25   virtual void WillBeginMainFrame() = 0;
  26   // Marks finishing compositing-related tasks on the main thread. In threaded
  27   // mode, this corresponds to DidCommit().
  28   virtual void BeginMainFrame(const BeginFrameArgs& args) = 0;
  29   virtual void BeginMainFrameNotExpectedSoon() = 0;
  30   virtual void DidBeginMainFrame() = 0;
  31   virtual void Layout() = 0;
  32   virtual void ApplyViewportDeltas(
  33       const gfx::Vector2dF& inner_delta,
  34       const gfx::Vector2dF& outer_delta,
  35       const gfx::Vector2dF& elastic_overscroll_delta,
  36       float page_scale,
  37       float top_controls_delta) = 0;
  38   // Request an OutputSurface from the client. When the client has one it should
  39   // call LayerTreeHost::SetOutputSurface.  This will result in either
  40   // DidFailToInitializeOutputSurface or DidInitializeOutputSurface being
  41   // called.
  42   virtual void RequestNewOutputSurface() = 0;
  43   virtual void DidInitializeOutputSurface() = 0;
  44   virtual void DidFailToInitializeOutputSurface() = 0;
  45   virtual void WillCommit() = 0;
  46   virtual void DidCommit() = 0;
  47   virtual void DidCommitAndDrawFrame() = 0;
  48   virtual void DidCompleteSwapBuffers() = 0;
  49
  50   // Called when page scale animation has completed.
  51   virtual void DidCompletePageScaleAnimation() = 0;
  52
  53   // TODO(simonhong): Makes this to pure virtual function when client
  54   // implementation is ready.
  55   virtual void SendBeginFramesToChildren(const BeginFrameArgs& args) {}
  56
  57   // Requests that the client insert a rate limiting token in the shared main
  58   // thread context's command stream that will block if the context gets too far
  59   // ahead of the compositor's command stream. Only needed if the tree contains
  60   // a TextureLayer that calls SetRateLimitContext(true).
  61   virtual void RateLimitSharedMainThreadContext() {}
  62
  63  protected:
  64   virtual ~LayerTreeHostClient() {}
  65 };
  66
  67 }  // namespace cc
  68
  69 #endif  // CC_TREES_LAYER_TREE_HOST_CLIENT_H_