Skip to content

瞽字象形PyDrawille : Using Unicode braille characters to draw pixel graphics in a terminal. | 使万国码盲文字符绘制文本字符画

License

Notifications You must be signed in to change notification settings

EillesWan/PyDrawille

Repository files navigation

瞽字象形 PyDrawille

采用万国码之盲文字符在控制台或终端应用中绘制点阵图。

此自述文件亦可见于诸下文字
The README is also in
🇬🇧 英文 English

此库开发,实为避 drawille 库之 AGPLv3 协议绑架。抽丝剥茧,以新逻辑呈同种功能,是为完全独一的软件,意欲完全避开其法律风险。为正本清源,不采用其应用程序接口,不采用同种代码逻辑,以全新之面貌呈现盲文点阵图。

功能说明

类定义

本库定义了一个 CanvasSurface 作为绘制像素画布的基础类。提供多种方法来操作画布,并课最终转为盲文字符串或图像。

基础属性

  • _width: 画布宽度,内部使用,不应直接修改。
  • _height: 画布高度,内部使用,不应直接修改。
  • data: 画布数据,使用 numpy 数组存储,布尔类型,True 表示该像素为突出(存在),False 表示相反。

构造函数

  • __init__: 初始化画布,可以指定宽度、高度、初始数据和填充值。默认情况下,宽度为终端宽度的两倍,高度为终端高度的四倍。

属性

  • surface_width: 获取画布宽度。
  • surface_height: 获取画布高度。
  • surface_size: 获取画布尺寸,返回一个元组 (width, height)

类函数

  • from_image: 从图片创建画布,将图片转换为布尔数组。

实例函数

  • reshape_canvas: 重新设置画布大小,不缩放内容。
  • resize_image: 缩放整个画布,支持多种插值方法。
  • stack: 将另一个画布对象堆叠到当前画布上,支持水平和垂直堆叠。(拼接画布)
  • rorate: 旋转画布及其图像,支持 90 度、180 度和 270 度旋转。
  • reset: 重置画布。
  • get_pixel: 获取指定坐标的像素。
  • set_pixel: 设置指定坐标的像素。
  • set_pixels: 使用 xy 序列设置多个像素,比 set_points 更快。
  • set_points: 使用多组坐标对设置多个像素。
  • set_line: 设置一行像素。
  • set_column: 设置一列像素。
  • set_block: 设置一个区域的像素。
  • set_canvas: 设置画布所有像素。
  • reverse_pixel: 翻转指定坐标的像素。(反色某点)
  • reverse_line: 翻转一行像素。(反色某行)
  • reverse_column: 翻转一列像素。(反色某列)
  • reverse_block: 翻转一个区域的像素。(反色某区域)
  • reverse_canvas: 翻转整个画布的像素。(反色画布)
  • dump_lines: 以行为分割的盲文字符画字符串迭代器。
  • dump: 将画布上的所有像素生成盲文字符画。
  • dump_singleline: 为指定的行生成盲文字符画,迭代每个字符。
  • to_image: 将画布生成图片。
  • dump_image: 将画布生成盲文字符画图片,支持指定字体、背景色和前景色。

静态函数

  • walk_line: 直线迭代器,返回一条直线上的所有坐标。

示例用法

# 创建一个画布
canvas = CanvasSurface(width=100, height=50)

# 设置一些像素
canvas.set_pixel(10, 10, True)
canvas.set_pixel(15, 15, True)

# 生成盲文字符画
braille_art = canvas.dump()
print(braille_art)

# 生成图片
image = canvas.to_image()
image.show()

# 生成盲文字符画图片
font = ImageFont.truetype("FontSupportsBraille.ttf", 24)
braille_image = canvas.dump_image(font, backgrand_color=0, foreground_color=255)
braille_image.show()

致谢

  1. 感谢 自由软件基金会 FSF 在促进软件非自由化方面取得的杰出贡献;所谓的自由软件,倘若仅仅建立于开发者的非自由之上,则无谓之以自由。在 自由软件基金会 的自介辞“我们的使命是在全球范围内促进计算机用户的自由。我们捍卫所有软件用户的权利。”中,我相信他们的的确确在其各类协议中试图保护计算机用户之自由,同时也试图剥夺开发者自由开发软件的权利。我相信,真正的自由,只有建立在全人类的广度之上,才可以称得上是真正的自由,一部分人的自由不叫自由,那只不过是他们对其他人的奴役。我们需要捍卫开发者的自由,捍卫开发者合理化自己知识产权的权利!

About

瞽字象形PyDrawille : Using Unicode braille characters to draw pixel graphics in a terminal. | 使万国码盲文字符绘制文本字符画

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published