Crate v4l2loopback

Expand description

Safe binding to interact with v4l2loopback.

v4l2loopback allows your to manage virtual video devices on linux. Application are able to pass video content to those devices, and this video feed will be available as a camera.

⚠️ Warning:

This crate is based on an unreleased version of v4l2loopback. To use this crate you will need to build and install v4l2loopback from source. (If you are on archlinux, you can install v4l2loopback-dkms-git from the aur)

§Usage

use std::path::Path;
use v4l2loopback::{add_device, delete_device, query_device, DeviceConfig};

// Device configuration
// Here you declare informations about the camera device that will be created.
// It should be matching the content that you will want to pass through
let device_config = DeviceConfig {
    label: "Test Device".to_string(),
    min_width: 100,
    max_width: 4000,
    min_height: 100,
    max_height: 4000,
    max_buffers: 9,
    max_openers: 3,
};
// Create a device
let device_num =
    add_device(None, device_config.clone()).expect("Error when creating the device");

// Querying informations about a device
// This returns the matchin device's configuration
let cfg =
    query_device(device_num).expect("Error when querying the device");

// When you are done with you processing, don't forget to delete the device, otherwise the
// device `/dev/videoN` will not be removed.
delete_device(device_num).expect("Error when removing device");
assert!(!Path::new(&format!("/dev/video{}", device_num)).exists());

Structs§

DeviceConfig: Wrapper type describing a v4l2loopback device.

Enums§

ControlDeviceError: Error generated when accessing the control device fails
Error: Error which can occure when calling a function from this crate

Constants§

V4L2LOOPBACK_VERSION_BUGFIX
V4L2LOOPBACK_VERSION_MAJOR
V4L2LOOPBACK_VERSION_MINOR

Functions§