Evaluating the Projector

From RidgeRun Developer Wiki



Previous: Getting Started Index Next: Getting Started/Getting the code







Requesting the Evaluation Binary

RidgeRun can provide you with an evaluation binary of the Projector to help you test it, in order to request an evaluation binary for a specific architecture, please contact us providing the following information:

  • Platform (i.e.: NVIDIA Jetson Orin, TX1/TX2, Xavier, Nano, or x86)
  • Jetpack version or Linux distribution version
  • The number of cameras to be used with the projector
  • Input resolutions and frame rates
  • Expected output resolution and frame rate
  • Latency requirements


Features of the Evaluation

The Projector evaluation version contains all the features of the plug-in, with with some limitations. Also, it is provided in binary form, so you won't have access to the source code.

The following table summarizes the features available in both the professional and evaluation version of the element.

Feature Professional Evaluation
GstRRPorjector Element Y Y
Unlimited Processing Time Y N (1)
Source Code Y N
Table 1. Features provided in the evaluation version

(1) The evaluation version will limit the processing to a maximum of 1800 frames.

Install and test the evaluation binaries

GstCUDA

If you already own a professional version of this plugin, skip to the projector element below.
To install the evaluation binaries follow the instructions found in the GstCuda Installation guide

RidgeRun Projector

Install Hotdoc
sudo -H pip3 install hotdoc
Once the requirement above is fulfilled, proceed with the installation of the tarball. RidgeRun should've provided you with the following compressed tar package/s:
gst-rr-projector-vX.Y.Z-gst-GV-P-T-eval.tar
Extract the contents of the file with the following command:
tar -xvf <path-to-evaluation-tar-file>
Execute the test environment configuration script:
cd gst-rr-projector-vX.Y.Z-gst-GV-P-T-eval
./configuration.sh
Clean the GStreamer registry
rm ~/.cache/gstreamer-1.0/*
Finally validate that the installation was successful with the following command, you should see the output for the evaluation binary.
 gst-inspect-1.0 | grep projector

Expected output:

rrprojector:  rrrectilineartoeqr: Rectilinear to Equirectangular
rrprojector:  rrfisheyetoeqr: FishEye to Equirectangular

How to use the Projector

Please refer to the Projector user guide to explore the process of calibration and using the projector. Refer to the Examples page for references pipelines.


Previous: Getting Started Index Next: Getting Started/Getting the code