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:
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
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
|operation|syntax|available (from version)|description|
|---|---|---|---|
|blur | blur <uint> | Yes (unreleased) | Performs a Gaussian blur on the image (more info) |
|brighten | TBD | No | ... |
|hue rotate | TBD | No | ... |
|contrast | TBD | No | ... |
|crop | TBD | No | ... |
|filter3x3 | TBD | No | ... |
|flip horizontal | flip_horizontal | Yes (unreleased) | Flips the image on the horizontal axis |
|flip vertical | flip_vertical | Yes (unreleased) | Flips the image on the horizontal axis |
|gray scale | TBD | No | ... |
|resize | resize <uint> <uint> | Yes (unreleased) | Resize the image using a Gaussian sampling filter (more info, filter) |
|rotate90 | TBD | No | ... |
|rotate180 | TBD | No | ... |
|rotate270 | TBD | No | ... |
|unsharpen | TBD | No | ... |