Moved to https://git.opendlv.org.
This repository provides source code to decode broadcasted video frames into a shared memory area for the OpenDLV software ecosystem.
OpenH264 Video Codec provided by Cisco Systems, Inc.
During the Docker-ized build process for this microservice, Cisco's binary library is downloaded from Cisco's webserver and installed on the user's computer due to legal implications arising from the patents around the AVC/h264 format.
End user's notice according to AVC/H.264 Patent Portfolio License Conditions: When you are using this software and build scripts from this repository, you are agreeing to and obeying the terms under which Cisco is making the binary library available.
You need a C++14-compliant compiler to compile this project.
The following dependency is part of the source distribution:
- libcluon -
The following dependencies are will be downloaded and installed during the Docker-ized build:
- openh264 -
- AVC/H.264 Patent Portfolio License Conditions
- libyuv -
- Google Patent License Conditions
Due to legal implications arising from the patents around the AVC/h264 format,
we cannot provide and distribute pre-built Docker images. Therefore, we provide
the build instructions in a Dockerfile
that can be easily integrated in a
docker-compose.yml
file.
To run this microservice using docker-compose
, you can simply add the following
section to your docker-compose.yml
file to let Docker build this software for you:
version: '2' # Must be present exactly once at the beginning of the docker-compose.yml file
services: # Must be present exactly once at the beginning of the docker-compose.yml file
video-h264-decoder-amd64:
build:
context: https://github.com/chalmers-revere/opendlv-video-h264-decoder.git#v0.0.5
dockerfile: Dockerfile.amd64
restart: on-failure
network_mode: "host"
ipc: "host"
volumes:
- /tmp:/tmp
environment:
- DISPLAY=${DISPLAY}
command: "--cid=111 --name=imageData"
As this microservice is connecting to an OD4Session to receive h264 frames to
decode them into a shared memory area using SysV IPC, the docker-compose.yml
file specifies the use of ipc:host
. The parameter network_mode: "host"
is
necessary to receive h264 frames broadcast from other microservices running
in an OD4Session
from OpenDLV. The folder /tmp
is shared into the Docker
container to provide tokens describing the shared memory area.
The parameters to the application are:
--cid=111
: Identifier of the OD4Session to listen for h264 frames--id=2
: Optional identifier to listen only for those h264 frames with the matching senderStamp of the OD4Session--name=XYZ
: Name of the shared memory area to create for storing the ARGB image data--verbose
: Display decoding information and render the image to screen (requires X11; runxhost +
to allow access to you X11 server)
- This project is released under the terms of the GNU GPLv3 License