Struct CameraManager 

pub struct CameraManager { /* private fields */ }

Camera manager used to enumerate available cameras in the system.

Implementations

impl CameraManager

pub fn new() -> Result<Self>

Initializes libcamera, starts the manager and creates Self.

pub fn new_unstarted() -> Result<Self>

Create a CameraManager without starting it.

Call Self::start before using it to enumerate cameras.

pub fn start(&mut self) -> Result<()>

Start the camera manager if it is not already running.

pub fn stop(&mut self) -> Result<()>

Stop the camera manager. Safe to call multiple times.

pub fn try_stop(&mut self) -> Result<()>

Attempt to stop only if no tracked cameras are still alive.

pub fn restart(&mut self) -> Result<()>

Restart the manager by stopping (if safe) and starting again.

pub fn is_started(&self) -> bool

Returns true if the manager has been started.

pub fn version(&self) -> &str

Returns version string of the linked libcamera.

pub fn cameras<'a>(&self) -> CameraList<'a>

Enumerates cameras within the system.

pub fn get<'a>(&self, id: &str) -> Option<Camera<'a>>

Returns a camera by id if present.

pub fn log_set_level(&self, category: &str, level: LoggingLevel)

Set the log level.

Parameters

• category - Free-form category string, a list of those can be seen by running grep 'LOG_DEFINE_CATEGORY(' -R on the libcamera source code
• level - Maximum log importance level to show, anything more less important than that will be hidden.

pub fn on_camera_added( &mut self, cb: impl FnMut(Camera<'static>) + Send + 'static, )

Register a callback for camera-added events.

Warning

The callback is invoked on libcamera’s internal thread. Do not block in the callback; send work to another thread/channel if needed.

pub fn on_camera_removed( &mut self, cb: impl FnMut(Camera<'static>) + Send + 'static, )

Register a callback for camera-removed events.

Warning

The callback is invoked on libcamera’s internal thread. Do not block in the callback; send work to another thread/channel if needed.

pub fn subscribe_hotplug_events(&mut self) -> Receiver<HotplugEvent>

Subscribe to hotplug events via a channel.

The returned Receiver yields HotplugEvent values. Internally this hooks into the libcamera hotplug signals and forwards them; it uses the same callbacks as on_camera_added/removed, so do not mix different senders without care.

Trait Implementations

impl Drop for CameraManager

fn drop(&mut self)

Executes the destructor for this type.