phixelgator

KO | EN

gitlite — search

#javascript #python #hacktoberfest #go #android #deep-learning #docker #nodejs #macos #java #awesome #kubernetes #awesome-list #openai

(★ 54)

Convert photos to pixel art at the command line.

파일 탐색기

최종 버전 다운로드 (.zip)

- - appleii.json
  - atari2600.json
  - commodore64.json
  - contra.json
  - gameboy.json
  - grayscale.json
  - hyrule.json
  - intellivision.json
  - kungfu.json
  - mario.json
  - nes.json
  - sega.json
  - tetris.json
- - appleii.json
  - atari2600.json
  - commodore64.json
  - contra.json
  - gameboy.json
  - grayscale.json
  - hyrule.json
  - intellivision.json
  - kungfu.json
  - mario.json
  - nes.json
  - sega.json
  - tetris.json
- - appleii.json
  - atari2600.json
  - commodore64.json
  - contra.json
  - gameboy.json
  - grayscale.json
  - hyrule.json
  - intellivision.json
  - kungfu.json
  - mario.json
  - nes.json
  - sega.json
  - tetris.json
- appleii.png
- atari2600.png
- commodore64.png
- contra.png
- ernie.jpg
- gameboy.png
- grayscale.png
- hyrule.png
- intellivision.png
- kungfu.png
- mario.png
- nes.png
- sega.png
- test_palette_generator.sh
- test_phixelgator.sh
- tetris.png
phixelgator.py
README.md

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

<h1>Phixelgator</h1>
Sorry for the dumb title! I couldn't think of anything. This is a command line utility that converts a photo to "pixel art", i.e. a lower resolution version of the same image with a custom color palette.

The idea is that you can specify one of the built-in palettes to use with the `-p` flag, or you can load a custom palette with the `-c` flag. The palette files should be in a valid JSON subset consisting of ONE top-level array containing an arbitrary number of arrays that all have EXACTLY three elements, all integers from 0-255. These are representative of RGB values. You can set the pixel width/height of the monochrome blocks to be generated with the `-b` option. Default is to create 8x8 blocks.

Aside from some basic, tangential image manipulation features like auto-cropping and resizing, the main extra feature is the ability to generate custom color palette files with an input image. Run phixelgator with the `-g` flag to convert the input image into a color palette file that can then be used with the `-c` flag. It's not recommended that you use palette files created with very complex images, as extremely large color palettes are the biggest bottleneck in performance. If you just want all the original colors of the image available with a more pixelized look, you can just run it without the `-p` or `-c` flag.

<h2>Installation</h2>
I've tested this successfully on Ubuntu Linux, OSX, and Windows. Dependencies are python &gt;= 2.7 and the python imaging library "PIL". It should work with older versions of python as well, but you'll have to install the argparse library separately. This should be enough on mac and linux:

<pre>
sudo easy_install PIL 
sudo easy_install argparse
</pre>

On Windows, you can just get the installers from the site or whatever people do on Windows :P

Once that stuff is done, checkout the repo, and make sure it's executable:

<pre>
git clone https://github.com/nathanharper/phixelgator.git
cd phixelgator
chmod +x phixelgator.py
./phixelgator.py -h
</pre>

That's it! The last line in there should print the help info, which should be very up-to-date. You can also check out the bash scripts in the "tests" directory if you want to see some examples.

<h2>Examples</h2>
Here's a before and after of my cat using the Atari 2600 color palette.

Then you do a little... `phixelgator.py -b4 -p atari2600 ernie.jpg atari2600.png`

And voila!

Here are the other default palettes.

<h3>Apple II</h3>
`phixelgator.py -b4 -p appleii ernie.jpg appleii.png`
<img src="tests/appleii.png" />

<h3>Commodore 64</h3>
`phixelgator.py -b4 -p commodore64 ernie.jpg commodore64.png`
<img src="tests/commodore64.png" />

<h3>Contra</h3>
`phixelgator.py -b4 -p contra ernie.jpg contra.png`
<img src="tests/contra.png" />

<h3>Gameboy</h3>
`phixelgator.py -b4 -p gameboy ernie.jpg gameboy.png`
<img src="tests/gameboy.png" />

<h3>Grayscale</h3>
`phixelgator.py -b4 -p grayscale ernie.jpg grayscale.png`
<img src="tests/grayscale.png" />

<h3>Hyrule</h3>
`phixelgator.py -b4 -p hyrule ernie.jpg hyrule.png`
<img src="tests/hyrule.png" />

<h3>Intellivision</h3>
`phixelgator.py -b4 -p intellivision ernie.jpg intellivision.png`
<img src="tests/intellivision.png" />

<h3>Kungfu</h3>
`phixelgator.py -b4 -p kungfu ernie.jpg kungfu.png`
<img src="tests/kungfu.png" />

<h3>Super Mario Bros.</h3>
`phixelgator.py -b4 -p mario ernie.jpg mario.png`
<img src="tests/mario.png" />

<h3>NES</h3>
`phixelgator.py -b4 -p nes ernie.jpg nes.png`
<img src="tests/nes.png" />

<h3>Sega</h3>
`phixelgator.py -b4 -p sega ernie.jpg sega.png`
<img src="tests/sega.png" />

<h3>Tetris</h3>
`phixelgator.py -b4 -p tetris ernie.jpg tetris.png`
<img src="tests/tetris.png" />

Mileage may vary depending on the palette you used, the colors used in the original image, the size of the original image, and the block size selected. All the samples above are using 4x4 monochrome blocks, but in many cases the default 8 will suffice.

<h2>Acknowledgement</h2>
This tool is *heavily* inspired by a site (which is now down) that was created by:
<br />
<a href="http://www.johnnylml.com/">John Lee</a> and <a href="http://famousaspect.com/">Ethan Levy</a>

phixelgator

파일 탐색기

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

phixelgator

파일 탐색기

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README