Image version 0.13.0 has been released. Lots of community encouragement and some fun challenges from @GenericJam that motivated the addition of chroma keying and meme generation.
Meme Generation
Generates a meme image from a base image and some text. For example:
iex> Image.open!("./test/support/images/meme.jpg", access: :random)
..|> Image.meme!("One simply cannot", text: "Enjoy image processing without libvips")
..|> Image.preview()
Chroma Keying
This is the process of eliminating a background color or color range from an image to produce an image mask that can be overlayed onto another image. For example:
iex> foreground = Image.open!("./test/support/images/chroma_key/greenscreen.jpg", access: :random)
...> |> Image.preview()
iex> foreground
...> |> Image.chroma_key!
...> |> Image.preview()
Now we can compose this image over another image:
iex> background = Image.open!("./test/support/images/chroma_key/background.jpg", access: :random)
...> Image.preview()
iex> Image.compose!(background, foreground)
...> |> Image.preview()
Image Previews
In the examples above you can see the use of Image.preview/1 (and its short form Image.p/1). This function emits an image preview to iTerm2 terminal windows. Its useful to import it into your .iex.exs file like this:
% cat .iex.exs
import_if_available(Image, only: [p: 1, preview: 1])
QRcode encoding
Leveraging the fabulous eVision library by @cocoa (now on hex.pm!) there is both QRcode encoding and decoding. Encoding is new in this release of Image. For example:
iex> {:ok, qrcode} = Image.QRcode.encode("eVision, OpenCV, vix and libvips make for a great image processing experience for Elixir", size: 100)
iex> Image.preview(qrcode)
Full Changelog for Image 0.13.0
Breaking change
Image.resize/3renamed toImage.thumbnail/3
Bug fixes
-
Fix
Image.open/2when opening JPEG images from a binary. Seems JPEG files agree on the<<0xff, 0xd8, 0xff>>header for the first three bytes. But not completely consistent with the following bytes. -
Fix options for
Image.Drawfunctions which are expected to be a map after validation (but were a keyword list).
Enhancements
-
Add
Image.chroma_key/2andImage.chroma_mask/2. -
Add
Image.meme/3andImage.meme!/3. -
Add
Image.QRcode.encode/1andImage.QRcode.decode/1. -
Add
Image.blur/2. -
Add
Image.feather/2. -
Add
Image.new/2that creates a new image of the same shape as the provided image. -
Add
Image.resize/3. -
Add
Image.split_bands/1. -
Add
Image.if_then_else/3. -
Add
Image.preview/1(andImage.p/1that delegates to it) to preview an image inline in an iTerm2 terminal windows. -
Add
Image.split_bands/1to return a list single band images, one for each band in the original image.
