Struct renderdoc::RenderDoc

#[repr(C)]
pub struct RenderDoc<V>(_, _);

An instance of the RenderDoc API with baseline version V.

Methods

impl<V: Version> RenderDoc<V>

pub fn new() -> Result<Self, String>

Initializes a new instance of the RenderDoc API.

pub unsafe fn raw_api(&self) -> *mut Entry

Returns the raw entry point of the API.

Safety

Using the entry point structure directly will discard any thread safety provided by default with this library.

pub unsafe fn shutdown(self)

Attempts to shut down RenderDoc.

Safety

Note that this will work correctly if done immediately after the dynamic library is loaded, before any API work happens. At that point, RenderDoc will remove its injected hooks and shut down. Behavior is undefined if this is called after any API functions have been called.

impl<V: HasPrevious> RenderDoc<V>

pub fn downgrade(self) -> RenderDoc<V::Previous>

Downgrades the current version of RenderDoc to the immediate previous one.

impl RenderDoc<V100>

pub fn get_api_version(&self) -> (u32, u32, u32)

Returns the major, minor, and patch version numbers of the RenderDoc API currently in use.

Note that RenderDoc will usually provide a higher API version than the one requested by the user if it's backwards compatible.

Examples

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

pub fn set_capture_option_f32(&mut self, opt: CaptureOption, val: f32)

Sets the specified CaptureOption to the given f32 value.

Panics

This method will panic if the option and/or the value are invalid.

pub fn set_capture_option_u32(&mut self, opt: CaptureOption, val: u32)

Sets the specified CaptureOption to the given u32 value.

Panics

This method will panic if the option and/or the value are invalid.

pub fn get_capture_option_f32(&self, opt: CaptureOption) -> f32

Returns the value of the given CaptureOption as an f32 value.

Panics

This method will panic if the option is invalid.

pub fn get_capture_option_u32(&self, opt: CaptureOption) -> u32

Returns the value of the given CaptureOption as a u32 value.

Panics

This method will panic if the option is invalid.

pub fn set_capture_keys<I: Into<InputButton> + Clone>(&mut self, keys: &[I])

pub fn set_focus_toggle_keys<I: Into<InputButton> + Clone>(
    &mut self,
    keys: &[I]
)

pub fn unload_crash_handler(&mut self)

pub fn get_overlay_bits(&self) -> OverlayBits

pub fn mask_overlay_bits(&mut self, and: OverlayBits, or: OverlayBits)

pub fn get_log_file_path_template(&self) -> &str

pub fn set_log_file_path_template<P: AsRef<Path>>(&mut self, path_template: P)

pub fn get_num_captures(&self) -> u32

pub fn get_capture(&self, index: u32) -> Option<(String, u64)>

pub fn trigger_capture(&mut self)

Captures the next frame from the currently active window and API device.

Data is saved to a capture log file at the location specified via set_log_file_path_template().

pub fn is_remote_access_connected(&self) -> bool

pub fn launch_replay_ui<'a, O>(
    &self,
    connect_immediately: bool,
    extra_opts: O
) -> Result<u32, ()> where
    O: Into<Option<&'a str>>, 

pub fn set_active_window<D>(&mut self, dev: D, win: WindowHandle) where
    D: Into<DevicePointer>, 

pub fn start_frame_capture<D>(&mut self, dev: D, win: WindowHandle) where
    D: Into<DevicePointer>, 

pub fn is_frame_capturing(&self) -> bool

Returns whether or not a frame capture is currently ongoing anywhere.

Examples

if renderdoc.is_frame_capturing() {
    println!("Frames are being captured.");
} else {
    println!("No frame capture is occurring.");
}

pub fn end_frame_capture<D>(&mut self, dev: D, win: WindowHandle) where
    D: Into<DevicePointer>, 

impl RenderDoc<V110>

pub fn trigger_multi_frame_capture(&mut self, num_frames: u32)

Captures the next n frames from the currently active window and API device.

Data is saved to a capture log file at the location specified via set_log_file_path_template().

impl RenderDoc<V111>

pub fn is_remote_access_connected(&self) -> bool

Deprecated since 1.1.1:

renamed to is_target_control_connected()

pub fn is_target_control_connected(&self) -> bool

impl RenderDoc<V112>

pub fn get_capture_file_path_template(&self) -> &str

pub fn set_capture_file_path_template<P: AsRef<Path>>(
    &mut self,
    path_template: P
)

impl RenderDoc<V120>

pub fn set_capture_file_comments<'a, P, C>(&mut self, path: P, comments: C) where
    P: Into<Option<&'a str>>,
    C: AsRef<str>, 

impl RenderDoc<V140>

pub fn discard_frame_capture<D>(&mut self, dev: D, win: WindowHandle) -> bool where
    D: Into<DevicePointer>, 

Ends capturing immediately and discard any data without saving to disk.

Returns true if the capture was discarded, or false if no capture is in progress.

Methods from Deref<Target = RenderDoc<V::Previous>>

pub unsafe fn raw_api(&self) -> *mut Entry

Returns the raw entry point of the API.

Safety

Using the entry point structure directly will discard any thread safety provided by default with this library.

pub fn get_api_version(&self) -> (u32, u32, u32)

Returns the major, minor, and patch version numbers of the RenderDoc API currently in use.

Note that RenderDoc will usually provide a higher API version than the one requested by the user if it's backwards compatible.

Examples

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

pub fn set_capture_option_f32(&mut self, opt: CaptureOption, val: f32)

Sets the specified CaptureOption to the given f32 value.

Panics

This method will panic if the option and/or the value are invalid.

pub fn set_capture_option_u32(&mut self, opt: CaptureOption, val: u32)

Sets the specified CaptureOption to the given u32 value.

Panics

This method will panic if the option and/or the value are invalid.

pub fn get_capture_option_f32(&self, opt: CaptureOption) -> f32

Returns the value of the given CaptureOption as an f32 value.

Panics

This method will panic if the option is invalid.

pub fn get_capture_option_u32(&self, opt: CaptureOption) -> u32

Returns the value of the given CaptureOption as a u32 value.

Panics

This method will panic if the option is invalid.

pub fn set_capture_keys<I: Into<InputButton> + Clone>(&mut self, keys: &[I])

pub fn set_focus_toggle_keys<I: Into<InputButton> + Clone>(
    &mut self,
    keys: &[I]
)

pub fn unload_crash_handler(&mut self)

pub fn get_overlay_bits(&self) -> OverlayBits

pub fn mask_overlay_bits(&mut self, and: OverlayBits, or: OverlayBits)

pub fn get_log_file_path_template(&self) -> &str

pub fn set_log_file_path_template<P: AsRef<Path>>(&mut self, path_template: P)

pub fn get_num_captures(&self) -> u32

pub fn get_capture(&self, index: u32) -> Option<(String, u64)>

pub fn trigger_capture(&mut self)

Captures the next frame from the currently active window and API device.

Data is saved to a capture log file at the location specified via set_log_file_path_template().

pub fn is_remote_access_connected(&self) -> bool

pub fn launch_replay_ui<'a, O>(
    &self,
    connect_immediately: bool,
    extra_opts: O
) -> Result<u32, ()> where
    O: Into<Option<&'a str>>, 

pub fn set_active_window<D>(&mut self, dev: D, win: WindowHandle) where
    D: Into<DevicePointer>, 

pub fn start_frame_capture<D>(&mut self, dev: D, win: WindowHandle) where
    D: Into<DevicePointer>, 

pub fn is_frame_capturing(&self) -> bool

Returns whether or not a frame capture is currently ongoing anywhere.

Examples

if renderdoc.is_frame_capturing() {
    println!("Frames are being captured.");
} else {
    println!("No frame capture is occurring.");
}

pub fn end_frame_capture<D>(&mut self, dev: D, win: WindowHandle) where
    D: Into<DevicePointer>, 

pub fn trigger_multi_frame_capture(&mut self, num_frames: u32)

Captures the next n frames from the currently active window and API device.

Data is saved to a capture log file at the location specified via set_log_file_path_template().

pub fn is_remote_access_connected(&self) -> bool

Deprecated since 1.1.1:

renamed to is_target_control_connected()

pub fn is_target_control_connected(&self) -> bool

pub fn get_capture_file_path_template(&self) -> &str

pub fn set_capture_file_path_template<P: AsRef<Path>>(
    &mut self,
    path_template: P
)

pub fn set_capture_file_comments<'a, P, C>(&mut self, path: P, comments: C) where
    P: Into<Option<&'a str>>,
    C: AsRef<str>, 

pub fn discard_frame_capture<D>(&mut self, dev: D, win: WindowHandle) -> bool where
    D: Into<DevicePointer>, 

Ends capturing immediately and discard any data without saving to disk.

Returns true if the capture was discarded, or false if no capture is in progress.

Trait Implementations

impl From<RenderDoc<V140>> for RenderDoc<V100> where
    Self: Sized, 

fn from(newer: RenderDoc<V140>) -> Self

Performs the conversion.

impl From<RenderDoc<V140>> for RenderDoc<V110> where
    Self: Sized, 

fn from(newer: RenderDoc<V140>) -> Self

Performs the conversion.

impl From<RenderDoc<V140>> for RenderDoc<V111> where
    Self: Sized, 

fn from(newer: RenderDoc<V140>) -> Self

Performs the conversion.

impl From<RenderDoc<V140>> for RenderDoc<V112> where
    Self: Sized, 

fn from(newer: RenderDoc<V140>) -> Self

Performs the conversion.

impl From<RenderDoc<V140>> for RenderDoc<V120> where
    Self: Sized, 

fn from(newer: RenderDoc<V140>) -> Self

Performs the conversion.

impl From<RenderDoc<V140>> for RenderDoc<V130> where
    Self: Sized, 

fn from(newer: RenderDoc<V140>) -> Self

Performs the conversion.

impl From<RenderDoc<V130>> for RenderDoc<V100> where
    Self: Sized, 

fn from(newer: RenderDoc<V130>) -> Self

Performs the conversion.

impl From<RenderDoc<V130>> for RenderDoc<V110> where
    Self: Sized, 

fn from(newer: RenderDoc<V130>) -> Self

Performs the conversion.

impl From<RenderDoc<V130>> for RenderDoc<V111> where
    Self: Sized, 

fn from(newer: RenderDoc<V130>) -> Self

Performs the conversion.

impl From<RenderDoc<V130>> for RenderDoc<V112> where
    Self: Sized, 

fn from(newer: RenderDoc<V130>) -> Self

Performs the conversion.

impl From<RenderDoc<V130>> for RenderDoc<V120> where
    Self: Sized, 

fn from(newer: RenderDoc<V130>) -> Self

Performs the conversion.

impl From<RenderDoc<V120>> for RenderDoc<V100> where
    Self: Sized, 

fn from(newer: RenderDoc<V120>) -> Self

Performs the conversion.

impl From<RenderDoc<V120>> for RenderDoc<V110> where
    Self: Sized, 

fn from(newer: RenderDoc<V120>) -> Self

Performs the conversion.

impl From<RenderDoc<V120>> for RenderDoc<V111> where
    Self: Sized, 

fn from(newer: RenderDoc<V120>) -> Self

Performs the conversion.

impl From<RenderDoc<V120>> for RenderDoc<V112> where
    Self: Sized, 

fn from(newer: RenderDoc<V120>) -> Self

Performs the conversion.

impl From<RenderDoc<V112>> for RenderDoc<V100> where
    Self: Sized, 

fn from(newer: RenderDoc<V112>) -> Self

Performs the conversion.

impl From<RenderDoc<V112>> for RenderDoc<V110> where
    Self: Sized, 

fn from(newer: RenderDoc<V112>) -> Self

Performs the conversion.

impl From<RenderDoc<V112>> for RenderDoc<V111> where
    Self: Sized, 

fn from(newer: RenderDoc<V112>) -> Self

Performs the conversion.

impl From<RenderDoc<V111>> for RenderDoc<V100> where
    Self: Sized, 

fn from(newer: RenderDoc<V111>) -> Self

Performs the conversion.

impl From<RenderDoc<V111>> for RenderDoc<V110> where
    Self: Sized, 

fn from(newer: RenderDoc<V111>) -> Self

Performs the conversion.

impl From<RenderDoc<V110>> for RenderDoc<V100> where
    Self: Sized, 

fn from(newer: RenderDoc<V110>) -> Self

Performs the conversion.

impl<V: Eq> Eq for RenderDoc<V>

impl<V: PartialEq> PartialEq<RenderDoc<V>> for RenderDoc<V>

fn eq(&self, other: &RenderDoc<V>) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &RenderDoc<V>) -> bool

This method tests for !=.

impl<V: HasPrevious> Deref for RenderDoc<V>

type Target = RenderDoc<V::Previous>

The resulting type after dereferencing.

fn deref(&self) -> &Self::Target

Dereferences the value.

impl<V: Version> Debug for RenderDoc<V>

fn fmt(&self, fmt: &mut Formatter) -> FmtResult

Formats the value using the given formatter.

impl<V: HasPrevious> DerefMut for RenderDoc<V>

fn deref_mut(&mut self) -> &mut Self::Target

Mutably dereferences the value.

impl<V: Hash> Hash for RenderDoc<V>

fn hash<__HV: Hasher>(&self, state: &mut __HV)

Feeds this value into the given [Hasher].

fn hash_slice<H>(data: &[Self], state: &mut H) where
    H: Hasher, 

Feeds a slice of this type into the given [Hasher].