bitmapascii's Introduction

BitmapASCII

Extends C#'s Bitmap class to add a PrintASCII() function that can be used in Windows console applications to render images as crude, colorful text.

The latest version is on the releases page.

PrintASCII()

void PrintASCII(this Bitmap src, int minSide, bool fit = true,bool useLongArray=false)

Parameters

minSide - the minimum width or height of the image specified as a number of columns or rows. The smallest dimension of the image is used.
fit - Should the image be resized to fit inside console window if minSide would overflow.
useLongArray - Two character shading arrays are provided to fill in each cell. The short one is used by default. The long one uses more characters but you might prefer one style over the other.

DominantConsoleColors()

ConsoleColor[] DominantConsoleColors(this Bitmap src, int num = 0, bool useLong = false)

num - the number of colors to return, default is all colors in descenting order.
useLongArray - Two character shading arrays are provided to fill in each cell. The short one is used by default. The long one uses more characters but you might prefer one style over the other.

DominantConsoleColor()

As above, but directly returns the most dominant ConsoleColor.

Examples

Bitmap bmp = new Bitmap(filePath);
bmp.PrintASCII();                  //print using default settings
bmp.PrintASCII(width);             //print at a desired width, but stay responsive
bmp.PrintASCII(width,false);       //print at a fixed width
bmp.PrintASCII(width, true, true); //print responsively and using the more detailed shading characters
ConsoleColor[] cols = bmp.DominantConsoleColors(3); //return an array of the three most dominant colors in the image
Console.ForegroundColor = bmp.DominantConsoleColor(); //set the console foreground color to match the image accent