AndroidVideoEncodeAccelerator is born!

content/common/gpu/media/android_video_encode_accelerator.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 CONTENT_COMMON_GPU_MEDIA_ANDROID_VIDEO_ENCODE_ACCELERATOR_H_
+#define CONTENT_COMMON_GPU_MEDIA_ANDROID_VIDEO_ENCODE_ACCELERATOR_H_
+
+#include <list>
+#include <queue>
+#include <vector>
+
+#include "base/memory/weak_ptr.h"
+#include "base/threading/thread_checker.h"
+#include "base/timer/timer.h"
+#include "base/tuple.h"
+#include "content/common/content_export.h"
+#include "media/base/android/media_codec_bridge.h"
+#include "media/video/video_encode_accelerator.h"
+
+namespace base {
+class MessageLoopProxy;

[xhwang, 2013/11/19 00:11:25]

not used?

[Ami GONE FROM CHROMIUM, 2013/11/21 22:59:07]

Done.

+}  // namespace base
+
+namespace media {
+class BitstreamBuffer;
+}  // namespace media
+
+namespace content {
+
+// Android-specific implementation of media::VideoEncodeAccelerator, enabling
+// hardware-acceleration of video encoding, based on Android's MediaCodec class
+// (http://developer.android.com/reference/android/media/MediaCodec.html).  This
+// class expects to live and be called on a single thread (the GPU process'
+// ChildThread).
+class CONTENT_EXPORT AndroidVideoEncodeAccelerator
+    : public media::VideoEncodeAccelerator {
+ public:
+  explicit AndroidVideoEncodeAccelerator(
+      media::VideoEncodeAccelerator::Client* client);
+  virtual ~AndroidVideoEncodeAccelerator();
+
+  static std::vector<media::VideoEncodeAccelerator::SupportedProfile>
+      GetSupportedProfiles();
+
+  // media::VideoEncodeAccelerator implementation.
+  virtual void Initialize(media::VideoFrame::Format format,
+                          const gfx::Size& input_visible_size,
+                          media::VideoCodecProfile output_profile,
+                          uint32 initial_bitrate) OVERRIDE;
+  virtual void Encode(const scoped_refptr<media::VideoFrame>& frame,
+                      bool force_keyframe) OVERRIDE;
+  virtual void UseOutputBitstreamBuffer(const media::BitstreamBuffer& buffer)
+      OVERRIDE;
+  virtual void RequestEncodingParametersChange(uint32 bitrate,
+                                               uint32 framerate) OVERRIDE;
+  virtual void Destroy() OVERRIDE;
+
+ private:
+  enum {
+    // Arbitrary choice.
+    kInitialFramerate = 30,
+    // Until there are non-realtime users, no need for unrequested I-frames.
+    kIFrameInterval = kint32max,

[xhwang, 2013/11/19 00:11:25]

we use UPPER_CASE format for enums (from
http://www.chromium.org/developers/coding-style):

Though the Google C++ Style Guide now says to use kConstantNaming for enums,
Chromium was written using MACRO_STYLE naming.  Continue to use this style for
consistency.

Currently we have a lot of kCamelCase for enums. The plan is to convert them in
the future. For now, we use UPPER_CASE for new code.

[Ami GONE FROM CHROMIUM, 2013/11/21 22:59:07]

Done.

+  };
+
+  // Impedance-mismatch fixers: MediaCodec is a poll-based API but VEA is a
+  // push-based API; these methods turn the crank to make the two work together.
+  void DoIOTask();
+  void QueueInput();
+  void DequeueOutput();
+
+  // Returns true if we don't need more or bigger output buffers.
+  bool DoOutputBuffersSuffice();
+
+  // Start & stop |io_timer_| if the time seems right.
+  void MaybeStartIOTimer();
+  void MaybeStopIOTimer();
+
+  // Used to DCHECK that we are called on the correct thread.
+  base::ThreadChecker thread_checker_;
+
+  // VideoDecodeAccelerator::Client callbacks go here.  Invalidated once any
+  // error triggers.
+  base::WeakPtrFactory<Client> client_ptr_factory_;
+
+  scoped_ptr<media::VideoCodecBridge> media_codec_;
+
+  // Bitstream buffers waiting to be populated & returned to the client.
+  std::vector<media::BitstreamBuffer> available_bitstream_buffers_;
+
+  // Frames waiting to be passed to the codec, queued until an input buffer is
+  // available.  Each element is a tuple of <Frame, key_frame, enqueue_time>.
+  typedef std::queue<Tuple3<scoped_refptr<media::VideoFrame>, bool,
+                            base::Time> > PendingFrames;
+  PendingFrames pending_frames_;
+
+  // Repeating timer responsible for draining pending IO to the codec.
+  base::RepeatingTimer<AndroidVideoEncodeAccelerator> io_timer_;
+
+  // The difference between number of buffers queued & dequeued at the codec.
+  int32 num_buffers_at_codec_;
+
+  // A monotonically-growing value, used as a fake timestamp just to keep things
+  // appearing to move forward.
+  base::TimeDelta fake_input_timestamp_;
+
+  // Number of requested output buffers and their capacity.
+  int num_output_buffers_;          // -1 until RequireBitstreamBuffers.
+  size_t output_buffers_capacity_;  // 0 until RequireBitstreamBuffers.
+
+  uint32 last_set_bitrate_;

[xhwang, 2013/11/19 00:11:25]

unit? in bps?

[Ami GONE FROM CHROMIUM, 2013/11/21 22:59:07]

Done.

+
+  DISALLOW_COPY_AND_ASSIGN(AndroidVideoEncodeAccelerator);
+};
+
+}  // namespace content
+
+#endif  // CONTENT_COMMON_GPU_MEDIA_ANDROID_VIDEO_ENCODE_ACCELERATOR_H_