| commit | 46bf42c4243f241a9f1e55fc2057d4d5a67e581c | [log] [tgz] |
|---|---|---|
| author | Alexandre Courbot <gnurou@gmail.com> | Thu Jun 11 14:19:54 2020 +0900 |
| committer | Alexandre Courbot <gnurou@gmail.com> | Thu Jun 11 14:28:59 2020 +0900 |
| tree | 903896ee6df68304b2b0f3d6fbe3c996a973f7b8 | |
| parent | 97296c883a04ec32f4843d7feec186deee2d251a [diff] |
queue: move num_queued_buffers out of buffer mananger This value is always updated from queue/dequeue and thus from the same thread, so there is no need to put it behind a mutex.
This is a work-in-progress library to implement safe Rust bindings for V4L2.
WARNING: Do not use this for any serious project yet. This is still in the process of being designed, and also serves as a way for the author to learn Rust. As such, it cannot be regarded as quality code.
The goal is to make V4L2 accessible to Rust on two level of abstractions:
A very thin wrapper over the V4L2 ioctls, that stays as close as possible to them while adding extra safety and removing some of the historical baggage like the difference in format for single-planar and multi-planar queues.
A higher-level abstraction (still in the design phase) which relies on the first one and exposes devices, queues, and other V4L2 concepts as strongly typed objects. The goal here is to provide an nice-to-use interface that remains generic enough to be used for any kind of V4L2 device.
Other libraries are expected to build upon these abstractions in order to provide more specialized libraries, e.g. a simple camera or decoder/encoder library.
Dependencies shall be kept to a minimum: this library talks directly to the kernel using ioctls, and only depends on a few small, well-established crates.
Check examples/vicodec_test/ioctl_api.rs for a short example of how to use the low-level ioctl interface, and examples/vicodec_test/device_api.rs for the same example using the device interface. This example program requires the vicodec virtual device, either in single or multi-planar mode.
You can try it with
cargo run --example vicodec_test -- /dev/video0
or
cargo run --example vicodec_test -- /dev/video0 --use_ioctl
assuming /dev/video0 is the path to the vicodec encoder.