1 /* 2 * Copyright (c) 2021-2022, 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 decode_mpeg2_mb_packet.h 24 //! \brief Defines the implementation of mpeg2 decode macroblock packet 25 //! 26 27 #ifndef __DECODE_MPEG2_MB_PACKET_H__ 28 #define __DECODE_MPEG2_MB_PACKET_H__ 29 30 #include "media_cmd_packet.h" 31 #include "decode_mpeg2_pipeline.h" 32 #include "decode_utils.h" 33 #include "decode_mpeg2_basic_feature.h" 34 #include "mhw_vdbox_mfx_itf.h" 35 36 using namespace mhw::vdbox::mfx; 37 38 namespace decode 39 { 40 41 class Mpeg2DecodeMbPkt : public DecodeSubPacket, public Itf::ParSetting 42 { 43 public: Mpeg2DecodeMbPkt(Mpeg2Pipeline * pipeline,CodechalHwInterfaceNext * hwInterface)44 Mpeg2DecodeMbPkt(Mpeg2Pipeline *pipeline, CodechalHwInterfaceNext *hwInterface) 45 : DecodeSubPacket(pipeline, hwInterface), m_mpeg2Pipeline(pipeline) 46 { 47 if (m_hwInterface != nullptr) 48 { 49 m_mfxItf = std::static_pointer_cast<Itf>(m_hwInterface->GetMfxInterfaceNext()); 50 m_miItf = std::static_pointer_cast<mhw::mi::Itf>(hwInterface->GetMiInterfaceNext()); 51 } 52 } ~Mpeg2DecodeMbPkt()53 virtual ~Mpeg2DecodeMbPkt(){}; 54 55 //! 56 //! \brief Initialize the media packet, allocate required resources 57 //! \return MOS_STATUS 58 //! MOS_STATUS_SUCCESS if success, else fail reason 59 //! 60 virtual MOS_STATUS Init() override; 61 62 //! 63 //! \brief Prepare interal parameters, should be invoked for each frame 64 //! \return MOS_STATUS 65 //! MOS_STATUS_SUCCESS if success, else fail reason 66 //! 67 virtual MOS_STATUS Prepare() override; 68 69 //! 70 //! \brief Execute mpeg2 slice packet 71 //! \return MOS_STATUS 72 //! MOS_STATUS_SUCCESS if success, else fail reason 73 //! 74 virtual MOS_STATUS Execute(MHW_BATCH_BUFFER& batchBuffer, uint32_t mbIdx) = 0; 75 76 //! 77 //! \brief Calculate Command Size 78 //! 79 //! \param [in, out] commandBufferSize 80 //! requested size 81 //! \param [in, out] requestedPatchListSize 82 //! requested size 83 //! \return MOS_STATUS 84 //! status 85 //! 86 MOS_STATUS CalculateCommandSize( 87 uint32_t &commandBufferSize, 88 uint32_t &requestedPatchListSize) override; 89 90 protected: 91 MOS_STATUS AddCmd_MFD_MPEG2_IT_OBJECT(MHW_BATCH_BUFFER &batchBuffer, uint32_t mbIdx); 92 MOS_STATUS AddAllCmdsInsertSkippedMacroblocks(MHW_BATCH_BUFFER &batchBuffer, uint32_t mbIdx, 93 uint16_t nextMBStart, uint16_t skippedMBs); 94 95 //! 96 //! \brief Calculate macroblock level command Buffer Size 97 //! 98 //! \return uint32_t 99 //! Command buffer size calculated 100 //! 101 virtual MOS_STATUS CalculateMbStateCommandSize(); 102 103 void PackMotionVectors(CODEC_PICTURE_FLAG pic_flag, uint32_t mbIdx, int16_t sPackedMVs0[], int16_t sPackedMVs1[]); 104 105 Mpeg2Pipeline *m_mpeg2Pipeline = nullptr; 106 Mpeg2BasicFeature *m_mpeg2BasicFeature = nullptr; 107 DecodeAllocator *m_allocator = nullptr; 108 std::shared_ptr<Itf> m_mfxItf = nullptr; 109 110 // Parameters passed from application 111 CodecDecodeMpeg2PicParams *m_mpeg2PicParams = nullptr; //!< Pointer to MPEG2 picture parameter 112 113 uint32_t m_mbStatesSize = 0; //!< MB state command size 114 uint32_t m_mbPatchListSize = 0; //!< MB patch list size 115 116 private: 117 //! 118 //! \enum _MPEG2_IMT_TYPE 119 //! \brief Mpeg2 image type 120 //! 121 enum Mpeg2ImtType 122 { 123 Mpeg2ImtNone = 0, //!< triple GFXBlocks 124 Mpeg2ImtFrameFrame = 1, //!< triple 125 Mpeg2ImtFieldField = 2, //!< triple 126 Mpeg2ImtFieldDualPrime = 3, //!< triple 127 Mpeg2ImtFrameFiled = 4, //!< hex 128 Mpeg2ImtFrameDualPrime = 5, //!< hex 129 Mpeg2Imt16x8 = 6 //!< hex 130 }; 131 132 //! 133 //! \enum DecodeMotionType 134 //! \brief Codechal decode motion type 135 //! 136 enum DecodeMotionType 137 { 138 CodechalDecodeMcField = 1, //!< Field motion type 139 CodechalDecodeMcFrame = 2, //!< Frame motion type 140 CodechalDecodeMc16x8 = 2, //!< 16x8 motion type 141 CodechalDecodeMcDmv = 3 //!< DMV motion type 142 }; 143 144 //! 145 //! \enum DecodeMvPacking 146 //! \brief For motion vector packing: the equivilant derefences of a [2][2][2] array mapped as a [8] array 147 //! 148 enum DecodeMvPacking 149 { 150 CodechalDecodeRstFirstForwHorz = 0, //!< first forward horizontal 151 CodechalDecodeRstFirstForwVert = 1, //!< first forward vertical 152 CodechalDecodeRstFirstBackHorz = 2, //!< first backward horizontal 153 CodechalDecodeRstFirstBackVert = 3, //!< first backward vertical 154 CodechalDecodeRstSecndForwHorz = 4, //!< second forward horizontal 155 CodechalDecodeRstSecndForwVert = 5, //!< second forward vertical 156 CodechalDecodeRstSecndBackHorz = 6, //!< second backward horizontal 157 CodechalDecodeRstSecndBackVert = 7 //!< second backward vertical 158 }; 159 160 MEDIA_CLASS_DEFINE_END(decode__Mpeg2DecodeMbPkt) 161 }; 162 163 } // namespace decode 164 #endif 165