1 /* 2 * Copyright (c) 2018-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 //! 24 //! \file encode_hevc_vdenc_feature_manager.h 25 //! \brief Defines the common interface for henvc vdenc feature manager 26 //! \details The encode feature manager is further sub-divided by codec type 27 //! this file is for the base interface which is shared by all components. 28 //! 29 30 #ifndef __ENCODE_HEVC_VDENC_FEATURE_MANAGER_H__ 31 #define __ENCODE_HEVC_VDENC_FEATURE_MANAGER_H__ 32 #include <vector> 33 #include "media_hevc_feature_defs.h" 34 #include "encode_feature_manager.h" 35 #include "encode_hevc_basic_feature.h" 36 #include "encode_hevc_cqp.h" 37 #include "encode_hevc_vdenc_roi.h" 38 #include "encode_hevc_tile.h" 39 #include "encode_hevc_dss.h" 40 #include "encode_recycle_resource.h" 41 #include "encode_hevc_vdenc_scc.h" 42 43 namespace encode 44 { 45 46 class EncodeHevcVdencFeatureManager : public EncodeFeatureManager 47 { 48 public: 49 //! 50 //! \brief EncodeHevcVdencFeatureManager constructor 51 //! \param [in] allocator 52 //! Pointer to EncodeAllocator 53 //! \param [in] hwInterface 54 //! Pointer to CodechalHwInterface 55 //! \param [in] trackedBuf 56 //! Pointer to TrackedBuffer 57 //! \param [in] recycleBuf 58 //! Pointer to RecycleResource 59 //! EncodeHevcVdencFeatureManager(EncodeAllocator * allocator,CodechalHwInterfaceNext * hwInterface,TrackedBuffer * trackedBuf,RecycleResource * recycleBuf)60 EncodeHevcVdencFeatureManager(EncodeAllocator *allocator, 61 CodechalHwInterfaceNext *hwInterface, 62 TrackedBuffer *trackedBuf, 63 RecycleResource *recycleBuf): 64 m_allocator(allocator), 65 m_hwInterface(hwInterface), 66 m_recycleResource(recycleBuf), 67 m_trackedBuf(trackedBuf) {}; 68 69 //! 70 //! \brief EncodeHevcVdencFeatureManager deconstructor 71 //! ~EncodeHevcVdencFeatureManager()72 virtual ~EncodeHevcVdencFeatureManager() {} 73 74 //! 75 //! \brief Check the conflict between features 76 //! \param [in] params 77 //! encode parameters 78 //! \return MOS_STATUS 79 //! MOS_STATUS_SUCCESS if success, else fail reason 80 //! 81 virtual MOS_STATUS CheckFeatures(void *params) override; 82 //! 83 //! \brief Create feature const settings 84 //! \return MOS_STATUS 85 //! MOS_STATUS_SUCCESS if success, else fail reason 86 //! 87 virtual MOS_STATUS CreateConstSettings() override; 88 89 protected: 90 91 //! 92 //! \brief Create features 93 //! \param [in] constsettings 94 //! feature const settings 95 //! \return MOS_STATUS 96 //! MOS_STATUS_SUCCESS if success, else fail reason 97 //! 98 virtual MOS_STATUS CreateFeatures(void *constSettings) override; 99 100 //! 101 //! \brief Map target usage 102 //! \return MOS_STATUS 103 //! MOS_STATUS_SUCCESS if success, else fail reason 104 //! 105 virtual MOS_STATUS MapTargetUsage(uint8_t &targetUsage); 106 107 //! 108 //! \brief Validate Random Access params 109 //! \param [in] hevcSeqParams 110 //! sequese parameters from DDI 111 //! \param [in] hevcPictureParams 112 //! picture parameters from DDI 113 //! \return MOS_STATUS 114 //! MOS_STATUS_SUCCESS if success, else fail reason 115 //! 116 MOS_STATUS ValidateRandomAccess( 117 PCODEC_HEVC_ENCODE_SEQUENCE_PARAMS hevcSeqParams, 118 PCODEC_HEVC_ENCODE_PICTURE_PARAMS hevcPicParams, 119 PCODEC_HEVC_ENCODE_SLICE_PARAMS slcParams); 120 121 //! 122 //! \brief Validate SCC status 123 //! \param [in] hevcPictureParams 124 //! picture parameters from DDI 125 //! \return MOS_STATUS 126 //! MOS_STATUS_SUCCESS if success, else fail reason 127 //! 128 MOS_STATUS ValidateSCC(PCODEC_HEVC_ENCODE_PICTURE_PARAMS hevcPicParams); 129 130 //! 131 //! \brief Validate ACQP status 132 //! \param [in] hevcSeqParams 133 //! sequese parameters from DDI 134 //! \param [in] hevcPictureParams 135 //! picture parameters from DDI 136 //! \return MOS_STATUS 137 //! MOS_STATUS_SUCCESS if success, else fail reason 138 //! 139 MOS_STATUS ValidateACQP( 140 PCODEC_HEVC_ENCODE_SEQUENCE_PARAMS hevcSeqParams, 141 PCODEC_HEVC_ENCODE_PICTURE_PARAMS hevcPicParams); 142 143 MOS_STATUS ValidatePassNum( 144 PCODEC_HEVC_ENCODE_SEQUENCE_PARAMS hevcSeqParams, 145 PCODEC_HEVC_ENCODE_PICTURE_PARAMS hevcPicParams); 146 147 //! 148 //! \brief Check Platform Capabilities 149 //! \param [in] hevcSeqParams 150 //! sequese parameters from DDI 151 //! \param [in] hevcPictureParams 152 //! picture parameters from DDI 153 //! \param [in] hevcSliceParams 154 //! slice parameters from DDI 155 //! \return MOS_STATUS 156 //! MOS_STATUS_SUCCESS if success, else fail reason 157 //! 158 virtual MOS_STATUS CheckPlatformCapability( 159 PCODEC_HEVC_ENCODE_SEQUENCE_PARAMS hevcSeqParams, 160 PCODEC_HEVC_ENCODE_PICTURE_PARAMS hevcPicParams, 161 PCODEC_HEVC_ENCODE_SLICE_PARAMS hevcSliceParams); 162 163 EncodeAllocator *m_allocator = nullptr; 164 165 CodechalHwInterfaceNext *m_hwInterface = nullptr; 166 RecycleResource *m_recycleResource = nullptr; 167 TrackedBuffer *m_trackedBuf = nullptr; 168 169 MEDIA_CLASS_DEFINE_END(encode__EncodeHevcVdencFeatureManager) 170 }; 171 172 173 } 174 #endif // !__ENCODE_HEVC_VDENC_FEATURE_MANAGER_H__ 175