[build] Enable NVIDIA Video Codec SDK support for hardware video decode/encode

Add NVCUVID and NVCUVENC support using the Video Codec SDK from the deps
repository. This enables hardware-accelerated video decoding and encoding
via NVIDIA GPUs.

Author: Breakthrough

.github/workflows/build_wheels_windows.yml

@@ -49,6 +49,8 @@ jobs:
             cuda-path-version: 'v12.9'
             cudnn-archive: 'cudnn-windows-x86_64-9.18.1.3_cuda12-archive.zip'
             cudnn-folder: 'cudnn-windows-x86_64-9.18.1.3_cuda12-archive'
+            video-codec-sdk-archive: 'Video_Codec_SDK_13.0.37.zip'
+            video-codec-sdk-folder: 'Video_Codec_SDK_13.0.37'
             cuda-arch-bin: '5.0;5.2;6.0;6.1;7.0;7.5;8.0;8.6;8.9;9.0;10.0'
             cuda-arch-ptx: '10.0'
             cache-key: 'nvidia-deps-cuda-12.9.1-cudnn-9.18.1.3'
@@ -60,6 +62,8 @@ jobs:
           #   cuda-path-version: 'v13.1'
           #   cudnn-archive: 'cudnn-windows-x86_64-9.18.1.3_cuda13-archive.zip'
           #   cudnn-folder: 'cudnn-windows-x86_64-9.18.1.3_cuda13-archive'
+          #   video-codec-sdk-archive: 'Video_Codec_SDK_13.0.37.zip'
+          #   video-codec-sdk-folder: 'Video_Codec_SDK_13.0.37'
           #   cuda-arch-bin: '7.5;8.0;8.6;8.9;9.0;10.0;12.0'
           #   cuda-arch-ptx: '12.0'
           #   cache-key: 'nvidia-deps-cuda-13.1.1-cudnn-9.18.1.3'
@@ -135,6 +139,19 @@ jobs:
         echo "CUDNN_INCLUDE_DIR=$CUDNN_PATH/include" | Out-File -FilePath $env:GITHUB_ENV -Append
         Copy-Item -Path "$CUDNN_PATH/bin/*" -Destination .  -Include "*.dll"
       shell: pwsh
+    - name: 🔧 Install NVIDIA Video Codec SDK
+      run: |
+        $sdk_path = ".deps/Nvidia/${{ matrix.video-codec-sdk-archive }}"
+        if (-not (Test-Path $sdk_path)) {
+          throw "Video Codec SDK archive not found at $sdk_path"
+        }
+        echo "Installing Video Codec SDK..."
+        7z x $sdk_path
+        $SDK_PATH = "D:/a/opencv-python-cuda/opencv-python-cuda/${{ matrix.video-codec-sdk-folder }}"
+        echo "CUDA_nvcuvid_LIBRARY=$SDK_PATH/Lib/win/x64/nvcuvid.lib" | Out-File -FilePath $env:GITHUB_ENV -Append
+        echo "CUDA_nvencodeapi_LIBRARY=$SDK_PATH/Lib/win/x64/nvencodeapi.lib" | Out-File -FilePath $env:GITHUB_ENV -Append
+        echo "NVCUVID_INCLUDE_DIR=$SDK_PATH/Interface" | Out-File -FilePath $env:GITHUB_ENV -Append
+      shell: pwsh
 
     - name: Restore build artifacts
       uses: actions/cache/restore@v3

setup.py

@@ -162,6 +162,11 @@ def main():
     cudnn_library = os.environ["CUDNN_LIBRARY"]
     cudnn_include_dir = os.environ["CUDNN_INCLUDE_DIR"]
 
+    # Video Codec SDK paths for NVCUVID/NVCUVENC (optional, enables hardware video decode/encode)
+    nvcuvid_library = os.environ.get("CUDA_nvcuvid_LIBRARY", "")
+    nvencodeapi_library = os.environ.get("CUDA_nvencodeapi_LIBRARY", "")
+    nvcuvid_include_dir = os.environ.get("NVCUVID_INCLUDE_DIR", "")
+
     cmake_args = (
         (ci_cmake_generator if is_CI_build else [])
         + [
@@ -191,13 +196,23 @@ def main():
             "-DPYTHON3_LIMITED_API=ON",
             "-DBUILD_OPENEXR=ON",
             "-DWITH_CUDA=ON",
-            # TODO(@Breakthrough): Download and install the required dependencies to enable this in build_wheels_windows.yml.
-            "-DWITH_NVCUVID=OFF",
+            "-DWITH_NVCUVID=ON",
+            "-DWITH_NVCUVENC=ON",
             f"-DCUDA_ARCH_BIN={cuda_arch_bin}",
             f"-DCUDA_ARCH_PTX={cuda_arch_ptx}",
             f"-DCUDNN_LIBRARY={cudnn_library}",
             f"-DCUDNN_INCLUDE_DIR={cudnn_include_dir}",
         ]
+        + (
+            # Video Codec SDK paths for hardware video decode/encode support
+            [
+                f"-DCUDA_nvcuvid_LIBRARY={nvcuvid_library}",
+                f"-DCUDA_nvencodeapi_LIBRARY={nvencodeapi_library}",
+                f"-DCMAKE_INCLUDE_PATH={nvcuvid_include_dir}",
+            ]
+            if nvcuvid_library and nvcuvid_include_dir
+            else []
+        )
         + (
             # CUDA 12.9+ requires MSVC's conformant preprocessor for CCCL headers.
             # -Xcompiler passes the flag from nvcc to the host compiler (MSVC).