Project

teaas

0.01
No release in over 3 years
Low commit activity in last 3 years
teaaswjr1985/teaasHomepageDocumentationSource CodeBug TrackerWiki
Gem to manipulate emoji-sized images
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
2025
2026
 Popularity
Downloads
11,376
Stars
16
Forks
2
Watchers
1
 Releases
Current version
1.0.0
Total releases
5
First release
2015-12-18
Latest release
2016-11-11
 Development
Primary Language
Ruby
Licenses
MIT
Average date of last 50 commits
2018-08-21
Reverse Dependencies
0

 Dependencies

Development

rspec
~> 3.4

Runtime

rmagick
~> 2.15
 Project Readme

teaas

Tests Gem Version

Total Emojis as a Service

Total Emojis as a Service (Teaas / TEAAS) is a Ruby library that wraps around RMagick and allows easy manipulation of emojis or emoji-like GIFs. Every effect works on both static images and animated GIFs, and each class provides a _from_file convenience method so you can pass a path instead of a Magick::ImageList.

Effects

Transforms

Class Description
Spin Rotates the image to create a spinning animation. Supports custom rotation count and counterclockwise mode.
Intensify Composites a slightly smaller copy of the image at alternating corners for a shaking/intensified effect (7 frames).
Pulse Rotates and resize-fills each frame to create a pulsing animation (8 frames).
Parrotify Bobs the image through 10 predefined offset positions, party-parrot style.
Marquee Rolls the image horizontally or vertically to create a scrolling marquee. Supports animated input and a crop option for tall images.
Mirror Flips the image horizontally. Returns a single image for static input or a mirrored ImageList for animated input.
Reverse Reverses the frame order of an animated GIF.
Dealwithit Animates sunglasses descending onto the image (15 frames, with a pause on the last frame).

Overlays

Class Description
Fire Overlays animated flames.
Blood Overlays animated dripping blood.
Heart Overlays animated hearts.
Tears Overlays animated tears.
Fireworks Overlays animated fireworks.
ShakeFist Overlays an animated shaking fist.
Wait Overlays an animated loading/wait indicator.
No Overlays a static "no" symbol (works on animated input).
Think Overlays a static thinking bubble (works on animated input).
Magrittify Overlays a green apple, Magritte-style (works on animated input).
Got Combines fire and blood overlays for a Game of Thrones effect.

Utilities

Class Description
Turboize Adjusts animation speed. Takes an array of speeds and returns an array of GIF blobs, one per speed. Optionally resizes.
Resize Resizes an image or animated GIF to the specified dimensions.
Overlayer Low-level overlay engine used by the overlay effects. Handles animated-on-static, static-on-animated, and animated-on-animated compositing.

Requirements

  • Ruby 3.3 or higher
  • rmagick ~> 6.1. rmagick requires ImageMagick to be installed. Additionally, the Ruby you're using needs to be able to compile C extensions.

Documentation

Docs are in YARD format. To build the HTML docs, just gem install yard then run yard. If you'd rather not use YARD, you can just read the documentation for the methods in the source files.

Example

If you're looking for a full example, check out the Puma app here.

If you just want to know how to get a modified image from a file or a pre-provided Magick::ImageList, check below. The example uses Teaas::Turboize but you can replace it with any of the other classes in lib/teaas.

From a file

image_path = "image.gif"

result = Teaas::Turboize.turbo_from_file(image_path, "")
# result contains an array of image blobs

From a Magick::ImageList 

image = Magick::ImageList.new

# populate image here

result = Teaas::Turboize.turbo(image, "")
# result contains an array of image blobs

Questions / PRs, etc.

Feel free to open a GitHub issue or file a pull request if you have a question or would like something added.

License

It's MIT. See the LICENSE file.