This code is depreciated! Please visit the new Version 2: https://github.com/CyanSorcery/Glitch-Gen-2
Create a glitched image from a sprite table in the style of NES, SNES, or Gameboy
There are two functions written in PHP. One allows you to optimize a sprite table, and the other allows you to create a glitched image based on this sprite table. The resulting image looks like a glitched image from the NES, SNES, or Gameboy, generated with the limitations of each in mind.
Here is an example of what the code does:
You can also view @ErrGraphic on Twitter to see my bot which uses this code.
Inside glitchedimggen.php there are two functions
This generates an optimizes sprite table and removes duplicate tiles from the table, to give a better overall result. It takes the following arguments:
$sourcetable- Path to source sprite tableThis is the path to the sprite table we'll be optimizing. It MUST be an 8x8 4 color image. If you open this in GIMP or Aseprite, you can easily add graphics to it. Here is an example:
Notice all the blank spaces. That's what this function will remove.
$desttable- Path to save optimized sprite table toThis is where we will save the optmized sprite table to. Here is an example:
You can see all blank spaces and duplicate entries have been removed entirely.
$trimbott(OPTIONAL) [Defaulttrue] - Trims the last row offThis trims the last row off of the image. This can be useful because the last row will more than likely have excess blank tiles on it. In the example above, the last row has been trimmed off.
$tablecols(OPTIONAL) [Default32] - Width of the optimized sprite table, in columnsThis specifies the width of the resulting optimized sprite table.
Returns:Nothing
This function creates a glitched image based on the sprite table that we made with spriteTableOpt(). It takes the following arguments:
$gfx_table_path- Path to source sprite tableThis is where we'll find the optimized sprite table. It should be composed of 8x8 tiles. This allows you to use this function multiple times with multiple sprite tables, if you so choose.
$output_path- Path where we'll save the image.This is where we'll save the output glitched image. At the top of this README is an example of what this code outputs.
$scale(OPTIONAL) [Default3] - How much we'll upscale the imageThis specifies how much we'll upscale the image. Set to 1 to have a 1:1 output ratio.
$mode_switch(OPTIONAL) [Default'DEFAULT'] - Output mode of the glitched graphicsThis mode forces a specific output mode to be chosen. Valid arguments are
NES,SNES, andGB. If you don't specify this, or putnullor some other argument that isn't valid, the script will simply choose it's own randomly (the default behavior)
Returns:Nothing
This file contains an example usage with the provided images. You can run this from the shell, or through a web browser.
Example file containing some sprites that I have made. You can modify it to contain your own sprites. Be sure to keep the size a multiple of 8, to avoid errors.
Example image of what you can expect to see by using spriteTableOpt(). You should definitely optimize your sprite table before creating an image with it, to avoid duplicate tiles and blanks.
This is an example of what this code does. You can also visit my bot @ErrGraphic on Twitter to see what it does.
A more robust image to sample data from. This file features graphics from Shield Cat the Game, also by CyanSorcery.
This outputs glitched images in NES, SNES, or Gameboy style, with the limitations of each in mind. Each tile is sourced from an 8x8 part of the tileset produced by spriteTableOpt(). It has a chance of producing randomized pixels, to emulate the game reading from program ROM instead of graphics ROM. It also flips and rotates tiles, to add to the corruption. It also has a chance of offsetting the sourced tile, so that it will read part of 4 tiles instead of just one from the tileset.
Here is a description of the modes and their differences in output:
In NES mode, a background color is picked, followed by 4 palette tables from the NES palette. This script uses the NES palette specified from the Nestopia emulator. It outputs an image in 256 x 240 resolution. It also scrolls vertically OR horizontally randomly. It only scrolls in one direction, as the NES also can only scroll in one direction. The output is done in chunks of 4 tiles, with one palette assigned to each chunk of 4 tiles, to match how the NES assigns palettes to the background layer.
In SNES mode, it emulates MODE 1 of the SNES. This mode has two background layers with 16 colors, and 1 background layer of 4 colors. For simplicity, this script only generates the two background layers with 16 colors. Two palettes with 16 colors are picked, with a result of 32 colors. The colors are picked to match the 15bit color specification of the SNES (see the comments in glitchedimggen.php for details.) It also outputs an image in 256 x 240, to match the SNES. It adds a scroll offset in both horizontal and vertical.
In Gameboy mode, it picks 4 colors from a prespecified table (please see glitchedimggen.php for the table.) The colors are stored in RRGGBBRRGGBBRRGGBBRRGGBB, or four RRGGBB hex values, starting with the brightest color. In this way, it is possible to add your own colors. I have included palettes from the Super Gameboy, the Gameboy Color, and some of my own palettes as well. It produces an image that is 160 x 144, to match the original Gameboy, and also scrolls horizontally OR vertically.
If you have any questions about this script, you can reach out to me either here or on Twitter at @CyanSorcery. I hope that you enjoy this script!
It requires PHP 5.5 or PHP 7 with GD installed.