README.md
# ExfileImagemagick
[![Build Status](https://travis-ci.org/keichan34/exfile-imagemagick.svg?branch=master)](https://travis-ci.org/keichan34/exfile-imagemagick)
An [ImageMagick](http://www.imagemagick.org) file processor suite for [Exfile](https://github.com/keichan34/exfile).
## Requirements
* A working ImageMagick installation. `identify` and `convert` must be in the
`PATH` of the running environment.
* Elixir `~> 1.2.0`
## Installation
1. Add exfile_imagemagick to your list of dependencies in `mix.exs`:
def deps do
[{:exfile_imagemagick, "~> 0.1.5"}]
end
2. Ensure exfile_imagemagick is started before your application:
def application do
[applications: [:exfile_imagemagick]]
end
## Usage
`exfile_imagemagick` automatically registers 4 processors:
* `convert`
* `fill`
* `limit`
* `metadata`
## Optional GraphicsMagick Configuration
Instead of ImageMagick you may optionally choose [GraphicsMagick](www.graphicsmagick.org) as image processor.
In `config.exs`:
```elixir
config :exfile_imagemagick, image_processor: :graphicsmagick
```
You also need to ensure that `GM` binary is in your environment's `PATH`.
See `ExfileImagemagick.Config` for defaults.