// Copyright 2020 yuzu Emulator Project // Licensed under GPLv2 or any later version // Refer to the license.txt file included. #pragma once #include #include #include "common/common_types.h" #include "common/stream.h" #include "video_core/command_classes/codecs/vp9_types.h" #include "video_core/command_classes/nvdec_common.h" namespace Tegra { class GPU; enum class FrameType { KeyFrame = 0, InterFrame = 1 }; namespace Decoder { /// The VpxRangeEncoder, and VpxBitStreamWriter classes are used to compose the /// VP9 header bitstreams. class VpxRangeEncoder { public: VpxRangeEncoder(); ~VpxRangeEncoder(); VpxRangeEncoder(const VpxRangeEncoder&) = delete; VpxRangeEncoder& operator=(const VpxRangeEncoder&) = delete; VpxRangeEncoder(VpxRangeEncoder&&) = default; VpxRangeEncoder& operator=(VpxRangeEncoder&&) = default; /// Writes the rightmost value_size bits from value into the stream void Write(s32 value, s32 value_size); /// Writes a single bit with half probability void Write(bool bit); /// Writes a bit to the base_stream encoded with probability void Write(bool bit, s32 probability); /// Signal the end of the bitstream void End(); [[nodiscard]] std::vector& GetBuffer() { return base_stream.GetBuffer(); } [[nodiscard]] const std::vector& GetBuffer() const { return base_stream.GetBuffer(); } private: u8 PeekByte(); Common::Stream base_stream{}; u32 low_value{}; u32 range{0xff}; s32 count{-24}; s32 half_probability{128}; }; class VpxBitStreamWriter { public: VpxBitStreamWriter(); ~VpxBitStreamWriter(); VpxBitStreamWriter(const VpxBitStreamWriter&) = delete; VpxBitStreamWriter& operator=(const VpxBitStreamWriter&) = delete; VpxBitStreamWriter(VpxBitStreamWriter&&) = default; VpxBitStreamWriter& operator=(VpxBitStreamWriter&&) = default; /// Write an unsigned integer value void WriteU(u32 value, u32 value_size); /// Write a signed integer value void WriteS(s32 value, u32 value_size); /// Based on 6.2.10 of VP9 Spec, writes a delta coded value void WriteDeltaQ(u32 value); /// Write a single bit. void WriteBit(bool state); /// Pushes current buffer into buffer_array, resets buffer void Flush(); /// Returns byte_array [[nodiscard]] std::vector& GetByteArray(); /// Returns const byte_array [[nodiscard]] const std::vector& GetByteArray() const; private: /// Write bit_count bits from value into buffer void WriteBits(u32 value, u32 bit_count); /// Gets next available position in buffer, invokes Flush() if buffer is full s32 GetFreeBufferBits(); s32 buffer_size{8}; s32 buffer{}; s32 buffer_pos{}; std::vector byte_array; }; class VP9 { public: explicit VP9(GPU& gpu_); ~VP9(); VP9(const VP9&) = delete; VP9& operator=(const VP9&) = delete; VP9(VP9&&) = default; VP9& operator=(VP9&&) = delete; /// Composes the VP9 frame from the GPU state information. Based on the official VP9 spec /// documentation [[nodiscard]] const std::vector& ComposeFrameHeader( const NvdecCommon::NvdecRegisters& state); /// Returns true if the most recent frame was a hidden frame. [[nodiscard]] bool WasFrameHidden() const { return hidden; } private: /// Generates compressed header probability updates in the bitstream writer template void WriteProbabilityUpdate(VpxRangeEncoder& writer, const std::array& new_prob, const std::array& old_prob); /// Generates compressed header probability updates in the bitstream writer /// If probs are not equal, WriteProbabilityDelta is invoked void WriteProbabilityUpdate(VpxRangeEncoder& writer, u8 new_prob, u8 old_prob); /// Generates compressed header probability deltas in the bitstream writer void WriteProbabilityDelta(VpxRangeEncoder& writer, u8 new_prob, u8 old_prob); /// Inverse of 6.3.4 Decode term subexp void EncodeTermSubExp(VpxRangeEncoder& writer, s32 value); /// Writes if the value is less than the test value bool WriteLessThan(VpxRangeEncoder& writer, s32 value, s32 test); /// Writes probability updates for the Coef probabilities void WriteCoefProbabilityUpdate(VpxRangeEncoder& writer, s32 tx_mode, const std::array& new_prob, const std::array& old_prob); /// Write probabilities for 4-byte aligned structures template void WriteProbabilityUpdateAligned4(VpxRangeEncoder& writer, const std::array& new_prob, const std::array& old_prob); /// Write motion vector probability updates. 6.3.17 in the spec void WriteMvProbabilityUpdate(VpxRangeEncoder& writer, u8 new_prob, u8 old_prob); /// Returns VP9 information from NVDEC provided offset and size [[nodiscard]] Vp9PictureInfo GetVp9PictureInfo(const NvdecCommon::NvdecRegisters& state); /// Read and convert NVDEC provided entropy probs to Vp9EntropyProbs struct void InsertEntropy(u64 offset, Vp9EntropyProbs& dst); /// Returns frame to be decoded after buffering [[nodiscard]] Vp9FrameContainer GetCurrentFrame(const NvdecCommon::NvdecRegisters& state); /// Use NVDEC providied information to compose the headers for the current frame [[nodiscard]] std::vector ComposeCompressedHeader(); [[nodiscard]] VpxBitStreamWriter ComposeUncompressedHeader(); GPU& gpu; std::vector frame; std::array loop_filter_ref_deltas{}; std::array loop_filter_mode_deltas{}; bool hidden = false; s64 current_frame_number = -2; // since we buffer 2 frames s32 grace_period = 6; // frame offsets need to stabilize std::array frame_ctxs{}; Vp9FrameContainer next_frame{}; Vp9FrameContainer next_next_frame{}; bool swap_next_golden{}; Vp9PictureInfo current_frame_info{}; Vp9EntropyProbs prev_frame_probs{}; s32 diff_update_probability = 252; s32 frame_sync_code = 0x498342; }; } // namespace Decoder } // namespace Tegra