Gravel

Gravel was designed as a tool that allows users to quickly manipulate images in simple, often needed, ways from the command-line.

These span from converting an image's format to changing it to greyscale.

Feel free to download the logo and experiment with it using Gravel.

What's possible?

As of now, Gravel support the following instructions:

- apply {effect}: applies supported effects
- rotate {deg}: rotates image
- convert {frmt}: converts image to supported formats
- give {info}: displays supported information on the image

NOTE: As Gravel does not care about the order of argument and instruction and does not count paths as arguments or instructions, all of the following inputs are valid:

gravel img.png apply grayscale

gravel apply grayscale img.png

gravel grayscale apply img.png

NOTE: The first path in the arguments will be regarded as the path to the image by gravel. Gravel will see the second path as the destination path for saving the image. This will only be relevant when the "save" flag is used.

Supported flags are:

- version: prints gravel version
- save: saves modified image
- print: comments all instructions while modifying the image
- show: displays the image in a viewer
- cut-rotate: crops the image when rotating 

Dependencies

This project uses Pillow, an incredible fork of the Python Image Library that makes working with Images in Python very comfortable.

Pillow is licensed under:

The Python Imaging Library (PIL) is

    Copyright © 1997-2011 by Secret Labs AB
    Copyright © 1995-2011 by Fredrik Lundh and contributors

Pillow is the friendly PIL fork. It is

    Copyright © 2010 by Jeffrey 'Alex' Clark and contributors

Like PIL, Pillow is licensed under the open source MIT-CMU License:

By obtaining, using, and/or copying this software and/or its associated
documentation, you agree that you have read, understood, and will comply
with the following terms and conditions:

Permission to use, copy, modify and distribute this software and its
documentation for any purpose and without fee is hereby granted,
provided that the above copyright notice appears in all copies, and that
both that copyright notice and this permission notice appear in supporting
documentation, and that the name of Secret Labs AB or the author not be
used in advertising or publicity pertaining to distribution of the software
without specific, written prior permission.

SECRET LABS AB AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS
SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS.
IN NO EVENT SHALL SECRET LABS AB OR THE AUTHOR BE LIABLE FOR ANY SPECIAL,
INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE
OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
PERFORMANCE OF THIS SOFTWARE.