### ----------------------------------------------------
### -- Imlib2
### -- Licenses: Artistic-2.0
### -- Authors: Naoum Hankache, Henrique Dias
### -- File: README.md
### ----------------------------------------------------
Raku Imlib2 ![Imlib2 Logo](logotype/logo_32x32.png)
============
Raku interface to the Imlib2 image library.

| Operating System  |   Build Status  |
| ----------------- | --------------- |
| Linux		    | [![Build Status](https://travis-ci.org/hankache/perl6-Imlib2.svg?branch=master)](https://travis-ci.org/hankache/perl6-Imlib2)  |

Description
-----------
Raku binding for [Imlib2][2], a featureful and efficient image manipulation library, which produces high quality, anti-aliased output.  

Installation
------------
Note that a recent version of [Imlib2][3] library must be installed before installing this module.

To install with zef:

	zef update
	zef install Imlib2


Synopsis
--------
WARNING: This module is Work in Progress, which means: this interface is not final. This will perhaps change in the future.

Below is a sample code:

```Raku
use Imlib2;

my $im = Imlib2.new();
# Create a new raw image.
my $rawimage = $im.create_image(200, 200);
exit() unless $rawimage;

# Sets the current image Imlib2 will be using with its function calls.
$rawimage.context_set();

# Sets the color with which text, lines and rectangles are drawn when
# being rendered onto an image.
$im.context_set_color(
	red   => 255,
	green => 127,
	blue  => 0,
	alpha => 255);

$im.image_draw_rectangle(
	location => (0, 0),
	size     => (200, 200),
	fill     => True);
$im.image_set_format("png");
unlink("images/test_imlib2.png") if "images/test_imlib2.png".IO ~~ :e;
$im.save_image("images/test_imlib2.png");

# Frees the image that is set as the current image in Imlib2's context.
$im.free_image();

exit();
```

Author
------
Henrique Dias <mrhdias@gmail.com>

See Also
--------
* [Imlib2 Raku Module Documentation][1]  
* [Imlib2 Library Documentation][2]
* [Imlib2 Source Repository][3]

License
-------

This library is free software; you can redistribute it and/or modify it under the same terms as Raku itself.

[1]: lib/Imlib2.pod "Imlib2 Raku Module Documentation"
[2]: http://docs.enlightenment.org/api/imlib2/html/ "Imlib2 Library Documentation"
[3]: http://sourceforge.net/projects/enlightenment/files/imlib2-src/


