使用image2ascii库将图片转换为ASCII字符画

image2ascii是一个Go语言库，可以将图片转换为ASCII字符画。下面我将详细介绍如何使用这个库。

安装

首先安装image2ascii库：

go get github.com/qeesung/image2ascii/convert

基本使用示例

package main

import (
	"fmt"
	"github.com/qeesung/image2ascii/convert"
	"image"
	_ "image/jpeg"
	_ "image/png"
	"os"
)

func main() {
	// 打开图片文件
	file, err := os.Open("example.jpg")
	if err != nil {
		fmt.Println("打开图片失败:", err)
		return
	}
	defer file.Close()

	// 解码图片
	img, _, err := image.Decode(file)
	if err != nil {
		fmt.Println("解码图片失败:", err)
		return
	}

	// 创建转换器
	converter := convert.NewImageConverter()
	
	// 设置转换选项
	options := convert.DefaultOptions
	options.FixedWidth = 100  // 设置输出宽度
	options.FixedHeight = 40  // 设置输出高度
	options.Colored = true    // 是否使用彩色输出
	options.Reversed = false  // 是否反转字符(黑白反转)

	// 转换为ASCII
	asciiArt := converter.Image2ASCIIString(img, &options)
	
	// 打印结果
	fmt.Println(asciiArt)
}

高级选项

image2ascii提供了多种配置选项来自定义输出：

options := convert.DefaultOptions
options.FixedWidth = 120      // 输出宽度(字符数)
options.FixedHeight = 60      // 输出高度(字符数)
options.Colored = true        // 彩色输出
options.Reversed = false      // 反转颜色
options.Ratio = 2.0           // 宽高比调整
options.FitScreen = false     // 是否适应终端大小
options.StretchedScreen = false // 是否拉伸适应

支持的字符集

你可以自定义使用的字符集：

options.CharSet = []string{"@", "#", "S", "%", "?", "*", "+", ";", ":", ",", "."}

从URL加载图片

func convertFromURL(url string) {
	resp, err := http.Get(url)
	if err != nil {
		fmt.Println("获取图片失败:", err)
		return
	}
	defer resp.Body.Close()

	img, _, err := image.Decode(resp.Body)
	if err != nil {
		fmt.Println("解码图片失败:", err)
		return
	}

	converter := convert.NewImageConverter()
	asciiArt := converter.Image2ASCIIString(img, &convert.DefaultOptions)
	fmt.Println(asciiArt)
}

保存到文件

func saveToFile(asciiArt string, filename string) {
	err := os.WriteFile(filename, []byte(asciiArt), 0644)
	if err != nil {
		fmt.Println("保存文件失败:", err)
		return
	}
	fmt.Println("ASCII艺术已保存到", filename)
}

完整示例

package main

import (
	"fmt"
	"github.com/qeesung/image2ascii/convert"
	"image"
	_ "image/jpeg"
	_ "image/png"
	"net/http"
	"os"
)

func main() {
	// 1. 从本地文件转换
	convertLocalImage("input.jpg", "output.txt")

	// 2. 从URL转换
	convertFromURL("https://example.com/image.jpg")
}

func convertLocalImage(inputPath, outputPath string) {
	file, err := os.Open(inputPath)
	if err != nil {
		fmt.Println("打开图片失败:", err)
		return
	}
	defer file.Close()

	img, _, err := image.Decode(file)
	if err != nil {
		fmt.Println("解码图片失败:", err)
		return
	}

	converter := convert.NewImageConverter()
	options := convert.DefaultOptions
	options.FixedWidth = 100
	options.FixedHeight = 50
	options.Colored = true

	asciiArt := converter.Image2ASCIIString(img, &options)
	
	// 打印到控制台
	fmt.Println(asciiArt)
	
	// 保存到文件
	saveToFile(asciiArt, outputPath)
}

func convertFromURL(url string) {
	resp, err := http.Get(url)
	if err != nil {
		fmt.Println("获取图片失败:", err)
		return
	}
	defer resp.Body.Close()

	img, _, err := image.Decode(resp.Body)
	if err != nil {
		fmt.Println("解码图片失败:", err)
		return
	}

	converter := convert.NewImageConverter()
	asciiArt := converter.Image2ASCIIString(img, &convert.DefaultOptions)
	fmt.Println(asciiArt)
}

func saveToFile(asciiArt string, filename string) {
	err := os.WriteFile(filename, []byte(asciiArt), 0644)
	if err != nil {
		fmt.Println("保存文件失败:", err)
		return
	}
	fmt.Println("ASCII艺术已保存到", filename)
}

注意事项

1. 对于彩色输出，确保你的终端支持ANSI颜色代码
2. 较大的图片转换可能需要更多时间
3. 输出效果受终端字体影响，等宽字体效果最佳
4. 可以调整字符集来获得不同的艺术效果

这个库简单易用，适合快速将图片转换为ASCII艺术，可以用于生成终端艺术、创建独特的文本图像等场景。