etxt

etxt

ETXT - это пакет для вектора ¹ текста, рендеринг в Голанге, предназначенный для использования с EbitingRineing , 2D Game Engine, изготовленным Hajime Hoshi.

В то время как Ebitinginer уже включает в себя пакет Ebiten/V2/Text/V2 , ETXT имеет некоторые преимущества перед ним:

• Делает размер текста легким в изменении.
• Уделяет акцент на правильном масштабировании дисплея.
• Избавляется от font.Face навсегда.
• Предоставляет высококачественную документацию и примеры.
• Помогает с некоторыми дополнениями, такими как Faux Bold, искусственная наклонная, базовая линейная упаковка, встроенные шрифты, квантование глифа, интервал линий и т. Д.
• Выставьте кеши, растировы и сизеры для адаптации, если у вас есть более усовершенствованные потребности.

Что Etxt не делает:

• Нет общего текста. Такие функции, как BIDI, элемент, формирование, общее тестирование ударов, оправдание и другие, не покрываются, и в большинстве случаев не являются основной целью для этого пакета.
• Плохо или нет поддержки сложных сценариев (например, арабского языка), а также вертикальных текстовых макетов (например, японский). Обратите внимание, что Ebiten/V2/Text/V2 намного лучше в этом отношении.
• Ничего из вещей, которую люди на самом деле хотят: тени и очертания, гамма-коррекция, субпиксельные антиалиазии, разрыв линии Кнут-Плас, лучшая поддержка шейдеров и т. Д. Некоторые из них уже могут быть грубо фальсифицированы, некоторые будут добавлены в будущем ... но сейчас это ситуация.

Если вы не знакомы с типографическими терминами и концепциями, я настоятельно рекомендую прочитать первые главы конвенций Freetype Glyph; Один из лучших ссылок на тему, которые вы можете найти в Интернете.

Пример кода

Меньше разговоров и больше кода!

 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/ и нажать на первый пример для веб-версии.

Это очень простой и автономный пример. Если вы хотите узнать больше, не забудьте взглянуть на Etxt/Примеры!

Могу ли я использовать этот пакет без EBITRINGINE?

Да, вы можете скомпилировать его с -tags gtxt . Обратите внимание, что gtxt сделает текстовый рисунок на процессоре, поэтому не пытайтесь использовать его для приложений в реальном времени. В частности, будьте осторожны, чтобы не случайно использовать gtxt с Ebitinginger (они совместимы во многих случаях, но производительность умрет).

Тестирование, вклады и другие

• Для тестирования см. Инструкции по etxt/test .
• Если у вас есть какие -либо вопросы или предложения по улучшениям, не стесняйтесь говорить, я всегда рад объяснить или обсудить.
• В противном случае я не ищу участников и общей помощи.

Сноски

1. Если вы используете векториальные шрифты, похожие на пиксель, прочитайте эти советы. ↩

2. Вам понадобится Golang> = 1,18, и если вы никогда раньше не использовали Ebitringine, вам может потребоваться установить некоторые зависимости (обычно только на Linux или FreeBSD). ↩