Shattered Machine

The Shattered Machine is a gem that aim to create glitched png images easily.

Features

Converter : Convert a single jpg images or a directory full of jpg image into png
Seven algorithms : Seven different alogirithm with their own settings giving you lots of freedom to mess with your images
Sampler : Giving you a quick overview of all algorithms effect on your image
Folder glitching : Glitch easily all png images contained in a folder

Usage/Examples

Glitcher


require 'shattered_machine'

io = ShatteredMachine::Io.new('input_image.png', 'output_folder', 'output_filename')
ShatteredMachine::Glitcher.new('Slim', io).call

Sampler


require 'shattered_machine'

io = ShatteredMachine::Io.new('input_image.png', 'output_folder', 'output_filename')
ShatteredMachine::Sampler.new(io).call

Converter


require 'shattered_machine'

io = ShatteredMachine::Io.new('input_image.jpg', 'output_folder', 'output_filename')
ShatteredMachine::Converter.new(io).call

Development

Install locally

The Shattered Machine using two main libraries for glitching :

The rusty engine is written in rust and a compiled version for Windows, Mac os and Linux is already included in the gem. To install the needed dependencies you need to install the Ruby language and Bundler.

Then run bundle install to fetch the needed gems.

Create new version

Fill the CHANGELOG with the changes contained in the new version
Ensure the specs are green
Change the versions in lib/shattered_machine.rb and shattered_machine.gemspec
Create git tag
Compile the gem : gem build shattered_machine.gemspec
Push the new version : gem push shattered_machine-x.x.x.gem

Specs

This project uses Rspec for writting specs, to run them simply run bundle rspec

Acknowledgements

This gem is relying heavily on the pnglitch gem and the rusty engine gem. The png image used in the specs has been created with Ronin while the jpg one is painting from Karl Wiener. Icons made by Freepik from www.flaticon.com