| /* |
| * Copyright (c) 2014-2020, Intel Corporation |
| * |
| * Permission is hereby granted, free of charge, to any person obtaining a |
| * copy of this software and associated documentation files (the "Software"), |
| * to deal in the Software without restriction, including without limitation |
| * the rights to use, copy, modify, merge, publish, distribute, sublicense, |
| * and/or sell copies of the Software, and to permit persons to whom the |
| * Software is furnished to do so, subject to the following conditions: |
| * |
| * The above copyright notice and this permission notice shall be included |
| * in all copies or substantial portions of the Software. |
| * |
| * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS |
| * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, |
| * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL |
| * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR |
| * OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, |
| * ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR |
| * OTHER DEALINGS IN THE SOFTWARE. |
| */ |
| //! |
| //! \file codechal_decode_downsampling.h |
| //! \brief Defines the decode interface extension for field downsampling. |
| //! \details Downsampling in this case is supported by EU kernels. |
| //! |
| |
| #ifndef __CODECHAL_DECODER_DOWNSAMPLING_H__ |
| #define __CODECHAL_DECODER_DOWNSAMPLING_H__ |
| |
| #include "mos_os.h" |
| #include "mhw_state_heap.h" |
| #include "codechal_mmc.h" |
| |
| struct DecodeProcessingParams; |
| |
| //! |
| //! \class MediaWalkerFieldScalingStaticData |
| //! \brief This class defines the member fields, functions etc. for Media Walker Static Data used by Field Downscaling Kernel. |
| //! |
| class MediaWalkerFieldScalingStaticData |
| { |
| public: |
| //! |
| //! \brief Constructor |
| //! |
| MediaWalkerFieldScalingStaticData(); |
| |
| //! |
| //! \brief Destructor |
| //! |
| ~MediaWalkerFieldScalingStaticData() {}; |
| |
| //! |
| //! \struct MediaWalkerData |
| //! \brief Media Walker Data bit definitions |
| //! |
| struct MediaWalkerData |
| { |
| // uint32_t 0 - GRF R1.0 |
| union |
| { |
| // CSC |
| struct |
| { |
| uint32_t m_cscConstantC0 : 16; |
| uint32_t m_cscConstantC1 : 16; |
| }; |
| |
| uint32_t m_value; |
| } m_dword00; |
| |
| // uint32_t 1 - GRF R1.1 |
| union |
| { |
| // CSC |
| struct |
| { |
| uint32_t m_cscConstantC2 : 16; |
| uint32_t m_cscConstantC3 : 16; |
| }; |
| |
| uint32_t m_value; |
| } m_dword01; |
| |
| // uint32_t 2 - GRF R1.2 |
| union |
| { |
| // CSC |
| struct |
| { |
| uint32_t m_cscConstantC4 : 16; |
| uint32_t m_cscConstantC5 : 16; |
| }; |
| |
| uint32_t m_value; |
| } m_dword02; |
| |
| // uint32_t 3 - GRF R1.3 |
| union |
| { |
| // CSC |
| struct |
| { |
| uint32_t m_cscConstantC6 : 16; |
| uint32_t m_cscConstantC7 : 16; |
| }; |
| |
| uint32_t m_value; |
| } m_dword03; |
| |
| // uint32_t 4 - GRF R1.4 |
| union |
| { |
| // CSC |
| struct |
| { |
| uint32_t m_cscConstantC8 : 16; |
| uint32_t m_cscConstantC9 : 16; |
| }; |
| |
| uint32_t m_value; |
| } m_dword04; |
| |
| // uint32_t 5 - GRF R1.5 |
| union |
| { |
| // CSC |
| struct |
| { |
| uint32_t m_cscConstantC10 : 16; |
| uint32_t m_cscConstantC11 : 16; |
| }; |
| |
| uint32_t m_value; |
| } m_dword05; |
| |
| // uint32_t 6 - GRF R1.6 |
| uint32_t m_padConstantBlend; |
| |
| // uint32_t 7 - GRF R1.7 |
| union |
| { |
| struct |
| { |
| uint32_t m_reserved : 24; |
| uint32_t m_pointerToInlineParameters : 8; |
| }; |
| |
| uint32_t m_value; |
| } m_dword07; |
| |
| // uint32_t 8 - GRF R2.0 |
| union |
| { |
| struct |
| { |
| uint32_t m_destinationRectangleWidth : 16; |
| uint32_t m_destinationRectangleHeight : 16; |
| }; |
| |
| uint32_t m_value; |
| } m_dword08; |
| |
| // uint32_t 9 - GRF R2.1 |
| union |
| { |
| struct |
| { |
| uint32_t m_reserved0 : 27; |
| uint32_t m_iefByPassEnable : 1; |
| uint32_t m_reserved1 : 4; |
| }; |
| |
| uint32_t m_value; |
| } m_dword09; |
| |
| // uint32_t 10 - GRF R2.2 |
| union |
| { |
| struct |
| { |
| uint32_t m_reserved0 : 24; |
| uint32_t m_chromaSitingLocation : 3; |
| uint32_t m_reserved1 : 5; |
| }; |
| |
| uint32_t m_value; |
| } m_dword10; |
| |
| // uint32_t 11 - 13 - GRF R2.3 - 2.5 |
| uint32_t m_pad0[3]; |
| |
| // uint32_t 14 - GRF R2.6 |
| union |
| { |
| // Lumakey, NLAS |
| struct |
| { |
| uint32_t m_lumakeyLowThreshold : 8; |
| uint32_t m_lumakeyHighThreshold : 8; |
| uint32_t m_nlasEnable : 8; |
| uint32_t m_reserved : 8; |
| }; |
| |
| uint32_t m_value; |
| } m_dword14; |
| |
| // uint32_t 15 - GRF R2.7 |
| union |
| { |
| // Save |
| struct |
| { |
| uint8_t m_destinationPackedYOffset; |
| uint8_t m_destinationPackedUOffset; |
| uint8_t m_destinationPackedVOffset; |
| uint8_t m_destinationRGBFormat; |
| }; |
| |
| uint32_t m_value; |
| } m_dword15; |
| |
| // uint32_t 16 - GRF R3.0 |
| union |
| { |
| // Sampler Load |
| struct |
| { |
| float m_horizontalScalingStepRatioLayer0; |
| }; |
| |
| uint32_t m_value; |
| } m_dword16; |
| |
| // uint32_t 17 - 23 - GRF R3.1 - R3.7 |
| uint32_t m_pad1[7]; |
| |
| // uint32_t 24 - GRF R4.0 |
| union |
| { |
| // Sampler Load |
| struct |
| { |
| float m_verticalScalingStepRatioLayer0; |
| }; |
| |
| // Dataport Load |
| struct |
| { |
| uint8_t m_sourcePackedYOffset; |
| uint8_t m_sourcePackedUOffset; |
| uint8_t m_sourcePackedVOffset; |
| uint8_t m_reserved; |
| }; |
| |
| uint32_t m_value; |
| } m_dword24; |
| |
| // uint32_t 25 - 31 - GRF R4.1 - R4.7 |
| uint32_t m_pad2[7]; |
| |
| // uint32_t 32 - GRF R5.0 |
| union |
| { |
| // Sampler Load |
| struct |
| { |
| float m_verticalFrameOriginLayer0; |
| }; |
| |
| uint32_t m_value; |
| } m_dword32; |
| |
| // uint32_t 33 - 39 - GRF R5.1 - R5.7 |
| uint32_t m_pad3[7]; |
| |
| // uint32_t 40 - GRF R6.0 |
| union |
| { |
| // Sampler Load |
| struct |
| { |
| float m_horizontalFrameOriginLayer0; |
| }; |
| |
| uint32_t m_value; |
| } m_dword40; |
| |
| // uint32_t 41 - 47 - GRF R6.1 - R6.7 |
| uint32_t m_pad4[7]; |
| |
| // uint32_t 48 - GRF R7.0 |
| union |
| { |
| struct |
| { |
| uint32_t m_destXTopLeftLayer0 : 16; |
| uint32_t m_destYTopLeftLayer0 : 16; |
| }; |
| |
| uint32_t m_value; |
| } m_dword48; |
| |
| // uint32_t 49 - 55 - GRF R7.1 - R7.7 |
| uint32_t m_pad5[7]; |
| |
| // uint32_t 56 - GRF R8.0 |
| union |
| { |
| struct |
| { |
| uint32_t m_destXBottomRightLayer0 : 16; |
| uint32_t m_destYBottomRightLayer0 : 16; |
| }; |
| |
| uint32_t m_value; |
| } m_dword56; |
| |
| // uint32_t 57 - 63 - GRF R8.1 |
| uint32_t m_pad6[7]; |
| |
| // uint32_t 64 - GRF R9.0 |
| union |
| { |
| struct |
| { |
| float m_mainVideoXScalingStepLeft; |
| }; |
| |
| uint32_t m_value; |
| } m_dword64; |
| |
| // DWORD65 - GRF R9.1 |
| union |
| { |
| struct |
| { |
| float m_videoStepDeltaForNonLinearRegion; |
| }; |
| |
| uint32_t m_value; |
| } m_dword65; |
| |
| // DWORD66 - GRF R9.2 |
| union |
| { |
| struct |
| { |
| uint32_t m_startofLinearScalingInPixelPositionC0 : 16; |
| uint32_t m_startofRHSNonLinearScalingInPixelPositionC1 : 16; |
| }; |
| |
| uint32_t m_value; |
| } m_dword66; |
| |
| // uint32_t 67 - GRF R9.3 |
| union |
| { |
| // Sampler Load |
| struct |
| { |
| float m_mainVideoXScalingStepCenter; |
| }; |
| |
| uint32_t m_value; |
| } m_dword67; |
| |
| // uint32_t 68 - GRF R9.4 |
| union |
| { |
| // Sampler Load |
| struct |
| { |
| float m_mainVideoXScalingStepRight; |
| }; |
| |
| uint32_t m_value; |
| } m_dword68; |
| |
| // uint32_t 69-71 - Padding is needed as we program ConstantURBEntryReadLength = iCurbeLength >> 5 |
| uint32_t m_pad[3]; |
| } m_mediaWalkerData; //!< media walker data |
| |
| static const size_t m_byteSize = sizeof(MediaWalkerData); //!< byte size of media walker data |
| }; |
| |
| //! |
| //! \class FieldScalingInterface |
| //! \brief This class defines the member fields, functions etc used by Field Downscaling interface. |
| //! |
| class FieldScalingInterface |
| { |
| public: |
| //! |
| //! \brief Copy constructor |
| //! |
| FieldScalingInterface(const FieldScalingInterface&) = delete; |
| |
| //! |
| //! \brief Copy assignment operator |
| //! |
| FieldScalingInterface& operator=(const FieldScalingInterface&) = delete; |
| |
| //! |
| //! \brief Destructor |
| //! |
| virtual ~FieldScalingInterface(); |
| |
| //! |
| //! \brief Check Field Scaling Supported |
| //! \details Check parameter legitimacy for field scaling |
| //! \param [in] procParams |
| //! Pointer to decode processing paramters #CODECHAL_DECODE_PROCESSING_PARAMS |
| //! \return bool |
| //! true if support, else false |
| //! |
| bool IsFieldScalingSupported(DecodeProcessingParams *procParams); |
| |
| //! |
| //! \brief Initialize Field Scaling Kernel State |
| //! \details Initialize Field Scaling Kernel State & Params |
| //! \param [in] decoder |
| //! Pointer to decode interface |
| //! \param [in] hwInterface |
| //! Pointer to hardware interface |
| //! \param [in] osInterface |
| //! Pointer to OS interface |
| //! \return MOS_STATUS |
| //! MOS_STATUS_SUCCESS if success, else fail reason |
| //! |
| virtual MOS_STATUS InitializeKernelState( |
| CodechalDecode *decoder, |
| CodechalHwInterface *hwInterface, |
| PMOS_INTERFACE osInterface); |
| |
| //! |
| //! \brief Send Media VFE cmds |
| //! \details Send Media VFE cmds to setup VFE for media kernel |
| //! \param [in] cmdBuffer |
| //! Pointer to command buffer |
| //! \param [in] kernelState |
| //! Pointer to MHW kernel state |
| //! \return MOS_STATUS |
| //! MOS_STATUS_SUCCESS if success, else fail reason |
| //! |
| virtual MOS_STATUS SetupMediaVfe( |
| PMOS_COMMAND_BUFFER cmdBuffer, |
| MHW_KERNEL_STATE *kernelState); |
| |
| //! |
| //! \brief Initialize MMC state for specified downsampling device |
| //! |
| //! \return MOS_STATUS |
| //! MOS_STATUS_SUCCESS if success, else fail reason |
| //! |
| virtual MOS_STATUS InitMmcState(); |
| |
| //! |
| //! \brief Perform Field Scaling |
| //! \details Configure kernel regions to do field scaling |
| //! \param [in] procParams |
| //! Pointer to decode processing paramters #CODECHAL_DECODE_PROCESSING_PARAMS |
| //! \param [in] renderContext |
| //! The render context using for decode |
| //! \param [in] disableDecodeSyncLock |
| //! Disable decode sync lock |
| //! \param [in] disableLockForTranscode |
| //! Disable lock for transcode |
| //! \return MOS_STATUS |
| //! MOS_STATUS_SUCCESS if success, else fail reason |
| //! |
| virtual MOS_STATUS DoFieldScaling( |
| DecodeProcessingParams *procParams, |
| MOS_GPU_CONTEXT renderContext, |
| bool disableDecodeSyncLock, |
| bool disableLockForTranscode); |
| |
| protected: |
| //! |
| //! \brief Constructor |
| //! |
| FieldScalingInterface(CodechalHwInterface *hwInterface); |
| |
| //! |
| //! \enum FieldScalingKernelStateIdx |
| //! \brief Field scaling kernel state index |
| //! |
| enum FieldScalingKernelStateIdx |
| { |
| stateNv12 = 0, //!< Field scaling kernel index for NV12 |
| stateYuy2, //!< Field scaling kernel index for YUY2 |
| stateMax //!< Max kernel index for Field scaling |
| }; |
| |
| enum |
| { |
| fieldTopSrcY = 0, //!< Binding table offset for Top field input Y |
| fieldTopSrcUV = 1, //!< Binding table offset for Top field input UV |
| fieldBotSrcY = 48, //!< Binding table offset for Bottom field input Y |
| fieldBotSrcUV = 49, //!< Binding table offset for Bottom field input UV |
| dstY = 24, //!< Binding table offset for output Y |
| dstUV = 25, //!< Binding table offset for output UV |
| numSurfaces = 50 //!< Number of BT entries for Field scaling |
| }; |
| |
| static const uint32_t m_maxInputWidth = 4096; //!< Max input width supported by Field Scaling |
| static const uint32_t m_minInputWidth = 128; //!< Min input width supported by Field Scaling |
| static const uint32_t m_maxInputHeight = 4096; //!< Max input height supported by Field Scaling |
| static const uint32_t m_minInputHeight = 128; //!< Min input height supported by Field Scaling |
| |
| static const uint32_t m_initDshSize = MHW_PAGE_SIZE; //!< Init DSH size for Field Downscailng kernel |
| static const uint32_t m_samplerNum = 4; //!< Sampler count for Field Downscaling kernel |
| static const uint32_t m_numSyncTags = 16; //!< Sync tags num of state heap settings |
| static const float m_maxScaleRatio; //!< Maximum scaling ratio for both X and Y directions |
| static const float m_minScaleRatio; //!< Minimum scaling ratio for both X and Y directions |
| |
| CodechalDecode *m_decoder = nullptr; //!< Pointer to Decode Interface |
| MOS_INTERFACE *m_osInterface = nullptr; //!< Pointer to OS Interface |
| CodechalHwInterface *m_hwInterface = nullptr; //!< Pointer to HW Interface |
| MhwRenderInterface *m_renderInterface = nullptr; //!< Pointer to Render Interface |
| MHW_STATE_HEAP_INTERFACE *m_stateHeapInterface = nullptr; //!< Pointer to State Heap Interface |
| MhwMiInterface *m_miInterface = nullptr; //!< Pointer to MI interface. |
| uint8_t *m_kernelBase = nullptr; //!< Pointer to kernel base address |
| CodecHalMmcState *m_mmcState = nullptr; //!< Pointer to MMC state |
| uint8_t *m_kernelBinary[stateMax]; //!< Kernel binary |
| uint32_t m_kernelUID[stateMax]; //!< Kernel unique ID |
| uint32_t m_kernelSize[stateMax]; //!< Kernel size |
| MHW_KERNEL_STATE m_kernelStates[stateMax]; //!< Kernel state |
| uint32_t m_dshSize[stateMax]; //!< DSH size |
| MOS_RESOURCE m_syncObject; //!< Sync Object |
| uint32_t m_curbeLength; //!< Media Data struct Length |
| |
| //! |
| //! \brief Initialize state heap settings and kernel params |
| //! \details Initialize Field Scaling Kernel State heap settings & params |
| //! \param [in] hwInterface |
| //! Pointer to HW Interface |
| //! \return MOS_STATUS |
| //! MOS_STATUS_SUCCESS if success, else fail reason |
| //! |
| virtual MOS_STATUS InitInterfaceStateHeapSetting( |
| CodechalHwInterface *hwInterface); |
| |
| protected: |
| //! |
| //! \brief Set Field Scaling Curbe |
| //! \details Set curbe for field scaling kernel |
| //! \param MHW_KERNEL_STATE *kernelState |
| //! [in] Pointer to kernel state |
| //! \param CODECHAL_DECODE_PROCESSING_PARAMS *procParams |
| //! [in] Pointer to decode processing paramters |
| //! \return MOS_STATUS |
| //! MOS_STATUS_SUCCESS if success, else fail reason |
| //! |
| MOS_STATUS SetCurbeFieldScaling( |
| MHW_KERNEL_STATE *kernelState, |
| DecodeProcessingParams *procParams); |
| }; |
| #endif // __CODECHAL_DECODER_DOWNSAMPLING_H__ |
