English
资源说明：Erlang ImageMagick Interface (for the web)
# eim - Erlang ImageMagick Interface (for the web) #
Provides nif helpers around MagickWand to resize, crop, and rotate images.
This is the initial goal of the eim project due to these being the primary
functions needed for web based services that require image uploading and
basic manipulation functionality.
Due to the nature of NIFs if they crash the whole node goes down, which
means you'd need to monitor/handle said crashes.
# Examples #
A photo hosting service which primarily deals with photographs of people
may create these derivations of uploaded images:
1> {ok, Image} = eim:load(Binary).
2> %% make derivations here
...
Create a thumbnail of the top portion of the image and scale it to a
box of 50x50 pixels - similar to default Facebook newsfeed profile
pictures
DerivedBinary = eim:derive(Image, png, {box, 50, 50, center, top})
Resize the image to width 180 and maintain aspect ratio on the height
and then make sure the height doesn't exceed 350, otherwise crop the
bottom out so that it is exactly 350 height. Will result in an image
with width 180 and a height of =< 350 - similar to Facebook style
pictures on the left of profile pages
DerivedBinary = eim:derive(Image, png, [{scale, width, 180}, {max, height, 350, top}])
User defined cropping the image to a specific region - similar to
the result of Facebook profile image thumbnail editing
DerivedBinary = eim:derive(Image, png, [{crop, 300, 300, 45, 130}, {scale, height, 50}])
# Derivation Reference/API #
Format can be one of the atoms jpg, gif, or png. You'll need imagemagick installed
and configured with the other libraries necessary to read and write these formats.
crop a region
{crop, Width, Height, X, Y}
scale by width and maintain aspect ratio on height
{scale, width, Width}
scale by height and maintain aspect ratio on width
{scale, height, Height}
crop the image if it exceeds these limits float crop center
{max, width, Width} -> {max, width, Width, left}
{max, height, Height} -> {max, height, Height, top}
crop the image if it exceeds these limits and float the crop
** variable floating on max not currently supported **
{max, width, Width, FloatX}
{max, height, Height, FloatY}
crop to 350 if the original Height > 350 and float the crop in the top
which is normally where someone's head is in a photograph
{max, height, 350, top}
fit inside this box by cropping out some of the image so it results in
am image exactly Width, Height in dimensions
{box, Width, Height} -> {crop_box, Width, Height, center, center}
same as above but with variable FloatX and FloatY
{box, Width, Height, FloatX, FloatY}
rotate 90 degress once, twice, or three times - 90, 180, or 270 degress
{rotate, 1}
{rotate, 2}
{rotate, 3}
fit inside a box of this size but maintain the aspect ratio
results in either
% NewWidth =:= Width and NewHeight =< Height
% or NewHeight =:= Height and NewWidth =< Width
{fit, Width, Height}
本源码包内暂不包含可直接显示的源代码文件，请下载源码包。
