Add Interface for AV1 B-frame Support

Author: rhutsAMD

amf/doc/AMF_Video_Encode_AV1_API.md

@@ -597,6 +597,8 @@ This command encodes `400` frames through D3D renderer and creates an output fil
 | TILES_PER_FRAME                        | amf_int64 |
 | LTR_MODE                               | amf_int64 |
 | MAX_NUM_REFRAMES                       | amf_int64 |
+| MAX_CONSECUTIVE_BPICTURES              | amf_int64 |
+| ADAPTIVE_MINIGOP                       | amf_bool  |
 | ENCODING_LATENCY_MODE                  | amf_int64 |
 | FRAMESIZE                              | AMFSize   |
 | ALIGNMENT_MODE                         | amf_int64 |
@@ -727,6 +729,34 @@ Maximum number of reference frames.
 
 ---
 
+**Name:**
+`AMF_VIDEO_ENCODER_AV1_MAX_CONSECUTIVE_BPICTURES`
+
+**Values:**
+`0`...`0` or `127`
+
+**Default Value:**
+`0` or `127`
+
+**Description:**
+Maximum number of consecutive B Pictures. The default value is determined by `AMF_VIDEO_ENCODER_AV1_CAP_BFRAMES`. If `AMF_VIDEO_ENCODER_AV1_CAP_BFRAMES` is true, the default value is 127; otherwise, it is 0.
+
+---
+
+**Name:**
+`AMF_VIDEO_ENCODER_AV1_ADAPTIVE_MINIGOP`
+
+**Values:**
+`true`, `false`
+
+**Default Value:**
+`false`
+
+**Description:**
+Disable/Enable Adaptive MiniGOP, can enable with PA enabled.
+
+---
+
 **Name:**
 `AMF_VIDEO_ENCODER_AV1_ENCODING_LATENCY_MODE`
 
@@ -1187,6 +1217,7 @@ Enable high motion quality boost mode to pre-analyze the motion of the video and
 | CDEF_MODE                              | amd_int64 |
 | INTRA_REFRESH_MODE                     | amf_int64 |
 | INTRAREFRESH_STRIPES                   | amf_int64 |
+| B_PIC_PATTERN                          | amf_int64 |
 
 <p align="center">
 Table 6. Encoder picture-control parameters
@@ -1311,6 +1342,20 @@ Valid only when intra refresh is enabled.
 
 ---
 
+**Name:**
+`AMF_VIDEO_ENCODER_AV1_B_PIC_PATTERN`
+
+**Values:**
+`0`...`127`
+
+**Default Value:**
+`0`
+
+**Description:**
+Sets the number of consecutive B-pictures in a GOP.  BPicturesPattern = `0` indicates that B-pictures are not used.
+
+---
+
 | Name (Prefix “AMF_VIDEO_ENCODER_AV1_”) |Type       |
 | :------------------------------------- | :-------- |
 | QUALITY_PRESET                         | amf_int64 |
@@ -2014,6 +2059,7 @@ Returns reconstructed picture as an `AMFSurface` attached to the output buffer a
 | SUPPORT_TILE_OUTPUT                           | amf_bool  |
 | WIDTH_ALIGNMENT_FACTOR                        | amf_int64 |
 | HEIGHT_ALIGNMENT_FACTOR                       | amf_int64 |
+| BFRAMES                                       | amf_bool  |
 
 <p align="center">
 Table 14. Encoder capabilities exposed in AMFCaps interface
@@ -2174,6 +2220,18 @@ This is used for querying the av1 picture height alignment factor
 
 ---
 
+**Name:**
+`AMF_VIDEO_ENCODER_AV1_CAP_BFRAMES`
+
+**Values:**
+`true`, `false`
+
+
+**Description:**
+This is used for querying av1 b frame support
+
+---
+
 ### Table A-4. Encoder statistics feedback
 
 | Statistic Name (prefix "AMF_VIDEO_ENCODER_AV1") | Type      |

amf/doc/AMF_Video_Encode_AV1_API.pdf

@@ -356,11 +356,17 @@ enum AMF_VIDEO_ENCODER_AV1_OUTPUT_BUFFER_TYPE_ENUM
 #define AMF_VIDEO_ENCODER_AV1_CAP_MAX_NUM_TEMPORAL_LAYERS           L"Av1CapMaxNumTemporalLayers"       // amf_int64; default = N/A; The cap of maximum number of temporal layers
 #define AMF_VIDEO_ENCODER_AV1_CAP_MAX_NUM_LTR_FRAMES                L"Av1CapMaxNumLTRFrames"            // amf_int64; default = N/A; The cap of maximum number of LTR frames. This value is calculated based on current value of AMF_VIDEO_ENCODER_AV1_MAX_NUM_TEMPORAL_LAYERS.
 #define AMF_VIDEO_ENCODER_AV1_CAP_SUPPORT_TILE_OUTPUT               L"AV1SupportTileOutput"             // amf_bool; if tile output is supported
+#define AMF_VIDEO_ENCODER_AV1_CAP_BFRAMES                           L"AV1BFrames"                       // amf_bool; if b frames are supported for AV1
 
 #define AMF_VIDEO_ENCODER_AV1_CAP_SUPPORT_SMART_ACCESS_VIDEO        L"Av1EncoderSupportSmartAccessVideo"    // amf_bool; returns true if system supports SmartAccess Video
 #define AMF_VIDEO_ENCODER_AV1_CAP_WIDTH_ALIGNMENT_FACTOR            L"Av1WidthAlignmentFactor"          // amf_int64; default = 1; The encoder capability for width alignment
 #define AMF_VIDEO_ENCODER_AV1_CAP_HEIGHT_ALIGNMENT_FACTOR           L"Av1HeightAlignmentFactor"         // amf_int64; default = 1; The encoder capability for height alignment
 
 #define AMF_VIDEO_ENCODER_AV1_MULTI_HW_INSTANCE_ENCODE              L"Av1MultiHwInstanceEncode"             // amf_bool; flag to enable AV1 multi VCN encode.
 
+// properties for Picture Management (VCN5 feature)
+#define AMF_VIDEO_ENCODER_AV1_MAX_CONSECUTIVE_BPICTURES             L"Av1MaxConsecutiveBPictures"        // amf_int64; default 0 or 127, determined by AMF_VIDEO_ENCODER_AV1_CAP_BFRAMES. Maximum number of consecutive B frames for B frame encoding
+#define AMF_VIDEO_ENCODER_AV1_B_PIC_PATTERN                         L"Av1BPicturesPattern"               // amf_int64; default 0. Number of B frames for B frame encoding
+#define AMF_VIDEO_ENCODER_AV1_ADAPTIVE_MINIGOP                      L"Av1AdaptiveMiniGop"                // amf_bool; default false. Adaptive miniGOP size for B frame encoding
+
 #endif //#ifndef AMF_VideoEncoderAV1_h