Vision Metrics is a free, professional desktop tool for precise image measurement and annotation – built for metrology, quality control, and engineering image analysis.
- Distance measurement with real-time rubber-band preview and calibrated unit display
- Angle measurement between three points with automatic arc rendering
- Scale calibration – define a known distance to convert pixels into mm, cm, or inches
- Text annotations placed directly on the image
- Zoom to cursor – scroll wheel zooms into the exact area under your mouse
- Pan with middle mouse button
- Undo / Clear for all measurement types
- Toggle visibility of lines, points, and angles independently
- Color customization for lines, text, and points
- Dark / Light mode
- Save annotated image as PNG or JPEG
-
Clone the repository:
git clone https://github.com/ZbynekStebnicky/Vision-Metrics.git cd Vision-Metrics -
Install dependencies:
pip install -r requirements.txt
-
Run the app:
python main.py
- Python 3.10+
opencv-pythonnumpyPillowcustomtkinter
- Load an image – File → Open Image (or
Ctrl+O) - Calibrate – press
C, click two points of known distance, enter the real-world value - Measure distances – press
L, click two points - Measure angles – press
A, click three points (vertex is the second point) - Annotate – use the Add Text Annotation button, type your text, click to place
- Save – File → Save Image (
Ctrl+S) exports the image with all annotations baked in
| Action | Input |
|---|---|
| Zoom in/out | Scroll wheel (zooms to cursor) |
| Pan | Hold middle mouse button + drag |
| Reset view | R |
| Key | Action |
|---|---|
L |
Line mode |
A |
Angle mode |
C |
Calibrate mode |
R |
Reset view |
Ctrl+O |
Open image |
Ctrl+S |
Save image |
Ctrl+Z |
Undo last action |
Esc |
Cancel current input |
Select your preferred unit from the sidebar dropdown: mm, cm, in, or px. The unit is applied to all live preview labels, measurement history, and saved annotations. Calibration is required for mm / cm / in output.
MIT