nvidia-streamline 0.1.0

Vulkan bindings for NVIDIA DLSS Ray Reconstruction through Streamline
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98

#[cfg(all(target_os = "windows", feature = "vk-graph"))]
use vk_graph::driver::instance::Instance;
use {
    crate::{DlssRrFrameConstants, DlssRrQuality, DlssRrResources},
    anyhow::{Result, bail},
    ash::vk,
    std::path::Path,
};

pub(crate) struct Context;

#[expect(clippy::unused_self, reason = "matches the native context interface")]
impl Context {
    pub(crate) fn initialize(
        _project_id: &str,
        _engine_version: &str,
        _runtime_dir: &Path,
    ) -> Result<Self> {
        bail!("native streamline is available only on x86_64-pc-windows-msvc")
    }

    pub(crate) unsafe fn is_dlss_rr_supported(&self, _physical_device: vk::PhysicalDevice) -> bool {
        false
    }

    pub(crate) fn optimal_render_extent(
        &self,
        _output_extent: [u32; 2],
        _quality: DlssRrQuality,
    ) -> Result<[u32; 2]> {
        bail!("native streamline is unavailable on this target")
    }

    pub(crate) unsafe fn evaluate_dlss_rr(
        &self,
        _command_buffer: vk::CommandBuffer,
        _frame: &DlssRrFrameConstants,
        _resources: &DlssRrResources,
        _quality: DlssRrQuality,
    ) -> Result<()> {
        bail!("native streamline is unavailable on this target")
    }

    #[expect(
        clippy::unnecessary_wraps,
        reason = "matches the fallible native backend while preserving no-op shutdown"
    )]
    pub(crate) unsafe fn shutdown(&self) -> Result<()> {
        Ok(())
    }

    pub(crate) fn is_active(&self) -> bool {
        false
    }

    #[cfg(target_os = "windows")]
    pub(crate) unsafe fn create_proxy_ash_instance(
        &self,
        _interposer_path: &Path,
        _create_info: &vk::InstanceCreateInfo<'_>,
    ) -> Result<ProxyOwner> {
        bail!("the streamline vulkan proxy is unavailable on this target")
    }

    #[cfg(all(target_os = "windows", feature = "vk-graph"))]
    pub(crate) unsafe fn create_proxy_vulkan_instance(
        &self,
        _interposer_path: &Path,
        _create_info: &vk::InstanceCreateInfo<'_>,
    ) -> Result<(Instance, ProxyOwner)> {
        bail!("the streamline vulkan proxy is unavailable on this target")
    }
}

#[cfg(target_os = "windows")]
pub(crate) struct ProxyOwner;

#[cfg(target_os = "windows")]
#[expect(
    clippy::unused_self,
    reason = "matches the native proxy owner interface"
)]
impl ProxyOwner {
    pub(crate) fn entry(&self) -> &ash::Entry {
        unreachable!("the streamline vulkan proxy is unavailable on this target")
    }

    pub(crate) fn instance(&self) -> &ash::Instance {
        unreachable!("the streamline vulkan proxy is unavailable on this target")
    }

    pub(crate) fn destroy(&mut self) {}
}

#[cfg(target_os = "windows")]
impl Drop for ProxyOwner {
    fn drop(&mut self) {}
}