etxt

etxt

ETXT عبارة عن حزمة لعرض النص المتجهية ¹ في Golang مصممة لاستخدامها مع Ebitengine ، محرك اللعبة ثنائية الأبعاد صنعته Hajime Hoshi.

في حين أن Ebitengine يتضمن بالفعل حزمة الأرباح الكرةفية/V2/Text/V2 ، فإن ETXT لديها بعض المزايا عليها:

• يجعل حجم النص سهل التغيير.
• يركز على الحصول على تحجيم عرض صحيح.
• يتخلص من font.Face للخير.
• يوفر وثائق وأمثلة عالية الجودة.
• يساعد مع بعض الإضافات مثل Faux Bold ، Faux Manived ، Wrapping Liner Line ، Fonts Embedded ، كميات Glyph ، تباعد الخط ، إلخ.
• يعرض ذاكرة التخزين المؤقت ، النقطية والأواني لكي تتكيف إذا كان لديك احتياجات أكثر تقدمًا.

ما لا يفعله etxt :

• لا تخطيط نص عام. لا يتم تغطية ميزات مثل Bidi ، والتفصيل ، والتشكيل ، واختبار الضربة العامة ، والتبرير ، وغيرها من الحالات ، وفي معظم الحالات ليست هدفًا أساسيًا لهذه الحزمة.
• ضعف أو عدم وجود دعم للنصوص المعقدة (مثل اللغة العربية) ولا تخطيطات النص العمودي (مثل اليابانية). لاحظ أن أسعار الفائدة/v2/text/v2 أفضل بكثير في هذا الصدد.
• لا شيء من الأشياء التي يريدها الناس فعليًا: الظلال والخطوط العريضة ، وتصحيح جاما ، ومضادات البكسل الفرعية ، وكسر خط plass ، ودعم أفضل للتظليل ، وما إلى ذلك.

إذا لم تكن معتادًا على مصطلحات ومفاهيم الطباعة ، فإنني أوصي بشدة بقراءة الفصول الأولى من اتفاقيات 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/أمثلة!

هل يمكنني استخدام هذه الحزمة بدون Ebitengine؟

نعم ، يمكنك تجميعها باستخدام -tags gtxt . لاحظ أن gtxt ستجعل رسم نص يحدث على وحدة المعالجة المركزية ، لذلك لا تحاول استخدامه للتطبيقات في الوقت الفعلي. على وجه الخصوص ، احرص على عدم استخدام gtxt بطريق الخطأ مع Ebitengine (فهي متوافقة في كثير من الحالات ، ولكن الأداء سيموت).

الاختبار والمساهمات وغيرها

• للاختبار ، راجع التعليمات على etxt/test .
• إذا كان لديك أي أسئلة أو اقتراحات للتحسينات ، فلا تتردد في التحدث ، فأنا سعيد دائمًا بالشرح أو مناقشة.
• خلاف ذلك ، أنا لا أبحث عن مساهمين ولا مساعدة عامة.

الحواشي

1. إذا كنت تستخدم الخطوط المتجهة التي تشبه البيكسل ، فاقرأ هذه النصائح. ↩

2. ستحتاج إلى Golang> = 1.18 ، وإذا لم تكن قد استخدمت Ebitengine من قبل ، فقد تحتاج إلى تثبيت بعض التبعيات (عادة على Linux أو FreeBsD). ↩