XeSS-rs

Raw unsafe XeSS 3.0.1 bindings for rust. We generate bindings for Vulkan, DirectX12 and DirectX11, for the XeSS-SR (super resolution), XeLL (low latency) and XeSS-FG (frame generation) systems. Further documentation should be found in the XeSS repository at https://github.com/intel/xess.

Upscaled render from 720p to 1440p using XeSS in Breda:

Usage

Add this to your Cargo.toml:

[dependencies]
xess-sys = "0.1.0"

Example code using the dx12 bindings:

use xess_sys::xess::{self, dx12};

# let device = todo!();

unsafe {
    // Init XeSS context
    let mut context_handle = xess::xess_context_handle_t::default();
    let library_handle = xess::Functions::new("libxess").unwrap();
    let library_dx12_handle = dx12::Functions::new("libxess").unwrap();
    let result =
        library_dx12_handle.xessD3D12CreateContext(device.as_raw(), &mut context_handle);
    if result != xess::xess_result_t::SUCCESS {
        panic!();
    }
    # let output_resolution = todo!();
    let init_params = dx12::xess_d3d12_init_params_t {
        outputResolution: output_resolution,
        qualitySetting: xess::xess_quality_settings_t::ULTRA_QUALITY_PLUS,
        initFlags: 0,
        creationNodeMask: 0,
        visibleNodeMask: 0,
        pTempBufferHeap: std::ptr::null_mut(),
        bufferHeapOffset: 0,
        pTempTextureHeap: std::ptr::null_mut(),
        textureHeapOffset: 0,
        pPipelineLibrary: std::ptr::null_mut(),
    };
    let result = library_dx12_handle.xessD3D12Init(context_handle, &init_params);
    if result != xess::xess_result_t::SUCCESS {
        panic!();
    }

    // In render loop
    loop {
        # let input_texture = todo!();
        # let motion_texture = todo!();
        # let depth_texture = todo!();
        # let output_texture = todo!();
        # let jitter = todo!();
        # let command_list = todo!();

        let exec_params = dx12::xess_d3d12_execute_params_t {
            pColorTexture: input_texture.as_raw(),
            pVelocityTexture: motion_texture.as_raw(),
            pDepthTexture: depth_texture.as_raw(),
            pOutputTexture: output_texture.as_raw(),
            jitterOffsetX: jitter[0],
            jitterOffsetY: jitter[1],
            inputWidth: input_texture.width,
            inputHeight: input_texture.height,
            pExposureScaleTexture: std::ptr::null_mut(),
            pResponsivePixelMaskTexture: std::ptr::null_mut(),
            exposureScale: 1.0,
            resetHistory: 0,
            inputColorBase: xess::xess_2d_t { x: 0, y: 0 },
            inputMotionVectorBase: xess::xess_2d_t { x: 0, y: 0 },
            inputDepthBase: xess::xess_2d_t { x: 0, y: 0 },
            inputResponsiveMaskBase: xess::xess_2d_t { x: 0, y: 0 },
            reserved0: xess::xess_2d_t { x: 0, y: 0 },
            outputColorBase: xess::xess_2d_t { x: 0, y: 0 },
            pDescriptorHeap: std::ptr::null_mut(),
            descriptorHeapOffset: 0,
        };
        let result =
            library_dx12_handle.xessD3D12Execute(context_handle, command_list, &exec_params);

        if result != xess::xess_result_t::SUCCESS {
            panic!();
        }
    }
    // Cleanup
    library_handle.xessDestroyContext(context_handle);
}

Ensure libxess.dll is available in the working directory or next to the executable. Our xess-bin crate provides handy paths for copying to the target/ folder from a build.rs script, as long as the crate is pulled from a git or path dependency!