Add 3DLUT filter in VPP.

1. Add 3DLUT interface and Linux implementation.
2. Add tutorials for 3DLUT VPP and transcode.

Signed-off-by: Furong Zhang <furong.zhang@intel.com>

Author: FurongZhang

_studio/mfx_lib/vpp/src/mfx_vpp_hw.cpp

@@ -1,4 +1,4 @@
-// Copyright (c) 2008-2020 Intel Corporation
+// Copyright (c) 2008-2021 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
@@ -148,6 +148,7 @@ static void MemSetZero4mfxExecuteParams (mfxExecuteParams *pMfxExecuteParams )
 #endif
     pMfxExecuteParams->bEOS = false;
     pMfxExecuteParams->scene = VPP_NO_SCENE_CHANGE;
+    memset(&pMfxExecuteParams->lut3DInfo, 0, sizeof(pMfxExecuteParams->lut3DInfo));
 } /*void MemSetZero4mfxExecuteParams (mfxExecuteParams *pMfxExecuteParams )*/
 
 
@@ -2036,6 +2037,16 @@ mfxStatus VideoVPPHW::GetVideoParams(mfxVideoParam *par) const
             bufSc->InterpolationMethod = m_executeParams.interpolationMethod;
 #endif            
         }
+        else if (MFX_EXTBUFF_VPP_3DLUT == bufferId)
+        {
+            mfxExtVPP3DLut *bufSc = reinterpret_cast<mfxExtVPP3DLut *>(par->ExtParam[i]);
+            MFX_CHECK_NULL_PTR1(bufSc);
+            bufSc->MemID            = m_executeParams.lut3DInfo.MemID;
+            bufSc->Size             = m_executeParams.lut3DInfo.Size;
+            bufSc->DataPrecision    = m_executeParams.lut3DInfo.DataPrecision;
+            bufSc->MemoryLayout     = m_executeParams.lut3DInfo.MemoryLayout;
+            bufSc->ChannelMapping   = m_executeParams.lut3DInfo.ChannelMapping;
+        }
 #if (MFX_VERSION >= 1025)
         else if (MFX_EXTBUFF_VPP_COLOR_CONVERSION == bufferId)
         {
@@ -5664,6 +5675,35 @@ mfxStatus ConfigureExecuteParams(
                     bIsFilterSkipped = true;
                 }
 
+                break;
+            }
+            case MFX_EXTBUFF_VPP_3DLUT:
+            {
+                if (caps.u3DLut)
+                {
+                    for (mfxU32 i = 0; i < videoParam.NumExtParam; i++)
+                    {
+                        if (videoParam.ExtParam[i]->BufferId == MFX_EXTBUFF_VPP_3DLUT)
+                        {
+                            mfxExtVPP3DLut *ext3DLUT = (mfxExtVPP3DLut*) videoParam.ExtParam[i];
+                            if (ext3DLUT)
+                            {
+                                executeParams.lut3DInfo.enabled         = true;
+                                executeParams.lut3DInfo.MemID           = ext3DLUT->MemID;
+                                executeParams.lut3DInfo.Size            = ext3DLUT->Size;
+                                executeParams.lut3DInfo.DataPrecision   = ext3DLUT->DataPrecision;
+                                executeParams.lut3DInfo.MemoryLayout    = ext3DLUT->MemoryLayout;
+                                executeParams.lut3DInfo.ChannelMapping  = ext3DLUT->ChannelMapping;
+                                executeParams.lut3DInfo.IOPattern       = videoParam.IOPattern;
+                            }
+                        }
+                    }
+                }
+                else
+                {
+                    bIsFilterSkipped = true;
+                }
+
                 break;
             }
 #if (MFX_VERSION >= 1025)
@@ -6252,6 +6292,10 @@ mfxStatus ConfigureExecuteParams(
                 {
                     executeParams.scalingMode = MFX_SCALING_MODE_DEFAULT;
                 }
+                else if (MFX_EXTBUFF_VPP_3DLUT == bufferId)
+                {
+                    executeParams.lut3DInfo.enabled = false;
+                }
 #if (MFX_VERSION >= 1025)
                 else if (MFX_EXTBUFF_VPP_COLOR_CONVERSION == bufferId)
                 {

_studio/mfx_lib/vpp/src/mfx_vpp_sw_internal.cpp

@@ -1,4 +1,4 @@
-// Copyright (c) 2018-2020 Intel Corporation
+// Copyright (c) 2018-2021 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
@@ -151,6 +151,11 @@ mfxStatus GetExternalFramesCount(VideoCORE* core,
                 break;
             }
 
+            case (mfxU32)MFX_EXTBUFF_VPP_3DLUT:
+            {
+                break;
+            }
+
             case (mfxU32)MFX_EXTBUFF_VPP_DEINTERLACING:
             {
                 break;

_studio/mfx_lib/vpp/src/mfx_vpp_utils.cpp

@@ -1,4 +1,4 @@
-// Copyright (c) 2018-2020 Intel Corporation
+// Copyright (c) 2018-2021 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
@@ -45,7 +45,8 @@ const mfxU32 g_TABLE_DO_NOT_USE [] =
 #endif
     MFX_EXTBUFF_VPP_VIDEO_SIGNAL_INFO,
     MFX_EXTBUFF_VPP_FIELD_PROCESSING,
-    MFX_EXTBUFF_VPP_MIRRORING
+    MFX_EXTBUFF_VPP_MIRRORING,
+    MFX_EXTBUFF_VPP_3DLUT
 };
 
 
@@ -69,7 +70,8 @@ const mfxU32 g_TABLE_DO_USE [] =
     MFX_EXTBUFF_VPP_DEINTERLACING,
     MFX_EXTBUFF_VPP_VIDEO_SIGNAL_INFO,
     MFX_EXTBUFF_VPP_FIELD_PROCESSING,
-    MFX_EXTBUFF_VPP_MIRRORING
+    MFX_EXTBUFF_VPP_MIRRORING,
+    MFX_EXTBUFF_VPP_3DLUT
 };
 
 
@@ -94,7 +96,8 @@ const mfxU32 g_TABLE_CONFIG [] =
 #if (MFX_VERSION >= 1025)
     MFX_EXTBUFF_VPP_COLOR_CONVERSION,
 #endif
-    MFX_EXTBUFF_VPP_MIRRORING
+    MFX_EXTBUFF_VPP_MIRRORING,
+    MFX_EXTBUFF_VPP_3DLUT
 };
 
 
@@ -125,7 +128,8 @@ const mfxU32 g_TABLE_EXT_PARAM [] =
 #if (MFX_VERSION >= 1025)
     MFX_EXTBUFF_VPP_COLOR_CONVERSION,
 #endif
-    MFX_EXTBUFF_VPP_MIRRORING
+    MFX_EXTBUFF_VPP_MIRRORING,
+    MFX_EXTBUFF_VPP_3DLUT
 };
 
 PicStructMode GetPicStructMode(mfxU16 inPicStruct, mfxU16 outPicStruct)
@@ -674,6 +678,11 @@ void ShowPipeline( std::vector<mfxU32> pipelineList )
                 break;
             }
 #endif
+            case (mfxU32)MFX_EXTBUFF_VPP_3DLUT:
+            {
+                fprintf(stderr, "MFX_EXTBUFF_VPP_3DLUT\n");
+                break;
+            }
             default:
             {
                 fprintf(stderr, "UNKNOWN Filter ID!!! \n");
@@ -793,6 +802,12 @@ void ReorderPipelineListForQuality( std::vector<mfxU32> & pipelineList )
         index++;
     }
 
+    if( IsFilterFound( &pipelineList[0], (mfxU32)pipelineList.size(), MFX_EXTBUFF_VPP_3DLUT ) )
+    {
+        newList[index] = MFX_EXTBUFF_VPP_3DLUT;
+        index++;
+    }
+
     if( IsFilterFound( &pipelineList[0], (mfxU32)pipelineList.size(), MFX_EXTBUFF_VPP_SCENE_ANALYSIS ) )
     {
         newList[index] = MFX_EXTBUFF_VPP_SCENE_ANALYSIS;
@@ -1253,6 +1268,14 @@ mfxStatus GetPipelineList(
         }
     }
 
+    if( IsFilterFound( &configList[0], configCount, MFX_EXTBUFF_VPP_3DLUT ) && !IsFilterFound(&pipelineList[0], (mfxU32)pipelineList.size(), MFX_EXTBUFF_VPP_3DLUT) )
+    {
+        if( !IsFilterFound( &pipelineList[0], (mfxU32)pipelineList.size(), MFX_EXTBUFF_VPP_3DLUT ) )
+        {
+            pipelineList.push_back( MFX_EXTBUFF_VPP_3DLUT );
+        }
+    }
+
     searchCount = sizeof(g_TABLE_CONFIG) / sizeof(*g_TABLE_CONFIG);
     fCount      = configCount;
     for(fIdx = 0; fIdx < fCount; fIdx++)
@@ -1404,8 +1427,14 @@ mfxStatus CheckFrameInfo(mfxFrameInfo* info, mfxU32 request, eMFXHWType platform
     }
 
     /* checking Height based on PicStruct filed */
-    if (MFX_PICSTRUCT_PROGRESSIVE & info->PicStruct ||
-        MFX_PICSTRUCT_FIELD_SINGLE & info->PicStruct)
+    if (MFX_PICSTRUCT_PROGRESSIVE & info->PicStruct)
+    {
+        if ((info->Height  & 4) !=0)
+        {
+            return MFX_ERR_INVALID_VIDEO_PARAM;
+        }
+    }
+    else if (MFX_PICSTRUCT_FIELD_SINGLE & info->PicStruct)
     {
         if ((info->Height  & 15) !=0)
         {
@@ -2288,6 +2317,11 @@ void ConvertCaps2ListDoUse(MfxHwVideoProcessing::mfxVppCaps& caps, std::vector<m
         list.push_back(MFX_EXTBUFF_VPP_SCALING);
     }
 
+    if(caps.u3DLut)
+    {
+        list.push_back(MFX_EXTBUFF_VPP_3DLUT);
+    }
+
 #if (MFX_VERSION >= 1025)
     if (caps.uChromaSiting)
     {

_studio/shared/include/mfx_utils_defs.h

@@ -25,7 +25,7 @@
 #include <vector>
 #include <memory>
 #include <assert.h>
-
+#define MFX_DEBUG_TRACE
 #ifndef MFX_DEBUG_TRACE
 #define MFX_STS_TRACE(sts) sts
 #else

_studio/shared/include/mfx_vpp_interface.h

@@ -1,4 +1,4 @@
-// Copyright (c) 2018-2020 Intel Corporation
+// Copyright (c) 2018-2021 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
@@ -186,6 +186,8 @@ namespace MfxHwVideoProcessing
 
         mfxU32 uMirroring;
 
+        mfxU32 u3DLut;
+
         mfxVppCaps()
             : uAdvancedDI(0)
             , uSimpleDI(0)
@@ -213,6 +215,7 @@ namespace MfxHwVideoProcessing
             , uChromaSiting(0)
             , mFormatSupport()
             , uMirroring(0)
+            , u3DLut(0)
         {
         };
     };
@@ -253,6 +256,16 @@ namespace MfxHwVideoProcessing
             }
         };
 
+        struct Lut3DInfo {
+            bool                      enabled;
+            mfxMemId                  MemID;
+            mfxU16                    IOPattern;
+            mfxU16                    Size;
+            mfxVariantType            DataPrecision;
+            mfx3DLutMemoryLayout      MemoryLayout;
+            mfx3DLutChannelMapping    ChannelMapping;
+        };
+
     public:
             mfxExecuteParams():
                 targetSurface()
@@ -328,6 +341,7 @@ namespace MfxHwVideoProcessing
 
                    VideoSignalInfo.clear();
                    VideoSignalInfo.assign(1, VideoSignalInfoIn);
+                   memset(&lut3DInfo, 0, sizeof(Lut3DInfo));
             };
 
             bool IsDoNothing()
@@ -362,6 +376,7 @@ namespace MfxHwVideoProcessing
 #ifdef MFX_ENABLE_MCTF
                     || bEnableMctf != false
 #endif
+                    || lut3DInfo.enabled != false
                 )
                     return false;
                 if (VideoSignalInfoIn != VideoSignalInfoOut)
@@ -457,6 +472,8 @@ namespace MfxHwVideoProcessing
 #endif
 #endif
         bool reset;
+
+        Lut3DInfo    lut3DInfo;
     };
 
     class DriverVideoProcessing

_studio/shared/include/mfx_vpp_vaapi.h

@@ -1,4 +1,4 @@
-// Copyright (c) 2017-2020 Intel Corporation
+// Copyright (c) 2017-2021 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
@@ -161,6 +161,9 @@ namespace MfxHwVideoProcessing
 
         UMC::Mutex m_guard;
 
+        VAProcFilterCap3DLUT  *m_3dlutCaps;
+        VABufferID            m_3dlutFilterID;
+
         mfxStatus Init( _mfxPlatformAccelerationService* pVADisplay, mfxVideoParam *pParams);
 
         mfxStatus Close( void );