img2ascii

README

img2ascii

|

Image to ascii (and not only) conversion library and command line tool

Usage

func ExampleImage_Encode() {
	ascii.NewImage().Encode(os.Stdout, i)
	// Output:
	// =++++***###%%%%%%%%%######****************######
	// ===+++***###%%%%%%%%%######****************#####
	// -===+++***###%%%%%%%%%######****************####
	// --===+++***###%%%%%%%%%######****************###
	// ---===+++***###%%%%%%%%%######****************##
	// ----===+++***###%%%%%%%%%######****************#
	// -----===+++***###%%%%%%%%%######****************
	// ------===+++***###%%%%%%%%%######***************
	// -------===+++***###%%%%%%%%%######**************
	// ==------===+++***###%%%%%%%%%######*************
	// ===------===+++***###%%%%%%%%%######************
	// ====------===+++***###%%%%%%%%%######***********
	// =====------===+++***###%%%%%%%%%######**********
	// ======------===+++***###%%%%%%%%%######*********
	// =======------===+++***###%%%%@%%%%######********
	// ========------===+++***###%%%@%%%%%######*******
	// =========------===+++***###%%@%%%%%%######******
	// ===#@@===@@*--@#@*%@#+*@%@%#%@%%@@@%%######*****
	// ===@*=====+@--@+=@*+@++@##@##@%%@@%@%%######****
	// ===*%%==#@@@--@--@==@++@**@##@%%@@@@%%@@#####***
	// =====%*=@++@=-@--@-=@=+@*#@**@##@@%%%%%%%#####**
	// ===@@%==#@#@==@--@--@==@%@#**@##%@@@%%%%%%######
	// ===============------==@+++****###%%%%%%%%%#####
	// -===============------=@=++++***###%%%%%%%%%####
	// --=*@@===@=======------====+++***###%%%%%%%%%###
	// ---@==@==@========-------===+++***###%%%%%%%%%##
	// ---@=====@=========-------===+++***###%%%%%%%%%#
	// --@@@=@==@==+@@*====-=%@@--+@@*++@%@%@@@%%%%%%%%
	// ---@--@==@==@*+@=====%*=---@**@++@##@%%@%%%%%%%%
	// :--@--@==@==@@@@=====@=----@==@=+@+*@*#@#%%%%%%%
	// ::-@--@-=@==@*=======%*=---%++@==@++@**@##%%%%%%
	// :::@--@--@==+@@@==@==+%@@--+@@+==@++@**@###%%%%%
	// ::::------===============-------===+++***###%%%%
	// :::::------================------===+++***###%%%
	// ::::::------================------===+++***###%%
	// :::::::------================------===+++***###%
	// ::::::::------================------===+++***###
	// :::::::::------================------===+++***##
	// -:::::::::-------===============------===+++***#
	// --:::::::::------================------===+++***
	// ---:::::::::-------===============------===+++**
	// =---:::::::::-------===============------===+++*
	// ==---:::::::::-------===============------===+++
	// ===----:::::::::------===============------===++
	// +===----:::::::::------===============------===+
	// ++===----:::::::::------===============------===
	// +++====---:::::::::------===============------==
	// *+++====---:::::::::------===============------=
}

Screenshots

ASCII

ANSI 256 colors Single Height

ANSI 256 colors Half Height

ANSI 24bit color Single Height

ANSI 24bit color Half Height

Documentation

Index

• Constants
• type Encoder

Constants

const HalfHeightRatio = 9 / 11.

HalfHeightRatio represents the width/height ratio of a character for half row pixel height

const SingleHeightRatio = 9 / 22.

SingleHeightRatio represents the width/height ratio of a character for single row pixel height

Types

type Encoder

type Encoder interface {
	Encode(w io.Writer, m image.Image) error
	GetFontRatio() float64
}

Encoder is the interface implemented by all converters