ImageSharpening
Demonstrates how to access AMD Radeon™ Image Sharpening and Sharpen Desktop options, perform related testing when programming with ADLX.
Command Prompts
| Command Prompt | Description |
|---|---|
| 1 | Display Radeon Image Sharpening and Sharpen Desktop support |
| 2 | Get current Radeon Image Sharpening and Image Sharpen Desktop state & additional information |
| 3 | Enable Radeon Image Sharpening and disable Sharpen Desktop |
| 4 | Enable Radeon Image Sharpening and enable Sharpen Desktop |
| 5 | Disable Radeon Image Sharpening |
| M/m | Display the main menu |
| Q/q | Quit the application |
Sample Path
/Samples/CPP/3DGraphics/ImageSharpening
Code
Copied!
//
// Copyright (c) 2021 - 2025 Advanced Micro Devices, Inc. All rights reserved.
//
//-------------------------------------------------------------------------------------------------
#include "SDK/ADLXHelper/Windows/Cpp/ADLXHelper.h"
#include "SDK/Include/I3DSettings.h"
#include "SDK/Include/I3DSettings2.h"
#include <iostream>
#include <string>
#include <vector>
// Use ADLX namespace
using namespace adlx;
// ADLXHelper instance
// No outstanding interfaces from ADLX must exist when ADLX is destroyed.
// Use global variables to ensure validity of the interface.
static ADLXHelper g_ADLXHelp;
// Display Image Sharpening and Image Sharpen Desktop support
void ShowImageSharpenSupport(const IADLX3DImageSharpeningPtr& d3dImageSharpen, const IADLX3DImageSharpenDesktopPtr& d3dImageSharpenDesktop);
// Get current Image Sharpening and Image Sharpen Desktop state and additional information
void GetImageSharpenState(const IADLX3DImageSharpeningPtr& d3dImageSharpen, const IADLX3DImageSharpenDesktopPtr& d3dImageSharpenDesktop);
// Set Image Sharpening and Image Sharpen Desktop state
void SetImageSharpenState(const IADLX3DImageSharpeningPtr& d3dImageSharpen, const IADLX3DImageSharpenDesktopPtr& d3dImageSharpenDesktop, int imageSharpeningIndex, int imageSharpenDesktopIndex);
// Disable Image Sharpening state
void SetImageSharpenState(const IADLX3DImageSharpeningPtr& d3dImageSharpen, int index);
// Menu
void MainMenu();
// Menu control
void MenuControl(const IADLX3DImageSharpeningPtr& d3dImageSharpen, const IADLX3DImageSharpenDesktopPtr& d3dImageSharpenDesktop);
// Wait for exit with error message
int WaitAndExit(const char* msg, const int retCode);
int main()
{
// Define return code
ADLX_RESULT res = ADLX_FAIL ;
// Initialize ADLX
res = g_ADLXHelp.Initialize();
if (ADLX_SUCCEEDED (res))
{
// Get GPUs
IADLXGPUListPtr gpus;
res = g_ADLXHelp.GetSystemServices()->GetGPUs(&gpus);
if (ADLX_SUCCEEDED (res) && !gpus->Empty())
{
// Get 3DSettings service
IADLX3DSettingsServicesPtr d3dSettingSrv;
res = g_ADLXHelp.GetSystemServices()->Get3DSettingsServices(&d3dSettingSrv);
if (ADLX_SUCCEEDED (res))
{
// Get GPU interface
IADLXGPUPtr gpuInfo;
adlx_uint index = 0;
res = gpus->At(index, &gpuInfo);
if (ADLX_SUCCEEDED (res))
{
// Get Image Sharpening interface
IADLX3DImageSharpeningPtr d3dImageSharpen;
res = d3dSettingSrv->GetImageSharpening(gpuInfo, &d3dImageSharpen);
if (ADLX_SUCCEEDED (res))
{
IADLX3DSettingsServices2Ptr d3dSettingSrv2(d3dSettingSrv);
// Get Sharpen Desktop interface
IADLX3DImageSharpenDesktopPtr d3dImageSharpenDesktop;
res = d3dSettingSrv2->GetImageSharpenDesktop(gpuInfo, &d3dImageSharpenDesktop);
if (ADLX_SUCCEEDED (res))
{
MainMenu();
MenuControl(d3dImageSharpen, d3dImageSharpenDesktop);
}
}
}
}
else
{
std::cout << "Failed to get 3DSettings services" << std::endl;
}
}
else
{
std::cout << "Failed to get the GPU" << std::endl;
}
}
else
{
return WaitAndExit("ADLX initialization failed", 0);
}
// Destroy ADLX
res = g_ADLXHelp.Terminate();
std::cout << "Destroy ADLX res: " << res << std::endl;
// Pause to see the printout
system("pause");
return 0;
}
void ShowImageSharpenSupport(const IADLX3DImageSharpeningPtr& d3dImageSharpen, const IADLX3DImageSharpenDesktopPtr& d3dImageSharpenDesktop)
{
adlx_bool supported = false;
ADLX_RESULT res = d3dImageSharpen->IsSupported(&supported);
std::cout << "\\tImageSharpening IsSupported: " << supported << ", return code is: "<< res << "(0 means success)" << std::endl;
supported = false;
res = d3dImageSharpen->IsSupported(&supported);
std::cout << "\\tImageSharpenDesktop IsSupported: " << supported << ", return code is: " << res << "(0 means success)" << std::endl;
}
void GetImageSharpenState(const IADLX3DImageSharpeningPtr& d3dImageSharpen, const IADLX3DImageSharpenDesktopPtr& d3dImageSharpenDesktop)
{
adlx_bool enabled = false;
ADLX_RESULT res = d3dImageSharpen->IsEnabled(&enabled);
std::cout << "\\tImageSharpening IsEnabled: " << enabled << ", return code is: "<< res << "(0 means success)" << std::endl;
enabled = false;
res = d3dImageSharpenDesktop->IsEnabled(&enabled);
std::cout << "\\tImageSharpenDesktop IsEnabled: " << enabled << ", return code is: " << res << "(0 means success)" << std::endl;
adlx_int sharpness;
ADLX_IntRange sharpnessRange = {0};
res = d3dImageSharpen->GetSharpness(&sharpness);
std::cout << "\\tCurrent Sharpness:" << sharpness
<< ", return code is: "<< res << "(0 means success)" << std::endl;
res = d3dImageSharpen->GetSharpnessRange(&sharpnessRange);
std::cout << "\\tSharpness limit [ " << sharpnessRange.minValue << " ," << sharpnessRange.maxValue << " ], step: " << sharpnessRange.step
<< ", return code is: "<< res << "(0 means success)" << std::endl;
}
void SetImageSharpenState(const IADLX3DImageSharpeningPtr& d3dImageSharpen, const IADLX3DImageSharpenDesktopPtr& d3dImageSharpenDesktop, int imageSharpeningIndex, int imageSharpenDesktopIndex)
{
ADLX_RESULT res = d3dImageSharpen->SetEnabled(imageSharpeningIndex);
std::cout << "\\tImage Sharpening Return code is: " << res << "(0 means success)" << std::endl;
if (imageSharpeningIndex && ADLX_SUCCEEDED (res))
{
res = d3dImageSharpenDesktop->SetEnabled(imageSharpenDesktopIndex);
std::cout << "\\tImage Sharpen Desktop Return code is: " << res << "(0 means success)" << std::endl;
adlx_int sharpness;
ADLX_IntRange sharpnessRange = {0};
d3dImageSharpen->GetSharpness(&sharpness);
d3dImageSharpen->GetSharpnessRange(&sharpnessRange);
if (sharpness != sharpnessRange.minValue )
{
res = d3dImageSharpen->SetSharpness(sharpnessRange.minValue );
std::cout << "\\tUse minimum Sharpness limit: return code is: " << res << "(0 means success)" << std::endl;
}
else
{
res = d3dImageSharpen->SetSharpness(sharpnessRange.maxValue );
std::cout << "\\tUse maximum Sharpness limit: return code is: " << res << "(0 means success)" << std::endl;
}
}
}
void SetImageSharpenState(const IADLX3DImageSharpeningPtr& d3dImageSharpen, int index)
{
ADLX_RESULT res = d3dImageSharpen->SetEnabled(index);
std::cout << "\\tImage Sharpening Return code is: " << res << "(0 means success)" << std::endl;
}
int WaitAndExit(const char* msg, const int retCode)
{
// Printout the message and pause to see it before returning the desired code
if (nullptr != msg)
std::cout << msg << std::endl;
system("pause");
return retCode;
}
void MainMenu()
{
std::cout << "\\tChoose from the following options:" << std::endl;
std::cout << "\\t->Press 1 to display Image Sharpening and Image Sharpen Desktop support" << std::endl;
std::cout << "\\t->Press 2 to get current Image Sharpening and Image Sharpen Desktop state & additional information" << std::endl;
std::cout << "\\t->Press 3 to enable Image Sharpening and disable Image Sharpen Desktop" << std::endl;
std::cout << "\\t->Press 4 to enable Image Sharpening and Image Sharpen Desktop" << std::endl;
std::cout << "\\t->Press 5 to disable Image Sharpening" << std::endl;
std::cout << "\\t->Press Q/q to quit the application" << std::endl;
std::cout << "\\t->Press M/m to display menu options" << std::endl;
}
void MenuControl(const IADLX3DImageSharpeningPtr& d3dImageSharpen, const IADLX3DImageSharpenDesktopPtr& d3dImageSharpenDesktop)
{
int num = 0;
while ((num = getchar()) != 'q' && num != 'Q')
{
switch (num)
{
// Display Image Sharpening and Image Sharpen Desktop support
case '1':
ShowImageSharpenSupport(d3dImageSharpen, d3dImageSharpenDesktop);
break;
// Get current Image Sharpening and Image Sharpen Desktop state and additional information
case '2':
GetImageSharpenState(d3dImageSharpen, d3dImageSharpenDesktop);
break;
// Enable Image Sharpening and disable Image Sharpen Desktop
case '3':
SetImageSharpenState(d3dImageSharpen, d3dImageSharpenDesktop, true, false);
break;
// Enable Image Sharpening and Image Sharpen Desktop
case '4':
SetImageSharpenState(d3dImageSharpen, d3dImageSharpenDesktop, true, true);
break;
// Disable Image Sharpening
case '5':
SetImageSharpenState(d3dImageSharpen, false);
break;
// Display menu options
case 'm':
case 'M':
MainMenu();
break;
default:
break;
}
}
}
