Struct windows_capture::frame::Frame

pub struct Frame<'a> { /* private fields */ }

Represents a frame captured from a graphics capture item.

Example

// Get frame from capture the session
let mut buffer = frame.buffer()?;
buffer.save_as_image("screenshot.png", ImageFormat::Png)?;

Implementations

impl<'a> Frame<'a>

pub fn new( d3d_device: &'a ID3D11Device, frame_surface: IDirect3DSurface, frame_texture: ID3D11Texture2D, time: TimeSpan, context: &'a ID3D11DeviceContext, buffer: &'a mut Vec<u8>, width: u32, height: u32, color_format: ColorFormat ) -> Self

Create a new Frame.

Arguments

• d3d_device - The ID3D11Device used for creating the frame.
• frame_surface - The IDirect3DSurface representing the frame surface.
• frame_texture - The ID3D11Texture2D representing the frame texture.
• time - The TimeSpan representing the frame time.
• context - The ID3D11DeviceContext used for copying the texture.
• buffer - The mutable Vec representing the frame buffer.
• width - The width of the frame.
• height - The height of the frame.
• color_format - The ColorFormat of the frame.

Returns

A new Frame instance.

pub const fn width(&self) -> u32

Get the width of the frame.

Returns

The width of the frame.

pub const fn height(&self) -> u32

Get the height of the frame.

Returns

The height of the frame.

pub const fn timespan(&self) -> TimeSpan

Get the time of the frame.

Returns

The time of the frame.

pub unsafe fn as_raw_surface(&self) -> IDirect3DSurface

Get the raw surface of the frame.

Returns

The IDirect3DSurface representing the raw surface of the frame.

Safety

This method is unsafe because it returns a raw pointer to the IDirect3DSurface.

pub fn buffer(&mut self) -> Result<FrameBuffer<'_>, Error>

Get the frame buffer.

Returns

The FrameBuffer containing the frame data.

pub fn buffer_crop( &mut self, start_width: u32, start_height: u32, end_width: u32, end_height: u32 ) -> Result<FrameBuffer<'_>, Error>

Get a cropped frame buffer.

Arguments

• start_width - The starting width of the cropped frame.
• start_height - The starting height of the cropped frame.
• end_width - The ending width of the cropped frame.
• end_height - The ending height of the cropped frame.

Returns

The FrameBuffer containing the cropped frame data.

pub fn save_as_image<T: AsRef<Path>>( &mut self, path: T, format: ImageFormat ) -> Result<(), Error>

Save the frame buffer as an image to the specified path.

Arguments

• path - The path where the image will be saved.
• format - The ImageFormat of the saved image.

Returns

An empty Result if successful, or an Error if there was an issue saving the image.