PolyGlitch Documentation (v1.4b)

PolyGlitch is a Paint.NET plugin, written by Graham Sutherland, containing a number of effects aimed at glitch art.

Installation is simple. Ensure that the DLL files have been unblocked (right click, properties, unblock) and move PolyGlitch.Effects.dll into the Effects subfolder of your Paint.NET installation directory. Copy the CodeArtEng.DspToolbox.dll file from the DspToolbox directory into the main Paint.NET directory. Restart Paint.NET and a new PolyGlitch section will appear under Effects.

The following effects are included:

• 3Displace - R/G/B channel displacement using source pixel intensity as an offset multiplier.
• Codebook - Encrypts the image using AES in Electronic Codebook (ECB) mode, creating a heavy glitch effect that works best with images that have large sections of block colour.
• Convert RGB to YUV - Converts from RGB888 to the Y'UV444 colour space, mapping the channels respectively. Produces interesting effects when affecting only the Y channel, or only the UV channels.
• Convert YUV to RGB - Converts from Y'UV444 to the RGB888 colour space, mapping the channels respectively.
• Cumulative Math - Performs a cumulative mathematical operation (add / or / xor) on source pixels given a loop bound amount and step, with an option for horizontal or vertical. This can produce heavy glitch effects or ghost images.
• Interlace Lines - Simple horizontal interlace effect with optional independent R/G/B channels.
• Literal Sort - Sorts an image's pixels horizontally by value, using Intensity, Hue, Saturation, Luminance, Red, Green, or Blue as the sort key.
• Low Pass - Transforms the image into a digital signal and performs a low-pass filter. Essentially a blur that targets detailed areas most heavily.
• Lumisort - Shifts pixels up to a certain distance, weighted by the luminance of the pixel.
• Pixel Drag - Picks pixels at random and drags them (either horizontally or vertically) based upon a minimum and maximum drag distance.
• QAM Fault - Emulates a faulty Quadrature Amplitude Modulation system. Supersamples two selected channels of the image, applies a pair of 90-degree phase-shifted carrier waves of a specified frequency, combines the two channels, then performs a demodulation using specified carrier frequencies for each channel. By shifting the demodulation carrier frequencies, you can gain different failure modes.
• Quad Flip - Flips pixel quads to create a subtle blocking effect. The process is invertable, such that performing the operation twice produces the original image. This can produce interesting subtle results when applied with other effects.
• Quadratic Looper - Translates X,Y coordinates based upon a quadratic function with customisable coefficients. Produces repeating loop patterns with varying scales.
• Render Raw File - Renders a raw file as an image, into the current layer, given a pixel format and byte offset. This is a work in progress - there is currently no file browser, so you just have to manually enter the file name, and errors are not displayed.
• Row Shifter - Shifts each row sequentially by a chosen offset, creating a tearing effect. In combination with other effects, can be used to create analog tape pause effects.
• Sigmoid Shifter - Works similarly to the Row Shifter effect, except it uses a sigmoid function to calculate the row offsets, and supports both positive and negative skew.
• Spiral Transform - Translates each pixel from being in right to left, top to bottom sequence, into a spiral pattern.
• Step Slice - A split hold-and-drag effect with customisable position, length, and position settings.
• True Glitch - Compresses the image to a JPEG and fuzzes the data in a deterministic pattern to create the classic blocky broken-JPEG look.

Please direct any bug reports, questions, or feature requests to @gsuberland, the PolyGlitch forum thread, or to one of the threads on the Glitch Artists Collective Facebook page.

This plugin makes use of the DspToolbox library from CodeArtEng, which is distrubted under MIT license - see the Readme.txt file in the DspToolbox director for full information.

This plugin is licensed under The MIT License:

Copyright © 2014 Graham Sutherland

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.