Improving the decoder pipeline.

remoting/client/frame_producer.h

+// Copyright (c) 2012 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 REMOTING_CLIENT_FRAME_PRODUCER_H_
+#define REMOTING_CLIENT_FRAME_PRODUCER_H_
+
+#include "base/callback_forward.h"
+#include "third_party/skia/include/core/SkRect.h"
+#include "third_party/skia/include/core/SkRegion.h"
+#include "third_party/skia/include/core/SkSize.h"
+
+namespace pp {
+class ImageData;
+} // namespace pp
+
+namespace remoting {
+
+class FrameProducer {
+ public:
+  FrameProducer() {}
+  virtual ~FrameProducer() {}
+
+  // This routine drains the queue returning all pending buffers to
+  // the consumer.
+  virtual void DrainQueue(const base::Closure& done) = 0;
+
+  // This routine submits an image buffer for subsequent drawing. Once any part
+  // of the frame within the clipping area is invalidated, the producer copies
+  // the updated pixels to one of the pending buffers and return it to
+  // the consumer via the FrameConsumer::PaintBuffer() call.
+  //
+  // The passed buffer must be large enough to hold the whole clipping area.
+  virtual void EnqueueBuffer(pp::ImageData* buffer) = 0;
+
+  // The frame consumer can call this routine requesting the frame to be
+  // repainted. The specified region of the frame is will be invalided.
+  // The region is given in client's coordinates relative to the beginning of
+  // the frame.
+  virtual void Invalidate(const SkRegion& region) = 0;
+
+  // The frame consumer calls this function to notify the producer about view
+  // area changes. This can result in producer immediately returning some of or
+  // all enqueued buffers to the consumer for reuse or reallocation.
+  virtual void SetView(const SkISize& view_size, const SkIRect& clip_area) = 0;
+
+ private:
+  DISALLOW_COPY_AND_ASSIGN(FrameProducer);
+};
+
+}  // namespace remoting
+
+#endif  // REMOTING_CLIENT_FRAME_PRODUCER_H_