Crate v4l2r

This library provides two levels of abstraction over V4L2:

• The ioctl module provides direct, thin wrappers over the V4L2 ioctls with added safety. Note that “safety” here is in terms of memory safety: this layer won’t guard against passing invalid data that the ioctls will reject - it just makes sure that data passed from and to the kernel can be accessed safely. Since this is a 1:1 mapping over the V4L2 ioctls, working at this level is a bit laborious, although more comfortable than doing the same in C.

• The device module (still WIP) provides a higher-level abstraction over the V4L2 entities, like device and queue. Strong typing will ensure that most inconsistencies while using the V4L2 API can be caught at compile-time.

These two layers should provide the foundations for higher-level libraries to provide safe, specialized APIs that support various V4L2 usage scenarios (camera, decoder/encoder, etc).

Re-exports

• pub use nix;

Modules

• controls
  Safe definitions around V4L2 extended controls.
• decoder
  High-level interface for a V4L2 video decoder. Currently only supports the stateful interface.
• device
  Interface to the V4L2 primitives that is both safe and higher-level than ioctl, while staying low-level enough to allow the implementation of any kind of V4L2 program on top of it.
• encoder
  High-level interface for a V4L2 video encoder.
• ioctl
  This module provides safer versions of the V4L2 ioctls through simple functions working on a RawFd, and safer variants of the main V4L2 structures. This module can be used directly, but the device module is very likely to be a better fit for application code.
• memory
  Abstracts the different kinds of backing memory (MMAP, USERPTR, DMABUF) supported by V4L2.

Structs

• Format
  Unified representation of a V4L2 format capable of handling both single and multi-planar formats. When the single-planar API is used, only one plane shall be used - attempts to have more will be rejected by the ioctl wrappers.
• PixelFormat
  A Fourcc pixel format, used to pass formats to V4L2. It can be converted back and forth from a 32-bit integer, or a 4-bytes string.
• PlaneLayout
  Description of a single plane in a format.
• Rect
  A more elegant representation for v4l2_rect.

Enums

• Colorspace
  Equivalent of enum v4l2_colorspace.
• FormatConversionError
• Quantization
  Equivalent of enum v4l2_quantization.
• QueueClass
  Possible classes for this queue.
• QueueDirection
  Possible directions for the queue
• QueueType
  Types of queues currently supported by this library.
• XferFunc
  Equivalent of enum v4l2_xfer_func.
• YCbCrEncoding
  Equivalent of enum v4l2_ycbcr_encoding.