From e99b42d924ad276555df17c1d5c6e7331826b641 Mon Sep 17 00:00:00 2001 From: Julian Bouzas Date: Thu, 8 Aug 2024 10:01:24 -0400 Subject: [PATCH] lcevcdecoder: Add README.md Part-of: --- .../ext/lcevcdecoder/README.md | 48 +++++++++++++++++++ 1 file changed, 48 insertions(+) create mode 100644 subprojects/gst-plugins-bad/ext/lcevcdecoder/README.md diff --git a/subprojects/gst-plugins-bad/ext/lcevcdecoder/README.md b/subprojects/gst-plugins-bad/ext/lcevcdecoder/README.md new file mode 100644 index 0000000000..daecfd47e1 --- /dev/null +++ b/subprojects/gst-plugins-bad/ext/lcevcdecoder/README.md @@ -0,0 +1,48 @@ +LCEVC Decoder Build Instructions +-------------------------------- + +1. Build and install the V-Nova's LCEVC Decoder SDK (LCEVCdec): + +- Checkout the repository: https://github.com/v-novaltd/LCEVCdec + +``` +$ git clone https://github.com/v-novaltd/LCEVCdec.git +$ cd LCEVCdec +``` + +- Build and install the SDK +- $BUILD_DIR and $INSTALL_DIR are local build and install directories + +``` +$ mkdir $BUILD_DIR +$ cd $BUILD_DIR +$ cmake -G Ninja -DCMAKE_BUILD_TYPE=Release -DCMAKE_INSTALL_PREFIX=$INSTALL_DIR .. +$ cmake --build . +$ cmake --install . +``` + +2. Build LCEVC decoder (lcevcdecoder) plugin for GStreamer: + +- You can now build the lcevcdecoder plugin by using the '-Dgst-plugins-bad:lcevcdecoder=enabled' meson flag +- $BUILD_DIR and $INSTALL_DIR are local build and install directories +- For example: + +``` +$ cd GStreaner +$ meson setup $BUILD_DIR --pkg-config-path=$INSTALL_DIR/lib/pkgconfig -Dgst-plugins-bad:lcevcdecoder=enabled +$ ninja -C $BUILD_DIR +``` + +3. Run GStreamer LCEVC decoder pipeline: + +- If the build was successful, you can test LCEVC decoding with the following pipeline: + +``` +$ gst-launch-1.0 filesrc location=/home/user/lcevc-sample.mp4 ! qtdemux ! h264parse ! openh264dec ! lcevcdec ! videoconvert ! autovideosink +``` + +- LCEVC decoding should also work with autoplugging elements: + +``` +$ gst-launch-1.0 playbin uri=file:///home/user/lcevc-sample.mp4 +```