// Copyright 2017 The Ebiten Authors // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. // Package text offers functions to draw texts on an Ebiten's image. // // For the example using a TTF font, see font package in the examples. package text import ( "image" "image/color" "math" "reflect" "golang.org/x/image/font" "golang.org/x/image/math/fixed" "github.com/hajimehoshi/ebiten" emath "github.com/hajimehoshi/ebiten/internal/math" "github.com/hajimehoshi/ebiten/internal/sync" ) var ( monotonicClock int64 ) func now() int64 { monotonicClock++ return monotonicClock } type cacheEntry struct { // Use pointers to avoid copying on browsers. bounds map[rune]*fixed.Rectangle26_6 atlases map[int]*atlas } var ( cache = map[font.Face]*cacheEntry{} ) type char struct { face font.Face rune rune atlasG int } func (c *char) bounds() *fixed.Rectangle26_6 { e := cache[c.face] if b, ok := e.bounds[c.rune]; ok { return b } b, _, _ := c.face.GlyphBounds(c.rune) e.bounds[c.rune] = &b return &b } func (c *char) size() (fixed.Int26_6, fixed.Int26_6) { b := c.bounds() return b.Max.X - b.Min.X, b.Max.Y - b.Min.Y } func (c *char) empty() bool { x, y := c.size() return x == 0 || y == 0 } func (c *char) atlasGroup() int { if c.atlasG != 0 { return c.atlasG } x, y := c.size() w, h := x.Ceil(), y.Ceil() t := w if t < h { t = h } // Different images for small runes are inefficient. // Let's use a same texture atlas for typical character sizes. if t < 32 { return 32 } c.atlasG = emath.NextPowerOf2Int(t) return c.atlasG } type glyph struct { char char index int atime int64 } func fixed26_6ToFloat64(x fixed.Int26_6) float64 { return float64(x) / (1 << 6) } type colorMCacheKey uint32 type colorMCacheEntry struct { m ebiten.ColorM atime int64 } var ( colorMCache = map[colorMCacheKey]*colorMCacheEntry{} ) func (g *glyph) draw(dst *ebiten.Image, x, y fixed.Int26_6, clr color.Color) { // RGBA() is in [0 - 0xffff]. Adjust them in [0 - 0xff]. cr, cg, cb, ca := clr.RGBA() cr >>= 8 cg >>= 8 cb >>= 8 ca >>= 8 if ca == 0 { return } b := g.char.bounds() op := &ebiten.DrawImageOptions{} op.GeoM.Translate(fixed26_6ToFloat64(x+b.Min.X), fixed26_6ToFloat64(y+b.Min.Y)) key := colorMCacheKey(uint32(cr) | (uint32(cg) << 8) | (uint32(cb) << 16) | (uint32(ca) << 24)) e, ok := colorMCache[key] if ok { e.atime = now() } else { if len(colorMCache) >= 256 { var oldest colorMCacheKey t := int64(math.MaxInt64) for key, e := range colorMCache { if e.atime < t { t = g.atime oldest = key } } delete(colorMCache, oldest) } cm := ebiten.ColorM{} rf := float64(cr) / float64(ca) gf := float64(cg) / float64(ca) bf := float64(cb) / float64(ca) af := float64(ca) / 0xff cm.Scale(rf, gf, bf, af) e = &colorMCacheEntry{ m: cm, atime: now(), } colorMCache[key] = e } op.ColorM = e.m a := cache[g.char.face].atlases[g.char.atlasGroup()] sx, sy := a.at(g) r := image.Rect(sx, sy, sx+a.glyphSize, sy+a.glyphSize) op.SourceRect = &r dst.DrawImage(a.image, op) } type atlas struct { // image is the back-end image to hold glyph cache. image *ebiten.Image // tmpImage is the temporary image as a renderer source for glyph. tmpImage *ebiten.Image // glyphSize is the size of one glyph in the cache. // This value is always power of 2. glyphSize int runeToGlyph map[rune]*glyph } func (a *atlas) at(glyph *glyph) (int, int) { if a.glyphSize != glyph.char.atlasGroup() { panic("not reached") } w, _ := a.image.Size() xnum := w / a.glyphSize x, y := glyph.index%xnum, glyph.index/xnum return x * a.glyphSize, y * a.glyphSize } func (a *atlas) maxGlyphNum() int { w, h := a.image.Size() xnum := w / a.glyphSize ynum := h / a.glyphSize return xnum * ynum } func (a *atlas) appendGlyph(char char, now int64) *glyph { g := &glyph{ char: char, atime: now, } if len(a.runeToGlyph) == a.maxGlyphNum() { var oldest *glyph t := int64(math.MaxInt64) for _, g := range a.runeToGlyph { if g.atime < t { t = g.atime oldest = g } } if oldest == nil { panic("not reached") } idx := oldest.index delete(a.runeToGlyph, oldest.char.rune) g.index = idx } else { g.index = len(a.runeToGlyph) } a.runeToGlyph[g.char.rune] = g a.draw(g) return g } func (a *atlas) draw(glyph *glyph) { if a.tmpImage == nil { a.tmpImage, _ = ebiten.NewImage(a.glyphSize, a.glyphSize, ebiten.FilterNearest) } dst := image.NewRGBA(image.Rect(0, 0, a.glyphSize, a.glyphSize)) d := font.Drawer{ Dst: dst, Src: image.White, Face: glyph.char.face, } b := glyph.char.bounds() d.Dot = fixed.Point26_6{-b.Min.X, -b.Min.Y} d.DrawString(string(glyph.char.rune)) a.tmpImage.ReplacePixels(dst.Pix) op := &ebiten.DrawImageOptions{} x, y := a.at(glyph) op.GeoM.Translate(float64(x), float64(y)) op.CompositeMode = ebiten.CompositeModeCopy a.image.DrawImage(a.tmpImage, op) a.tmpImage.Clear() } func getGlyphFromCache(face font.Face, r rune, now int64) *glyph { ch := char{ face: face, rune: r, } at, ok := cache[face].atlases[ch.atlasGroup()] if ok { g, ok := at.runeToGlyph[r] if ok { g.atime = now return g } } if ch.empty() { // The glyph doesn't have its size but might have valid 'advance' parameter // when ch is e.g. space (U+0020). return &glyph{ char: ch, atime: now, } } if at == nil { // Don't use ebiten.MaxImageSize here. // It's because the back-end image pixels will be restored from GPU // whenever a new glyph is rendered on the image, and restoring cost is // expensive if the image is big. // The back-end image is updated a temporary image, and the temporary image is // always cleared after used. This means that there is no clue to restore // the back-end image without reading from GPU // (see the package 'restorable' implementation). // // TODO: How about making a new function for 'flagile' image? const size = 1024 i, _ := ebiten.NewImage(size, size, ebiten.FilterNearest) at = &atlas{ image: i, glyphSize: ch.atlasGroup(), runeToGlyph: map[rune]*glyph{}, } cache[face].atlases[ch.atlasGroup()] = at } return at.appendGlyph(ch, now) } func uniqFace(f font.Face) font.Face { if _, ok := cache[f]; ok { return f } // If the (DeepEqual-ly) same font exists, // reuse this to avoid to consume a lot of cache (#498). for key := range cache { if reflect.DeepEqual(key, f) { return key } } cache[f] = &cacheEntry{ bounds: map[rune]*fixed.Rectangle26_6{}, atlases: map[int]*atlas{}, } return f } var textM sync.Mutex // Draw draws a given text on a given destination image dst. // // face is the font for text rendering. // (x, y) represents a 'dot' (period) position. // Be careful that this doesn't represent left-upper corner position. // clr is the color for text rendering. // // Glyphs used for rendering are cached in least-recently-used way. // It is OK to call this function with a same text and a same face at every frame in terms of performance. // // This function is concurrent-safe. func Draw(dst *ebiten.Image, text string, face font.Face, x, y int, clr color.Color) { textM.Lock() n := now() fx := fixed.I(x) prevC := rune(-1) runes := []rune(text) for _, c := range runes { if prevC >= 0 { fx += face.Kern(prevC, c) } fa := uniqFace(face) if g := getGlyphFromCache(fa, c, n); g != nil { if !g.char.empty() { g.draw(dst, fx, fixed.I(y), clr) } a, _ := face.GlyphAdvance(c) fx += a } prevC = c } textM.Unlock() }