FRTC

Demonstrates how to access AMD Frame Rate Target Control (FRTC) options, and perform related testing when programming with ADLX.

Command Prompts

Command Prompt Description
1 Display AMD FRTC support
2 Get and display current AMD FRTC state and additional information
3 Enable and configure AMD FRTC
4 Disable AMD FRTC
M/m Display the main menu
Q/q Quit the application

Sample Path

/Samples/C/3DGraphics/FRTC

Code

Copied!

//
// Copyright (c) 2021 - 2023 Advanced Micro Devices, Inc. All rights reserved.
//
//-------------------------------------------------------------------------------------------------


#include "SDK/ADLXHelper/Windows/C/ADLXHelper.h"
#include "SDK/Include/I3DSettings.h"

// Display FRTC support
void ShowFRTCSupport(IADLX3DFrameRateTargetControl* frtc);

// Get and display current FRTC state
void GetFRTCState(IADLX3DFrameRateTargetControl* frtc);

// Set FRTC state
void SetFRTCState(IADLX3DFrameRateTargetControl* frtc, int index);

// Menu
void MainMenu();

// Menu control
void MenuControl(IADLX3DFrameRateTargetControl* frtc);

int main()
{
    // Define return code
    ADLX_RESULT  res = ADLX_FAIL ;

    // Initialize ADLX
    res = ADLXHelper_Initialize();
    if (ADLX_SUCCEEDED (res))
    {
        // Get system services
        IADLXSystem* sys = ADLXHelper_GetSystemServices();

        // Get GPUs
        IADLXGPUList* gpus = NULL;
        res = sys->pVtbl->GetGPUs(sys, &gpus);

        // Get 3DSettings service
        IADLX3DSettingsServices* d3dSettingSrv = NULL;
        res = sys->pVtbl->Get3DSettingsServices(sys, &d3dSettingSrv);

        if (ADLX_SUCCEEDED (res))
        {
                // Get GPU interface
            IADLXGPU* gpu = NULL;
            adlx_uint index = 0;
            res = gpus->pVtbl->At_GPUList(gpus, index, &gpu);

            // Get FRTC interface
            IADLX3DFrameRateTargetControl* frtc = NULL;
            res = d3dSettingSrv->pVtbl->GetFrameRateTargetControl(d3dSettingSrv, gpu, &frtc);
            if (ADLX_SUCCEEDED (res))
            {
                MainMenu();
                MenuControl(frtc);
            }

            // Release the FRTC interface
            if (frtc != NULL)
            {
                frtc->pVtbl->Release(frtc);
                frtc = NULL;
            }

            // Release the GPU interface
            if (gpu != NULL)
            {
                gpu->pVtbl->Release(gpu);
                gpu = NULL;
            }
        }
        else
        {
            printf("Failed to get 3DSettings services\n");
        }

        // Release the 3DSettingsService interface
        if (d3dSettingSrv != NULL)
        {
            d3dSettingSrv->pVtbl->Release(d3dSettingSrv);
            d3dSettingSrv = NULL;
        }

        // Release the GPUs list interface
        if (gpus != NULL)
        {
            gpus->pVtbl->Release(gpus);
            gpus = NULL;
        }
    }
    else
    {
        printf("ADLX initialization failed\n");
        return 0;
    }

    // Destroy ADLX
    res = ADLXHelper_Terminate();
    printf("Destroy ADLX res: %d\n", res);

    // Pause to see the printout
    system("pause");

    return 0;
}

void ShowFRTCSupport(IADLX3DFrameRateTargetControl* frtc)
{
    adlx_bool supported = false;
    ADLX_RESULT  res = frtc->pVtbl->IsSupported(frtc, &supported);
    printf("\tIsSupported: %d, return code is: %d(0 means success)\n", supported, res);
}

void GetFRTCState(IADLX3DFrameRateTargetControl* frtc)
{
    adlx_bool enabled = false;
    ADLX_RESULT  res = frtc->pVtbl->IsEnabled(frtc, &enabled);
    printf("\tIsEnabled: %d, return code is: %d(0 means success)\n", enabled, res);
    adlx_int fps;
    ADLX_IntRange  range = { 0 };
    res = frtc->pVtbl->GetFPS(frtc, &fps);
    printf("\tCurrent FPS: %d, return code is: %d(0 means success)\n", fps, res);
    res = frtc->pVtbl->GetFPSRange(frtc, &range);
    printf("\tFPS limit [ %d , %d ], step: %d, return code is: %d(0 means success)\n", range.minValue , range.maxValue , range.step , res);
}

void SetFRTCState(IADLX3DFrameRateTargetControl* frtc, int index)
{
    ADLX_RESULT  res = frtc->pVtbl->SetEnabled(frtc, index == 0);
    printf("\tReturn code is: %d (0 means success)\n", res);

    if (index == 0 && ADLX_SUCCEEDED (res))
    {
        adlx_int fps;
        ADLX_IntRange  range = { 0 };
        frtc->pVtbl->GetFPS(frtc, &fps);
        frtc->pVtbl->GetFPSRange(frtc, &range);
        if (fps != range.minValue )
        {
            res = frtc->pVtbl->SetFPS(frtc, range.minValue );
            printf("\tUse minimum FPS limit: return code is: %d (0 means success)\n", res);
        }
        else
        {
            res = frtc->pVtbl->SetFPS(frtc, range.maxValue );
            printf("\tUse maximum FPS limit: return code is: %d (0 means success)\n", res);
        }
    }
}

void MainMenu()
{
    printf("\tChoose from the following options:\n");

    printf("\t->Press 1 to display FRTC support\n");
    printf("\t->Press 2 to get and display current FRTC state\n");
    printf("\t->Press 3 to enable and configure FRTC\n");
    printf("\t->Press 4 to disable FRTC\n");

    printf("\t->Press Q/q to quit the application\n");
    printf("\t->Press M/m to display menu options\n");
}

void MenuControl(IADLX3DFrameRateTargetControl* frtc)
{
    int num = 0;
    while ((num = getchar()) != 'q' && num != 'Q')
    {
        switch (num)
        {
            // Display FRTC support
        case '1':
            ShowFRTCSupport(frtc);
            break;

            // Get and display current FRTC state
        case '2':
            GetFRTCState(frtc);
            break;

            // Set FRTC state
        case '3':
        case '4':
            SetFRTCState(frtc, num - '3');
            break;

            // Display menu options
        case 'm':
        case 'M':
            MainMenu();
            break;
        default:
            break;
        }
    }
}