Libpanorama

This wiki introduces a basic use of Spherical Video PTZ for converting equirectangular images to rectilinear format with an engine. It includes a simple example and instructions on how to use the engine for different needs. The engine makes it easy to change panoramic images into a straight view, useful for many projects.

Minimal Application

After Building and Installation, follow these steps:

1. Download the sample images, if you haven't already.

cd $SAMPLES
./download_samples.sh

2. This example demonstrates the use of the Spherical Video PTZ engine to convert equirectangular images into rectilinear format. This command processes example_image.jpg, converting it from an equirectangular format to a rectilinear view. But you can use any other reference image as long as it is equirectangular. Run the example as:

cd $LIBPANORAMA_PATH
./builddir/examples/equirectangular_to_rectilinear_npp $SAMPLES/example_image.jpg

3. For this example you can use the interactive controls with the Spherical Video PTZ (Pan-Tilt-Zoom) for dynamic exploration of panoramic images. Hit the specified keys when the example is running:

Zoom In/Out: Adjust the zoom level to get a closer view or a wider perspective of the image.
- In: i
- Out: o
Pan Left/Right: Rotate the view horizontally to explore the left or right sides of the panoramic image.
- Left: 4
- Right: 6
Tilt Up/Down: Adjust the vertical angle of the camera to look up or down within the panoramic image.
- Up: 8
- Down: 2

Spherical Video PTZ Engine

Description of how to use the engine

GstRrPanoramaptz

The GstRrPanoramaptz plugin allows for real-time PTZ adjustments on panoramic video feeds, enabling users to explore video scenes in greater detail or from different perspectives.

Overview

Features

CUDA-accelerated PTZ transformations.
Support for RGBA video format.
Dynamic parameter adjustments for pan, tilt, and zoom.

Properties

Rotate the video on its horizontal axis. Range: -360 to 360 degrees. Default: 0.
Rotate the video on its vertical axis. Range: -360 to 360 degrees. Default: 0.
Dynamic parameter adjustments for pan, tilt, and zoom. WIP

Caps and Formats

Accepts and outputs video in video/x-raw format with RGBA color space.
Supports both system memory and NVMM memory inputs for enhanced performance on NVIDIA hardware.

Basic use example

To pan a test video source 90 degrees, you can use the following pipeline:

gst-launch-1.0 videotestsrc ! rrpanoramaptz pan=90 ! fakesink

Index