Gi

Hex.pm Hex.pm

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.

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"])

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