Skip to content

Latest commit

 

History

History
113 lines (65 loc) · 6.21 KB

README.md

File metadata and controls

113 lines (65 loc) · 6.21 KB
Raw

VK_VULKAN_VIDEO

This project conatins two Vulkan Video sample applications which demonstrate video decoding and encoding, respectively. These samples can be independently compiled. Instructions on how to build either the encoder or decoder sample are present within each respective folder.

VK_VIDEO_DECODE

vk_video_decode

This project is a Vulkan Video Sample Application demonstrating an end-to-end, all-Vulkan, processing of h.264/5 compressed video content. The application decodes the h.264/5 compressed content using an HW accelerated decoder, the decoded YCbCr frames are processed with Vulkan Graphics and then presented via the Vulkan WSI.

Currently, the sample application supports Linux and Windows10 operating systems.

Features

  • Extracts (DEMUX via FFMPEG) compressed video from .mp4, .mkv .mov and others video containers using h.264 (AVC) or h.265 (HEVC) compression formats.
  • The HW video decoder processes textures to Vulkan Video Images that can be directly sampled from Vulkan Samplers (Textures).
  • Converts the YCbCr (YUV) Images to RGB while sampling the decoded images using the VK_KHR_sampler_ycbcr_conversion
  • Displays the post-processed video frames using Vulkan WSI.
  • Provides the h.264/5 SPS/PPS video picture parameters inlined with each frame's parameters. This isn't compliant with the Vulkan Video Specification. Proper handling of such parameters must be done using an object of type VkVideoSessionParametersKHR.
  • Added support for VkVideoSessionParametersKHR for full compliance with the Vulkan Video Specification.
  • Use Video display timing synchronization (such as VK_EXT_present_timing) at the WSI side - currently the video is played at the maximum frame rate that the display device can support. The video may be played at a faster rate than it is authored.
  • Convert the sample's framework to be compatible with the rest of the nvpro-samples.

For instructions on how to build the sample decode application, please see the build instructions.

Please download and install Beta NVIDIA Driver with Vulkan Video Enabled.

For Vulkan Video Specification please refer to Vulkan Spec with Video Extensions.

For deep-dive information on Vulkan Video please refer to the Deep Dive Slide Deck.

VK_VIDEO_ENCODE

This project is a Nvpro-based Vulkan Video sample application demonstrating video encoding. By using the Vulkan video encoding extensions to drive the HW-accelerated video encoder, this application encodes YCbCr content and writes the h.264 or h.265 compressed video to a file.

The sample is still in development and has issues such as missing POC numbers and corrupted frames.

Currently, the sample application supports Linux and Windows operating systems.

Features

  • Video encoding using h.264 standard
  • Support for all-Intra GOP structure
  • Support for P frames
  • Support for B frames
  • Encoding frames from graphical application
  • Different YCbCr chroma subsampling and bit depth options
  • Support for h.265 standard
  • Support for encoding tuning and quality levels
  • Better Support for rate control
  • Support for multi-threaded encoding
  • Test 10-bit encoding

For instructions on how to build the sample decode application, please see the build instructions.

Please download and install Beta NVIDIA Driver with Vulkan Video Enabled.

For Vulkan Video Specification please refer to Vulkan Spec with Video Extensions.

For deep-dive information on Vulkan Video please refer to the Deep Dive Slide Deck.

Enabling Vulkan Validation Layers

The Khronos Valiation Layer can be used for to verify the application correctly use the Vulkan API. There are two options for running the validation layers using the application.

Option 1: Vulkan Configurator

Vulkan Configurator is installed with the Vulkan SDK. When Vulkan Configurator opens its GUI put the ticks opposite VK_LAYER_KHRONOS_validation, VK_VALIDATION_VALIDATE_SYNC, VK_VALIDATION_THREAD_SAFETY.

On Ubuntu

Make sure Qt is installed - it can be installed by executing sudo apt install qt5-default. To launch Vulkan Configurator GUI execute vkconfig.

On Windows

Vulkan Configurator is located in Start menu, in the Vulkan SDK folder. Vulkan Configurator can be launched from command-line shell vkconfig.

To turn off the Validation layers override click "Yes" when closing Vulkan Configurator window.

For more information on Vulkan Configurator please refer to the LunarG, Using the Vulkan Configurator

Option 2: Environmental variables

Open command-line shell, execute the following commands to enable VK_LAYER_KHRONOS_validation, VK_VALIDATION_VALIDATE_SYNC, VK_VALIDATION_THREAD_SAFETY.

On Ubuntu:

$ export VK_LOADER_LAYERS_ENABLE=*validation

$ export VK_VALIDATION_VALIDATE_SYNC=true

$ export VK_VALIDATION_THREAD_SAFETY=true

$ export VK_LOADER_LAYERS_DISABLE=~implicit~,*validation

On Windows:

C:\> set VK_LOADER_LAYERS_ENABLE=*validation

C:\> set VK_VALIDATION_VALIDATE_SYNC=true

C:\> set VK_VALIDATION_THREAD_SAFETY=true

C:\> set VK_LOADER_LAYERS_DISABLE=~implicit~,*validation

Do not use ~all~ or ~explicit~ options with VK_LOADER_LAYERS_DISABLE because these options disable the validation layers that other applications might attempt to enable programmaticaly.

For more information on Layers configuration please refer to the LunarG, Layers Configuration