txt: ## dist_cpan-AZAWAWI-MagickWand.md
  # MagickWand
  
  This provides a Perl 6 object-oriented [NativeCall](http://doc.perl6.org/language/nativecall)-based API for ImageMagick's
  [MagickWand C API](http://www.imagemagick.org/script/magick-wand.php).
  
  ## Build Status
  
  | Operating System | Build Status | CI Provider |
  | --- | --- | --- |
  | Linux / Mac OS X | [Build Status](https://travis-ci.org/azawawi/perl6-magickwand) | Travis CI |
  | Windows 7 64-bit | [Build status](https://ci.appveyor.com/project/azawawi/perl6-magickwand/branch/master) | AppVeyor |
  
  ## Example
  
  ```
  use v6;
  use MagickWand;
  
  # A new magic wand
  my $wand = MagickWand.new;
  
  # Read an image
  $wand.read("examples/images/aero1.jpg");
  
  # Lighten dark areas
  $wand.auto-gamma;
  
  # And then write a new image
  $wand.write("output.png");
  
  # And cleanup on exit
  LEAVE {
    $wand.cleanup if $wand.defined;
  }
  
  ```
  
  For more examples, please see the <examples> folder.
  For examples of available image effects, please click
  [here](http://www.imagemagick.org/script/examples.php).
  
  ## Prerequisites
  
  Please follow the instructions below based on your platform:
  
  ### Linux (Debian)
  
  * To install ImageMagick libraries, please run:
  
  ```
  $ sudo apt install libmagickwand-dev
  
  ```
  
  ### MacOSX (Darwin)
  
  * To install ImageMagick libraries via [Homebrew](http://brew.sh/), please run:
  
  ```
  $ brew update
  $ brew install imagemagick
  
  ```
  
  * To install ImageMagick libraries via [MacPorts](https://www.macports.org/),
    please run:
  
  ```
  $ sudo port install ImageMagick
  
  ```
  
  ### Windows
  
  For 64-bit Windows, please install the [`64-bit`](https://www.imagemagick.org/download/binaries/ImageMagick-7.0.8-14-Q16-x64-dll.exe)
  DLL installer. Otherwise, use the [`32-bit`](https://www.imagemagick.org/download/binaries/ImageMagick-7.0.8-14-Q16-x86-dll.exe)
  version.
  
  Also please remember to enable **"Add to PATH"** option.
  
  ## Installation
  
  * Install this module using [zef](https://github.com/ugexe/zef):
  
  ```
  $ zef install MagickWand
  
  ```
  
  ## Testing
  
  To run tests:
  
  ```
  $ prove -ve "perl6 -Ilib"
  
  ```
  
  ## Author
  
  Ahmad M. Zawawi, azawawi on #perl6, <https://github.com/azawawi/>
  
  ## License
  
  MIT License
  