samples/basic_sample_frame_generation/DXSample.h - main - redgpu/xess

samples/basic_sample_frame_generation/DXSample.h
106 строк3 KB
Intel XeSS
XeSS SDK 3.0.1
17 апр 2026, 02:50
17 апр 2026, 02:50207b703
//*********************************************************
//
// Copyright (c) Microsoft. All rights reserved.
// Copyright (c) 2023 Intel Corporation
// 
// This code is licensed under the MIT License (MIT).
// THIS CODE IS PROVIDED *AS IS* WITHOUT WARRANTY OF
// ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING ANY
// IMPLIED WARRANTIES OF FITNESS FOR A PARTICULAR
// PURPOSE, MERCHANTABILITY, OR NON-INFRINGEMENT.
//
//*********************************************************

#pragma once

#include "DXSampleHelper.h"
#include "Win32Application.h"

class DXSample
{
public:
    DXSample(UINT width, UINT height, std::wstring name);
    virtual ~DXSample();

    virtual void OnInit() = 0;
    virtual void OnUpdate() = 0;

    virtual void OnRender() = 0;

    virtual void OnDestroy() = 0;
    virtual void SetViewPort(UINT width, UINT height) = 0;

    // Samples override the event handlers to handle specific messages.
    virtual void OnKeyDown(UINT8 /*key*/)      {}
    virtual void OnKeyUp(UINT8 /*key*/)        {}
    virtual void OnMouseWheel(WPARAM /*wParam*/) {}
    virtual void OnSleep() = 0;

    // Accessors.
    UINT GetWidth() const           { return m_width; }
    UINT GetHeight() const          { return m_height; }
    const WCHAR* GetTitle() const   { return m_title.c_str(); }
    void SetFrameTime(float duration) { m_lastFrameTimeMS = duration; };

    void ParseCommandLineArgs(_In_reads_(argc) WCHAR* argv[], int argc);

    // Target FPS
    float m_minimumFrameTimeMS = 0; // as fast as possible

    // Use Full Screen
    bool m_fullScreen = false;
    bool m_switchFullScreen = false;
    bool m_switchResolution = false;

    bool m_showOnlyInterpolation = false;
    bool m_tagInterpolatedFrames = true;
    bool m_maximized = false;
    bool m_borderless = false;
    bool m_topmost = false;
    float m_lastFrameTimeMS = 0.0;

    // XeSS-FG can be initialized either using a swap chain descriptor
    // or from an existing application swap chain.
    bool m_initializeFromApplicationSwapChain = false;

    // XeSS-FG can use an external descriptor heap.
    bool m_enableExternalDescriptorHeap = false;

    // By default we initialize XeSS-FG to use the maximum supported number of interpolated frames,
    // unless a different value was provided on the command line.
    // After initialization this variable will contain the actual maximum number
    // of interpolated frames.
    uint32_t m_maxInterpolatedFrames = 0;

    bool m_useWaitableSwapChain = false;

    // Maximum number of frames to stop rendering after.
    int m_maxFrames = INT_MAX;

protected:
    std::wstring GetAssetFullPath(LPCWSTR assetName);

    void GetHardwareAdapter(
        _In_ IDXGIFactory1* pFactory,
        _Outptr_result_maybenull_ IDXGIAdapter1** ppAdapter,
        bool requestHighPerformanceAdapter = false);

    void SetCustomWindowText(LPCWSTR text);

    // Viewport dimensions.
    UINT m_width;
    UINT m_height;
    float m_aspectRatio;

    // Adapter info.
    bool m_useWarpDevice;
    bool m_useDebugDevice;
    INT m_hardwareAdapterId;

private:
    // Root assets path.
    std::wstring m_assetsPath;

    // Window title.
    std::wstring m_title;
};