Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/ahgsql/panorama-virtual-cam-ptz

Transform equirectangular images into live perspective camera feeds! Panorama Virtual Cam PTZ is a Python application that converts panoramic images and streams them as a virtual camera with Pan-Tilt-Zoom (PTZ) control. Ideal for virtual reality experiences and creative video projects. 📷🌐🚀
https://github.com/ahgsql/panorama-virtual-cam-ptz

equirectangular-panorama panoramic-images virtual-camera

Last synced: about 23 hours ago
JSON representation

Transform equirectangular images into live perspective camera feeds! Panorama Virtual Cam PTZ is a Python application that converts panoramic images and streams them as a virtual camera with Pan-Tilt-Zoom (PTZ) control. Ideal for virtual reality experiences and creative video projects. 📷🌐🚀

Awesome Lists containing this project

README 

        
# Panorama Virtual Cam with PTZ



PVCP is Python based application that allows you to load an equirectangular image, convert it to a perspective image, and push this image into a live virtual camera driver using UnityCapture. It also provides a web interface powered by Flask to control the camera's angle and zoom.



## Project Goal



The goal of this project is to enable users to transform equirectangular images into perspective images and stream them as a virtual camera feed. This can be useful for various applications, including virtual reality experiences or projects that rely on ptz cameras.



I need this kind of virtual camera for my fire-dedection system.



## Mechanism



![](example-lowres.jpg)



1.  **Image Conversion**: The application loads an equirectangular image (specified in the `fileToOpen` variable) and converts it into a perspective image using the `py360convert` library.

2.  **Virtual Camera**: It utilizes the `pyvirtualcam` library to create a virtual camera with specified dimensions (width, height, fps) and sends the converted perspective image to this virtual camera.

3.  **Web Interface**: The application provides a Flask-based web interface to control the camera's horizontal and vertical angles as well as zoom. It listens on specified routes to adjust these parameters.



## Flask Routes



- **Root Route ("/")**:



  - Description: This route serves as a basic indicator that the server is running.

  - Usage: Visit this route to check if the server is operational.



- **Horizontal Camera Movement ("/move-x/angle")**:



  - Description: Adjusts the horizontal angle of the virtual camera.

  - Usage: Access this route with a specified angle to move the camera horizontally.

  - http://127.0.0.1:5000/move-x/4



- **Vertical Camera Movement ("/move-y/angle")**:

  - Description: Adjusts the vertical angle of the virtual camera.

  - Usage: Access this route with a specified angle to move the camera vertically.

  - http://127.0.0.1:5000/move-y/-2

- **Zoom Control ("/zoom/zoomAmount")**:

  - Description: Changes the zoom level of the virtual camera.

  - Usage: Access this route with a specified zoom amount to control the camera's zoom.

  - http://127.0.0.1:5000/zoom/1.3



## PTZ (Pan-Tilt-Zoom) Feature



- **Pan (Horizontal Angle)**: You can adjust the horizontal angle of the virtual camera using the `/move-x/` route.

- **Tilt (Vertical Angle)**: You can adjust the vertical angle of the virtual camera using the `/move-y/` route.

- **Zoom**: You can control the zoom level of the virtual camera using the `/zoom/` route.

  ![](usage.gif)



## Usage



1. Install Unity Capture

   Visit https://github.com/schellingb/UnityCapture#installation for more information

2. Clone this repository



   `git clone https://github.com/yourusername/panorama-virtual-cam-ptz.git`



3. Install the required dependencies:



   `pip install -r requirements.txt`



4. Run the application:



   `flask run`



5. Access the web interface to control the virtual camera.