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上）。 ↩