| Index: content/common/gpu/media/vp9_decoder.h
|
| diff --git a/content/common/gpu/media/vp9_decoder.h b/content/common/gpu/media/vp9_decoder.h
|
| new file mode 100644
|
| index 0000000000000000000000000000000000000000..c2540d07827f1e0ddc4bab8d28f4bd693843b22d
|
| --- /dev/null
|
| +++ b/content/common/gpu/media/vp9_decoder.h
|
| @@ -0,0 +1,130 @@
|
| +// 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_VP9_DECODER_H_
|
| +#define CONTENT_COMMON_GPU_MEDIA_VP9_DECODER_H_
|
| +
|
| +#include <vector>
|
| +
|
| +#include "base/memory/ref_counted.h"
|
| +#include "base/memory/scoped_ptr.h"
|
| +#include "content/common/gpu/media/accelerated_video_decoder.h"
|
| +#include "content/common/gpu/media/vp9_picture.h"
|
| +#include "media/filters/vp9_parser.h"
|
| +
|
| +namespace content {
|
| +
|
| +// This class implements an AcceleratedVideoDecoder for VP9 decoding.
|
| +// Clients of this class are expected to pass raw VP9 stream and are expected
|
| +// to provide an implementation of VP9Accelerator for offloading final steps
|
| +// of the decoding process.
|
| +//
|
| +// This class must be created, called and destroyed on a single thread, and
|
| +// does nothing internally on any other thread.
|
| +class CONTENT_EXPORT VP9Decoder : public AcceleratedVideoDecoder {
|
| + public:
|
| + class CONTENT_EXPORT VP9Accelerator {
|
| + public:
|
| + VP9Accelerator();
|
| + virtual ~VP9Accelerator();
|
| +
|
| + // Create a new VP9Picture that the decoder client can use for initial
|
| + // stages of the decoding process and pass back to this accelerator for
|
| + // final, accelerated stages of it, or for reference when decoding other
|
| + // pictures.
|
| + //
|
| + // When a picture is no longer needed by the decoder, it will just drop
|
| + // its reference to it, and it may do so at any time.
|
| + //
|
| + // Note that this may return nullptr if the accelerator is not able to
|
| + // provide any new pictures at the given time. The decoder must handle this
|
| + // case and treat it as normal, returning kRanOutOfSurfaces from Decode().
|
| + virtual scoped_refptr<VP9Picture> CreateVP9Picture() = 0;
|
| +
|
| + // Submit decode for |pic| to be run in accelerator, taking as arguments
|
| + // information contained in it, as well as current segmentation and loop
|
| + // filter state in |seg| and |lf|, respectively, and using pictures in
|
| + // |ref_pictures| for reference.
|
| + //
|
| + // Note that returning from this method does not mean that the decode
|
| + // process is finished, but the caller may drop its references to |pic|
|
| + // and |ref_pictures| immediately, and the data in |seg| and |lf| does not
|
| + // need to remain valid after this method returns.
|
| + //
|
| + // Return true when successful, false otherwise.
|
| + virtual bool SubmitDecode(
|
| + const scoped_refptr<VP9Picture>& pic,
|
| + const media::Vp9Segmentation& seg,
|
| + const media::Vp9LoopFilter& lf,
|
| + const std::vector<scoped_refptr<VP9Picture>>& ref_pictures) = 0;
|
| +
|
| + // Schedule output (display) of |pic|.
|
| + //
|
| + // Note that returning from this method does not mean that |pic| has already
|
| + // been outputted (displayed), but guarantees that all pictures will be
|
| + // outputted in the same order as this method was called for them, and that
|
| + // they are decoded before outputting (assuming SubmitDecode() has been
|
| + // called for them beforehand). Decoder may drop its references to |pic|
|
| + // immediately after calling this method.
|
| + //
|
| + // Return true when successful, false otherwise.
|
| + virtual bool OutputPicture(const scoped_refptr<VP9Picture>& pic) = 0;
|
| +
|
| + private:
|
| + DISALLOW_COPY_AND_ASSIGN(VP9Accelerator);
|
| + };
|
| +
|
| + VP9Decoder(VP9Accelerator* accelerator);
|
| + ~VP9Decoder() override;
|
| +
|
| + // content::AcceleratedVideoDecoder implementation.
|
| + void SetStream(const uint8_t* ptr, size_t size) override;
|
| + bool Flush() override WARN_UNUSED_RESULT;
|
| + void Reset() override;
|
| + DecodeResult Decode() override WARN_UNUSED_RESULT;
|
| + gfx::Size GetPicSize() const override;
|
| + size_t GetRequiredNumOfPictures() const override;
|
| +
|
| + private:
|
| + // Update ref_frames_ based on the information in current frame header.
|
| + void RefreshReferenceFrames(const scoped_refptr<VP9Picture>& pic);
|
| +
|
| + // Decode and possibly output |pic| (if the picture is to be shown).
|
| + // Return true on success, false otherwise.
|
| + bool DecodeAndOutputPicture(scoped_refptr<VP9Picture> pic);
|
| +
|
| + // Called on error, when decoding cannot continue. Sets state_ to kError and
|
| + // releases current state.
|
| + void SetError();
|
| +
|
| + enum State {
|
| + kNeedStreamMetadata, // After initialization, need a keyframe.
|
| + kDecoding, // Ready to decode from any point.
|
| + kAfterReset, // After Reset(), need a resume point.
|
| + kError, // Error in decode, can't continue.
|
| + };
|
| +
|
| + // Current decoder state.
|
| + State state_;
|
| +
|
| + // Current frame header to be used in decoding the next picture.
|
| + scoped_ptr<media::Vp9FrameHeader> curr_frame_hdr_;
|
| +
|
| + // Reference frames currently in use.
|
| + std::vector<scoped_refptr<VP9Picture>> ref_frames_;
|
| +
|
| + // Current coded resolution.
|
| + gfx::Size pic_size_;
|
| +
|
| + media::Vp9Parser parser_;
|
| +
|
| + // VP9Accelerator instance owned by the client.
|
| + VP9Accelerator* accelerator_;
|
| +
|
| + DISALLOW_COPY_AND_ASSIGN(VP9Decoder);
|
| +};
|
| +
|
| +} // namespace content
|
| +
|
| +#endif // CONTENT_COMMON_GPU_MEDIA_VP9_DECODER_H_
|
|
|