pix

pixelsort

Pixel sorting images in python.

Showing:

Popularity

Downloads/wk

0

GitHub Stars

494

Maintenance

Last Commit

1yr ago

Contributors

12

Package

Dependencies

1

License

Categories

Readme

pixelsort

What is Pixel Sorting?

Have a look at this post or /r/pixelsorting

Dependencies

Should work in both Python 2 and 3, but Python 3 is recommended.

Usage

From the command line:

pip install pixelsort
python3 -m pixelsort %PathToImage% [options]

Tip: To replicate Kim Asendorf's original processing script, first sort vertically and then horizontally in threshold (default) mode:

python3 -m pixelsort %PathToImage% -a 90
python3 -m pixelsort %PathToSortedImage%

As a package:

>>> from pixelsort import pixelsort
>>> from PIL import Image
>>> a = Image.open("examples/image.jpg")
>>> a
<PIL.JpegImagePlugin.JpegImageFile image mode=RGB size=576x324 at 0x7F8F6A2AC208>
>>> pixelsort(a)
<PIL.Image.Image image mode=RGBA size=576x324 at 0x7F8F66AA57B8>

Parameters:

ParameterFlagDescription
Interval function-iControls how the intervals used for sorting are defined. See below for more details and examples. Threshold by default.
Output path-oPath of output file. Uses the current time for the file name by default.
Randomness-rWhat percentage of intervals not to sort. 0 by default.
Threshold (lower)-tHow dark must a pixel be to be considered as a 'border' for sorting? Takes values from 0-1. 0.25 by default. Used in edges and threshold modes.
Threshold (upper)-uHow bright must a pixel be to be considered as a 'border' for sorting? Takes values from 0-1. 0.8 by default. Used in threshold mode.
Char. length-cCharacteristic length for the random width generator. Used in mode random and waves.
Angle-aAngle at which you're pixel sorting in degrees. 0 (horizontal) by default.
External interval file-fImage used to define intervals. Must be black and white.
Sorting function-sSorting function to use for sorting the pixels. Lightness by default.
Mask-mImage used for masking parts of the image.
Logging level-lLevel of logging statements made visible. Choices include DEBUG, INFO, WARNING, ERROR, and CRITICAL. WARNING by default.

Interval Functions

Interval functionDescription
randomRandomly generate intervals. Distribution of widths is linear by default. Interval widths can be scaled using clength.
edgesPerforms an edge detection, which is used to define intervals. Tweak threshold with threshold.
thresholdIntervals defined by lightness thresholds; only pixels with a lightness between the upper and lower thresholds are sorted.
wavesIntervals are waves of nearly uniform widths. Control width of waves with clength.
fileIntervals taken from another specified input image. Must be black and white, and the same size as the input image.
file-edgesIntevals defined by performing edge detection on the file specified by -f. Must be the same size as the input image.
noneSort whole rows, only stopping at image borders.

Sorting Functions

Sorting functionDescription
lightnessSort by the lightness of a pixel according to a HSV representation.
hueSort by the hue of a pixel according to a HSV representation.
saturationSort by the saturation of a pixel according to a HSV representation.
intensitySort by the intensity of a pixel, i.e. the sum of all the RGB values.
minimumSort on the minimum RGB value of a pixel (either the R, G or B).

Examples

python3 -m pixelsort examples/image.jpg -i random -c 20

random

python3 -m pixelsort examples/image.jpg -i edges -t .5

edges

  • file: Intervals taken from image specified with -f. Must be black and white.

python3 -m pixelsort examples/image.jpg -i file -f examples/intervals.png

file

(generated with elementary-ca)

file

  • mask: Mask taken from image specified with -m. Must be black and white.

python3 -m pixelsort examples/image.jpg -i random -c 20 -m examples/mask.png

file

file

Todo

  • Allow defining different intervals for different channels.

Based on https://gist.github.com/prophetgoddess/667c5554e5d9d9a25ae6

Rate & Review

Great Documentation0
Easy to Use0
Performant0
Highly Customizable0
Bleeding Edge0
Responsive Maintainers0
Poor Documentation0
Hard to Use0
Slow0
Buggy0
Abandoned0
Unwelcoming Community0
100