libcamlite-rs

This crate brings libcamlite support to rust!

Libcamlite add support for accessing libcamera-supported cameras on the raspberry pi. It provides a simple, efficient API for getting simultaneous H264 and RGB streams. The H264 stream can be saved to a file or streamed over, say, RTSP (support not included). The RGB stream is ideal for passing to an object detection library, such as torch or tflite.

As an example, in a few lines we can stream h264/rgb as follows:

let libcam = LibCamClient::new();

let lowres = StreamParams{ width: 300, height: 300, format: StreamFormat::STREAM_FORMAT_RGB, framerate: 30};
libcam.client.setupLowres(&lowres);

let h264Params = StreamParams{ width: 1920, height: 1080, format:  StreamFormat::STREAM_FORMAT_H264, framerate: 30};
libcam.client.setupH264(&h264Params, 5, &"main".to_owned(), &"2mbps".to_owned());

let mycb = Box::new(MyCallback::new(lowres));
libcam.setCallbacks(mycb);
libcam.run();

You should then see output on the command line every second or so indicating received frames:

low: 31 calls in past 1.0325267 seconds; 30.023436 calls/sec
h264: 31 calls in past 1.0341291 seconds; 29.976913 calls/sec
Wrote output.ppm
low: 31 calls in past 1.0325396 seconds; 30.023062 calls/sec
h264: 30 calls in past 1.0032188 seconds; 29.903748 calls/sec

All in this takes up about 70MB of ram and a load average of 0.5 on a raspberry pi zero 2w, running bullseye aarch64!

You can view the output.h264 file in VLC. The PPM should be viewable in any image viewer.

See https://github.com/carsonfenimore/libcamlite-rs-test for sample code.

Note: 0.1.2 fixes the crate so that it builds the libcamlite dependency automatically.

Building

This library requires libcamera and rpicam-apps to be installed.