Menu

Tree [4d72a1] main /
 History

HTTPS access


File Date Author Commit
 test 2025-02-20 Martin D. Adamiker Martin D. Adamiker [4d72a1] Ignore generated documentation
 .gitignore 2025-02-20 Martin D. Adamiker Martin D. Adamiker [4d72a1] Ignore generated documentation
 CMakeLists.txt 2025-02-20 Martin D. Adamiker Martin D. Adamiker [4d72a1] Ignore generated documentation
 Doxyfile 2025-02-20 Martin D. Adamiker Martin D. Adamiker [4d72a1] Ignore generated documentation
 LICENSE.md 2025-02-07 Martin D. Adamiker Martin D. Adamiker [405747] LICENSE.txt, THIRD_PARTY_LICENSES.txt
 README.md 2025-02-07 Martin D. Adamiker Martin D. Adamiker [c47fcf] Renamed 00README.md to README.md
 THIRD_PARTY_LICENSES.md 2025-02-07 Martin D. Adamiker Martin D. Adamiker [405747] LICENSE.txt, THIRD_PARTY_LICENSES.txt
 constants.h 2025-02-07 Martin D. Adamiker Martin D. Adamiker [e92da3] Initial commit
 coordinateConversion.cpp 2025-02-20 Martin D. Adamiker Martin D. Adamiker [4d72a1] Ignore generated documentation
 coordinateConversion.h 2025-02-20 Martin D. Adamiker Martin D. Adamiker [4d72a1] Ignore generated documentation
 fileValidation.cpp 2025-02-20 Martin D. Adamiker Martin D. Adamiker [4d72a1] Ignore generated documentation
 fileValidation.h 2025-02-20 Martin D. Adamiker Martin D. Adamiker [4d72a1] Ignore generated documentation
 planoMetrix.cpp 2025-02-20 Martin D. Adamiker Martin D. Adamiker [4d72a1] Ignore generated documentation
 point.h 2025-02-20 Martin D. Adamiker Martin D. Adamiker [4d72a1] Ignore generated documentation
 rectification.cpp 2025-02-20 Martin D. Adamiker Martin D. Adamiker [4d72a1] Ignore generated documentation
 rectification.h 2025-02-20 Martin D. Adamiker Martin D. Adamiker [4d72a1] Ignore generated documentation
 serializePoint.h 2025-02-20 Martin D. Adamiker Martin D. Adamiker [4d72a1] Ignore generated documentation

Read Me

PlanoMetrix

Corrects scanner distortions using a reference scan for realignment.

🌟 Overview

PlanoMetrix is an open-source tool designed to correct mechanical distortions in flatbed and document feeder scanners. Many scanners suffer from periodic errors caused by sensor motion mechanics and paper transport irregularities, leading to misaligned scans and horizontal scale inconsistencies.

This software realigns scanned documents by using a reference scan of graph paper, ensuring accurate and consistent output.

🎯 How It Works

Phase 1: Calibration (Reference Scan)

  • Scan a piece of graph paper (e.g., millimeter paper).
  • PlanoMetrix analyzes the scanned grid and calculates alignment parameters.

Phase 2: Realignment (Correction Phase)

  • All subsequent scans are adjusted based on the stored reference parameters.
  • Corrects distortions, ensuring accurate proportions and alignment.

✨ Features

✔ Eliminates periodic scanner errors caused by mechanics\
✔ Reduces horizontal scale distortions in scans\
✔ Works with flatbed and document feeder scanners\
✔ Uses graph paper for easy calibration\
✔ Open-source and customizable

🚀 Installation

To install planoMetrix, follow these steps:

git clone https://sourceforge.net/projects/planometrix.git
cd planometrix
make

Alternatively, download the latest release from the SourceForge project page.

🛠 Usage

  1. Calibrate: Scan a piece of graph paper and save the alignment parameters.
  2. Correct Scans: Process new scans to automatically adjust distortions.

To run the software:

1.) To read a mesh image and store the rectification parameters:

planoMetrix -m <mesh image> -p <point file>

2.) To read rectification parameters and input image and to store the rectified output image:

planoMetrix -p <point file> -i <input image> -o <output image>

3.) To read a mesh image and an input image and store the rectified output image, do not store the rectification parameters:

planoMetrix -m <mesh image> -i <input image> -o <output image>

For more options, use:

planoMetrix --help

🖥 Supported Platforms

  • Linux
  • Windows (via MinGW or WSL)
  • macOS

💼 License

PlanoMetrix is released under a Commercial License. See LICENSE for details. See Third-Party Licenses for dependencies.

🤝 Contributing

Contributions are welcome! Feel free to submit issues or pull requests on SourceForge.

📞 Contact

For support or questions, visit the discussion forum or open an issue.

Want the latest updates on software, tech news, and AI?
Get latest updates about software, tech news, and AI from SourceForge directly in your inbox once a month.