Evaluating the Projector
| RidgeRun Image Projector |
|---|
 |
| Image Projector Basics |
| Overview |
| Getting Started |
| User Guide |
| Examples |
| Performance |
|
Xavier
|
| 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.
| 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.