nvfbc 0.1.2

Safe bindings for NVFBC, an NVIDIA API for capturing the front buffer from NVIDIA GPUs.
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

# nvfbc

This library contains a safe FFI for [NVFBC](https://developer.nvidia.com/capture-sdk) from NVIDIA.

## Supported GPUs
As this uses a proprietary NVIDIA API, the supported devices are limited to NVIDIA GPUs.
Additionally, the NVFBC API is only officially supported on GRID, Tesla, or Quadro X2000+ GPUs.
Unofficial support is possible by applying a [patch](https://github.com/illnyang/nvlax/) to the NVFBC library.

## Supported capture types
Currently only CUDA and system (RAM) capture types are supported.

## Example: Saving an image.
```rust
use nvfbc::{SystemCapturer, BufferFormat};

fn main() -> Result<(), Box<dyn std::error::Error>> {
    let mut capturer = SystemCapturer::new()?;

    let status = capturer.status()?;
    println!("{:#?}", capturer.status()?);
    if !status.can_create_now {
        panic!("Can't create a system capture session.");
    }

    capturer.start(BufferFormat::Rgb)?;

    let frame_info = capturer.next_frame()?;
    println!("{:#?}", frame_info);

    let image = image::ImageBuffer::<image::Rgb<u8>, &[u8]>::from_raw(
        frame_info.width,
        frame_info.height,
        frame_info.buffer,
    ).unwrap();
    image.save("frame.png")?;
    println!("Saved frame to 'frame.png'.");

    capturer.stop()?;

    Ok(())
}
```

## Future work
Support for configuration is currently limited, to keep the code simple and concise.
Future releases will add more configuration options.

License: BSD-2-Clause