#graphics #profile #renderdoc #trace

renderdoc

RenderDoc application bindings for Rust

6 releases (breaking)

0.6.0 May 19, 2019
0.5.0 May 18, 2019
0.4.0 Sep 16, 2018
0.3.0 May 31, 2018
0.1.0 Oct 12, 2017

#34 in Rendering

Download history 21/week @ 2019-02-03 3/week @ 2019-02-17 3/week @ 2019-02-24 91/week @ 2019-03-03 2/week @ 2019-03-10 27/week @ 2019-03-17 33/week @ 2019-03-24 13/week @ 2019-03-31 5/week @ 2019-04-07 3/week @ 2019-04-14 6/week @ 2019-04-21 13/week @ 2019-04-28 10/week @ 2019-05-05 18/week @ 2019-05-12

75 downloads per month

MIT/Apache

69KB
1.5K SLoC

renderdoc-rs

Build Status Crates.io Documentation

Rust bindings to RenderDoc, a popular graphics debugger.

RenderDoc is a free and open source graphics debugging tool. RenderDoc allows game developers to take frame captures of their applications, replay them, examine the graphics pipeline state, and potentially identify nasty graphics bugs.

These bindings require that RenderDoc be installed on the target machine, with either renderdoc.dll or librenderdoc.so visible from yourPATH.

For more details on how to use this API to integrate your game or renderer with the RenderDoc profiler, consult the in-application API documentation.

Example

extern crate renderdoc;

use renderdoc::{RenderDoc, V100, V110};

fn main() {
    let mut rd: RenderDoc<V110> = RenderDoc::new().expect("Failed to init");

    let (major, minor, patch) = rd.get_api_version();
    assert_eq!(major, 1u32);
    assert_eq!(minor, 1u32);

    // When a certain key is pressed, trigger a single-frame capture like this.
    rd.trigger_capture();

    // If you specify version `V110` or newer, you can trigger a multi-frame
    // capture like this.
    rd.trigger_multi_frame_capture(3);

    // Query the details of an existing capture like this.
    match rd.get_capture(0) {
        Some(cap) => println!("ID: 0, Path: {}, Timestamp: {}", cap.0, cap.1),
        None => println!("No capture found with ID of 0!"),
    }

    // Downgrade your effective API version at run-time like this.
    let mut rd: RenderDoc<V100> = rd.into();

    // Now this line will no longer compile!
    // rd.trigger_multi_frame_capture(3);
}

Working examples are available in the examples directory.

License

renderdoc-rs is free and open source software distributed under the terms of both the MIT and the Apache 2.0 licenses.

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.

Dependencies

~3.5MB
~69K SLoC