Simple Image Converter (sic)

Converts a single image from one format to another (plus some other operations).

The image conversion is actually done by the awesome image crate :balloon:. sic is a small command line frontend which supports a portion of the conversion operations supported by the image crate.

It was initially created to try out another awesome Rust library: clap :tada:

Install

With cargo install: cargo install --force sic

Pre build binary: see releases

From the source of this repo:

• Setup rust and cargo with (for example) rustup, a nightly version is required.
• Clone this repo: git clone https://github.com/foresterre/sic.git
• Switch to this repo: cd sic
• Build a release: cargo build --release

Usage

Convert an image from one format to another, for example from PNG to JPG.

• In general: sic <input> <output>
• Example: sic input.png output.jpg

Covert an image from one format to another while not caring about the output file extension.

• In general sic --force-format "<format>" <input> <output> (or sic --force-format "<format>" <input> <output>)
• Example sic --force-format png input.bmp output.jpg (Note: output.jpg will have the PNG format even though the extension is jpg.)

Note: supported forced formats currently are: bmp, gif, ico, jpg (80%), pnm (P6 only). Support for other versions of supported formats is planned.

Apply image operations to an image.

• In general: sic --script "<operations>" <input> <output>
• Example `sic input.png output.jpg --script "flip_horizontal; blur 10; resize 250 250"

Note: resize applies a gaussian sampling filter on resizing. This is currently the only sampling filter available (i.e. not changeable, all resize operations will be done with the gaussian sampling filter).

Image operations availability:

operation => operation name
syntax => command syntax
available (from version) => lists whether the operation is supported right now (and optionally from which version forward)
description => descriptive information about the operation


<uint> means any 32 bit unsigned integer is required as parameter input