Skip to content

Commit

Permalink
ADLX SDK v1.3
Browse files Browse the repository at this point in the history
  • Loading branch information
ericjunwei committed Aug 28, 2024
1 parent d361234 commit e874832
Show file tree
Hide file tree
Showing 1,915 changed files with 21,597 additions and 11,369 deletions.
2 changes: 1 addition & 1 deletion SDK/ADLXHelper/Windows/C/ADLXHelper.c
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
//
// Copyright (c) 2021 - 2023 Advanced Micro Devices, Inc. All rights reserved.
// Copyright (c) 2021 - 2024 Advanced Micro Devices, Inc. All rights reserved.
//
//-------------------------------------------------------------------------------------------------
#include "ADLXHelper.h"
Expand Down
2 changes: 1 addition & 1 deletion SDK/ADLXHelper/Windows/C/ADLXHelper.h
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
//
// Copyright (c) 2021 - 2023 Advanced Micro Devices, Inc. All rights reserved.
// Copyright (c) 2021 - 2024 Advanced Micro Devices, Inc. All rights reserved.
//
//-------------------------------------------------------------------------------------------------

Expand Down
2 changes: 1 addition & 1 deletion SDK/ADLXHelper/Windows/Cpp/ADLXHelper.cpp
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
//
// Copyright (c) 2021 - 2023 Advanced Micro Devices, Inc. All rights reserved.
// Copyright (c) 2021 - 2024 Advanced Micro Devices, Inc. All rights reserved.
//
//-------------------------------------------------------------------------------------------------

Expand Down
2 changes: 1 addition & 1 deletion SDK/ADLXHelper/Windows/Cpp/ADLXHelper.h
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
//
// Copyright (c) 2021 - 2023 Advanced Micro Devices, Inc. All rights reserved.
// Copyright (c) 2021 - 2024 Advanced Micro Devices, Inc. All rights reserved.
//
//-------------------------------------------------------------------------------------------------

Expand Down
2 changes: 1 addition & 1 deletion SDK/Include/ADLX.h
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
//
// Copyright (c) 2021 - 2023 Advanced Micro Devices, Inc. All rights reserved.
// Copyright (c) 2021 - 2024 Advanced Micro Devices, Inc. All rights reserved.
//
//-------------------------------------------------------------------------------------------------

Expand Down
25 changes: 22 additions & 3 deletions SDK/Include/ADLXDefines.h
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
//
// Copyright (c) 2021 - 2023 Advanced Micro Devices, Inc. All rights reserved.
// Copyright (c) 2021 - 2024 Advanced Micro Devices, Inc. All rights reserved.
//
//-------------------------------------------------------------------------------------------------

Expand Down Expand Up @@ -290,7 +290,9 @@ typedef enum
ADLX_ORPHAN_OBJECTS, /**< @ENG_START_DOX This result indicates that ADLX was terminated with outstanding ADLX objects. Any interface obtained from ADLX points to invalid memory and calls in their methods will result in unexpected behavior. @ENG_END_DOX */
ADLX_NOT_SUPPORTED, /**< @ENG_START_DOX This result indicates that the asked feature is not supported. @ENG_END_DOX */
ADLX_PENDING_OPERATION, /**< @ENG_START_DOX This result indicates a failure due to an operation currently in progress. @ENG_END_DOX */
ADLX_GPU_INACTIVE /**< @ENG_START_DOX This result indicates that the GPU is inactive. @ENG_END_DOX */
ADLX_GPU_INACTIVE, /**< @ENG_START_DOX This result indicates that the GPU is inactive. @ENG_END_DOX */
ADLX_GPU_IN_USE, /**< @ENG_START_DOX This result indicates that the GPU is in used by applications. @ENG_END_DOX */
ADLX_TIMEOUT_OPERATION /**< @ENG_START_DOX This result indicates that the operation is timeout. @ENG_END_DOX */
} ADLX_RESULT;

/**
Expand Down Expand Up @@ -851,7 +853,7 @@ typedef enum
* @enum ADLX_MEMORYTIMING_DESCRIPTION
* @ingroup enumerations
* @ENG_START_DOX
* @brief Indicates the priority of the log entry.
* @brief Indicates the memory timing description.
* @ENG_END_DOX
*/
typedef enum
Expand Down Expand Up @@ -976,6 +978,23 @@ typedef enum
} ADLX_MGPU_MODE;
#pragma endregion ADLX_MGPU_MODE

#pragma region ADLX_APP_GPU_DEPENDENCY
/**
* @enum ADLX_APP_GPU_DEPENDENCY
* @ingroup enumerations
* @ENG_START_DOX
* @brief Indicates the type of dependence of an application on the GPU on which it runs.
* @ENG_END_DOX
*/
typedef enum
{
APP_GPU_UNKNOWN = 0, /**< @ENG_START_DOX It is unknown if the application is bound to the GPU on which it runs. The application might behave unexpectedly if the GPU is powered off or disabled. @ENG_END_DOX */
APP_GPU_BOUND, /**< @ENG_START_DOX The application is bound to the GPU on which it runs and will behave unexpectedly if the GPU is powered off or disabled. @ENG_END_DOX */
APP_GPU_NOT_BOUND, /**< @ENG_START_DOX The application is not bound to this GPU on which it runs and will continue to run properly if the GPU is powered off or disabled. @ENG_END_DOX */
} ADLX_APP_GPU_DEPENDENCY;

#pragma endregion ADLX_APP_GPU_DEPENDENCY

#pragma endregion ADLX data types

//-------------------------------------------------------------------------------------------------
Expand Down
2 changes: 1 addition & 1 deletion SDK/Include/ADLXStructures.h
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
//
// Copyright (c) 2021 - 2023 Advanced Micro Devices, Inc. All rights reserved.
// Copyright (c) 2021 - 2024 Advanced Micro Devices, Inc. All rights reserved.
//
//-------------------------------------------------------------------------------------------------

Expand Down
6 changes: 3 additions & 3 deletions SDK/Include/ADLXVersion.h
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
//
// Copyright (c) 2021 - 2023 Advanced Micro Devices, Inc. All rights reserved.
// Copyright (c) 2021 - 2024 Advanced Micro Devices, Inc. All rights reserved.
//
//-------------------------------------------------------------------------------------------------

Expand All @@ -8,9 +8,9 @@
#pragma once

#define ADLX_VER_MAJOR 1
#define ADLX_VER_MINOR 2
#define ADLX_VER_MINOR 3
#define ADLX_VER_RELEASE 0
#define ADLX_VER_BUILD_NUM 72
#define ADLX_VER_BUILD_NUM 85

#define STRING(a) #a
#define STRING_EXPAND(a) STRING(a)
Expand Down
90 changes: 66 additions & 24 deletions SDK/Include/I3DSettings.h
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
//
// Copyright (c) 2021 - 2023 Advanced Micro Devices, Inc. All rights reserved.
// Copyright (c) 2021 - 2024 Advanced Micro Devices, Inc. All rights reserved.
//
//-------------------------------------------------------------------------------------------------

Expand Down Expand Up @@ -70,7 +70,11 @@ namespace adlx
* @addinfo
* @ENG_START_DOX
* Radeon Anti-Lag helps reduce input lag in GPU-limited cases by controlling the pace of the CPU work to ensure it doesn't get too far ahead of the GPU. <br>
* __Note:__ @ref DOX_IADLX3DChill "AMD Radeon Chill", and AMD Radeon Anti-Lag features cannot be enabled simultaneously. If AMD Radeon Chill is enabled, AMD Radeon Anti-Lag is automatically disabled.
*
* @depifc
* AMD Radeon Anti-Lag cannot be simultaneously enabled with @ref DOX_IADLX3DChill "AMD Radeon Chill".<br>
*
* When a mutually exclusive feature is enabled, AMD Radeon Anti-Lag is automatically disabled.
* @ENG_END_DOX
*
*@copydoc IADLX3DAntiLag_REQ_TABLE
Expand Down Expand Up @@ -98,7 +102,11 @@ namespace adlx
* @addinfo
* @ENG_START_DOX
* Radeon Anti-Lag helps reduce input lag in GPU-limited cases by controlling the pace of the CPU work to ensure it doesn't get too far ahead of the GPU. <br>
* __Note:__ @ref DOX_IADLX3DChill "AMD Radeon Chill", and AMD Radeon Anti-Lag features cannot be enabled simultaneously. If AMD Radeon Anti-Lag is enabled, AMD Radeon Chill is automatically disabled. However, the configuration of the disabled feature is preserved.
*
* @depifc
* AMD Radeon Anti-Lag cannot be simultaneously enabled with @ref DOX_IADLX3DChill "AMD Radeon Chill".<br>
*
* When AMD Radeon Anti-Lag is enabled, the mutually exclusive features are automatically disabled. If a mutually exclusive feature is re-enabled, its previous configuration settings are restored.
* @ENG_END_DOX
*
*@copydoc IADLX3DAntiLag_REQ_TABLE
Expand Down Expand Up @@ -282,10 +290,13 @@ namespace adlx
* @addinfo
* @ENG_START_DOX
* AMD Radeon Chill conserves GPU power and reduces heat by adjusting the FPS based on the intensity of in-game movement.<br>
* AMD Radeon Chill cannot be enabled simultaneously with @ref DOX_IADLX3DBoost "AMD Radeon Boost", @ref DOX_IADLX3DAntiLag "AMD Radeon Anti-Lag", and @ref DOX_IADLX3DAntiLag1 "AMD Radeon Anti-Lag Next".<br>
* On some AMD GPUs, AMD Radeon Chill cannot be enabled simultaneously with @ref DOX_IADLX3DRadeonSuperResolution "Radeon Super Resolution".<br>
* When a mutually exclusive feature is enabled, AMD Radeon Chill is automatically disabled.<br>
* __Note:__ If AMD Radeon Chill is later re-enabled, its previous configuration settings will be restored.
*
* @depifc
* AMD Radeon Chill cannot be simultaneously enabled with @ref DOX_IADLX3DBoost "AMD Radeon Boost", @ref DOX_IADLX3DAntiLag "AMD Radeon Anti-Lag" @ref DOX_IADLX3DAntiLag1 "AMD Radeon Anti-Lag Next", or @ref DOX_IADLX3DAMDFluidMotionFrames "AMD Fluid Motion Frames".<br>
*
* On some AMD GPUs, AMD Radeon Chill cannot be simultaneously enabled with @ref DOX_IADLX3DRadeonSuperResolution "Radeon Super Resolution".<br>
*
* If a mutually exclusive feature is enabled, AMD Radeon Chill is automatically disabled. When AMD Radeon Chill is re-enabled, its previous configuration settings are restored.<br>
* @ENG_END_DOX
*
*@copydoc IADLX3DChill_REQ_TABLE
Expand Down Expand Up @@ -405,10 +416,13 @@ namespace adlx
* @addinfo
* @ENG_START_DOX
* AMD Radeon Chill conserves GPU power and reduces heat by adjusting the FPS based on the intensity of in-game movement.<br>
* AMD Radeon Chill cannot be enabled simultaneously with @ref DOX_IADLX3DBoost "AMD Radeon Boost", @ref DOX_IADLX3DAntiLag "AMD Radeon Anti-Lag", and @ref DOX_IADLX3DAntiLag1 "AMD Radeon Anti-Lag Next".<br>
* On some AMD GPUs, AMD Radeon Chill cannot be enabled simultaneously with @ref DOX_IADLX3DRadeonSuperResolution "Radeon Super Resolution".<br>
* When AMD Radeon Chill is enabled, the mutually exclusive features are automatically disabled.<br>
* __Note:__ If the disabled feature is later re-enabled, its previous configuration settings will be restored.
*
* @depifc
* AMD Radeon Chill cannot be simultaneously enabled with @ref DOX_IADLX3DBoost "AMD Radeon Boost", @ref DOX_IADLX3DAntiLag "AMD Radeon Anti-Lag" @ref DOX_IADLX3DAntiLag1 "AMD Radeon Anti-Lag Next", and @ref DOX_IADLX3DAMDFluidMotionFrames "AMD Fluid Motion Frames".<br>
*
* On some AMD GPUs, AMD Radeon Chill cannot simultaneously enabled with @ref DOX_IADLX3DRadeonSuperResolution "Radeon Super Resolution".<br>
*
* When AMD Radeon Chill is enabled, the mutually exclusive features are automatically disabled. If a mutually exclusive feature is re-enabled, its previous configuration settings are restored.<br>
* @ENG_END_DOX
*
*@copydoc IADLX3DChill_REQ_TABLE
Expand Down Expand Up @@ -560,9 +574,15 @@ namespace adlx
* Refer to @ref ADLX_RESULT for success codes and error codes.<br> @ENG_END_DOX
*
* @addinfo
*@ENG_START_DOX AMD Radeon Boost dynamically reduces resolution during motion to improve performance with little perceptible impact on image quality. Only works in supported games.<br>
* __Note:__ @ref DOX_IADLX3DChill "AMD Radeon Chill", AMD Radeon Boost features cannot be enabled simultaneously. If AMD Radeon Chill is enabled, AMD Radeon Boost is automatically disabled.<br>
* On some AMD GPUs, AMD Radeon Boost and @ref DOX_IADLX3DRadeonSuperResolution "Radeon Super Resolution" cannot be enabled simultaneously. If Radeon Super Resolution is enabled, AMD Radeon Boost is automatically disabled.
*@ENG_START_DOX AMD Radeon Boost dynamically reduces resolution during motion to improve performance with little perceptible impact on image quality.<br>
* __Note:__ Only works in supported games.<br>
*
* @depifc
* AMD Radeon Boost cannot be simultaneously enabled with @ref DOX_IADLX3DChill "AMD Radeon Chill".<br>
*
* On some AMD GPUs, AMD Radeon Boost cannot be simultaneously enabled with @ref DOX_IADLX3DRadeonSuperResolution "Radeon Super Resolution".<br>
*
* When a mutually exclusive feature is enabled, AMD Radeon Boost is automatically disabled. If AMD Radeon Boost is later re-enabled, its previous configuration settings will be restored.
* @ENG_END_DOX
*
*@copydoc IADLX3DBoost_REQ_TABLE
Expand Down Expand Up @@ -645,9 +665,15 @@ namespace adlx
* Refer to @ref ADLX_RESULT for success codes and error codes.<br> @ENG_END_DOX
*
* @addinfo
*@ENG_START_DOX AMD Radeon Boost dynamically reduces resolution during motion to improve performance with little perceptible impact on image quality. Only works in supported games. <br>
* __Note:__ @ref DOX_IADLX3DChill "AMD Radeon Chill", AMD Radeon Boost features cannot be enabled simultaneously. If AMD Radeon Boost is enabled, AMD Radeon Chill are automatically disabled. However, the configuration of the disabled feature is preserved.<br>
* On some AMD GPUs, AMD Radeon Boost and @ref DOX_IADLX3DRadeonSuperResolution "Radeon Super Resolution" cannot be enabled simultaneously. If AMD Radeon Boost is enabled, Radeon Super Resolution is automatically disabled.
*@ENG_START_DOX AMD Radeon Boost dynamically reduces resolution during motion to improve performance with little perceptible impact on image quality.<br>
* __Note:__ Only works in supported games.<br>
*
* @depifc
* AMD Radeon Boost cannot be simultaneously enabled with @ref DOX_IADLX3DChill "AMD Radeon Chill".<br>
*
* On some AMD GPUs, AMD Radeon Boost cannot be simultaneously enabled with @ref DOX_IADLX3DRadeonSuperResolution "Radeon Super Resolution".<br>
*
* When AMD Radeon Boost is enabled, the mutually exclusive features are automatically disabled. If a mutually exclusive feature is re-enabled, its previous configuration settings are restored.
* @ENG_END_DOX
*
*@copydoc IADLX3DBoost_REQ_TABLE
Expand Down Expand Up @@ -766,7 +792,12 @@ namespace adlx
*
* @addinfo
*@ENG_START_DOX AMD Radeon Image Sharpening restores clarity softened by other effects to in-game visuals, and select productivity and media applications.<br>
* __Note:__ On some AMD GPUs, AMD Radeon Image Sharpening and @ref DOX_IADLX3DRadeonSuperResolution "Radeon Super Resolution" cannot be enabled simultaneously. If Radeon Super Resolution is enabled, AMD Radeon Image Sharpening is automatically disabled.
* @depifc
* On some AMD GPUs, AMD Radeon 3D Image Sharpening is mutually exclusive with @ref DOX_IADLX3DRadeonSuperResolution "Radeon Super Resolution".<br>
*
* When a mutually exclusive feature is enabled, AMD Radeon 3D Image Sharpening is automatically disabled. If AMD Radeon 3D Image Sharpening is later re-enabled, its previous configuration settings will be restored.<br>
* @ENG_END_DOX
*
*@copydoc IADLX3DImageSharpening_REQ_TABLE
Expand Down Expand Up @@ -848,7 +879,11 @@ namespace adlx
*
* @addinfo
*@ENG_START_DOX AMD Radeon Image Sharpening restores clarity softened by other effects to in-game visuals, and select productivity and media applications.<br>
* __Note:__ On some AMD GPUs, AMD Radeon Image Sharpening and @ref DOX_IADLX3DRadeonSuperResolution "Radeon Super Resolution" cannot be enabled simultaneously. If Radeon Image Sharpening is enabled, AMD Radeon Super Resolution is automatically disabled.
*
* @depifc
* On some AMD GPUs, AMD Radeon 3D Image Sharpening is mutually exclusive with @ref DOX_IADLX3DRadeonSuperResolution "Radeon Super Resolution".<br>
*
* When AMD Radeon 3D Image Sharpening is enabled, the mutually exclusive features are automatically disabled. If a mutually exclusive feature is re-enabled, its previous configuration settings are restored.<br>
* @ENG_END_DOX
*
*@copydoc IADLX3DImageSharpening_REQ_TABLE
Expand Down Expand Up @@ -2149,9 +2184,12 @@ namespace adlx
* @ENG_START_DOX
* Radeon Super Resolution is an upscaling feature for faster game frame rates. <br>
*
* __Note:__ @ref DOX_IADLXDisplayGPUScaling "GPU scaling" is a requirement for Radeon Super Resolution. When Radeon Super Resolution is enabled, GPU scaling is automatically enabled. If GPU scaling is disabled while Radeon Super Resolution is enabled, Radeon Super Resolution is automatically disabled.
* @depifc
* Radeon Super Resolution requires @ref DOX_IADLXDisplayGPUScaling "GPU scaling". When Radeon Super Resolution is enabled, GPU scaling is automatically enabled. If GPU scaling is disabled while Radeon Super Resolution is enabled, Radeon Super Resolution is automatically disabled.<br>
*
* On some AMD GPUs, Radeon Super Resolution is mutually exclusive with @ref DOX_IADLX3DChill "AMD Radeon Chill", @ref DOX_IADLX3DBoost "AMD Radeon Boost", @ref DOX_IADLX3DImageSharpening "AMD Radeon Image Sharpening", @ref DOX_IADLXDisplayIntegerScaling "Integer Display Scaling", or @ref DOX_IADLXDisplayScalingMode_GetMode "Center Scaling".<br>
*
* On some AMD GPUs, Radeon Super Resolution is mutually exclusive with @ref DOX_IADLX3DChill "AMD Radeon Chill", @ref DOX_IADLX3DBoost "AMD Radeon Boost", @ref DOX_IADLX3DImageSharpening "AMD Radeon Image Sharpening", @ref DOX_IADLXDisplayIntegerScaling "Integer Display Scaling", and @ref DOX_IADLXDisplayScalingMode_GetMode "Center Scaling". When Radeon Super Resolution is enabled, the mutually exclusive features are automatically disabled.<br>
* When a mutually exclusive feature is enabled, Radeon Super Resolution is automatically disabled. If Radeon Super Resolution is later re-enabled, its previous configuration settings will be restored.<br>
* @ENG_END_DOX
*
*@copydoc IADLX3DRadeonSuperResolution_REQ_TABLE
Expand Down Expand Up @@ -2180,10 +2218,14 @@ namespace adlx
* @ENG_START_DOX
* Radeon Super Resolution is an upscaling feature for faster game frame rates. <br>
*
* __Note:__ @ref DOX_IADLXDisplayGPUScaling "GPU scaling" is a requirement for Radeon Super Resolution. When Radeon Super Resolution is enabled, GPU scaling is automatically enabled. If GPU scaling is disabled while Radeon Super Resolution is enabled, Radeon Super Resolution is automatically disabled.
* @depifc
* Radeon Super Resolution requires @ref DOX_IADLXDisplayGPUScaling "GPU scaling". When Radeon Super Resolution is enabled, GPU scaling is automatically enabled. If GPU scaling is disabled while Radeon Super Resolution is enabled, Radeon Super Resolution is automatically disabled.<br>
*
* On some AMD GPUs, Radeon Super Resolution is mutually exclusive with @ref DOX_IADLX3DChill "AMD Radeon Chill", @ref DOX_IADLX3DBoost "AMD Radeon Boost", @ref DOX_IADLX3DImageSharpening "AMD Radeon Image Sharpening", @ref DOX_IADLXDisplayIntegerScaling "Integer Display Scaling", and @ref DOX_IADLXDisplayScalingMode_GetMode "Center Scaling". When Radeon Super Resolution is enabled, the mutually exclusive features are automatically disabled.<br>
* On some AMD GPUs, Radeon Super Resolution is mutually exclusive with @ref DOX_IADLX3DChill "AMD Radeon Chill", @ref DOX_IADLX3DBoost "AMD Radeon Boost", @ref DOX_IADLX3DImageSharpening "AMD Radeon Image Sharpening", @ref DOX_IADLXDisplayIntegerScaling "Integer Display Scaling", or @ref DOX_IADLXDisplayScalingMode_GetMode "Center Scaling".<br>
*
* When Radeon Super Resolution is enabled, the mutually exclusive features are automatically disabled.<br>
*
* If a mutually exclusive feature is re-enabled, its previous configuration settings are restored.<br>
* @ENG_END_DOX
*
*@copydoc IADLX3DRadeonSuperResolution_REQ_TABLE
Expand Down
Loading

0 comments on commit e874832

Please sign in to comment.