[exp] cc: Introduce cc::CompositorMutator.

cc/scheduler/scheduler.h

 // Copyright 2011 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 CC_SCHEDULER_SCHEDULER_H_
 #define CC_SCHEDULER_SCHEDULER_H_
 
 #include <deque>
 #include <string>
 
@@ skipping 19 matching lines @@
 
 namespace cc {
 
 class SchedulerClient {
  public:
   virtual void WillBeginImplFrame(const BeginFrameArgs& args) = 0;
   virtual void ScheduledActionSendBeginMainFrame() = 0;
   virtual DrawResult ScheduledActionDrawAndSwapIfPossible() = 0;
   virtual DrawResult ScheduledActionDrawAndSwapForced() = 0;
   virtual void ScheduledActionAnimate() = 0;
+  virtual void ScheduledActionCustomMutate() = 0;

[brianderson, 2015/03/19 22:23:18]

Maybe call this ScheduledActionStartCustomMutate() to imply it's async.

In response to this, we'll need a Scheduler::NotifyCustomMutateResultsReady.

We can then use NotifyCustomMutateResultsReady to provide back-pressure on some
of the other actions we have, like PrepareTiles and the BeginImplFrameDeadline.

PrepareTiles kicks off rasterization of the visible tiles, which we won't be
able to determine until the custom mutate results are ready.

In low latency mode, this will put UIWorker directly in the critical path since
we'd have to do BeginImplFrame, raf, layout, commit, uiworker, preparetiles,
raster, activate, draw serially.

Once we have active UIWorkers though, we could run them directly from
BeginImplFrame in parallel with raf, layout, and commit. We would need to have
extra logic to run any new UIWorkers from the commit that we haven't run already
though.

I wonder if it would be acceptable to define UIWorkers as only running after the
first draw, so they don't need to be in the critical path whenever they are
added?

   virtual void ScheduledActionCommit() = 0;
   virtual void ScheduledActionActivateSyncTree() = 0;
   virtual void ScheduledActionBeginOutputSurfaceCreation() = 0;
   virtual void ScheduledActionPrepareTiles() = 0;
   virtual void DidAnticipatedDrawTimeChange(base::TimeTicks time) = 0;
   virtual base::TimeDelta DrawDurationEstimate() = 0;
   virtual base::TimeDelta BeginMainFrameToCommitDurationEstimate() = 0;
   virtual base::TimeDelta CommitToActivateDurationEstimate() = 0;
   virtual void DidBeginImplFrameDeadline() = 0;
   virtual void SendBeginFramesToChildren(const BeginFrameArgs& args) = 0;
@@ skipping 196 matching lines @@
 
   friend class SchedulerFrameSourcesConstructor;
   friend class TestSchedulerFrameSourcesConstructor;
 
   DISALLOW_COPY_AND_ASSIGN(Scheduler);
 };
 
 }  // namespace cc
 
 #endif  // CC_SCHEDULER_SCHEDULER_H_