4 stable releases
1.3.0 | Jun 11, 2024 |
---|---|
1.2.0 | Dec 22, 2023 |
1.1.1 | Oct 20, 2023 |
#350 in Images
29 downloads per month
6MB
184 lines
Contains (DOS exe, 5.5MB) rusty_scissors.exe
🖼️ Rusty Scissors ✂️
Introduction
Rusty Scissors is a useful tool created with ❤️ using Rust. It quickly trims extra space around images like smart scissors. It's fast, efficient, and precise.
Features 🌟
- 🚀 Fast image trimming powered by Rayon.
- 🖼️ Supports many image formats (JPEG, PNG, BMP, GIF, ICO, QOI, and more).
- 🗂️ Batch process multiple images at once.
- 📁 Organized output to keep trimmed images together.
- 🛠️ Easy-to-use command-line interface.
How to Use 💼
If you are on Windows, simply download the .exe file. For all other operating systems, refer to the "Build the Project" section for compilation instructions.
Build the Project 🚀
- Clone the repository:
$ git clone https://github.com/Inc44/rusty-scissors.git
- Go to the project directory:
$ cd rusty-scissors
- Build and run the project:
$ cargo run --release <input-path>
How Does It Work? 🔎
Rusty Scissors scans each row and column of pixels, checking for similarities within a specified tolerance.
If you're processing noisy images with slightly varying pixel values, you can set a tolerance value of 13.725
to account for this noise. If the default behavior (a tolerance value of 0
) works well for your images, there's no need to adjust the tolerance.
Currently, Rusty Scissors does not use the Delta E 2000 metric for color similarity, as it would significantly impact performance due to the complex calculations involved. Instead, a simpler pixel difference approach is used to prioritize speed.
Contribution 🤝
We welcome contributions! For significant changes, please open an issue for discussion before making a pull request.
License 📜
This software is licensed under the MIT Massachusetts Institute of Technology (MIT). For more details, refer to LICENSE.
Dependencies
~2.6–9.5MB
~93K SLoC