Aruco Frame
This open source project lets you scan a drawing or image using an easy to build frame, and obtain a rectified image in real-life units. The frame exists in 3 different sizes, you can build your own by downloading the design files here.
Installation
Steps:
- Clone or download this project, and place the folder somewhere
- Install python>3.8 (link)
- Add python to your system's path (guide)
- Open a terminal and navigate to the project's folder
- Install dependencies:
python -m pip install -r requirements.txt- Test:
python aruco-frame.py -i example/raspi.jpgUsage
Process an image:
python aruco-frame.py -i <FILENAME_IN>If the output path is not specified with a -o <FILENAME_OUT> argument, the result is saved as <FILENAME_IN>_<DPI>_DPI.png.
User manual
usage: aruco-frame.py [-h] [-i INPUT] [-o OUTPUT] [-d DPI] [-s] [-c CONFIG] [-v]
Extracts the image from an image containing an aruco frame
options:
-h, --help show this help message and exit
-i INPUT, --input INPUT
Input filename.
-o OUTPUT, --output OUTPUT
Output filename (default: <filename_in>_<DPI>_DPI.png).
-d DPI, --dpi DPI Manual output DPI (default: auto).
-s, --show Show debug image.
-c CONFIG, --config CONFIG
Frame configuration file (default: ./config/config.json).
-v, --verbose Verbose mode (default: false).Authors and acknowledgment
Quentin Bolsee 2024
License
This project is provided under the MIT License.