chalmers-revere / rec2csv-png

Tool to extract messages as .csv and h264/VP8/VP9 frames as separate .png files from a .rec file from OpenDLV

Moved to https://git.opendlv.org.

OpenDLV Microservice to convert a .rec file from OpenDLV into .csv and .png for h264 video frames

This repository provides source code to convert a .rec file from OpenDLV into .csv for the contained messages and .png for the contained h264 video frames 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.

Table of Contents

• Dependencies
• Building and Usage
• License

Dependencies

You need a C++14-compliant compiler to compile this project.

The following dependency is part of the source distribution:

• libcluon -
• lodePNG -

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
• libjpeg-turbo - IJG License/BSD 3-Clause/zlib

Building and Usage

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 use the following docker-compose.yml file to let Docker build this software for you:

version: '2'
services:
    rec2csv_png:
        build:
            context: https://github.com/chalmers-revere/rec2csv-png.git
            dockerfile: Dockerfile.amd64
        restart: on-failure
        volumes:
        - .:/opt/data
        working_dir: /opt/data
        command: "--rec=YourRecording.rec --odvd=YourMessageSpec.odvd"

When you built your Docker image named transcoder, you can also call it as follows:

docker run --rm -ti --init -v $PWD:/opt/data -w /opt/data transcoder --rec=YourRecording.rec --odvd=YourMessageSpec.odvd

The current folder . is shared into the Docker container to access the recording file YourRecording.rec and the message specification file YourMessageSpec.odvd.

License

• This project is released under the terms of the GNU GPLv3 License

rec2csv-png's Issues

Stride problem

Bug: https://github.com/chalmers-revere/rec2csv-png/blob/master/src/rec2csv%2Bpng.cpp#L254
Easy to see when breaking at 80. ;)