Gi

Gi is a library for manipulating Graphics Interfacing. Use utility mogrify, identify, ... of GraphicsMagick to resize, draw on base images....

Requirements

You must have GraphicsMagick installed of course.

Features

Utilities for image:

• Resize image to width x height with ratio (WxH)

  Gi.open("example.jpg") # example.jpg (300x200)
  |> Gi.gm_mogrify(resize: "200x100")
  |> Gi.save() # => example.jpg (150x100)

• Resize image to width x height (WxH!)

  Gi.open("example.jpg") # example.jpg (300x200)
  |> Gi.gm_mogrify(resize: "200x100!")
  |> Gi.save() # => example.jpg (200x100)

• Format image to jpg, png, webp, ...

  Gi.open("example.jpg")
  |> Gi.gm_mogrify(format: "webp")
  |> Gi.save() # => create new file "example.webp"

• Draw text on image text x,y 'string'

  Gi.open("example.jpg")
  |> Gi.gm_mogrify(draw: "text 150,150 'Theta.vn'")
  |> Gi.save() 

• Draw image on image "image Over x,y,w,h file"

  Gi.open("example.jpg")
  |> Gi.gm_mogrify(draw: "image Over 100,100,200, 200 dir/logo.a")
  |> Gi.save()

• Multi utilities

  Gi.open("example.jpg")
  |> Gi.gm_mogrify([resize: "300x200", draw: "text 150,150 'Theta.vn'"])
  |> Gi.save()

• Combine multiple images into one

  Gi.open("frame.png")
  |> Gi.gm_composite(["background.jpg","result.png"])

Installation

If available in Hex, the package can be installed by adding gi to your list of dependencies in mix.exs:

def deps do
  [
    {:gi, "~> 0.1.0"}
  ]
end

Documentation https://hexdocs.pm/gi.