Add SmartAccess Video documentation

Author: rhutsAMD

amf/doc/AMF_Video_Decode_API.md

@@ -109,20 +109,24 @@ Table 1. AMF components IDs depending on codec selection
 
 AMF Decoder can be configured using the following properties that need to be set before initialization:
 
-| Name                                         | Type         |
-| :------------------------------------------- | :----------- |
-| AMF_VIDEO_DECODER_SURFACE_COPY               | amf_bool     |
-| AMF_VIDEO_DECODER_EXTRADATA                  | AMFBufferPtr |
-| AMF_VIDEO_DECODER_FRAME_RATE                 | amf_double   |
-| AMF_TIMESTAMP_MODE                           | amf_int64    |
-| AMF_VIDEO_DECODER_ADAPTIVE_RESOLUTION_CHANGE | amf_bool     |
-| AMF_VIDEO_DECODER_REORDER_MODE               | amf_int64    |
-| AMF_VIDEO_DECODER_DPB_SIZE                   | amf_int64    |
+| Name                                               | Type         |
+| :------------------------------------------------- | :----------- |
+| AMF_VIDEO_DECODER_SURFACE_COPY                     | amf_bool     |
+| AMF_VIDEO_DECODER_EXTRADATA                        | AMFBufferPtr |
+| AMF_VIDEO_DECODER_FRAME_RATE                       | amf_double   |
+| AMF_TIMESTAMP_MODE                                 | amf_int64    |
+| AMF_VIDEO_DECODER_ADAPTIVE_RESOLUTION_CHANGE       | amf_bool     |
+| AMF_VIDEO_DECODER_REORDER_MODE                     | amf_int64    |
+| AMF_VIDEO_DECODER_DPB_SIZE                         | amf_int64    |
+| AMF_VIDEO_DECODER_ENABLE_SMART_ACCESS_VIDEO        | amf_bool     |
+| AMF_VIDEO_DECODER_SKIP_TRANSFER_SMART_ACCESS_VIDEO | amf_bool     |
 
 <p align="center">
-Table 2. AMF Video Converter parameters which configure input and output
+Table 2. AMF Video Decoder pre-initialization properties
 </p>
 
+On supported APU + GPU systems, there is an opportunity to use SmartAccess Video. SmartAccess Video - an optimization logic which enables the parallelization of encode and decode streams across multiple Video Codec Engine (VCN) hardware instances – empowers apps to process streams faster through seamless job distribution across available hardware. With a simple enablement of the encoder and decoder control flags, the SmartAccess Video logic will optimally use hardware resources to benefit media apps. Follow the `SMART_ACCESS_VIDEO` tag in the documentation to search for the property flags to set. On systems without SmartAccess Video support, the `SMART_ACCESS_VIDEO` properties have no effect.
+
 ---
 
 **Name:**
@@ -228,6 +232,34 @@ The minimum required number of surfaces for frame reordering.
 
 ---
 
+**Name:**
+`AMF_VIDEO_DECODER_ENABLE_SMART_ACCESS_VIDEO`
+
+**Values:**
+`true`, `false`
+
+**Default Value:**
+`false`
+
+**Description:**
+When set to `true`, enables the SmartAccess Video feature, which optimally allocates the decoding task on supported APU/GPU pairings.
+
+---
+
+**Name:**
+`AMF_VIDEO_DECODER_SKIP_TRANSFER_SMART_ACCESS_VIDEO`
+
+**Values:**
+`true`, `false`
+
+**Default Value:**
+`false`
+
+**Description:**
+When set to `false` and the SmartAccess Video feature is enabled, decoded frames are transferred back to the initial APU/GPU. When this is set to `true`, surfaces remain on the decoder device, which may not be the same as the initial APU/GPU.
+
+---
+
 The following read-only properties can be read to obtain information about the current stream, as well as decoder capabilities:
 
 | Name                                 | Type      |
@@ -237,7 +269,7 @@ The following read-only properties can be read to obtain information about the c
 | AMF_VIDEO_DECODER_CAP_NUM_OF_STREAMS | amf_int64 |
 
 <p align="center">
-Table 2. AMF Video Converter read-only properties
+Table 3. AMF Video Decoder read-only properties
 </p>
 
 ---

amf/doc/AMF_Video_Decode_API.pdf

@@ -52,17 +52,18 @@ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLI
    - [2.2.6 Encoder Statistics Feedback](#226-encoder-statistics-feedback)
    - [2.2.7 Picture Transfer Mode](#227-picture-transfer-mode)
    - [2.2.8 LTR Properties](#228-ltr-properties)
+   - [2.2.9 SmartAccess Video](#229-smartaccess-video)
 3. [Sample Applications](#3-sample-applications)
    - [3.1 List of Parameters](#31-list-of-parameters)
    - [3.2 Command line example](#32-command-line-example)
       - [3.2.1 Transcoding application (TranscodingHW.exe)](#321-transcoding-application-transcodinghwexe)
-      - [3.2.2	D3D application (VCEEncoderD3D.exe)](#322d3d-application-vceencoderd3dexe)
+      - [3.2.2	D3D application (VCEEncoderD3D.exe)](#322-d3d-application-vceencoderd3dexe)
 4. [Annex A: Encoding & frame parameters description](#4-annex-a-encoding--frame-parameters-description)
-   - [Table A-1. Encoder configuration parameters](#table-a---1-encoder-configuration-parameters)
-   - [Table A-2. Input frame and encoded data parameters](#table-a---2-input-frame-and-encoded-data-parameters)
+   - [Table A-1. Encoder configuration parameters](#table-a-1-encoder-configuration-parameters)
+   - [Table A-2. Input frame and encoded data parameters](#table-a-2-input-frame-and-encoded-data-parameters)
    - [Table A-3. Default values of parameters](#table-a---3-default-values-of-parameters)
-   - [Table A-4. Encoder statistics feedback](#table-a---4-encoder-statistics-feedback)
-   - [Table A-5. Encoder PSNR/SSIM feedback](#table-a---5-encoder-psnr-/-ssim-feedback)
+   - [Table A-4. Encoder statistics feedback](#table-a-4-encoder-statistics-feedback)
+   - [Table A-5. Encoder PSNR/SSIM feedback](#table-a-5-encoder-psnrssim-feedback)
 
 
 ## 1 Introduction
@@ -217,6 +218,10 @@ When we encode a key frame or switch frame, all save LTR slots will be cleared.
 
 Referring to a LTR frame not exiting in LTR slot will generate an Intra only frame.
 
+#### 2.2.9 SmartAccess Video
+
+On supported APU + GPU systems, there is an opportunity to use SmartAccess Video. SmartAccess Video - an optimization logic which enables the parallelization of encode and decode streams across multiple Video Codec Engine (VCN) hardware instances – empowers apps to process streams faster through seamless job distribution across available hardware. With a simple enablement of the encoder and decoder control flags, the SmartAccess Video logic will optimally use hardware resources to benefit media apps. Follow the `SMART_ACCESS_VIDEO` tag in the documentation to search for the property flags to set. On systems without SmartAccess Video support, the `SMART_ACCESS_VIDEO` properties have no effect.
+
 ## 3 Sample Applications
 
 The AMF Encoder Sample application show how to setup and use the AMF Video Encoder VCE-AVC Component to encode video frames that are loaded from disk or rendered by the DirectX 3D engine.
@@ -611,6 +616,7 @@ This command encodes `400` frames through D3D renderer and creates an output fil
 | PRE_ANALYSIS_ENABLE                | amf_bool  |
 | COLOR_BIT_DEPTH                    | amf_int64 |
 | MAX_NUM_TEMPORAL_LAYERS            | amf_int64 |
+| ENABLE_SMART_ACCESS_VIDEO          | amf_bool  |
 
 
 <p align="center">
@@ -832,6 +838,20 @@ Sets the maximum number of temporal layers. It shall not be exceeded by the numb
 
 ---
 
+**Name:**
+`AMF_VIDEO_ENCODER_ENABLE_SMART_ACCESS_VIDEO`
+
+**Values:**
+`true`, `false`
+
+**Default Value:**
+`false`
+
+**Description:**
+When set to `true`, enables the SmartAccess Video feature, which optimally allocates the encoding task on supported APU/GPU pairings.
+
+---
+
 | Name (prefix "AMF_VIDEO_ENCODER_") | Type      |
 | :--------------------------------- | :-------- |
 | INPUT_COLOR_PROFILE                | amf_int64 |