#image-processing #command-line #command-line-tool #precise #space #smart #scissors

bin+lib rusty_scissors

A command-line tool for trimming images

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

MIT license

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 🚀

  1. Clone the repository:
$ git clone https://github.com/Inc44/rusty-scissors.git
  1. Go to the project directory:
$ cd rusty-scissors
  1. 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