Debian Codegraph @

media_driver/agnostic/gen11/codec/hal/codechal_encode_avc_g11.h

raw
1 /*
2 * Copyright (c) 2011-2017, 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_encode_avc_g11.h
24 //! \brief This file defines the C++ class/interface for Gen11 platform's AVC
25 //! DualPipe encoding to be used across CODECHAL components.
26 //!
27
28 #ifndef __CODECHAL_ENCODE_AVC_G11_H__
29 #define __CODECHAL_ENCODE_AVC_G11_H__
30
31 #include "codechal_encode_avc.h"
32 #include "codechal_kernel_intra_dist.h"
33 #include "codechal_encode_sw_scoreboard_g11.h"
34 #include "codechal_encode_singlepipe_virtualengine.h"
35
36 class CodechalEncodeAvcEncG11 : public CodechalEncodeAvcEnc
37 {
38 public:
39 //!
40 //! \brief Constructor
41 //!
42 CodechalEncodeAvcEncG11(
43 CodechalHwInterface * hwInterface,
44 CodechalDebugInterface *debugInterface,
45 PCODECHAL_STANDARD_INFO standardInfo);
46
47 //!
48 //! \brief Copy constructor
49 //!
50 CodechalEncodeAvcEncG11(const CodechalEncodeAvcEncG11&) = delete;
51
52 //!
53 //! \brief Copy assignment operator
54 //!
55 CodechalEncodeAvcEncG11& operator=(const CodechalEncodeAvcEncG11&) = delete;
56
57 //!
58 //! \brief Destructor
59 //!
60 ~CodechalEncodeAvcEncG11();
61
62
63 //!
64 //! \brief Encode frame in slice level.
65 //! \details Call related encode functions to encode
66 //! one frame in slice level.
67 //!
68 //! \return MOS_STATUS
69 //! MOS_STATUS_SUCCESS if success
70 //!
71 virtual MOS_STATUS ExecuteSliceLevel() override;
72
73 //!
74 //! \brief Encoder related function
75 //!
76 //! \return MOS_STATUS
77 //! MOS_STATUS_SUCCESS if success, else fail reason
78 //!
79 MOS_STATUS ExecuteKernelFunctions( ) override;
80
81 virtual MOS_STATUS SceneChangeReport(
82 PMOS_COMMAND_BUFFER cmdBuffer,
83 PCODECHAL_ENCODE_AVC_GENERIC_PICTURE_LEVEL_PARAMS params) override;
84
85 //! \brief Get encoder kernel header and kernel size
86 //!
87 //! \param [in] binary
88 //! Pointer to kernel binary
89 //! \param [in] operation
90 //! Enc kernel operation
91 //! \param [in] krnStateIdx
92 //! Kernel state index
93 //! \param [out] krnHeader
94 //! Pointer to kernel header
95 //! \param [out] krnSize
96 //! Pointer to kernel size
97 //!
98 //! \return MOS_STATUS
99 //! MOS_STATUS_SUCCESS if success, else fail reason
100 //!
101 static MOS_STATUS GetKernelHeaderAndSize(
102 void *binary,
103 EncOperation operation,
104 uint32_t krnStateIdx,
105 void *krnHeader,
106 uint32_t *krnSize);
107
108 //!
109 //! \brief Get Trellis Quantization mode/value enable or not.
110 //!
111 //! \param [in] params
112 //! Pointer to CODECHAL_ENCODE_AVC_TQ_INPUT_PARAMS.
113 //! \param [out] trellisQuantParams
114 //! Pointer to CODECHAL_ENCODE_AVC_TQ_PARAMS, mode & value setup.
115 //!
116 //! \return MOS_STATUS
117 //! MOS_STATUS_SUCCESS if success, else fail reason
118 //!
119 virtual MOS_STATUS GetTrellisQuantization(
120 PCODECHAL_ENCODE_AVC_TQ_INPUT_PARAMS params,
121 PCODECHAL_ENCODE_AVC_TQ_PARAMS trellisQuantParams) override;
122
123 // state related funcs
124 //!
125 //! \brief Initialize encode state
126 //!
127 //! \return MOS_STATUS
128 //! MOS_STATUS_SUCCESS if success, else fail reason
129 //!
130 virtual MOS_STATUS InitializeState() override;
131
132 //!
133 //! \brief Init MbEnc kernel state
134 //!
135 //! \return MOS_STATUS
136 //! MOS_STATUS_SUCCESS if success, else fail reason
137 //!
138 virtual MOS_STATUS InitKernelStateMbEnc() override;
139
140 //!
141 //! \brief Init BRC kernel state
142 //!
143 //! \return MOS_STATUS
144 //! MOS_STATUS_SUCCESS if success, else fail reason
145 //!
146 virtual MOS_STATUS InitKernelStateBrc() override;
147
148 //!
149 //! \brief Initialize brc constant buffer
150 //!
151 //! \param [in] params
152 //! Pointer to CODECHAL_ENCODE_AVC_INIT_BRC_CONSTANT_BUFFER_PARAMS
153 //!
154 //! \return MOS_STATUS
155 //! MOS_STATUS_SUCCESS if success, else fail reason
156 //!
157 virtual MOS_STATUS InitBrcConstantBuffer(
158 PCODECHAL_ENCODE_AVC_INIT_BRC_CONSTANT_BUFFER_PARAMS params) override;
159
160 //!
161 //! \brief Initialize MB brc constant buffer
162 //!
163 //! \param [in] params
164 //! Pointer to CODECHAL_ENCODE_AVC_INIT_MBBRC_CONSTANT_DATA_BUFFER_PARAMS
165 //!
166 //! \return MOS_STATUS
167 //! MOS_STATUS_SUCCESS if success, else fail reason
168 //!
169 virtual MOS_STATUS InitMbBrcConstantDataBuffer(
170 PCODECHAL_ENCODE_AVC_INIT_MBBRC_CONSTANT_DATA_BUFFER_PARAMS params) override;
171
172 //!
173 //! \brief Get MBEnc kernel state index
174 //!
175 //! \param [in] params
176 //! Pointer to CODECHAL_ENCODE_ID_OFFSET_PARAM
177 //!
178 //! \param [out] kernelOffset
179 //! The required kernel offset.
180 //!
181 //! \return MOS_STATUS
182 //! MOS_STATUS_SUCCESS if success, else fail reason
183 //!
184 virtual MOS_STATUS GetMbEncKernelStateIdx(
185 CodechalEncodeIdOffsetParams* params,
186 uint32_t* kernelOffset) override;
187 //!
188 //! \brief Set MbEnc kernel curbe data
189 //!
190 //! \param [in] params
191 //! Pointer to CODECHAL_ENCODE_AVC_MBENC_CURBE_PARAMS
192 //!
193 //! \return MOS_STATUS
194 //! MOS_STATUS_SUCCESS if success, else fail reason
195 //!
196 virtual MOS_STATUS SetCurbeAvcMbEnc(
197 PCODECHAL_ENCODE_AVC_MBENC_CURBE_PARAMS params) override;
198
199 //!
200 //! \brief Set up BrcInit curbe
201 //!
202 //! \param [in] params
203 //! Pointer to CODECHAL_ENCODE_AVC_INIT_BRC_CONSTANT_BUFFER_PARAMS
204 //!
205 //! \return MOS_STATUS
206 //! MOS_STATUS_SUCCESS if success, else fail reason
207 //!
208 virtual MOS_STATUS SetCurbeAvcBrcInitReset(
209 PCODECHAL_ENCODE_AVC_BRC_INIT_RESET_CURBE_PARAMS params) override;
210 //!
211 //! \brief Set up frameBrcUpdate kernel curbe
212 //!
213 //! \param [in] params
214 //! Pointer to CODECHAL_ENCODE_AVC_BRC_UPDATE_CURBE_PARAMS
215 //!
216 //! \return MOS_STATUS
217 //! MOS_STATUS_SUCCESS if success, else fail reason
218 //!
219 virtual MOS_STATUS SetCurbeAvcFrameBrcUpdate(
220 PCODECHAL_ENCODE_AVC_BRC_UPDATE_CURBE_PARAMS params) override;
221 //!
222 //! \brief Set up MbBrcUpdate curbe
223 //!
224 //! \param [in] params
225 //! Pointer to CODECHAL_ENCODE_AVC_BRC_UPDATE_CURBE_PARAMS
226 //!
227 //! \return MOS_STATUS
228 //! MOS_STATUS_SUCCESS if success, else fail reason
229 //!
230 virtual MOS_STATUS SetCurbeAvcMbBrcUpdate(
231 PCODECHAL_ENCODE_AVC_BRC_UPDATE_CURBE_PARAMS params) override;
232 //!
233 //! \brief Set up BrcBlockCopy kernel curbe
234 //!
235 //! \param [in] params
236 //! Pointer to CODECHAL_ENCODE_AVC_BRC_BLOCK_COPY_CURBE_PARAMS
237 //!
238 //! \return MOS_STATUS
239 //! MOS_STATUS_SUCCESS if success, else fail reason
240 //!
241 virtual MOS_STATUS SetCurbeAvcBrcBlockCopy(
242 PCODECHAL_ENCODE_AVC_BRC_BLOCK_COPY_CURBE_PARAMS params) override;
243 //!
244 //! \brief Encode User Feature Key Report.
245 //! \details Report user feature values set by encode.
246 //!
247 //! \return MOS_STATUS
248 //! MOS_STATUS_SUCCESS if success
249 //!
250 virtual MOS_STATUS UserFeatureKeyReport() override;
251 //!
252 //! \brief Set up surfaces for MbEnc kernel
253 //!
254 //! \param [in] cmdBuffer
255 //! Pointer to MOS_COMMAND_BUFFER
256 //!
257 //! \param [in] params
258 //! Pointer to CODECHAL_ENCODE_AVC_MBENC_SURFACE_PARAMS
259 //!
260 //! \return MOS_STATUS
261 //! MOS_STATUS_SUCCESS if success, else fail reason
262 //!
263 virtual MOS_STATUS SendAvcMbEncSurfaces(
264 PMOS_COMMAND_BUFFER cmdBuffer,
265 PCODECHAL_ENCODE_AVC_MBENC_SURFACE_PARAMS params) override;
266
267 //!
268 //! \brief Set up surfaces for BrcFrameUpdate kernel
269 //!
270 //! \param [in] cmdBuffer
271 //! Pointer to MOS_COMMAND_BUFFER
272 //!
273 //! \param [in] params
274 //! Pointer to CODECHAL_ENCODE_AVC_BRC_UPDATE_SURFACE_PARAMS
275 //!
276 //! \return MOS_STATUS
277 //! MOS_STATUS_SUCCESS if success, else fail reason
278 //!
279 virtual MOS_STATUS SendAvcBrcFrameUpdateSurfaces(
280 PMOS_COMMAND_BUFFER cmdBuffer,
281 PCODECHAL_ENCODE_AVC_BRC_UPDATE_SURFACE_PARAMS params) override;
282 //!
283 //! \brief Set up surfaces for BrcMbUpdate kernel
284 //!
285 //! \param [in] cmdBuffer
286 //! Pointer to MOS_COMMAND_BUFFER
287 //!
288 //! \param [in] params
289 //! Pointer to CODECHAL_ENCODE_AVC_BRC_UPDATE_SURFACE_PARAMS
290 //!
291 //! \return MOS_STATUS
292 //! MOS_STATUS_SUCCESS if success, else fail reason
293 //!
294 virtual MOS_STATUS SendAvcBrcMbUpdateSurfaces(
295 PMOS_COMMAND_BUFFER cmdBuffer,
296 PCODECHAL_ENCODE_AVC_BRC_UPDATE_SURFACE_PARAMS params) override;
297 //!
298 //! \brief Set up ROI surfaces
299 //!
300 //! \return MOS_STATUS
301 //! MOS_STATUS_SUCCESS if success, else fail reason
302 //!
303 virtual MOS_STATUS SetupROISurface() override;
304
305 virtual MOS_STATUS SendPrologWithFrameTracking(
306 PMOS_COMMAND_BUFFER cmdBuffer,
307 bool frameTracking,
308 MHW_MI_MMIOREGISTERS *mmioRegister = nullptr) override;
309
310 //!
311 //! \brief Run MbEnc Kernel.
312 //!
313 //! \param [in] mbEncIFrameDistInUse
314 //! MbEncIFrameDist in use or not
315 //!
316 //! \return MOS_STATUS
317 //! MOS_STATUS_SUCCESS if success, else fail reason
318 //!
319 virtual MOS_STATUS MbEncKernel(
320 bool mbEncIFrameDistInUse) override;
321
322 //!
323 //! \brief Resize buffers due to resoluton change.
324 //! \details Resize buffers due to resoluton change.
325 //!
326 //! \return void
327 //!
328 virtual void ResizeOnResChange() override;
329
330 virtual MOS_STATUS InitKernelStateMe() override;
331
332 virtual MOS_STATUS UpdateCmdBufAttribute(
333 PMOS_COMMAND_BUFFER cmdBuffer,
334 bool renderEngineInUse) override;
335
336 //!
337 //! \brief Set And Populate VE Hint parameters
338 //! \details Set Virtual Engine hint parameter and populate it to primary cmd buffer attributes
339 //! \param [in] cmdBuffer
340 //! Pointer to primary cmd buffer
341 //! \return MOS_STATUS
342 //! MOS_STATUS_SUCCESS if success, else fail reason
343 //!
344 MOS_STATUS SetAndPopulateVEHintParams(
345 PMOS_COMMAND_BUFFER cmdBuffer);
346
347 //!
348 //! \brief Set up params for gpu context creation
349 //! \return MOS_STATUS
350 //! MOS_STATUS_SUCCESS if success, else fail reason
351 //!
352 MOS_STATUS SetGpuCtxCreatOption() override;
353
354 PCODECHAL_ENCODE_SINGLEPIPE_VIRTUALENGINE_STATE m_sinlgePipeVeState; //!< single pipe virtual engine state
355
356 #if USE_CODECHAL_DEBUG_TOOL
357 protected:
358 virtual MOS_STATUS PopulateBrcInitParam(
359 void *cmd) override;
360
361 virtual MOS_STATUS PopulateBrcUpdateParam(
362 void *cmd) override;
363
364 virtual MOS_STATUS PopulateEncParam(
365 uint8_t meMethod,
366 void *cmd) override;
367
368 virtual MOS_STATUS PopulatePakParam(
369 PMOS_COMMAND_BUFFER cmdBuffer,
370 PMHW_BATCH_BUFFER secondLevelBatchBuffer) override;
371 #endif
372
373 private:
374 static const uint32_t m_IntraModeCostForHighTextureMB[CODEC_AVC_NUM_QP];
375 static const uint8_t m_QPAdjustmentDistThresholdMaxFrameThresholdIPB[576];
376 static const CODECHAL_ENCODE_AVC_IPCM_THRESHOLD m_IPCMThresholdTable[5];
377 static const int32_t m_brcBTCounts[CODECHAL_ENCODE_BRC_IDX_NUM];
378 static const int32_t m_brcCurbeSize[CODECHAL_ENCODE_BRC_IDX_NUM];
379 static const uint16_t m_LambdaData[256];
380 static const uint8_t m_FTQ25[64];
381 static const uint16_t m_refCostMultiRefQp[NUM_PIC_TYPES][64];
382 static const uint32_t m_multiPred[NUM_TARGET_USAGE_MODES];
383 static const uint32_t m_MRDisableQPCheck[NUM_TARGET_USAGE_MODES];
384
385 CodechalKernelIntraDist *m_intraDistKernel = nullptr;
386 CodechalEncodeSwScoreboard *m_swScoreboardState = nullptr; //!< pointer to SW scoreboard init state.
387 };
388
389 #endif // __CODECHAL_ENCODE_AVC_G11_H__