mirror of
https://github.com/tangerineturtle1/NX2navi.git
synced 2026-11-17 02:49:57 -04:00
With DLSS Frame Generation, nx2sl_reflex set only Reflex's mode, so Reflex's sleep at the frame's start held no limit and the game's own pacer held the finished picture until its turn, a second wait after the frame was drawn (A-16, P-16). nx2sl_reflex2(mode, frame_limit_us) fills sl::ReflexOptions::frameLimitUs as well, which the driver's sleep then holds as its minimum interval. Streamline drops both with the swapchain and a call without the limit clears it, so every call carries both. It returns 1 only when Streamline took them and, for a limit, did not report Reflex's sleep as unavailable on this GPU and driver (slReflexGetState, asked from nx2sl_available on the device's thread and from nx2sl_reflex2 under the runtime's present lock, never at once). nx2sl_reflex stays exported for older runtimes and sets the mode alone; NX2SL_VERSION stays 3, since the runtime refuses any other version and the new export is optional. Built with tools/build_dlssg.py against the pinned Streamline 2.14.16 SDK: clean at /W3, 15 exports including nx2sl_reflex2. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
82 lines
4.7 KiB
C
82 lines
4.7 KiB
C
// The C interface of nx2navi_dlssg.dll (runtime/dlssg/nx2_sl.cpp), which runtime/vk_dlssg.c loads for DLSS Frame
|
|
// Generation. The DLL is built with MSVC against NVIDIA's Streamline SDK (its C++ types have MSVC's ABI); nothing of
|
|
// the SDK is in this repository, and the game itself is built without it.
|
|
#pragma once
|
|
#include <stdint.h>
|
|
#include <vulkan/vulkan.h>
|
|
|
|
#define NX2SL_VERSION 3
|
|
|
|
typedef struct {
|
|
VkImage image;
|
|
VkImageView view;
|
|
VkFormat format;
|
|
uint32_t width, height;
|
|
VkImageLayout layout; // the layout it is in when Streamline reads it (at the present)
|
|
VkImageUsageFlags usage;
|
|
} Nx2SlImage;
|
|
|
|
typedef struct {
|
|
float view_to_clip[16], clip_to_view[16], clip_to_prev_clip[16], prev_clip_to_clip[16]; // row-major
|
|
float pos[3], up[3], right[3], fwd[3];
|
|
float znear, zfar, fov_y, aspect;
|
|
float jitter[2]; // render pixels
|
|
float mv_scale[2]; // what makes the motion vectors fractions of the render size
|
|
int reset;
|
|
} Nx2SlCamera;
|
|
|
|
typedef void (*Nx2SlLog)(const char *line);
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
#ifdef NX2SL_BUILD
|
|
#define NX2SL_API __declspec(dllexport)
|
|
#else
|
|
#define NX2SL_API
|
|
#endif
|
|
typedef int (*PFN_nx2sl_version)(void);
|
|
// slInit with DLSS-G, Reflex and PCL for Vulkan; dir: the folder of sl.interposer.dll and the plugins (the game's)
|
|
typedef int (*PFN_nx2sl_init)(const wchar_t *dir, Nx2SlLog log);
|
|
// The interposer's proc address functions: vkCreateInstance and vkCreateDevice through them add what DLSS-G needs
|
|
// (extensions, features, queues) and tell Streamline the device; the swapchain functions through them are its hooks.
|
|
typedef PFN_vkGetInstanceProcAddr (*PFN_nx2sl_instance_proc)(void);
|
|
typedef PFN_vkGetDeviceProcAddr (*PFN_nx2sl_device_proc)(void);
|
|
// 1 when DLSS-G loaded and supports this GPU (after the device exists)
|
|
typedef int (*PFN_nx2sl_available)(void);
|
|
// Optional: log Streamline's support result for frame generation after availability failed (its general check of
|
|
// the system, driver and adapters: Streamline looks at one adapter only when given its LUID, which Vulkan has not).
|
|
typedef void (*PFN_nx2sl_log_unavailable)(VkPhysicalDevice physical);
|
|
// Reflex's low-latency mode, 0 off, 1 on, 2 on with boost: after the device, and after each swapchain the game creates
|
|
// through the interposer (the mode is the swapchain's)
|
|
typedef void (*PFN_nx2sl_reflex)(int mode);
|
|
// The same with Reflex's frame limit, frame_limit_us microseconds from one frame's start to the next (0 none), which
|
|
// the driver's sleep then holds (vk_dlssg.c vk_dlssg_pace). Each call sets both, so the runtime calls only this one when
|
|
// the DLL has it. 1 when Streamline took them and, for a limit, Reflex's sleep runs on this GPU and driver. Optional:
|
|
// an older DLL lacks it, and the game's own limiter then keeps the frame limit.
|
|
typedef int (*PFN_nx2sl_reflex2)(int mode, uint32_t frame_limit_us);
|
|
// Frames are numbered by the game's presents: frame n ends with its n-th present (vk_dlssg.c vk_dlssg_game_present).
|
|
// Where the game starts a frame: with hold, Reflex's sleep, which holds the start until the time the driver computes
|
|
// from the measured render and queue times; then the frame's simulation and render-submit-start markers.
|
|
typedef void (*PFN_nx2sl_sleep)(uint32_t frame, int hold);
|
|
// The frame's submissions went out (at the game's present; with asynchronous replay, when the replay reaches it): its
|
|
// render-submit-end marker.
|
|
typedef void (*PFN_nx2sl_submit_end)(uint32_t frame);
|
|
// Each host present, before the present call: the frame's constants and tags, and frame generation on or off. enable is
|
|
// the number of frames to generate between two rendered ones (0 off; 1, 2 or 3 for 2x, 3x or 4x), at most what
|
|
// nx2sl_frames_max reports; a DLL without nx2sl_frames_max (an older build) generates one for any nonzero value. Then
|
|
// nx2sl_present_marker(0) before and (1) after the present.
|
|
typedef int (*PFN_nx2sl_frame)(VkCommandBuffer cb, const Nx2SlImage *depth, const Nx2SlImage *mv, const Nx2SlImage *hudless,
|
|
const Nx2SlCamera *cam, uint32_t out_w, uint32_t out_h, int enable, uint32_t frame);
|
|
// The most frames DLSS-G can generate between two rendered ones on this GPU and driver (Streamline's
|
|
// numFramesToGenerateMax: 1 on a GPU that does 2x, 3 on one that does 4x); 0 until Streamline reports it. Asked after
|
|
// the device exists and refreshed after each present. Optional: an older DLL lacks it, and the game then asks for one.
|
|
typedef uint32_t (*PFN_nx2sl_frames_max)(void);
|
|
typedef void (*PFN_nx2sl_present_marker)(int after, uint32_t frame);
|
|
// The frames the display got, generated ones included, counted after each present (on the present thread)
|
|
typedef uint64_t (*PFN_nx2sl_shown)(void);
|
|
typedef void (*PFN_nx2sl_shutdown)(void);
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|