Index: content/common/gpu/media/accelerated_video_decoder.h |
diff --git a/content/common/gpu/media/accelerated_video_decoder.h b/content/common/gpu/media/accelerated_video_decoder.h |
new file mode 100644 |
index 0000000000000000000000000000000000000000..6bbf9cdb30705257cffffc6e94071cda8e2965b3 |
--- /dev/null |
+++ b/content/common/gpu/media/accelerated_video_decoder.h |
@@ -0,0 +1,63 @@ |
+// Copyright 2015 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_ACCELERATED_VIDEO_DECODER_ |
+#define CONTENT_COMMON_GPU_MEDIA_ACCELERATED_VIDEO_DECODER_ |
+ |
+#include "base/macros.h" |
+#include "content/common/content_export.h" |
+#include "ui/gfx/geometry/size.h" |
+ |
+namespace content { |
+ |
+// An AcceleratedVideoDecoder is a video decoder that requires support from an |
+// external accelerator (typically a hardware accelerator) to partially offload |
+// the decode process after parsing stream headers, and performing reference |
+// frame and state management. |
+class CONTENT_EXPORT AcceleratedVideoDecoder { |
+ public: |
+ AcceleratedVideoDecoder() {} |
+ virtual ~AcceleratedVideoDecoder() {} |
+ |
+ virtual void SetStream(const uint8_t* ptr, size_t size) = 0; |
+ |
+ // Have the decoder flush its state and trigger output of all previously |
+ // decoded surfaces. Return false on failure. |
+ virtual bool Flush() WARN_UNUSED_RESULT = 0; |
+ |
+ // Stop (pause) decoding, discarding all remaining inputs and outputs, |
+ // but do not flush decoder state, so that playback can be resumed later, |
+ // possibly from a different location. |
+ // To be called during decoding. |
+ virtual void Reset() = 0; |
+ |
+ enum DecodeResult { |
+ kDecodeError, // Error while decoding. |
+ // TODO(posciak): unsupported streams are currently treated as error |
+ // in decoding; in future it could perhaps be possible to fall back |
+ // to software decoding instead. |
+ // kStreamError, // Error in stream. |
+ kAllocateNewSurfaces, // Need a new set of surfaces to be allocated. |
+ kRanOutOfStreamData, // Need more stream data to proceed. |
+ kRanOutOfSurfaces, // Waiting for the client to free up output surfaces. |
+ }; |
+ |
+ // Try to decode more of the stream, returning decoded frames asynchronously. |
+ // Return when more stream is needed, when we run out of free surfaces, when |
+ // we need a new set of them, or when an error occurs. |
+ virtual DecodeResult Decode() WARN_UNUSED_RESULT = 0; |
+ |
+ // Return dimensions/required number of output surfaces that client should |
+ // be ready to provide for the decoder to function properly. |
+ // To be used after Decode() returns kNeedNewSurfaces. |
+ virtual gfx::Size GetPicSize() const = 0; |
+ virtual size_t GetRequiredNumOfPictures() const = 0; |
+ |
+ private: |
+ DISALLOW_COPY_AND_ASSIGN(AcceleratedVideoDecoder); |
+}; |
+ |
+} // namespace content |
+ |
+#endif // CONTENT_COMMON_GPU_MEDIA_ACCELERATED_VIDEO_DECODER_ |