Skip to main content

Triangulizor is a little Python script to apply a “triangular pixel” effect to images, like so:

https://github.com/mccutchen/triangulizor/raw/master/examples/in.jpg

⇊☁⇊

https://github.com/mccutchen/triangulizor/raw/master/examples/out.png

Installation

Use pip to install:

pip install triangulizor

Usage

Command Line Usage

First, find an image to triangulize! To generate the example above, either of these commands will do the trick:

$ triangulizor --show --tile-size=16 examples/in.jpg

The --show flag will cause the resulting image to be displayed immediately instead of written to stdout or to disk. You can also pass in the URL to an image that you want to process:

$ triangulizor --show --tile-size=16 https://github.com/mccutchen/triangulizor/raw/master/examples/in.jpg

All command line options are given below:

$ triangulizor --help

Outputs:

usage: triangulizor [-h] [-t TILE_SIZE] [-v] [-vv] [-s] [infile] [outfile]

Applies a "triangular pixel" effect to an image.

positional arguments:
  infile                Image to process (path or URL; defaults to STDIN)
  outfile               Output file (defaults to STDOUT)

optional arguments:
  -h, --help            show this help message and exit
  -t TILE_SIZE, --tile-size TILE_SIZE
                        Tile size (should be divisible by 2)
  -v, --verbose         Verbose output
  -vv                   Very verbose output
  -s, --show            Immediately display image instead of writing to
                        OUTFILE.

Library Usage

Triangulizor can also be used as a plain old Python library:

>>> import triangulizor
>>> triangulizor.triangulize('examples/in.jpg', 24)
<Image._ImageCrop image mode=RGB size=384x216 at 0x10A5BA758>

Credits

This was inspired entirely by this awesomely helpful blog post by @revdancatt.

Release files for triangulizor 1.0.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for triangulizor 1.0.2
File Size Uploaded
triangulizor-1.0.2.tar.gz 6.0 kB Details

Release files / triangulizor-1.0.2.tar.gz

Download URL triangulizor-1.0.2.tar.gz
Size 6.0 kB
Tags Source
SHA-256 checksum
How to use checksums
1a5fd22fa52fbe02b681b9138b2575e3c0d58748e0ce0dafe5efbb5870887142
BLAKE2b-256 checksum
How to use checksums
2aba88dfa1d1c1791e58eb84d1c7323e5476d6f8fb4016634845da329f591a65
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Release history Release notifications | RSS feed

This release

1.0.2 This release

1 release file

1.0.1

1 release file

1.0.0

1 release file

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page