OpenGL Accelerated HTML Overlay: Getting Started - Building HTML Overlay
|
|
OpenGL Accelerated HTML Overlay |
---|
Basics |
Getting Started |
Library User Manual |
GStreamer |
Examples |
Performance |
Contact Us |
Dependencies
HTML Overlay has the following dependencies for building from source:
- GStreamer. Visit this webpage for more information: https://gstreamer.freedesktop.org/
- OpenGL. See more about OpenGL in this link: OpenGL
- GTK+. You can see more about GTK+ in this link: GTK+.
- Webkit2GTK+. You can see more about it in the following link: Webkit2GTK+
- GLEW
- EGL
In the following sections you can see how to install, in Debian-based systems, the dependencies mentioned before.
OpenGL
To install OpenGL, please use:
sudo apt install mesa-utils sudo apt-get install freeglut3
GTK+
To install GTK+,please use:
sudo apt-get install libgtk-3-dev
Webkit2GTK+
To install Webkit2GTK+, please use:
sudo apt-get install libwebkit2gtk-4.0-dev
GLEW
To install GLEW, please use:
sudo apt-get install libglew-dev
GLFW
To install GLFW, please use:
sudo apt-get install libglfw3 libglfw3-dev
GStreamer
In case you don't have GStreamer, please visit this webpage to see your specific installation guide. If you're in a Ubuntu or Debian you can run the following command:
apt-get install libgstreamer1.0-dev libgstreamer-plugins-base1.0-dev libgstreamer-plugins-bad1.0-dev gstreamer1.0-plugins-base gstreamer1.0-plugins-good gstreamer1.0-plugins-bad gstreamer1.0-plugins-ugly gstreamer1.0-libav gstreamer1.0-tools gstreamer1.0-x gstreamer1.0-alsa gstreamer1.0-gl gstreamer1.0-gtk3 gstreamer1.0-qt5 gstreamer1.0-pulseaudio
Documentation (optional)
For the documentation, consider the following dependency:
- doxygen
Please, install it using (in Debian-based systems):
sudo apt install -y \ doxygen \
Meson building system
At the building system level:
- ninja-build
- python3-pip
- pkg-config
- meson
Please, install them using (in Debian-based systems):
sudo apt install -y \ build-essential \ python3 \ python3-pip \ ninja-build \ meson \ pkg-config
The process should be similar in other systems, not based on Debian.
Building the project
Once fulfilled the dependencies, you can run a default compilation with:
meson setup build --optimization 3 --prefix /usr -Denable-docs=disabled -Ddeveloper-mode=false ninja -C build sudo ninja -C build install
For additional customization, you may refer to the following table of options:
Configure Option | Description |
---|---|
-Ddeveloper-mode=false | Disable developer mode. Enabled by default. |
-Denable-docs=disabled | Skip documentation generation. Enabled by default. |
-Denable-docs-only=enabled | Build documentation with Doxygen without compiling. Disabled by default. |
-Denable-gst=disabled | Skip building the GStreamer element. Enabled by default. |
-Denable-tests=disabled | Skip building tests. Enabled by default. |
-Denable-examples=disabled | Build examples |
-Dplatform=jetson | Select target platform as Jetson. x86 by default |
--prefix /usr | Set the installation path of the library. |
--optimization 3 | Set the optimization level to the maximum |
Examples
You can visit this section of the current wiki to check out some application examples.