PDrAW works as a standalone program & library for Linux (tested on Ubuntu 20.04) and macOS (tested on macOS 11.6 Big Sur)
You need to install the following packages:
$ apt install curl git python3 zlib1g-dev libglfw3-dev libsdl2-dev cmake qtbase5-dev build-essential
repo as a tool for downloading and updating the workspace. The tool
might be available from your OS package manager (which is the preferred way of
installing it), but is notoriously absent from Ubuntu 20.04.
To install it on Ubuntu 20.04 :
# ~/bin/ can be replaced by any directory on your PATH $ curl https://storage.googleapis.com/git-repo-downloads/repo > ~/bin/repo $ chmod a+x ~/bin/repo $ sed -i.bak -e 's;#!/usr/bin/env python$;#!/usr/bin/env python3;' ~/bin/repo
We use the homebrew package manager to install packages under macOS. If you use another package manager, you will need to install the required packages manually.
We also require the Xcode command line tools, which should be automatically installed by homebrew.
# Install homebrew first $ brew install repo pkg-config glfw3 sdl2 cmake
Clone the GroundSDK Tools workspace#
PDrAW is part of Parrot’s GroundSDK Tools workspace, so you need to clone
that workspace, using the
# Assuming you want to put the code in $HOME/code/groundsdk-tools $ mkdir -p $HOME/code/groundsdk-tools $ cd $HOME/code/groundsdk-tools $ repo init -u https://github.com/Parrot-Developers/groundsdk-tools-manifest $ repo sync
After the initial clone, only the
repo sync command will be needed to
update your workspace to the latest GroundSDK Tools version.
After each update, the GroundSDK Tools project needs to be rebuilt with the following command:
# Run from the workspace root directory $ ./build.sh -p groundsdk-linux -t build -j/1
For macOS users, replace the following parts of example command lines:
This commands builds both the pdraw and vmeta-extract executables, and all the required libraries required to use PDrAW from your own project.
In order to run the built binaries, you need to use a wrapper script provided
# Run from the workspace root directory $ ./out/groundsdk-linux/staging/native-wrapper.sh pdraw --help