OpenGL Accelerated HTML Overlay/Getting Started/Building HTML Overlay: Difference between revisions

From RidgeRun Developer Wiki
Line 91: Line 91:


<syntaxhighlight lang=bash>
<syntaxhighlight lang=bash>
meson build --optimization 3 --prefix /usr -Denable-docs=disabled -Ddeveloper-mode=false
meson setup build --optimization 3 --prefix /usr -Denable-docs=disabled -Ddeveloper-mode=false
ninja -C build
ninja -C build
sudo ninja -C build install
sudo ninja -C build install
Line 110: Line 110:
| -Denable-docs-only=enabled || Build documentation with Doxygen without compiling. Disabled by default.   
| -Denable-docs-only=enabled || Build documentation with Doxygen without compiling. Disabled by default.   
|-
|-
| -Denable-gst=disabled || Skip building for GStreamer elements. Enabled by default.
| -Denable-gst=disabled || Skip building the GStreamer element. Enabled by default.
|-
|-
| -Denable-tests=disabled || Skip building tests. Enabled by default.
| -Denable-tests=disabled || Skip building tests. Enabled by default.
Line 116: Line 116:
| -Denable-examples=disabled || Build examples
| -Denable-examples=disabled || Build examples
|-
|-
| -Dplatform=jetson || Select target paltform as Jetson. x86 by default
| -Dplatform=jetson || Select target platform as Jetson. x86 by default
|-
|-
| --prefix /usr || Set the installation path of the library.  
| --prefix /usr || Set the installation path of the library.  

Revision as of 23:04, 29 June 2023



Previous: Getting_Started/Getting_the_Code Index Next: Library_User_Manual




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)



Previous: Getting_Started/Getting_the_Code Index Next: Library_User_Manual