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_hevc_tile_packet_xe2_lpm_base.h
24 //! \brief    Defines the implementation of hevc decode tile coding packet for Xe2_LPM+
25 //!
26 
27 #ifndef __DECODE_HEVC_TILE_PACKET_XE2_LPM_BASE_H__
28 #define __DECODE_HEVC_TILE_PACKET_XE2_LPM_BASE_H__
29 
30 #include "media_cmd_packet.h"
31 #include "decode_hevc_pipeline.h"
32 #include "decode_utils.h"
33 #include "decode_hevc_basic_feature.h"
34 #include "mhw_vdbox_hcp_hwcmd_xe2_lpm.h"
35 
36 namespace decode
37 {
38 
39 class HevcDecodeTilePktXe2_Lpm_Base : public DecodeSubPacket
40 {
41 public:
HevcDecodeTilePktXe2_Lpm_Base(HevcPipeline * pipeline,CodechalHwInterfaceNext * hwInterface)42     HevcDecodeTilePktXe2_Lpm_Base(HevcPipeline *pipeline, CodechalHwInterfaceNext *hwInterface)
43         : DecodeSubPacket(pipeline, hwInterface), m_hevcPipeline(pipeline)
44     {
45         if (m_hwInterface != nullptr)
46         {
47             m_hcpItf = std::static_pointer_cast<mhw::vdbox::hcp::Itf>(m_hwInterface->GetHcpInterfaceNext());
48             m_miItf  = std::static_pointer_cast<mhw::mi::Itf>(m_hwInterface->GetMiInterfaceNext());
49         }
50     }
51     virtual ~HevcDecodeTilePktXe2_Lpm_Base();
52 
53     //!
54     //! \brief  Initialize the media packet, allocate required resources
55     //! \return MOS_STATUS
56     //!         MOS_STATUS_SUCCESS if success, else fail reason
57     //!
58     virtual MOS_STATUS Init() override;
59 
60     //!
61     //! \brief  Prepare interal parameters, should be invoked for each frame
62     //! \return MOS_STATUS
63     //!         MOS_STATUS_SUCCESS if success, else fail reason
64     //!
65     virtual MOS_STATUS Prepare() override;
66 
67     //!
68     //! \brief  Execute hevc tile packet for real tile
69     //! \param  [in] cmdBuffer
70     //!         Commnd buffer to program
71     //! \param  [in] tileX
72     //!         Tile X offset of slice
73     //! \param  [in] tileY
74     //!         Tile Y offset of slice
75     //! \return MOS_STATUS
76     //!         MOS_STATUS_SUCCESS if success, else fail reason
77     //!
78     virtual MOS_STATUS Execute(MOS_COMMAND_BUFFER& cmdBuffer, uint16_t tileX, uint16_t tileY);
79 
80     //!
81     //! \brief  Execute hevc tile packet for virtual tile
82     //! \param  [in] cmdBuffer
83     //!         Commnd buffer to program
84     //! \param  [in] virtualTileIdx
85     //!         The index of virtual tile
86     //! \return MOS_STATUS
87     //!         MOS_STATUS_SUCCESS if success, else fail reason
88     //!
89     virtual MOS_STATUS Execute(MOS_COMMAND_BUFFER& cmdBuffer, uint8_t virtualTileIdx);
90 
91     //!
92     //! \brief  Calculate Command Size
93     //!
94     //! \param  [in, out] commandBufferSize
95     //!         requested size
96     //! \param  [in, out] requestedPatchListSize
97     //!         requested size
98     //! \return MOS_STATUS
99     //!         status
100     //!
101     MOS_STATUS CalculateCommandSize(
102         uint32_t &commandBufferSize,
103         uint32_t &requestedPatchListSize) override;
104 
105 protected:
106     virtual MOS_STATUS SET_HCP_TILE_CODING(uint16_t tileX, uint16_t tileY);
107     virtual MOS_STATUS AddCmd_HCP_Tile_Coding(MOS_COMMAND_BUFFER &cmdBuffer, uint16_t tileX, uint16_t tileY);
108     virtual MOS_STATUS SET_HCP_TILE_CODING(uint8_t virtualTileIdx);
109     virtual MOS_STATUS AddCmd_HCP_Tile_Coding(MOS_COMMAND_BUFFER &cmdBuffer, uint8_t virtualTileIdx);
110 
111     static constexpr uint32_t m_virtualTileMaxNum = 8; //!< The max num of virtual tile
112 
113     HevcPipeline                         *m_hevcPipeline     = nullptr; //!< Pointer to hevc pipeline
114     HevcBasicFeature                     *m_hevcBasicFeature = nullptr; //!< Pointer to hevc basic feature
115     PCODEC_HEVC_PIC_PARAMS                m_hevcPicParams    = nullptr; //!< Pointer to picture parameter
116     std::shared_ptr<mhw::vdbox::hcp::Itf> m_hcpItf           = nullptr;
117 #if (_DEBUG || _RELEASE_INTERNAL)
118     uint32_t                  m_dbgOvrdWidthInMinCb = 0; //!< debug override for picture width in min ctb
119 #endif
120 
121 MEDIA_CLASS_DEFINE_END(decode__HevcDecodeTilePktXe2_Lpm_Base)
122 };
123 
124 }  // namespace decode
125 #endif
126