Skip to content

ucnv/pnglitch

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

45 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

PNGlitch

Gem Version test

PNGlitch is a Ruby library to destroy your PNG images.

With normal data-bending technique, a glitch against PNG will easily fail because of the checksum function. We provide a fail-proof destruction for it. Using this library you will see beautiful and various PNG artifacts.

For more details about glitching PNG image, see my documentation The Art of PNG Glitch.

Usage

  require 'pnglitch'

  PNGlitch.open('/path/to/your/image.png') do |p|
    p.glitch do |data|
      data.gsub /\d/, 'x'
    end
    p.save '/path/to/broken/image.png'
  end

The Art of PNG Glitch includes the usage of this library.

CLI

Once you've installed the gem, it can be used in the terminal.

Usage:
  pnglitch <infile> [--filter=<n>] <outfile>

Options:
  -f, --filter=<n>  Fix all filter types as passed value before glitching.
                    A number (0..4) or a type name (none|sub|up|average|paeth).
  --version         Show version.
  -h, --help        Show this screen.

Installation

Add this line to your application's Gemfile:

gem 'pnglitch'

And then execute:

$ bundle

Or install it yourself as:

$ gem install pnglitch

Contributing

  1. Fork it ( http://github.com/ucnv/pnglitch/fork )
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create new Pull Request