etxt

Etxt

ETXT adalah paket untuk rendering teks vektorial ¹ di golang yang dirancang untuk digunakan dengan ebitengine , mesin game 2D yang dibuat oleh Hajime Hoshi.

Sementara Ebitengine sudah memasukkan paket Ebiten/V2/Text/V2 , Etxt memiliki beberapa keunggulan di atasnya:

• Membuat ukuran teks mudah diubah.
• Memberi penekanan pada mendapatkan penskalaan tampilan yang benar.
• Menyingkirkan font.Face untuk selamanya.
• Memberikan dokumentasi dan contoh berkualitas tinggi.
• Membantu dengan beberapa tambahan seperti tebal palsu, oblique palsu, pembungkus garis dasar, font tertanam, kuantisasi mesin terbang, jarak garis, dll.
• Mengekspos cache, rasterizer, dan sizer untuk Anda beradaptasi jika Anda memiliki kebutuhan yang lebih maju.

Apa yang tidak dilakukan Etxt :

• Tidak ada tata letak teks umum. Fitur -fitur seperti Bidi, perincian, pembentukan, pengujian hit umum, pembenaran dan lainnya tidak tercakup dan dalam kebanyakan kasus bukanlah tujuan utama untuk paket ini.
• Buruk atau tidak ada dukungan untuk skrip kompleks (misalnya arab) atau tata letak teks vertikal (mis. Jepang). Perhatikan bahwa ebiten/v2/teks/v2 tarif jauh lebih baik dalam hal ini.
• Tak satu pun dari hal-hal yang benar-benar diinginkan orang: bayangan dan garis besar, koreksi gamma, antialiasing subpiksel, pemecahan garis Knuth-plass, dukungan yang lebih baik untuk shader, dll. Beberapa sudah dapat dipalsukan dengan kasar, beberapa akan ditambahkan di masa depan ... tetapi ini adalah situasinya sekarang.

Jika Anda tidak terbiasa dengan istilah dan konsep tipografi, saya sangat merekomendasikan membaca bab -bab pertama konvensi Glyph Freetype; Salah satu referensi terbaik tentang topik yang dapat Anda temukan di internet.

Contoh Kode

Lebih sedikit bicara dan lebih banyak kode!

 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 ) }
}

Anda dapat mencoba menjalankan ini sendiri dengan ² :

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

Atau, Anda dapat pergi ke https://tinne26.github.io/etxt-examples/ dan klik contoh pertama untuk versi web.

Ini adalah contoh yang sangat sederhana dan mandiri. Jika Anda ingin mempelajari lebih lanjut, pastikan untuk melihat ETXT/contoh!

Bisakah saya menggunakan paket ini tanpa ebitengine?

Ya, Anda dapat mengkompilasinya dengan -tags gtxt . Perhatikan bahwa gtxt akan membuat gambar teks terjadi pada CPU, jadi jangan mencoba menggunakannya untuk aplikasi real-time. Secara khusus, berhati -hatilah untuk tidak secara tidak sengaja menggunakan gtxt dengan ebitengine (mereka kompatibel dalam banyak kasus, tetapi kinerja akan mati).

Pengujian, kontribusi dan lainnya

• Untuk pengujian, lihat instruksi pada etxt/test .
• Jika Anda memiliki pertanyaan atau saran untuk perbaikan, jangan ragu untuk berbicara, saya selalu senang menjelaskan atau berdiskusi.
• Kalau tidak, saya tidak mencari kontributor atau bantuan umum.

Catatan kaki

1. Jika Anda menggunakan font vektorial seperti pixel-art, baca tips ini. ↩

2. Anda akan memerlukan golang> = 1.18, dan jika Anda belum pernah menggunakan ebitengine sebelumnya, Anda mungkin perlu menginstal beberapa dependensi (biasanya hanya pada linux atau freebsd). ↩