Birds Eye View - Quick Start Guide

This wiki will show you how to quickly get started with Birds Eye View. It will use the provided samples and calibration file to show a default scene.

Installing Dependencies

Run the following command to make sure all the dependencies are installed:

sudo apt update
sudo apt install -y \
  libjsoncpp-dev \
  libopencv-dev libopencv-core-dev \
  libopencv-video-dev libopencv-highgui-dev libopencv-videoio-dev \
  libgstreamer1.0-dev libgstreamer-plugins-base1.0-dev \
  gstreamer1.0-plugins-bad gstreamer1.0-plugins-good gstreamer1.0-plugins-base \
  gstreamer1.0-libav gstreamer1.0-plugins-ugly \
  qtbase5-dev qtmultimedia5-dev libqt5multimedia5-plugins \
  git wget unzip libcpputest-dev doxygen graphviz \
  python3-pip ninja-build
sudo -H pip3 install meson

Building the Project

Once you have dependencies installed, you can proceed to configure and build the project:

With CUDA acceleration

meson builddir
ninja -C builddir

Plain CPU

meson builddir -Dnpp=disabled
ninja -C builddir

Running the Sample

Once you've built the project, you can run the example with the provided sample images and calibration file.

cd samples && ./download_samples.sh && cd -
./builddir/examples/birds_eye_view -p examples/birds_eye_view.json

You should see the resulting image as below. Press ESC to stop the execution.

Quick start result — Resulting image after running the quick start guide

⇦ Getting Started/How to Get the Code

Home

User Guide/Building and Installation ⇨

❯