Simple GUI-based correction of fisheye images. The correction parameters specified on the screen can be diverted to opencv's fisheye correction parameters.
Project description
simple_fisheye_calibrator
Simple GUI-based correction of fisheye images. The correction parameters specified on the screen can be diverted to opencv's fisheye correction parameters. Supports execution via Docker.
- Fisheye image before calibration
- (Sample) Fisheye image after calibration
1. Install
1-1. Launching with Docker (with USB Camera / HostPC GUI, Docker Image size: 1.4GB)
- simple_capture
xhost +local: && \
docker run -it --rm \
-v `pwd`:/home/user/workdir \
-v /tmp/.X11-unix/:/tmp/.X11-unix:rw \
--device /dev/video0:/dev/video0:mwr \
--net=host \
-e XDG_RUNTIME_DIR=$XDG_RUNTIME_DIR \
-e DISPLAY=$DISPLAY \
--privileged \
pinto0309/simple_fisheye_calibrator:0.0.10 \
/bin/bash -c 'sudo simple_capture'
# 1. Capture one test image from the USB camera with "c" on the keyboard
# 2. Exit the capture application with "q" on the keyboard
- simple_fisheye_calibrator
# Still image
xhost +local: && \
docker run -it --rm \
-v `pwd`:/home/user/workdir \
-v /tmp/.X11-unix/:/tmp/.X11-unix:rw \
--device /dev/video0:/dev/video0:mwr \
--net=host \
-e XDG_RUNTIME_DIR=$XDG_RUNTIME_DIR \
-e DISPLAY=$DISPLAY \
--privileged \
pinto0309/simple_fisheye_calibrator:0.0.10 \
simple_fisheye_calibrator --file_path fisheye_test.jpg
or
# USB Camera: video0
xhost +local: && \
docker run -it --rm \
-v `pwd`:/home/user/workdir \
-v /tmp/.X11-unix/:/tmp/.X11-unix:rw \
--device /dev/video0:/dev/video0:mwr \
--net=host \
-e XDG_RUNTIME_DIR=$XDG_RUNTIME_DIR \
-e DISPLAY=$DISPLAY \
--privileged \
pinto0309/simple_fisheye_calibrator:0.0.10 \
/bin/bash -c 'sudo simple_fisheye_calibrator --file_path 0'
1-2. Installation on the host PC
$ pip3 install -U simple_fisheye_calibrator
2. Usage
$ simple_capture
# 1. Capture one test image from the USB camera with "c" on the keyboard
# 2. Exit the capture application with "q" on the keyboard
# Still image
$ simple_fisheye_calibrator --file_path xxx.jpg
# USB Camera: video0
$ simple_fisheye_calibrator --file_path 0
or
$ sudo pip3 install cvui Pillow opencv_python numpy --upgrade
$ git clone https://github.com/PINTO0309/simple_fisheye_calibrator.git && \
cd simple_fisheye_calibrator
$ python3 simple_fisheye_calibrator/simple_capture.py
# 1. Capture one test image from the USB camera with "c" on the keyboard
# 2. Exit the capture application with "q" on the keyboard
# USB Camera: video0
$ python3 simple_fisheye_calibrator/simple_fisheye_calibrator.py --file_path 0
3. Parameter
usage:
simple_fisheye_calibrator.py \
[-h] \
[--file_path FILE_PATH] \
[--window_size_width WINDOW_SIZE_WIDTH] \
[--window_size_height WINDOW_SIZE_HEIGHT]
optional arguments:
-h, --help
show this help message and exit
--file_path FILE_PATH
File path of the still image (e.g. xxx.jpg) or device number of the camera (e.g. 0)
--window_size_width WINDOW_SIZE_WIDTH
Default window size width
--window_size_height WINDOW_SIZE_HEIGHT
Default window size height
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Close
Hashes for simple_fisheye_calibrator-0.0.10.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 7c279a26915a95c481fcd98368e1ba245af134b4429916b25094b483c30b9e0e |
|
MD5 | c23b7d635159975aad718817829af797 |
|
BLAKE2b-256 | c8eb12556b36b04aeb7abfcd3569b99ec8fa7a1bc7067fd7095c16271b71ad6c |
Close
Hashes for simple_fisheye_calibrator-0.0.10-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | a4487116712b284dc829d4ac6fd4832e7e66b00b6458cf2063a196b1811411d1 |
|
MD5 | 653b856737df3db097282c2d99bd79ab |
|
BLAKE2b-256 | 15fd259c02ebd8d595db870214a7776bd25cebf4a34a70d0e7a02b2386637580 |