This crate contains a library allowing you to glitch PNG images. Most of the code comes from the PNG encoder written for the wonderful Image crate. The idea here is to provide a tool similar to the Ruby gem PNGlitch for Rust. The output of an image will not be the exact same as PNGlitch, it's simply used for inspiration.
At the moment this cargo is in heavy WIP, any release could introduce breaking changes so please use this crate for having fun and create weird looking PNG images.
How to use
Duplicate
Single filter
For each occurence this algorithm will copy data from another part of the image, then force the png to use a given filter.
Params
- input(str): The path to the input png image.
- output(str): The path to the output png image (without extension).
- filter(u8): From 0 to 5, define the filter used when saving the image.
- occurence(usize): Occurence of the glitch, 1 means every column of the image.
- gap(usize): The number of column skipped before the first occurence
Examples
pnglitcher::duplicate("input1.png", "output1", 3, 1, 0);
pnglitcher::duplicate("input2.png", "output2", 0, 100, 1000);
Sample
Create a sample using duplicate algorithm for all filters for a given image
Params
- input(str): The path to the input png image.
- output(str): The path to the output png image (without extension).
- occurence(usize): Occurence of the glitch, 1 means every column of the image.
- gap(usize): The number of column skipped before the first occurence
Examples
pnglitcher::duplicate_sample("input1.png", "output1", 1, 0);
pnglitcher::duplicate_sample("input2.png", "output2", 100, 1000);
Replace
Single filter
For each occurence this algorithm will replace the data with 0, then force the png to use a given filter.
Params
- input(str): The path to the input png image.
- output(str): The path to the output png image (without extension).
- filter(u8): From 0 to 5, define the filter used when saving the image.
- occurence(usize): Occurence of the glitch, 1 means every column of the image.
Examples
pnglitcher::replace("input1.png", "output1", 0, 1);
pnglitcher::replace("input2.png", "output2", 4, 1);
Sample
Create a sample using duplicate algorithm for all filters for a given image
Params
- input(str): The path to the input png image.
- output(str): The path to the output png image (without extension).
- occurence(usize): Occurence of the glitch, 1 means every column of the image.
Examples
pnglitcher::replace_sample("input1.png", "output1", 1);
pnglitcher::replace_sample("input2.png", "output2", 10);
Wrong filter
Single filter
Force the png encoder to use a wrong filter
Params
- input(str): The path to the input png image.
- output(str): The path to the output png image (without extension).
- filter(u8): From 0 to 5, define the filter used when saving the image.
Examples
pnglitcher::wrong_filter("input1.png", "output1", 0);
pnglitcher::wrong_filter("input2.png", "output2", 2);
Sample
Create a sample using wrong filter algorithm for all filters for a given imageParams
- input(str): The path to the input png image.
- output(str): The path to the output png image (without extension).
Examples
pnglitcher::wrong_filter_sample("input1.png", "output1");
pnglitcher::wrong_filter_sample("input2.png", "output2");