View source for RidgeRun Image Projector/Getting Started/Building Image Projector

<noinclude>
{{RidgeRun_Image_Projector/Head|previous=Getting Started/Getting the code|next=User Guide|metakeywords=Image Stitching, CUDA, Stitcher, Projector, Equirectangular Projection, 360}}
</noinclude>

{{DISPLAYTITLE:Building Projector|noerror}}

== Dependencies ==

* GstCuda
* CudaStitcher
* Meson
* Hotdoc

=== GstCuda ===

To install GstCuda see the [[GstCUDA_-_Building_and_Installation_Guide|GstCUDA - Building and Installation Guide]].

=== CudaStitcher ===

To install CudaStitcher see the  [[Image_Stitching_for_NVIDIA_Jetson/Getting_Started/Building_Image_Stitching_for_NVIDIA_Jetson|Cuda Stitcher - Building and Installation Guide]].

=== Meson ===

The image projector makes use of the Meson build system. To correctly build this library you need to use version 0.60 of Meson: 

First, make sure Python dependencies and Ninja are installed.

<syntaxhighlight lang=bash>
sudo apt-get install python3 python3-pip python3-setuptools \
                       python3-wheel ninja-build
</syntaxhighlight>

Then use '''pip3''' to install '''Meson'''.

<syntaxhighlight lang=bash>
sudo -H pip3 install meson==0.60
</syntaxhighlight>

=== Hotdoc ===

<syntaxhighlight lang=bash>
sudo -H pip3 install hotdoc
</syntaxhighlight>

== Building the project ==

Once you have met the requirements, execute the following commands:

<syntaxhighlight lang=bash>
cd gst-rr-projector
meson setup --prefix=/usr build
ninja -C build
sudo ninja -C build install
</syntaxhighlight>

To verify that the plug-in was correctly installed, you should run: 

<syntaxhighlight lang=bash>
gst-inspect-1.0 rrprojector
</syntaxhighlight>

with expected output

<syntaxhighlight lang=bash>
Plugin Details:
  Name                     rrprojector
  Description              Image projection elments
  Filename                 /usr/lib/aarch64-linux-gnu/gstreamer-1.0/libgstrrprojector.so
  Version                  0.2.0
  License                  Proprietary
  Source module            gst-rr-projector
  Binary package           gst-rr-projector
  Origin URL               www.ridgerun.com

  rrfisheyetoeqr: FishEye to Equirectangular
  rrrectilineartoeqr: Rectilinear to Equirectangular

  2 features:
  +-- 2 elements

</syntaxhighlight>

<noinclude>
{{RidgeRun_Image_Projector/Foot|Getting Started/Getting the code|User Guide}}
</noinclude>