A command line tool to automatically resize and crop an image to its most complex (and hopefully interesting) section.
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
src
COPYING
Makefile.am
README
TODO.org
autogen.sh
configure.ac

README

----------------------------------------------------------------------

  Kiri's Cropping Tool 0.1

  Copyright (c) 2018 Kiri Jolly
    http://expiredpopsicle.com
    expiredpopsicle@gmail.com

----------------------------------------------------------------------

This tool attempts to resize and crop an image to the most complex
region to match the aspect ratio of the given size. The region
complexity is considered to be the region with the most edges as
detected by a Sobel edge detection filter done against a luminance map
of the input images for RGB and RGBA inputs, or against the image
itself for Grayscale and Grayscale + alpha images.

----------------------------------------------------------------------
  Installation
----------------------------------------------------------------------

First make sure libjpeg-dev and libpng-dev are installed...

    sudo apt-get install libjpeg-dev libpng-dev

If you're installing from a Git repository, you need to have Autotools
installed...

    sudo apt-get install automake autoconf

Aside from that you need Git (to automatically pull the latest
Lily-Engine-Utils)...

    sudo apt-get install git

And a C++ compiler.

If installing from Git, first generate the configure script.

   ./autogen.sh

Run the configure script.

    ./configure

Build.

    make

Installation on Debian-based systems will probably want to use
checkinstall, but if you want to skip the package manager or you're
using another OS, you can just run...

    sudo make install

----------------------------------------------------------------------
  Usage
----------------------------------------------------------------------

Run kcrop with the image of your choice specified on the command line.
The --width and --height parameters should be specified, but will
default to the original image width and height if they are not. If the
--out option is not used, the original image will be overwritten.

    kcrop image.png                   \
        --out=some_other_filename.png \
        --width=128                   \
        --height=128

----------------------------------------------------------------------

Butts.