32
GitHub - qeesung/image2ascii: Convert image to ASCII
source link: https://github.com/qeesung/image2ascii
Go to the source link to view the article. You can view the picture content, updated content and better typesetting reading experience. If the link is broken, please click the button below to view the snapshot at that time.
README.md
? Image2ascii
Image2ASCII is a library that converts images into ASCII images and provides command-line tools for easy use.
Installation
go get github.com/qeesung/image2ascii
CLI usage
image2ascii version: image2ascii/1.0.0 >> HomePage: https://github.com/qeesung/image2ascii >> Issue : https://github.com/qeesung/image2ascii/issues >> Author : qeesung Usage: image2ascii [-s] -f <filename> -r <ratio> -w <width> -g <height> Options: -c Colored the ascii when output to the terminal (default true) -f string Image filename to be convert -g int Expected image height, -1 for image default height (default -1) -r float Ratio to scale the image, ignored when use -w or -g (default 1) -s Fit the terminal screen, ignored when use -w, -g, -r (default true) -w int Expected image width, -1 for image default width (default -1)
convert the image to ascii image with fixed width and height
# width: 100 # height: 30 image2ascii -f example/images/baozou.jpg -w 100 -g 30
convert the image to ascii image by ratio
# ratio: 0.3 # width: imageWidth * 0.3 # height: imageHeight * 0.3 image2ascii -f example/images/pikaqiu.jpg -r 0.3
convert the image to ascii fit the screen
image2ascii -f example/images/lufei.jpg -s
convert the image without the color
image2ascii -f example/images/lufei.jpg -s -c=false
convert the image disable fit the screen
image2ascii -f example/images/lufei.jpg -s=false
Library usage
package main import ( "fmt" "github.com/qeesung/image2ascii/convert" _ "image/jpeg" _ "image/png" ) func main() { fmt.Print(convert.ImageFile2ASCIIString("example/images/baozou.jpg", &convert.Options{ Ratio: 0.5, })) }
convert options
type Options struct { Ratio float64 . // Scale Ratio ExpectedWidth int // Convert the image with fixed width ExpectedHeight int // Convert the image with fixed height FitScreen bool // Scale the image to fit the tereminal screen Colored bool // if convert the image to colored ascii }
supported convert function
// convert a image object to ascii matrix func Image2ASCIIMatrix(image image.Image, imageConvertOptions *Options) []string {} // convert a image object to ascii matrix and then join the matrix to a string func Image2ASCIIString(image image.Image, options *Options) string {} // convert a image object by input a string to ascii matrix then join the matrix to a string func ImageFile2ASCIIString(imageFilename string, option *Options) string {}
Sample outputs
Raw Image ASCII ImageLicense
This project is under the MIT License. See the LICENSE file for the full license text.
Recommend
About Joyk
Aggregate valuable and interesting links.
Joyk means Joy of geeK