lastguest / pixeler
CLI Image renderer
Installs: 2 285
Dependents: 0
Suggesters: 0
Security: 0
Stars: 452
Watchers: 13
Forks: 18
Open Issues: 1
Requires
- php: >=5.4
This package is auto-updated.
Last update: 2024-10-16 21:22:41 UTC
README
Render images in CLI with UTF-8 characters.
Installation
Require in your project with composer :
$ composer require lastguest/pixeler
This will also install a pixeler tool in :
your_project_dir/vendor/bin/pixeler
It works exactly like the example below.
Example
Create a file pixel.php
:
<?php // Include autoloader include __DIR__."/vendor/autoload.php"; // Parse options from command line $opts = array_merge([ 'd' => 1, // Dithering mode : 0 = DITHER_NONE, 1 = DITHER_ERROR 'f' => false, 'r' => 1.0, // Resize factor 1.0 = 100% 'w' => 0.75, // Dither treshold weight ], getopt("f:r:w:d:ib")); // An image file/url is required. $opts['f'] || die("Must specify an image file.\n"); // The -i option inverts the image $image = Pixeler\Pixeler::image($opts['f'], $opts['r'], isset($opts['i']), $opts['w'], $opts['d']); // No colors if "-b" is passed isset($opts['b']) && $image->clearColors(); // The Pixeler\Image instance render itself if casted to a string echo $image;
$ php pixel.php -f http://drop.caffeina.co/image/160L0Y3C0a29/vocaloid.jpg -r .25 -w 0.25 -i
$ php pixel.php -f http://flippywall.com/wp-content/uploads/2014/07/Manga-Girl-Wallpaper-16.jpg -r 0.15 -w 0.5 -i
$ php pixel.php -f http://blog.circleci.com/wp-content/uploads/2014/07/elephant.jpg -r 0.3 -w 0.5 -b
Dithering
Use the -d
option to choose 1-bit dithering mode.
Animation Example
You will see a lot of tearing, need some kind of vsync wait.
<?php // Vendors include __DIR__."/vendor/autoload.php"; $screen = new Pixeler\Canvas(160,100); $sh2 = $screen->height()/2; $sh4 = $sh2/1.5; $ph = pi()/32; $i = 0; // To exit, press Ctr-C while(1){ $screen->clear(); for ($x=0,$c=$screen->width(); $x < $c; $x++){ $y = $sh4*sin($i++/128 + $ph*$x); $screen->setPixel($x,$sh2 + $y); $screen->setPixel($x,$sh2 + $y/2); $screen->setPixel($x,$sh2 + $y/4); $screen->setPixel($x,$sh2); } echo $screen; }