https://github.com/es-alexander/kaleidoscope
Apply a kaleidoscope effect to images and videos
https://github.com/es-alexander/kaleidoscope
Last synced: 9 months ago
JSON representation
Apply a kaleidoscope effect to images and videos
- Host: GitHub
- URL: https://github.com/es-alexander/kaleidoscope
- Owner: ES-Alexander
- License: mit
- Created: 2021-02-24T03:31:37.000Z (over 5 years ago)
- Default Branch: main
- Last Pushed: 2021-04-17T13:40:03.000Z (about 5 years ago)
- Last Synced: 2025-04-13T19:18:04.600Z (about 1 year ago)
- Language: Python
- Size: 6.17 MB
- Stars: 8
- Watchers: 1
- Forks: 4
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# kaleidoscope
A kaleidoscope effect for images and videos.
Implements a Python version of the functionality displayed in
[this GIMP tutorial](https://www.youtube.com/watch?v=C6Y9Yh4BM1Q), plus some extra
configurability.
Test image is taken from that tutorial video for comparison.
## Requirements
Functionality requires numpy for kaleidoscope creation, and opencv for display and
annotation
(can use `pip install -r requirements.txt`, `pip3` on Mac).
## Running
Run `kaleidoscope.py` as a command-line script (`-h` for help with parameters), or
import the `kaleido` function to your script and pass in an image and the relevant
parameters as desired.
## Example
Run `interactive.py` (`-h` for help with parameters), and modify the sliders to
change the kaleidoscope parameters. When not using the `-i` flag, click and drag
on the input image (left) to change the center position and angle of the kaleidoscope.
It's also possible to use the `-v` flag to run as a filter on a connected camera, with
`-f` to specify the camera ID (probably `0`). Requires
[pythonic-cv](https://github.com/ES-Alexander/pythonic-cv) to be installed.
### TODO
- Enable filter on video files (non-digit filenames)
- Enable recording video output (somehow deal with changing size)?