| /* |
| * Copyright (c) 2021, Alliance for Open Media. All rights reserved |
| * |
| * This source code is subject to the terms of the BSD 3-Clause Clear License |
| * and the Alliance for Open Media Patent License 1.0. If the BSD 3-Clause Clear |
| * License was not distributed with this source code in the LICENSE file, you |
| * can obtain it at aomedia.org/license/software-license/bsd-3-c-c/. If the |
| * Alliance for Open Media Patent License 1.0 was not distributed with this |
| * source code in the PATENTS file, you can obtain it at |
| * aomedia.org/license/patent-license/. |
| */ |
| |
| #ifndef AOM_TEST_DECODE_TEST_DRIVER_H_ |
| #define AOM_TEST_DECODE_TEST_DRIVER_H_ |
| #include <cstring> |
| #include "third_party/googletest/src/googletest/include/gtest/gtest.h" |
| |
| #include "config/aom_config.h" |
| |
| #include "aom/aom_decoder.h" |
| |
| namespace libaom_test { |
| |
| class CodecFactory; |
| class CompressedVideoSource; |
| |
| // Provides an object to handle decoding output |
| class DxDataIterator { |
| public: |
| explicit DxDataIterator(aom_codec_ctx_t *decoder) |
| : decoder_(decoder), iter_(NULL) {} |
| |
| const aom_image_t *Next() { return aom_codec_get_frame(decoder_, &iter_); } |
| const aom_image_t *Peek() { return aom_codec_peek_frame(decoder_, &iter_); } |
| |
| private: |
| aom_codec_ctx_t *decoder_; |
| aom_codec_iter_t iter_; |
| }; |
| |
| // Provides a simplified interface to manage one video decoding. |
| // Similar to Encoder class, the exact services should be added |
| // as more tests are added. |
| class Decoder { |
| public: |
| explicit Decoder(aom_codec_dec_cfg_t cfg) |
| : cfg_(cfg), flags_(0), init_done_(false) { |
| memset(&decoder_, 0, sizeof(decoder_)); |
| } |
| |
| Decoder(aom_codec_dec_cfg_t cfg, const aom_codec_flags_t flag) |
| : cfg_(cfg), flags_(flag), init_done_(false) { |
| memset(&decoder_, 0, sizeof(decoder_)); |
| } |
| |
| virtual ~Decoder() { aom_codec_destroy(&decoder_); } |
| |
| aom_codec_err_t PeekStream(const uint8_t *cxdata, size_t size, |
| aom_codec_stream_info_t *stream_info); |
| |
| aom_codec_err_t DecodeFrame(const uint8_t *cxdata, size_t size); |
| |
| aom_codec_err_t DecodeFrame(const uint8_t *cxdata, size_t size, |
| void *user_priv); |
| |
| DxDataIterator GetDxData() { return DxDataIterator(&decoder_); } |
| |
| void Control(int ctrl_id, int arg) { Control(ctrl_id, arg, AOM_CODEC_OK); } |
| |
| void Control(int ctrl_id, const void *arg) { |
| InitOnce(); |
| const aom_codec_err_t res = aom_codec_control(&decoder_, ctrl_id, arg); |
| ASSERT_EQ(AOM_CODEC_OK, res) << DecodeError(); |
| } |
| |
| void Control(int ctrl_id, int arg, aom_codec_err_t expected_value) { |
| InitOnce(); |
| const aom_codec_err_t res = aom_codec_control(&decoder_, ctrl_id, arg); |
| ASSERT_EQ(expected_value, res) << DecodeError(); |
| } |
| |
| const char *DecodeError() { |
| const char *detail = aom_codec_error_detail(&decoder_); |
| return detail ? detail : aom_codec_error(&decoder_); |
| } |
| |
| // Passes the external frame buffer information to libaom. |
| aom_codec_err_t SetFrameBufferFunctions( |
| aom_get_frame_buffer_cb_fn_t cb_get, |
| aom_release_frame_buffer_cb_fn_t cb_release, void *user_priv) { |
| InitOnce(); |
| return aom_codec_set_frame_buffer_functions(&decoder_, cb_get, cb_release, |
| user_priv); |
| } |
| |
| const char *GetDecoderName() const { |
| return aom_codec_iface_name(CodecInterface()); |
| } |
| |
| bool IsAV1() const; |
| |
| aom_codec_ctx_t *GetDecoder() { return &decoder_; } |
| |
| protected: |
| virtual aom_codec_iface_t *CodecInterface() const = 0; |
| |
| void InitOnce() { |
| if (!init_done_) { |
| const aom_codec_err_t res = |
| aom_codec_dec_init(&decoder_, CodecInterface(), &cfg_, flags_); |
| ASSERT_EQ(AOM_CODEC_OK, res) << DecodeError(); |
| init_done_ = true; |
| } |
| } |
| |
| aom_codec_ctx_t decoder_; |
| aom_codec_dec_cfg_t cfg_; |
| aom_codec_flags_t flags_; |
| bool init_done_; |
| }; |
| |
| // Common test functionality for all Decoder tests. |
| class DecoderTest { |
| public: |
| // Main decoding loop |
| virtual void RunLoop(CompressedVideoSource *video); |
| virtual void RunLoop(CompressedVideoSource *video, |
| const aom_codec_dec_cfg_t &dec_cfg); |
| |
| virtual void set_cfg(const aom_codec_dec_cfg_t &dec_cfg); |
| virtual void set_flags(const aom_codec_flags_t flags); |
| |
| // Hook to be called before decompressing every frame. |
| virtual void PreDecodeFrameHook(const CompressedVideoSource & /*video*/, |
| Decoder * /*decoder*/) {} |
| |
| // Hook to be called to handle decode result. Return true to continue. |
| virtual bool HandleDecodeResult(const aom_codec_err_t res_dec, |
| const CompressedVideoSource & /*video*/, |
| Decoder *decoder) { |
| EXPECT_EQ(AOM_CODEC_OK, res_dec) << decoder->DecodeError(); |
| return AOM_CODEC_OK == res_dec; |
| } |
| |
| // Hook to be called on every decompressed frame. |
| virtual void DecompressedFrameHook(const aom_image_t & /*img*/, |
| const unsigned int /*frame_number*/) {} |
| |
| // Hook to be called on peek result |
| virtual void HandlePeekResult(Decoder *const decoder, |
| CompressedVideoSource *video, |
| const aom_codec_err_t res_peek); |
| |
| protected: |
| explicit DecoderTest(const CodecFactory *codec) |
| : codec_(codec), cfg_(), flags_(0) {} |
| |
| virtual ~DecoderTest() {} |
| |
| const CodecFactory *codec_; |
| aom_codec_dec_cfg_t cfg_; |
| aom_codec_flags_t flags_; |
| }; |
| |
| } // namespace libaom_test |
| |
| #endif // AOM_TEST_DECODE_TEST_DRIVER_H_ |