azawawi / raku-magickwand Goto Github PK

View Code? Open in Web Editor NEW

14.0 5.0 9.0 374 KB

ImageMagick's MagickWand API Bindings for Raku

License: MIT License

Raku 100.00%

magickwand raku

raku-magickwand's Introduction

MagickWand

This provides a Raku object-oriented NativeCall-based API for ImageMagick's MagickWand C API.

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.

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, please run:

$ brew update
$ brew install imagemagick

To install ImageMagick libraries via MacPorts, please run:

$ sudo port install ImageMagick

Windows

For Windows, most people will want the standard 64-bit DLL installer. If you need 32-bit or other special options, select the appropriate alternate installer.

Also please remember to enable "Add to PATH" option.

Installation

Install this module using zef:

$ zef install MagickWand

Handling PDF files

To process PDF files, please remember to install Ghostscript from here.

Testing

To run tests:

$ prove --ext .rakutest -ve "raku -I."

To run all tests including author tests (Please make sure Test::Meta is installed):

$ zef install Test::META
$ TEST_AUTHOR=1 prove --ext .rakutest -ve "raku -I."

Author

Ahmad M. Zawawi, azawawi on #raku, https://github.com/azawawi/

License

MIT License

raku-magickwand's People

Contributors

Stargazers

Watchers

Forkers

samcv cono loops ufobat thundergnat rypervenche pheix spritefullake

raku-magickwand's Issues

Write step-by-step HOWTO tutorials for making certain images

After discussing it with Gabor, he gave me this nice task to do:

Here is a task, I am not even sure if this could be the right tool for it. Given a base-line image
(e.g. http://perlmaven.com/img/perl_maven_150x212.png ) I'd like to create versions of it.
(e.g. http://perlmaven.com/img/beginner_perl_maven_150x212.png ) but if fits,
you might write an articles showing how to do such thing using your code.

Can't work out how to get errors

I'm guessing maybe this isn't implemented but I can't figure out how to get the error when read returns false.

Ideally this would have a more modern, Perl6-y architecture where we would have atomic object creation with exceptions thrown, but any guide on how to get the error string from the magick wand would be helpful, even if it's just done in the examples or tests.

Complete effects example

https://github.com/azawawi/perl6-magickwand/blob/master/examples/02-effects.pl6

win 64bit link is broken

I get a 404 when i click on it

Install fails with Cannot locate native library 'CORE_RL_wand_.dll': error 0x7e

I'm using Windows 10 with Rakudo version 2017.07 and have tried both the 16 and 8 bit depth versions of ImageMagick-7.0.7-7

Looking in the Image Magick folder I can't see that dll, but there is one called CORE_RL_MagickWand_.dll

Here's the first bit of output from zef with the path shown first

PS C:\WINDOWS\system32> $Env:Path
C:\Program Files\ImageMagick-7.0.7-Q8;C:\ProgramData\Oracle\Java\javapath;C:\ProgramFiles\Common Files\Microsoft Shared\Windows Live;C:\Program Files (x86)\Common Files\Microsoft Shared\Windows etc. etc.
PS C:\WINDOWS\system32> zef install MagickWand
Use of Nil in string context
in sub guess-path at C:\rakudo\share\perl6\site\sources\2A928C6F9B02AF49EBD04F99E07BE1820A3A1C9F (Zef::Config) line 21
Use of Nil in string context
in sub guess-path at C:\rakudo\share\perl6\site\sources\2A928C6F9B02AF49EBD04F99E07BE1820A3A1C9F (Zef::Config) line 21
===> Searching for: MagickWand
===> Searching for missing dependencies: LibraryCheck
===> Testing: LibraryCheck:ver('0.0.6'):auth('github:jonathanstowe')
===> Testing [OK] for LibraryCheck:ver('0.0.6'):auth('github:jonathanstowe')
===> Testing: MagickWand:ver('0.0.2'):auth('github:azawawi')
Cannot locate native library 'CORE_RL_wand_.dll': error 0x7e
in method setup at C:\rakudo\share\perl6\sources\24DD121B5B4774C04A7084827BFAD92199756E03 (NativeCall) line 316
in method CALL-ME at C:\rakudo\share\perl6\sources\24DD121B5B4774C04A7084827BFAD92199756E03 (NativeCall) line 328
in method read at C:\Users\ADMINI~1\AppData\Local\Temp.zef\store\perl6-magickwand.git\13bc0b051775f74f2422833017915dc
87aebcaec\lib\MagickWand.pm6 (MagickWand) line 72
in block at t\02-magickwand.t line 24

Write a User Guide

We need a user guide similar to Python's Wand or Ruby's Wand

Processing PDF

you can process PDF with magickwand if you install https://www.ghostscript.com/download/gsdnld.html. Maybe it is worth to mention it in the README.md?