Beam Bots Logo

bb_camera_ffmpeg

CI License: Apache 2.0 Hex version badge Hexdocs badge REUSE status Ask DeepWiki

The ffmpeg capture that Beam Bots camera drivers share: an ffmpeg process that cannot outlive its owner, flow-controlled output, and structural MJPEG framing.

You do not use this package directly in a robot. A camera driver uses it:

Each driver builds the ffmpeg argument vector for its own input. This package runs it, frames the output, and hands whole JPEG images to the driver.

What it does

MuonTrap ──> ffmpeg ──pipe──> Capture ──frames──> the driver's sink
   ▲                             │
   └──── acknowledgements ───────┘

Requirements

Installation

def deps do
  [
    {:bb_camera_ffmpeg, "~> 0.1"}
  ]
end

Limitations

Testing

BB_VERSION=local mix test                   # no ffmpeg needed
BB_VERSION=local mix test --include ffmpeg  # also runs ffmpeg under MuonTrap
BB_VERSION=local mix check --no-retry

The default suite drives capture through a stub backend, so every case is a function call rather than something to wait for. The :ffmpeg tests run real ffmpeg against its synthetic testsrc2 source and check that nothing outlives a stopped or killed capture.

Licence

Apache-2.0. See LICENSES/.