Skip to content

Parrot-Developers/libvideo-encode

Repository files navigation

libvideo-encode - Video encoding library

libvideo-encode is a C library to handle the encoding of H.264 video on various platforms with a common API.

The library uses hardware-accelerated encoding when available.

Implementations

The following implementations are available:

  • x264 (software encoding)

The application can force using a specific implementation or let the library decide according to what is supported by the platform.

Dependencies

The library depends on the following Alchemy modules:

  • libfutils
  • libh264
  • libpomp
  • libulog
  • libvideo-buffers
  • libvideo-streaming
  • (optional) x264
  • (optional) libvideo-buffers-generic (for x264 support)

Building

Building is activated by enabling libvideo-encode in the Alchemy build configuration.

Operation

Some encoders need the input buffers to originate from their own buffer pool; when the input buffer pool returned by the library is not NULL it must be used and input buffers cannot be shared with other video pipeline elements.

The encoding is asynchronous: the application pushes buffers to encode in the input queue and is notified of encoded frames through a callback function.

Threading model

The library is designed to run on a libpomp event loop (pomp_loop, see libpomp documentation). All API functions must be called from the pomp_loop thread. All callback functions (frame_output, flush or stop) are called from the pomp_loop thread.

Testing

The library can be tested using the provided venc command-line tool which takes as input a raw YUV file and can optionally output an encoded H.264 bitstream.

To build the tool, enable venc in the Alchemy build configuration.

For a list of available options, run

$ venc -h

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published