RidgeRun Image Projector/Getting Started/Evaluating the projector

RidgeRun Image Projector
Image Projector Basics
Overview
Getting Started
Evaluating the Projector Getting the code Building Image Projector
User Guide
Calibration Rrprojector
Examples
GStreamer Pipelines
Performance
Xavier Orin Nano
Contact Us

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 the exception that is limited to..... 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.

Table 1. Features provided in the evaluation version

Feature	Professional	Evaluation
GstRRPorjector Element	Y	Y
Unlimited Processing Time	Y	N (1)
Source Code	Y	N

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

The provided cuda-stitcher evaluation version should have the following structure:

gst-rr-projector-vX.Y.Z-gst-GV-P-T-eval/
├── configuration.sh
├── environment.sh
├── examples
│   ├── cudafilter_algorithms
│   │   ├── gray-scale-filter
│   │   │   └── gray-scale-filter.so
│   │   ├── median-filter
│   │   │   └── median-filter.so
│   │   ├── memcpy
│   │   │   └── memcpy.so
│   │   └── pinhole
│   │       └── pinhole.so
│   └── cudamux_algorithms
│       └── mixer
│           └── mixer.so
├── include
│   ├── gstreamer-1.0
│   │   ├── gst
│   │   │   └── stitcher
│   │   │       └── gststitchermaskmeta.h
│   │   └── sys
│   │       └── gstrrbaseprojector.h
│   └── rr
│       └── stitcher
│           ├── eval.h
│           ├── homography_preprocessor.h
│           ├── iblender.h
│           ├── icombiner.h
│           ├── ihomography.h
│           ├── image_geometry_utils.h
│           ├── matrix.h
│           ├── matrix_utils.h
│           ├── ocvcuda
│           │   ├── blender.h
│           │   └── homography.h
│           ├── rgba.h
│           ├── runtime_error.h
│           └── transformation_node.h
├── lib
│   └── aarch64-linux-gnu
│       ├── cmake
│       │   └── opencv4
│       │       ├── OpenCVConfig.cmake
│       │       ├── OpenCVConfig-version.cmake
│       │       ├── OpenCVModules.cmake
│       │       └── OpenCVModules-release.cmake
│       ├── gstreamer-1.0
│       │   ├── libgstcuda.a
│       │   ├── libgstcudaexamplefilter.a
│       │   ├── libgstcudaexamplefilter.la
│       │   ├── libgstcudaexamplefilter.so
│       │   ├── libgstcuda.la
│       │   ├── libgstcuda.so
│       │   ├── libgstcudastitcher.so
│       │   ├── libgstopencvfilter.a
│       │   ├── libgstopencvfilter.la
│       │   ├── libgstopencvfilter.so
│       │   ├── libgstopencvremap.a
│       │   ├── libgstopencvremap.la
│       │   ├── libgstopencvremap.so
│       │   ├── libgstopencvsharpen.a
│       │   ├── libgstopencvsharpen.la
│       │   ├── libgstopencvsharpen.so
│       │   ├── libgstopencvwarp.a
│       │   ├── libgstopencvwarp.la
│       │   ├── libgstopencvwarp.so
│       │   └── libgstrrprojector.so
│       ├── libgstcuda-1.0.a
│       ├── libgstcuda-1.0.la
│       ├── libgstcuda-1.0.so -> libgstcuda-1.0.so.0.100.0
│       ├── libgstcuda-1.0.so.0 -> libgstcuda-1.0.so.0.100.0
│       ├── libgstcuda-1.0.so.0.100.0
│       ├── libgstrrprojector-1.0.so -> libgstrrprojector-1.0.so.1
│       ├── libgstrrprojector-1.0.so.1 -> libgstrrprojector-1.0.so.1.0
│       ├── libgstrrprojector-1.0.so.1.0
│       ├── libgststitcherhelper-1.0.so -> libgststitcherhelper-1.0.so.0
│       ├── libgststitcherhelper-1.0.so.0 -> libgststitcherhelper-1.0.so.0.0.0
│       ├── libgststitcherhelper-1.0.so.0.0.0
│       ├── libopencv_alphamat.so -> libopencv_alphamat.so.4.4
│       ├── libopencv_alphamat.so.4.4 -> libopencv_alphamat.so.4.4.0
│       ├── libopencv_alphamat.so.4.4.0
│       ├── libopencv_aruco.so -> libopencv_aruco.so.4.4
│       ├── libopencv_aruco.so.4.4 -> libopencv_aruco.so.4.4.0
│       ├── libopencv_aruco.so.4.4.0
│       ├── libopencv_bgsegm.so -> libopencv_bgsegm.so.4.4
│       ├── libopencv_bgsegm.so.4.4 -> libopencv_bgsegm.so.4.4.0
│       ├── libopencv_bgsegm.so.4.4.0
│       ├── libopencv_bioinspired.so -> libopencv_bioinspired.so.4.4
│       ├── libopencv_bioinspired.so.4.4 -> libopencv_bioinspired.so.4.4.0
│       ├── libopencv_bioinspired.so.4.4.0
│       ├── libopencv_calib3d.so -> libopencv_calib3d.so.4.4
│       ├── libopencv_calib3d.so.4.4 -> libopencv_calib3d.so.4.4.0
│       ├── libopencv_calib3d.so.4.4.0
│       ├── libopencv_ccalib.so -> libopencv_ccalib.so.4.4
│       ├── libopencv_ccalib.so.4.4 -> libopencv_ccalib.so.4.4.0
│       ├── libopencv_ccalib.so.4.4.0
│       ├── libopencv_core.so -> libopencv_core.so.4.4
│       ├── libopencv_core.so.4.4 -> libopencv_core.so.4.4.0
│       ├── libopencv_core.so.4.4.0
│       ├── libopencv_cudaarithm.so -> libopencv_cudaarithm.so.4.4
│       ├── libopencv_cudaarithm.so.4.4 -> libopencv_cudaarithm.so.4.4.0
│       ├── libopencv_cudaarithm.so.4.4.0
│       ├── libopencv_cudabgsegm.so -> libopencv_cudabgsegm.so.4.4
│       ├── libopencv_cudabgsegm.so.4.4 -> libopencv_cudabgsegm.so.4.4.0
│       ├── libopencv_cudabgsegm.so.4.4.0
│       ├── libopencv_cudacodec.so -> libopencv_cudacodec.so.4.4
│       ├── libopencv_cudacodec.so.4.4 -> libopencv_cudacodec.so.4.4.0
│       ├── libopencv_cudacodec.so.4.4.0
│       ├── libopencv_cudafeatures2d.so -> libopencv_cudafeatures2d.so.4.4
│       ├── libopencv_cudafeatures2d.so.4.4 -> libopencv_cudafeatures2d.so.4.4.0
│       ├── libopencv_cudafeatures2d.so.4.4.0
│       ├── libopencv_cudafilters.so -> libopencv_cudafilters.so.4.4
│       ├── libopencv_cudafilters.so.4.4 -> libopencv_cudafilters.so.4.4.0
│       ├── libopencv_cudafilters.so.4.4.0
│       ├── libopencv_cudaimgproc.so -> libopencv_cudaimgproc.so.4.4
│       ├── libopencv_cudaimgproc.so.4.4 -> libopencv_cudaimgproc.so.4.4.0
│       ├── libopencv_cudaimgproc.so.4.4.0
│       ├── libopencv_cudalegacy.so -> libopencv_cudalegacy.so.4.4
│       ├── libopencv_cudalegacy.so.4.4 -> libopencv_cudalegacy.so.4.4.0
│       ├── libopencv_cudalegacy.so.4.4.0
│       ├── libopencv_cudaobjdetect.so -> libopencv_cudaobjdetect.so.4.4
│       ├── libopencv_cudaobjdetect.so.4.4 -> libopencv_cudaobjdetect.so.4.4.0
│       ├── libopencv_cudaobjdetect.so.4.4.0
│       ├── libopencv_cudaoptflow.so -> libopencv_cudaoptflow.so.4.4
│       ├── libopencv_cudaoptflow.so.4.4 -> libopencv_cudaoptflow.so.4.4.0
│       ├── libopencv_cudaoptflow.so.4.4.0
│       ├── libopencv_cudastereo.so -> libopencv_cudastereo.so.4.4
│       ├── libopencv_cudastereo.so.4.4 -> libopencv_cudastereo.so.4.4.0
│       ├── libopencv_cudastereo.so.4.4.0
│       ├── libopencv_cudawarping.so -> libopencv_cudawarping.so.4.4
│       ├── libopencv_cudawarping.so.4.4 -> libopencv_cudawarping.so.4.4.0
│       ├── libopencv_cudawarping.so.4.4.0
│       ├── libopencv_cudev.so -> libopencv_cudev.so.4.4
│       ├── libopencv_cudev.so.4.4 -> libopencv_cudev.so.4.4.0
│       ├── libopencv_cudev.so.4.4.0
│       ├── libopencv_datasets.so -> libopencv_datasets.so.4.4
│       ├── libopencv_datasets.so.4.4 -> libopencv_datasets.so.4.4.0
│       ├── libopencv_datasets.so.4.4.0
│       ├── libopencv_dnn_objdetect.so -> libopencv_dnn_objdetect.so.4.4
│       ├── libopencv_dnn_objdetect.so.4.4 -> libopencv_dnn_objdetect.so.4.4.0
│       ├── libopencv_dnn_objdetect.so.4.4.0
│       ├── libopencv_dnn.so -> libopencv_dnn.so.4.4
│       ├── libopencv_dnn.so.4.4 -> libopencv_dnn.so.4.4.0
│       ├── libopencv_dnn.so.4.4.0
│       ├── libopencv_dnn_superres.so -> libopencv_dnn_superres.so.4.4
│       ├── libopencv_dnn_superres.so.4.4 -> libopencv_dnn_superres.so.4.4.0
│       ├── libopencv_dnn_superres.so.4.4.0
│       ├── libopencv_dpm.so -> libopencv_dpm.so.4.4
│       ├── libopencv_dpm.so.4.4 -> libopencv_dpm.so.4.4.0
│       ├── libopencv_dpm.so.4.4.0
│       ├── libopencv_face.so -> libopencv_face.so.4.4
│       ├── libopencv_face.so.4.4 -> libopencv_face.so.4.4.0
│       ├── libopencv_face.so.4.4.0
│       ├── libopencv_features2d.so -> libopencv_features2d.so.4.4
│       ├── libopencv_features2d.so.4.4 -> libopencv_features2d.so.4.4.0
│       ├── libopencv_features2d.so.4.4.0
│       ├── libopencv_flann.so -> libopencv_flann.so.4.4
│       ├── libopencv_flann.so.4.4 -> libopencv_flann.so.4.4.0
│       ├── libopencv_flann.so.4.4.0
│       ├── libopencv_freetype.so -> libopencv_freetype.so.4.4
│       ├── libopencv_freetype.so.4.4 -> libopencv_freetype.so.4.4.0
│       ├── libopencv_freetype.so.4.4.0
│       ├── libopencv_fuzzy.so -> libopencv_fuzzy.so.4.4
│       ├── libopencv_fuzzy.so.4.4 -> libopencv_fuzzy.so.4.4.0
│       ├── libopencv_fuzzy.so.4.4.0
│       ├── libopencv_gapi.so -> libopencv_gapi.so.4.4
│       ├── libopencv_gapi.so.4.4 -> libopencv_gapi.so.4.4.0
│       ├── libopencv_gapi.so.4.4.0
│       ├── libopencv_hfs.so -> libopencv_hfs.so.4.4
│       ├── libopencv_hfs.so.4.4 -> libopencv_hfs.so.4.4.0
│       ├── libopencv_hfs.so.4.4.0
│       ├── libopencv_highgui.so -> libopencv_highgui.so.4.4
│       ├── libopencv_highgui.so.4.4 -> libopencv_highgui.so.4.4.0
│       ├── libopencv_highgui.so.4.4.0
│       ├── libopencv_imgcodecs.so -> libopencv_imgcodecs.so.4.4
│       ├── libopencv_imgcodecs.so.4.4 -> libopencv_imgcodecs.so.4.4.0
│       ├── libopencv_imgcodecs.so.4.4.0
│       ├── libopencv_img_hash.so -> libopencv_img_hash.so.4.4
│       ├── libopencv_img_hash.so.4.4 -> libopencv_img_hash.so.4.4.0
│       ├── libopencv_img_hash.so.4.4.0
│       ├── libopencv_imgproc.so -> libopencv_imgproc.so.4.4
│       ├── libopencv_imgproc.so.4.4 -> libopencv_imgproc.so.4.4.0
│       ├── libopencv_imgproc.so.4.4.0
│       ├── libopencv_intensity_transform.so -> libopencv_intensity_transform.so.4.4
│       ├── libopencv_intensity_transform.so.4.4 -> libopencv_intensity_transform.so.4.4.0
│       ├── libopencv_intensity_transform.so.4.4.0
│       ├── libopencv_line_descriptor.so -> libopencv_line_descriptor.so.4.4
│       ├── libopencv_line_descriptor.so.4.4 -> libopencv_line_descriptor.so.4.4.0
│       ├── libopencv_line_descriptor.so.4.4.0
│       ├── libopencv_mcc.so -> libopencv_mcc.so.4.4
│       ├── libopencv_mcc.so.4.4 -> libopencv_mcc.so.4.4.0
│       ├── libopencv_mcc.so.4.4.0
│       ├── libopencv_ml.so -> libopencv_ml.so.4.4
│       ├── libopencv_ml.so.4.4 -> libopencv_ml.so.4.4.0
│       ├── libopencv_ml.so.4.4.0
│       ├── libopencv_objdetect.so -> libopencv_objdetect.so.4.4
│       ├── libopencv_objdetect.so.4.4 -> libopencv_objdetect.so.4.4.0
│       ├── libopencv_objdetect.so.4.4.0
│       ├── libopencv_optflow.so -> libopencv_optflow.so.4.4
│       ├── libopencv_optflow.so.4.4 -> libopencv_optflow.so.4.4.0
│       ├── libopencv_optflow.so.4.4.0
│       ├── libopencv_phase_unwrapping.so -> libopencv_phase_unwrapping.so.4.4
│       ├── libopencv_phase_unwrapping.so.4.4 -> libopencv_phase_unwrapping.so.4.4.0
│       ├── libopencv_phase_unwrapping.so.4.4.0
│       ├── libopencv_photo.so -> libopencv_photo.so.4.4
│       ├── libopencv_photo.so.4.4 -> libopencv_photo.so.4.4.0
│       ├── libopencv_photo.so.4.4.0
│       ├── libopencv_plot.so -> libopencv_plot.so.4.4
│       ├── libopencv_plot.so.4.4 -> libopencv_plot.so.4.4.0
│       ├── libopencv_plot.so.4.4.0
│       ├── libopencv_quality.so -> libopencv_quality.so.4.4
│       ├── libopencv_quality.so.4.4 -> libopencv_quality.so.4.4.0
│       ├── libopencv_quality.so.4.4.0
│       ├── libopencv_rapid.so -> libopencv_rapid.so.4.4
│       ├── libopencv_rapid.so.4.4 -> libopencv_rapid.so.4.4.0
│       ├── libopencv_rapid.so.4.4.0
│       ├── libopencv_reg.so -> libopencv_reg.so.4.4
│       ├── libopencv_reg.so.4.4 -> libopencv_reg.so.4.4.0
│       ├── libopencv_reg.so.4.4.0
│       ├── libopencv_rgbd.so -> libopencv_rgbd.so.4.4
│       ├── libopencv_rgbd.so.4.4 -> libopencv_rgbd.so.4.4.0
│       ├── libopencv_rgbd.so.4.4.0
│       ├── libopencv_saliency.so -> libopencv_saliency.so.4.4
│       ├── libopencv_saliency.so.4.4 -> libopencv_saliency.so.4.4.0
│       ├── libopencv_saliency.so.4.4.0
│       ├── libopencv_shape.so -> libopencv_shape.so.4.4
│       ├── libopencv_shape.so.4.4 -> libopencv_shape.so.4.4.0
│       ├── libopencv_shape.so.4.4.0
│       ├── libopencv_stereo.so -> libopencv_stereo.so.4.4
│       ├── libopencv_stereo.so.4.4 -> libopencv_stereo.so.4.4.0
│       ├── libopencv_stereo.so.4.4.0
│       ├── libopencv_stitching.so -> libopencv_stitching.so.4.4
│       ├── libopencv_stitching.so.4.4 -> libopencv_stitching.so.4.4.0
│       ├── libopencv_stitching.so.4.4.0
│       ├── libopencv_structured_light.so -> libopencv_structured_light.so.4.4
│       ├── libopencv_structured_light.so.4.4 -> libopencv_structured_light.so.4.4.0
│       ├── libopencv_structured_light.so.4.4.0
│       ├── libopencv_superres.so -> libopencv_superres.so.4.4
│       ├── libopencv_superres.so.4.4 -> libopencv_superres.so.4.4.0
│       ├── libopencv_superres.so.4.4.0
│       ├── libopencv_surface_matching.so -> libopencv_surface_matching.so.4.4
│       ├── libopencv_surface_matching.so.4.4 -> libopencv_surface_matching.so.4.4.0
│       ├── libopencv_surface_matching.so.4.4.0
│       ├── libopencv_text.so -> libopencv_text.so.4.4
│       ├── libopencv_text.so.4.4 -> libopencv_text.so.4.4.0
│       ├── libopencv_text.so.4.4.0
│       ├── libopencv_tracking.so -> libopencv_tracking.so.4.4
│       ├── libopencv_tracking.so.4.4 -> libopencv_tracking.so.4.4.0
│       ├── libopencv_tracking.so.4.4.0
│       ├── libopencv_videoio.so -> libopencv_videoio.so.4.4
│       ├── libopencv_videoio.so.4.4 -> libopencv_videoio.so.4.4.0
│       ├── libopencv_videoio.so.4.4.0
│       ├── libopencv_video.so -> libopencv_video.so.4.4
│       ├── libopencv_video.so.4.4 -> libopencv_video.so.4.4.0
│       ├── libopencv_video.so.4.4.0
│       ├── libopencv_videostab.so -> libopencv_videostab.so.4.4
│       ├── libopencv_videostab.so.4.4 -> libopencv_videostab.so.4.4.0
│       ├── libopencv_videostab.so.4.4.0
│       ├── libopencv_xfeatures2d.so -> libopencv_xfeatures2d.so.4.4
│       ├── libopencv_xfeatures2d.so.4.4 -> libopencv_xfeatures2d.so.4.4.0
│       ├── libopencv_xfeatures2d.so.4.4.0
│       ├── libopencv_ximgproc.so -> libopencv_ximgproc.so.4.4
│       ├── libopencv_ximgproc.so.4.4 -> libopencv_ximgproc.so.4.4.0
│       ├── libopencv_ximgproc.so.4.4.0
│       ├── libopencv_xobjdetect.so -> libopencv_xobjdetect.so.4.4
│       ├── libopencv_xobjdetect.so.4.4 -> libopencv_xobjdetect.so.4.4.0
│       ├── libopencv_xobjdetect.so.4.4.0
│       ├── libopencv_xphoto.so -> libopencv_xphoto.so.4.4
│       ├── libopencv_xphoto.so.4.4 -> libopencv_xphoto.so.4.4.0
│       ├── libopencv_xphoto.so.4.4.0
│       ├── librrstitcher-1.0.0.so -> librrstitcher-1.0.0.so.1
│       ├── librrstitcher-1.0.0.so.1 -> librrstitcher-1.0.0.so.1.0.0
│       ├── librrstitcher-1.0.0.so.1.0.0
│       └── pkgconfig
│           ├── gst-cuda-1.0.pc
│           ├── gstrrprojector-1.0.pc
│           ├── gststitcherhelper-1.0.pc
│           ├── opencv4.pc
│           └── rrstitcher-1.0.0.pc
└── README

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 inspect output for the evaluation binary.

gst-inspect-1.0 rreqrprojector

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.