Spherical Video PTZ/User Guide/Quick Start Guide: Difference between revisions
No edit summary |
mNo edit summary |
||
Line 2: | Line 2: | ||
{{Spherical Video PTZ/Head|previous=|next=|metakeywords=}} | {{Spherical Video PTZ/Head|previous=|next=|metakeywords=}} | ||
</noinclude> | </noinclude> | ||
=Libpanorama= | |||
==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. | 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 == | === Minimal Application === | ||
After [[Spherical Video PTZ/User Guide/Building and Installation|Building and Installation]], follow these steps: | After [[Spherical Video PTZ/User Guide/Building and Installation|Building and Installation]], follow these steps: | ||
Line 34: | Line 35: | ||
** Down: <code>2</code> | ** Down: <code>2</code> | ||
== Spherical Video PTZ Engine == | === Spherical Video PTZ Engine === | ||
''Description of how to use the engine'' | ''Description of how to use the engine'' | ||
=GstRrPanoramaptz= | ==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. | 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== | ===Overview=== | ||
===Features=== | ====Features==== | ||
* CUDA-accelerated PTZ transformations. | * CUDA-accelerated PTZ transformations. | ||
* Support for RGBA video format. | * Support for RGBA video format. | ||
* Dynamic parameter adjustments for pan, tilt, and zoom. | * Dynamic parameter adjustments for pan, tilt, and zoom. | ||
===Properties=== | ====Properties==== | ||
* Rotate the video on its horizontal axis. Range: -360 to 360 degrees. Default: 0. | * 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. | * Rotate the video on its vertical axis. Range: -360 to 360 degrees. Default: 0. | ||
* Dynamic parameter adjustments for pan, tilt, and zoom. ''WIP'' | * Dynamic parameter adjustments for pan, tilt, and zoom. ''WIP'' | ||
===Caps and Formats=== | ====Caps and Formats==== | ||
* Accepts and outputs video in video/x-raw format with RGBA color space. | * 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. | * Supports both system memory and NVMM memory inputs for enhanced performance on NVIDIA hardware. | ||
===Basic use example=== | ====Basic use example==== | ||
To pan a test video source 90 degrees, you can use the following pipeline: | To pan a test video source 90 degrees, you can use the following pipeline: | ||
<syntaxhighlight> | <syntaxhighlight> |
Revision as of 16:07, 22 March 2024
Spherical Video PTZ |
---|
Getting Started |
User Guide |
Examples |
Performance |
Contact Us |
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
- In:
- Pan Left/Right: Rotate the view horizontally to explore the left or right sides of the panoramic image.
- Left:
4
- Right:
6
- Left:
- Tilt Up/Down: Adjust the vertical angle of the camera to look up or down within the panoramic image.
- Up:
8
- Down:
2
- Up:
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