From 20a2d92d7aeab01006f3ed0a5893c7e6b2052057 Mon Sep 17 00:00:00 2001
From: "Marc A. Valle" Hardware acceleration goes through the Linux* VA-API infrastructure with OpenGL Extension to the X Window System as default acceleration access point. Hardware acceleration goes through the Linux* VA-API infrastructure with OpenGL Extension to the X Window System as default acceleration access point. Hardware acceleration goes through the Linux* VA-API infrastructure with X11 as default acceleration access point. Hardware acceleration goes through the Linux* VA-API infrastructure with X11 as default acceleration access point. Vulkan 2D image (VkImage). Values: AI based frame interpolation is disabled. The library duplicates the frame if AI frame interpolation is disabled. Default AI based frame interpolation mode. The library selects the most appropriate AI based frame interpolation mode. Initialize the SDK in (decode + vpp) mode. The logic of this function is similar to MFXVideoDECODE_Init, but application has to provide array of pointers to mfxVideoChannelParam and num_channel_param - number of channels. Application is responsible for memory allocation for parameters and for each channel it should specify channel IDs: mfxVideoChannelParam::mfxFrameInfo::ChannelId. ChannelId should be unique value within one session. ChannelID equals to the 0 is reserved for the original decoded frame. The application can attachmfxAccelerationMode
+
diff --git a/latest/API_ref/VPL_enums.html b/latest/API_ref/VPL_enums.html
index 562f6c75..9cff0f59 100644
--- a/latest/API_ref/VPL_enums.html
+++ b/latest/API_ref/VPL_enums.html
@@ -490,6 +490,7 @@
Contents
mfxSurfaceType
+
mfxAISuperResolutionMode
+
mfxAIFrameInterpolationMode#
+
+
+
+
+
+
+
+
+mfxQualityInfoMode#
@@ -5722,6 +5750,7 @@ AlphaChannelModemfxSurfaceType
MFXVideoDECODE_VPP_In
Initialize the SDK in (decode + vpp) mode. The logic of this function is similar to MFXVideoDECODE_Init, but application has to provide array of pointers to mfxVideoChannelParam and num_channel_param - number of channels. Application is responsible for memory allocation for mfxVideoChannelParam parameters and for each channel it should specify channel IDs: mfxVideoChannelParam::mfxFrameInfo::ChannelId. ChannelId should be unique value within one session. ChannelID equals to the 0 is reserved for the original decoded frame. The application can attach mfxExtInCrops to mfxVideoChannelParam::ExtParam to annotate input video frame if it wants to enable letterboxing operation.
This function is available since API version 2.1.
Returns actual VPP parameters for selected channel which should be specified by application through
-mfxVideoChannelParam::mfxFrameInfo::ChannelId.
- +Returns actual VPP parameters for selected channel which should be specified by application through mfxVideoChannelParam::mfxFrameInfo::ChannelId.
This function is available since API version 2.1.
Returns information about current hardware platform in the Legacy mode.
-This function is available since API version 1.19.
++Notes: Deprecated mfxPlatform::CodeName will be filled with MFX_PLATFORM_MAXIMUM for future new platforms.
This function is available since API version 1.19.
View identifiers of the view components for inter-view prediction in the initial reference picture list RefPicList0 for non-anchor view components.
View identifiers of the view components for inter-view prediction in the initial reference picture list RefPicList0 for non-anchor view components.
+distortion measure, approximation to SAD.
-Will deviate significantly (pre, post reconstruction) and due to variation in algorithm.
- +distortion measure, approximation to SAD. Will deviate significantly (pre, post reconstruction) and due to variation in algorithm.
Distortion measure, approximation to SAD.
-Deviate significantly (pre, post reconstruction) and due to variation in algorithm.
- +Distortion measure, approximation to SAD. Deviate significantly (pre, post reconstruction) and due to variation in algorithm.
distortion measure, approximation to SAD.
-Will deviate significantly (pre, post reconstruction) and due to variation in algorithm.
- +distortion measure, approximation to SAD. Will deviate significantly (pre, post reconstruction) and due to variation in algorithm.
+average frame QP, may have fractional part in case of MBQP.
Public Members
+ + + + + + + + + + +Optional extension buffer, which can be attached to mfxSurfaceHeader::ExtParam (second parameter of mfxFrameSurfaceInterface::Export) in order to pass Vulkan parameters during mfxFrameSurface1 exporting to Vulkan surface. If buffer is not provided all resources will be created by oneAPI Video Processing Library (oneVPL) RT internally.
+Public Members
+Extension buffer header. Header.BufferId must be equal to MFX_EXTBUFF_EXPORT_SHARING_DESC_VULKAN.
+A hint structure that configures AI based frame interpolation VPP filter. AI powered frame interpolation feature can reconstruct one or more intermediate frames between two consecutive frames by AI method. On some platforms this filter is not supported. To query its support, the application should use the same approach that it uses to configure VPP filters: Attaching the mfxExtVPPAIFrameInterpolation structure directly to the mfxVideoParam structure and setting the frame rate of input and output (FrameRateExtN and FrameRateExtD), then calling the Query API function. If the filter is supported, the Query function returns a MFX_ERR_NONE status; otherwise, the function returns MFX_ERR_UNSUPPORTED. As a new method of frame interpolation, the application can attach mfxExtVPPAIFrameInterpolation to mfxVideoParam during initialization for frame interpolation, or attach both mfxExtVPPAIFrameInterpolation and mfxExtVPPFrameRateConversion to mfxVideoParam and use which mfxExtVPPAIFrameInterpolation is regarded as a new algorithm of mfxExtVPPFrameRateConversion (MFX_FRCALGM_AI_FRAME_INTERPOLATION). The applications should follow video processing procedures and call the API mfxStatus MFXVideoVPP_RunFrameVPPAsync(Session, Input, Output, Auxdata, Syncp) to process the frames one by one. The below is detailed explanation of video processing procedures in this AI frame interpolation case. If the application does not follow the below input/output sequence, the application could get the unexpected output and get an error return value. Input: Frame0 Frame1 Frame2 Frame3 FrameN Output: Frame0 Frame0.5 Frame1 Frame1.5 Frame2 Frame2.5 Frame3 FrameX.5 FrameN #0 API call: Input Frame0, Output Frame0, Return MFX_ERR_NONE. #1 API call: Input Frame1, Output Frame0.5 and Return MFX_ERR_MORE_SURFACE. #2 API call: Input Frame1, Output Frame1, Return MFX_ERR_NONE. #3 API call: Input Frame2, Output Frame1.5, Return MFX_ERR_MORE_SURFACE. #4 API call: Input Frame2, Output Frame2, Return MFX_ERR_NONE.
+Public Members
+Extension buffer header. Header.BufferId must be equal to MFX_EXTBUFF_VPP_AI_FRAME_INTERPOLATION.
+Indicates frame interpolation mode. The mfxAIFrameInterpolationMode enumerator.
+2.12
2.12
2.12
2.12
New in this release:
+Experimental API: Added new structures and enumerated types for importing and exporting surfaces:
+++
Experimental API: introduced mfxExtVPPAIFrameInterpolation
and mfxAIFrameInterpolationMode
for AI powered frame interpolation.
Added code names for the platforms: Meteor Lake, Arrow Lake and Lunar Lake:
++++
+- +
MFX_DEPRECATED_ENUM_FIELD_INSIDE(MFX_PLATFORM_METEORLAKE)
- +
MFX_DEPRECATED_ENUM_FIELD_INSIDE(MFX_PLATFORM_LUNARLAKE)
- +
MFX_DEPRECATED_ENUM_FIELD_INSIDE(MFX_PLATFORM_ARROWLAKE)
Added code name for future platforms:
++++
+- +
MFX_DEPRECATED_ENUM_FIELD_INSIDE(MFX_PLATFORM_MAXIMUM)
Updated description for the function MFXVideoCORE_QueryPlatform()
.
New in this release:
Experimental API: introduced mfxExtAV1ScreenContentTools
to support screen content tools setting for encoder.
New in this release:
Experimental API: introduced MFX_CORRUPTION_HW_RESET
to support media reset info report.
New in this release:
Deprecated mfxExtCodingOption2::BitrateLimit
.
New in this release:
Introduced MFX_FOURCC_ABGR16F
FourCC for 16-bit float point (per channel) 4:4:4 ABGR format.
New in this release:
mfxExtVppAuxData::RepeatedFrame
flag is actual again and returned back from deprecation state.
New in this release:
New development practice to treat some new API features as experimental was introduced. @@ -616,7 +650,7 @@
New in this release:
Added mfxMediaAdapterType to capability reporting.
Added ability to retrieve path to the shared library with the implementation.
Added 3DLUT (Three-Dimensional Look Up Table) filter in VPP.
Encoding in Hyper mode.
New product names for platforms:
@@ -714,6 +748,7 @@