Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/aanastasiou/pywundercam
Python interface to the Wunder 360 S1 panoramic camera.
https://github.com/aanastasiou/pywundercam
image-acquisition panoramic-camera python-module python3
Last synced: 1 day ago
JSON representation
Python interface to the Wunder 360 S1 panoramic camera.
- Host: GitHub
- URL: https://github.com/aanastasiou/pywundercam
- Owner: aanastasiou
- License: other
- Created: 2019-09-13T00:42:02.000Z (over 5 years ago)
- Default Branch: main
- Last Pushed: 2022-12-08T05:21:47.000Z (about 2 years ago)
- Last Synced: 2024-12-19T06:15:50.899Z (4 days ago)
- Topics: image-acquisition, panoramic-camera, python-module, python3
- Language: Python
- Size: 158 KB
- Stars: 3
- Watchers: 2
- Forks: 0
- Open Issues: 7
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# PyWunderCam
`PyWunderCam` is a Python module that enables control of the Wunder 360 S1 panoramic camera from a Python program.
The camera is based on a Rockchip 1108 System on Chip (SoC) running Linux.
Within its operating system, it raises three services to serve images and video, control the camera and stream video
over a WiFi interface. In addition to these services, the camera presents itself as a standard webcam if connected
via USB.
At the time of writing, PyWunderCam interfaces with the first two services and enables functionality that is not
possible via the provided mobile phone application.
Streaming video and extended functionality are scheduled for upcoming releases.
## Installation
At the moment, installation is recommended directly from this repository with:
```
pip install git+https://github.com/aanastasiou/pywundercam
```
## Quickstart
```
from pywundercam import PyWunderCamAuto
camera_control = PyWunderCamAuto()
```
### Single 360 Shot
```
single_photo = camera_control.single_shot()
```
### Continuous (Burst) 360 Shot
```
photos = camera_control.continuous_shot()
```
### Altering the ISO, White Balance and Exposure Compensation Modes
Both of the above functions ( `.single_shot()`, `.continuous_shot()`) take optional parameters
`iso`, `white_balance_mode` and `exposure_compensation`. For more information on the values of
camera state parameters, please see `pywundercam.CamState`.
### Storing Images
To store the result of a single shot:
```
single_photo[0].save_to("MyImage.jpg")
```
To store the result of a continuous (burst) shot:
```
photos[0].save_to("./")
```
Worth noting at this point that:
1. In the case of a single image, all that is required is a filename. When saving
the result of a continuous (burst) shot, all that is required is a directory
in which all files belonging to the same shot will be stored.
2. Depending on file sizes and number of shots (in continuous mode), the file transfers
might appear to be inserting a small delay in the whole process.
### Displaying images
`pywundercam` makes use of the `pillow` module and returns images that are ready to be forwarded to
Python's ritch ecosystem of image processing modules. A quick way of displaying the image is to use `matplotlib`.
Continuing from the above example, to display the result of a single shot:
```
from matplotlib import pyplot as plt
plt.imshow(single_photo[0].get())
plt.axis("off")
plt.show()
```
And in the case of a continuous (burst) shot, a specific picture out of the set would have to be chosen first:
```
plt.imshow(photos[0].get())
plt.axis("off")
plt.show()
```
This concludes the quickstart guide which makes use of `PyWunderCamAuto`. Although this client allows you to take
pictures in single and continuous (burst) modes, the real power of `pywundercam` is in the underlying client object
`PyWunderCam` that allows finer control over the complete parameter set of the Wunder 360 S1.
You can now [browse the rest of the documentation](https://pywundercam.readthedocs.io/en/latest/) to learn more about exceptions, hardware, and the general design of PyWunderCam.