OpenGL Accelerated HTML Overlay/Getting Started/Building HTML Overlay

OpenGL Accelerated HTML Overlay
Basics
Getting Started
Evaluating HTML Overlay Getting the Code Building HTML Overlay Platform-Specific Details
Library User Manual
GStreamer
GstHTMLOverlay
Examples
Library Usage GStreamer Usage
Performance
NVIDIA Jetson x86 NXP i.MX 8
Contact Us

Dependencies

HTML Overlay has the following dependencies for building from source:

• 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

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    \
     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

Table 1. HTML Overlay configuration options (Meson)

Examples

You can visit this section of the current wiki to check out some application examples.