etxtダウンロードetxtソースコードのダウンロード

etxt

フォントのダウンロード

v0.0.9

ダウンロード

etxt

ETXTは、Hajime Hoshiによって作られた2DゲームエンジンであるEbitengineで使用するように設計されたGolangでのVectorial ¹テキストレンダリングのパッケージです。

eBitEngineには既にEBITEN/V2/TEXT/V2パッケージが含まれていますが、 ETXTにはいくつかの利点があります。

テキストサイズを簡単に変更できます。
ディスプレイのスケーリングを正しくすることに重点を置いています。
font.Faceを永久に取り除きます。
高品質のドキュメントと例を提供します。
フェイクボールド、フェイク斜め、基本的なラインラッピング、埋め込みフォント、グリフ量子化、ライン間隔などのエキストラを助けます。
より高度なニーズがある場合は、キャッシュ、ラスター、サイザーを露出させて、適応してください。

ETXTがしないこと：

一般的なテキストレイアウトはありません。 BIDI、アイテム化、シェーピング、一般的なヒットテスト、正当化などの機能はカバーされておらず、ほとんどの場合、このパッケージの主な目標ではありません。
複雑なスクリプト（アラビア語など）のサポートが不十分または垂直テキストレイアウト（日本語など）。 Ebiten/V2/Text/V2は、この点ではるかに優れていることに注意してください。
影と輪郭、ガンマ補正、サブピクセルのアンチアライアス、クヌースプラスラインブレイク、シェーダーのより良いサポートなど、人々が実際に望んでいるものはどれもありません。一部はすでに粗雑に偽造できます。

タイポグラフィの用語や概念に慣れていない場合は、Freetype Glyph Conventionsの最初の章を読むことを強くお勧めします。インターネット上で見つけることができるトピックに関する最高の参照の1つ。

コードの例

より少ない話とより多くのコード！

 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でテキスト描画を行うことに注意してください。そのため、リアルタイムアプリケーションに使用しようとしないでください。特に、eBitengineでgtxt誤って使用しないように注意してください（多くの場合互換性がありますが、パフォーマンスは死にます）。

テスト、貢献など

テストについては、 etxt/testの指示を参照してください。
改善のための質問や提案がある場合は、お気軽にお話ししてください。私はいつでも説明したり議論したりしてうれしいです。
そうでなければ、私は貢献者や一般的な助けを探していません。

Pixel-Artのようなベクトルフォントを使用している場合は、これらのヒントをお読みください。 ↩
Golang> = 1.18が必要になります。以前にEbitengineを使用したことがない場合は、依存関係をいくつかインストールする必要がある場合があります（通常はLinuxまたはFreeBSDにのみ）。 ↩

拡大する

追加情報