mth/ebiten
1
0
Fork 0
mirror of https://github.com/hajimehoshi/ebiten.git synced 2024-12-26 11:48:55 +01:00
Code Issues Packages Projects Releases Wiki Activity

text: Improve the comments

Browse Source
This commit is contained in:
Hajime Hoshi 2021-04-27 02:20:10 +09:00
parent c5c12cbf68
commit cdf700ed84
1 changed files with 9 additions and 9 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

18
text/text.go
View File

@ -161,9 +161,9 @@ var textM sync.Mutex
// //
// The two functions are implemented like this: // The two functions are implemented like this:
// //
// Draw = Create glyphs by `ReplacePixels` and put them into the cache if necessary // Draw = Create glyphs by `(*ebiten.Image).ReplacePixels` and put them into the cache if necessary
// + Draw them onto the destination by `DrawImage` // + Draw them onto the destination by `(*ebiten.Image).DrawImage`
// CacheGlyphs = Create glyphs by `ReplacePixels` and put them into the cache if necessary // CacheGlyphs = Create glyphs by `(*ebiten.Image).ReplacePixels` and put them into the cache if necessary
// //
// Be careful that the passed font face is held by this package and is never released. // Be careful that the passed font face is held by this package and is never released.
// This is a known issue (#498). // This is a known issue (#498).
@ -283,15 +283,15 @@ func BoundString(face font.Face, text string) image.Rectangle {
// Draw automatically creates and caches necessary glyphs, so usually you don't have to call CacheGlyphs // Draw automatically creates and caches necessary glyphs, so usually you don't have to call CacheGlyphs
// explicitly. However, for example, when you call Draw for each rune of one big text, Draw tries to create the glyph // explicitly. However, for example, when you call Draw for each rune of one big text, Draw tries to create the glyph
// cache and render it for each rune. This is very inefficient because creating a glyph image and rendering it are // cache and render it for each rune. This is very inefficient because creating a glyph image and rendering it are
// different operations (ReplacePixels and DrawImage) and can never be merged as one draw call. // different operations (`(*ebiten.Image).ReplacePixels` and `(*ebiten.Image).DrawImage`) and can never be merged as
// CacheGlyphs creates necessary glyphs without rendering them so that these operations are likely merged into one // one draw call. CacheGlyphs creates necessary glyphs without rendering them so that these operations are likely
// draw call regardless of the size of the text. // merged into one draw call regardless of the size of the text.
// //
// The two functions are implemented like this: // The two functions are implemented like this:
// //
// Draw = Create glyphs by `ReplacePixels` and put them into the cache if necessary // Draw = Create glyphs by `(*ebiten.Image).ReplacePixels` and put them into the cache if necessary
// + Draw them onto the destination by `DrawImage` // + Draw them onto the destination by `(*ebiten.Image).DrawImage`
// CacheGlyphs = Create glyphs by `ReplacePixels` and put them into the cache if necessary // CacheGlyphs = Create glyphs by `(*ebiten.Image).ReplacePixels` and put them into the cache if necessary
// //
// If a rune's glyph is already cached, CacheGlyphs does nothing for the rune. // If a rune's glyph is already cached, CacheGlyphs does nothing for the rune.
func CacheGlyphs(face font.Face, text string) { func CacheGlyphs(face font.Face, text string) {