1 /* 2 * Copyright (c) 2017-2019, Intel Corporation 3 * 4 * Permission is hereby granted, free of charge, to any person obtaining a 5 * copy of this software and associated documentation files (the "Software"), 6 * to deal in the Software without restriction, including without limitation 7 * the rights to use, copy, modify, merge, publish, distribute, sublicense, 8 * and/or sell copies of the Software, and to permit persons to whom the 9 * Software is furnished to do so, subject to the following conditions: 10 * 11 * The above copyright notice and this permission notice shall be included 12 * in all copies or substantial portions of the Software. 13 * 14 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS 15 * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, 16 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL 17 * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR 18 * OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, 19 * ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR 20 * OTHER DEALINGS IN THE SOFTWARE. 21 */ 22 //! 23 //! \file codechal_decode_avc_g12.h 24 //! \brief This modules implements Render interface layer for AVC decoding to be used on all operating systems/DDIs, across CODECHAL components. 25 //! 26 //! 27 //! \file codechal_decode_avc_g12.h 28 //! \brief Defines the decode interface extension for AVC. 29 //! \details Defines all types, macros, and functions required by CodecHal for AVC decoding. 30 //! Definitions are not externally facing. 31 //! 32 33 #ifndef __CODECHAL_DECODER_AVC_G12_H__ 34 #define __CODECHAL_DECODER_AVC_G12_H__ 35 36 #include "codechal_decode_avc.h" 37 #include "codechal_decode_singlepipe_virtualengine.h" 38 #include "codechal_decode_sfc_avc_g12.h" 39 40 //! 41 //! \class CodechalDecodeAvcG12 42 //! \brief This class defines the member fields, functions etc used by AVC decoder. 43 //! 44 class CodechalDecodeAvcG12 : public CodechalDecodeAvc 45 { 46 public: 47 //! 48 //! \brief Constructor 49 //! \param [in] hwInterface 50 //! Hardware interface 51 //! \param [in] debugInterface 52 //! Debug interface 53 //! \param [in] standardInfo 54 //! The information of decode standard for this instance 55 //! 56 CodechalDecodeAvcG12( 57 CodechalHwInterface *hwInterface, 58 CodechalDebugInterface* debugInterface, 59 PCODECHAL_STANDARD_INFO standardInfo); 60 61 //! 62 //! \brief Copy constructor 63 //! 64 CodechalDecodeAvcG12(const CodechalDecodeAvcG12&) = delete; 65 66 //! 67 //! \brief Copy assignment operator 68 //! 69 CodechalDecodeAvcG12& operator=(const CodechalDecodeAvcG12&) = delete; 70 71 //! 72 //! \brief Destructor 73 //! 74 ~CodechalDecodeAvcG12(); 75 76 //! 77 //! \brief Allocate and initialize AVC decoder standard 78 //! \param [in] settings 79 //! Pointer to CodechalSetting 80 //! \return MOS_STATUS 81 //! MOS_STATUS_SUCCESS if success, else fail reason 82 //! 83 MOS_STATUS AllocateStandard( 84 CodechalSetting * settings) override; 85 86 //! 87 //! \brief Set states for each frame to prepare for GEN11 AVC decode 88 //! \return MOS_STATUS 89 //! MOS_STATUS_SUCCESS if success, else fail reason 90 //! 91 MOS_STATUS SetFrameStates() override; 92 93 //! 94 //! \brief AVC decoder state level function 95 //! \details State level function for GEN11 AVC decoder 96 //! 97 //! \return MOS_STATUS 98 //! MOS_STATUS_SUCCESS if success, else fail reason 99 //! 100 MOS_STATUS DecodeStateLevel() override; 101 102 //! 103 //! \brief AVC decoder primitive level function 104 //! \details Primitive level function for GEN specific AVC decoder 105 //! 106 //! \return MOS_STATUS 107 //! MOS_STATUS_SUCCESS if success, else fail reason 108 //! 109 MOS_STATUS DecodePrimitiveLevel() override; 110 111 //! 112 //! \brief Constrcut Mono Picture 113 //! \details Constrcut Mono Picture in AVC decode driver, Write 0x80 in the chroma plane for Monochrome clips 114 //! \param [in] surface 115 //! Pointer to the decode output surface 116 //! \return MOS_STATUS 117 //! MOS_STATUS_SUCCESS if success, else fail reason 118 //! 119 MOS_STATUS FormatAvcMonoPicture(PMOS_SURFACE surface) override; 120 121 protected: 122 MOS_STATUS InitMmcState() override; 123 124 MOS_STATUS InitSfcState() override; 125 126 MOS_STATUS SetGpuCtxCreatOption(CodechalSetting *settings) override; 127 void CalcRequestedSpace( 128 uint32_t &requestedSize, 129 uint32_t &additionalSizeNeeded, 130 uint32_t &requestedPatchListSize) override; 131 132 //! 133 //! \brief Utility function to allocate internal histogram surface 134 //! 135 //! \return MOS_STATUS 136 //! MOS_STATUS_SUCCESS if success, else fail reason 137 //! 138 virtual MOS_STATUS AllocateHistogramSurface(); 139 140 PCODECHAL_DECODE_SINGLEPIPE_VIRTUALENGINE_STATE m_veState; //!< single pipe virtual engine state 141 142 PMOS_SURFACE m_histogramSurface = nullptr; //!< Internal histogram buffer 143 144 //! \Huc state level command buffer size is required 145 uint32_t m_HucStateCmdBufferSizeNeeded = 0; 146 //! \Huc state level patch list size is required 147 uint32_t m_HucPatchListSizeNeeded = 0; 148 }; 149 150 #endif // __CODECHAL_DECODER_AVC_G12_H__ 151