Skip to content
This repository has been archived by the owner on Apr 2, 2024. It is now read-only.
/ argb2i420 Public archive

Microservice to convert an image in shared memory in (A)RGB layout to an image in shared memory in i420 format suitable to be used for video compression.

License

Notifications You must be signed in to change notification settings

chalmers-revere/argb2i420

Repository files navigation

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

Microservice to transform an input image in (A)RGB/(A)BGR format to I420

This repository provides source code to transform an input image in (A)RGB/(A)BGR format residing in a shared memory to an image in I420 residing in a new shared memory suitable for subsequent video compression.

License: GPLv3

Table of Contents

Dependencies

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

The following dependency is part of the source distribution:

The following dependency is downloaded and installed during the Docker-ized build:

Usage

To run this microservice using docker-compose, you can simply add the following section to your docker-compose.yml:

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
    argb2i420:
        image: chalmersrevere/argb2i420-multi:v0.0.1
        restart: on-failure
        ipc: "host"
        volumes:
        - /tmp:/tmp
        environment:
        - DISPLAY=${DISPLAY}
        command: "--in=img.argb --width=640 --height=480 --argb --out=imgout.i420"

As this microservice is connecting to an existing shared memory to read the (A)RGB/(A)BGR image for transform it into a new shared memory area using SysV IPC, the docker-compose.yml file specifies the use of ipc:host. The folder /tmp is shared into the Docker container to provide tokens describing the shared memory areas. The parameters to the application are:

  • --in: Name of the shared memory area containing the (A)RBG/(A)BGR image
  • --out: Name of the shared memory area to be created for the I420 image
  • --width: Width of the input image
  • --height: Height of the input image
  • --argb: Format of the input image (choose exactly one!)
  • --rgb: Format of the input image (choose exactly one!)
  • --abgr: Format of the input image (choose exactly one!)
  • --bgr: Format of the input image (choose exactly one!)
  • --verbose: Display decoding information and render the image to screen (requires X11; run xhost + to allow access to you X11 server)

Build from sources on the example of Ubuntu 16.04 LTS

To build this software, you need cmake, C++14 or newer, libyuv, libvpx, and make. Having these preconditions, just run cmake and make as follows:

mkdir build && cd build
cmake -D CMAKE_BUILD_TYPE=Release ..
make && make test && make install

License

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

About

Microservice to convert an image in shared memory in (A)RGB layout to an image in shared memory in i420 format suitable to be used for video compression.

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published