etxt

eTXT

ETXT是Golang中矢量¹文本渲染的软件包，该渲染旨在与Hajime Hoshi制造的2D游戏引擎Ebitengine一起使用。

尽管Ebitengine已经包含Ebiten/V2/Text/V2软件包，但ETXT具有一些优势：

• 使文本大小易于更改。
• 强调正确的显示缩放。
• 摆脱font.Face 。
• 提供高质量的文档和示例。
• 帮助一些额外的额外功能，例如人造粗体，人造倾斜，基本线条包装，嵌入式字体，字形量化，线间距等。
• 如果您有更多的高级需求，则会揭示缓存，栅格式和棉布供您适应。

ETXT不做什么：

• 没有一般文本布局。 BIDI，逐项，整形，一般命中测试，理由和其他功能均未涵盖，并且在大多数情况下不是此软件包的主要目标。
• 对复杂脚本（例如阿拉伯语）或垂直文本布局（例如日语）的不良支持或不支持。请注意，在这方面，Ebiten/V2/Text/V2的票价要好得多。
• 人们实际想要的东西都不是：阴影和轮廓，伽马校正，子像素抗质量，knuth-plass line折断，对着色器的更好的支持等。有些人已经可以被伪装成混乱，将来会添加一些...但是现在情况就是这样。

如果您不熟悉版式的术语和概念，我强烈建议您阅读弗泰普（Freetype）glyph公约的第一章；您可以在Internet上找到的关于主题的最佳参考。

代码示例

更少的谈话和更多的代码！

 package main

import ( "math" ; "image/color" )
import "github.com/hajimehoshi/ebiten/v2"
import "github.com/tinne26/etxt"
import "github.com/tinne26/fonts/liberation/lbrtserif"

const WordsPerSec = 2.71828
var Words = [] string {
	"solitude" , "joy" , "ride" , "whisper" , "leaves" , "cookie" ,
	"hearts" , "disdain" , "simple" , "death" , "sea" , "shallow" ,
	"self" , "rhyme" , "childish" , "sky" , "tic" , "tac" , "boom" ,
}

// ---- Ebitengine's Game interface implementation ----

type Game struct { text * etxt. Renderer ; wordIndex float64 }

func ( self * Game ) Layout ( winWidth int , winHeight int ) ( int , int ) {
	scale := ebiten . DeviceScaleFactor () // *
	// * ebiten.Monitor().DeviceScaleFactor() in >=v2.7.0
	self . text . SetScale ( scale ) // relevant for HiDPI
	canvasWidth  := int ( math . Ceil ( float64 ( winWidth ) * scale ))
	canvasHeight := int ( math . Ceil ( float64 ( winHeight ) * scale ))
	return canvasWidth , canvasHeight
}

func ( self * Game ) Update () error {
	newIndex := ( self . wordIndex + WordsPerSec / 60.0 )
	self . wordIndex = math . Mod ( newIndex , float64 ( len ( Words )))
	return nil
}

func ( self * Game ) Draw ( canvas * ebiten. Image ) {
	// background color
	canvas . Fill (color. RGBA { 229 , 255 , 222 , 255 })
	
	// get screen center position
	bounds := canvas . Bounds () // assumes origin (0, 0)
	x , y := bounds . Dx () / 2 , bounds . Dy () / 2

	// draw text
	word := Words [ int ( self . wordIndex )]
	self . text . Draw ( canvas , word , x , y )
}

// ---- main function ----

func main () {
	// create text renderer, set the font and cache
	renderer := etxt . NewRenderer ()
	renderer . SetFont ( lbrtserif . Font ())
	renderer . Utils (). SetCache8MiB ()
	
	// adjust main text style properties
	renderer . SetColor (color. RGBA { 239 , 91 , 91 , 255 })
	renderer . SetAlign ( etxt . Center )
	renderer . SetSize ( 72 )

	// set up Ebitengine and start the game
	ebiten . SetWindowTitle ( "etxt/examples/ebiten/words" )
	err := ebiten . RunGame ( & Game { text : renderer })
	if err != nil { panic ( err ) }
}

您可以尝试使用² ：

 go run github.com/tinne26/etxt/examples/ebiten/words@latest

另外，您可以访问https://tinne26.github.io/etxt-examples/，然后单击Web版本的第一个示例。

这是一个非常简单且独立的例子。如果您想了解更多信息，请确保查看ETXT/示例！

我可以不用Ebitengine使用此包装吗？

是的，您可以使用-tags gtxt对其进行编译。请注意， gtxt将使文本绘图发生在CPU上，因此请勿尝试将其用于实时应用程序。特别是，请注意不要意外地将gtxt与Ebitengine一起使用（在许多情况下它们是兼容的，但性能会消失）。

测试，贡献和其他

• 对于测试，请参阅有关etxt/test的说明。
• 如果您对改进有任何疑问或建议，请随时讲话，我总是很乐意解释或讨论。
• 否则，我不是在寻找贡献者，也不是一般的帮助。

脚注

1. 如果使用类似像素的矢量字体，请阅读以下技巧。 ↩

2. 您需要Golang> = 1.18，如果您以前从未使用过Ebitengine，则可能需要安装一些依赖项（通常仅在Linux或FreeBSD上）。 ↩