A texture containing the bitmap representation of glyphs in different fonts along with the ability to query the location of specific font glyphs within the texture. More...

#include <glyph_atlas.h>

Public Types
enum	Type { Type::kAlphaBitmap, Type::kColorBitmap }
	Describes how the glyphs are represented in the texture. More...

Public Member Functions
	GlyphAtlas (Type type)
	Create an empty glyph atlas. More...

	~GlyphAtlas ()

bool	IsValid () const

Type	GetType () const
	Describes how the glyphs are represented in the texture. More...

void	SetTexture (std::shared_ptr< Texture > texture)
	Set the texture for the glyph atlas. More...

const std::shared_ptr< Texture > &	GetTexture () const
	Get the texture for the glyph atlas. More...

void	AddTypefaceGlyphPositionAndBounds (const FontGlyphPair &pair, Rect position, Rect bounds)
	Record the location of a specific font-glyph pair within the atlas. More...

size_t	GetGlyphCount () const
	Get the number of unique font-glyph pairs in this atlas. More...

size_t	IterateGlyphs (const std::function< bool(const ScaledFont &scaled_font, const SubpixelGlyph &glyph, const Rect &rect)> &iterator) const
	Iterate of all the glyphs along with their locations in the atlas. More...

std::optional< std::pair< Rect, Rect > >	FindFontGlyphBounds (const FontGlyphPair &pair) const
	Find the location of a specific font-glyph pair in the atlas. More...

const FontGlyphAtlas *	GetFontGlyphAtlas (const Font &font, Scalar scale) const
	Obtain an interface for querying the location of glyphs in the atlas for the given font and scale. This provides a more efficient way to look up a run of glyphs in the same font. More...

Detailed Description

A texture containing the bitmap representation of glyphs in different fonts along with the ability to query the location of specific font glyphs within the texture.

Definition at line 27 of file glyph_atlas.h.

Member Enumeration Documentation

◆ Type

enum impeller::GlyphAtlas::Type

strong

Describes how the glyphs are represented in the texture.

Enumerator

kAlphaBitmap

The glyphs are reprsented at their requested size using only an 8-bit color channel.

This might be backed by a grey or red single channel texture, depending on the backend capabilities.

kColorBitmap

The glyphs are reprsented at their requested size using N32 premul colors.

Definition at line 31 of file glyph_atlas.h.

                   {
     //--------------------------------------------------------------------------
     /// The glyphs are reprsented at their requested size using only an 8-bit
     /// color channel.
     ///
     /// This might be backed by a grey or red single channel texture, depending
     /// on the backend capabilities.
     kAlphaBitmap,
  
     //--------------------------------------------------------------------------
     /// The glyphs are reprsented at their requested size using N32 premul
     /// colors.
     ///
     kColorBitmap,
   };

Constructor & Destructor Documentation

◆ GlyphAtlas()

impeller::GlyphAtlas::GlyphAtlas ( Type type )

explicit

Create an empty glyph atlas.

Parameters

[in] type How the glyphs are represented in the texture.

Definition at line 46 of file glyph_atlas.cc.

46 : type_(type) {}

◆ ~GlyphAtlas()

impeller::GlyphAtlas::~GlyphAtlas ( )

default

Member Function Documentation

◆ AddTypefaceGlyphPositionAndBounds()

void impeller::GlyphAtlas::AddTypefaceGlyphPositionAndBounds	(	const FontGlyphPair &	pair,
		Rect	position,
		Rect	bounds
	)

Record the location of a specific font-glyph pair within the atlas.

Parameters

[in]	pair	The font-glyph pair
[in]	rect	The position in the atlas
[in]	bounds	The bounds of the glyph at scale

Definition at line 66 of file glyph_atlas.cc.

                                                                 {
   font_atlas_map_[pair.scaled_font].positions_[pair.glyph] =
       std::make_pair(position, bounds);
 }

References impeller::FontGlyphPair::glyph, and impeller::FontGlyphPair::scaled_font.

◆ FindFontGlyphBounds()

std::optional< std::pair< Rect, Rect > > impeller::GlyphAtlas::FindFontGlyphBounds ( const FontGlyphPair & pair ) const

Find the location of a specific font-glyph pair in the atlas.

Parameters

[in] pair The font-glyph pair

Returns: The location of the font-glyph pair in the atlas. std::nullopt if the pair is not in the atlas.

Definition at line 73 of file glyph_atlas.cc.

                                      {
   const auto& found = font_atlas_map_.find(pair.scaled_font);
   if (found == font_atlas_map_.end()) {
     return std::nullopt;
   }
   return found->second.FindGlyphBounds(pair.glyph);
 }

References impeller::FontGlyphPair::glyph, and impeller::FontGlyphPair::scaled_font.

Referenced by impeller::UpdateAtlasBitmap().

◆ GetFontGlyphAtlas()

const FontGlyphAtlas * impeller::GlyphAtlas::GetFontGlyphAtlas	(	const Font &	font,
		Scalar	scale
	)		const

Obtain an interface for querying the location of glyphs in the atlas for the given font and scale. This provides a more efficient way to look up a run of glyphs in the same font.

Parameters

[in]	font	The font
[in]	scale	The scale

Returns: A pointer to a FontGlyphAtlas, or nullptr if the font and scale are not available in the atlas. The pointer is only valid for the lifetime of the GlyphAtlas.

Definition at line 82 of file glyph_atlas.cc.

                                                                         {
   const auto& found = font_atlas_map_.find(ScaledFont{font, scale});
   if (found == font_atlas_map_.end()) {
     return nullptr;
   }
   return &found->second;
 }

References scale.

◆ GetGlyphCount()

size_t impeller::GlyphAtlas::GetGlyphCount ( ) const

Get the number of unique font-glyph pairs in this atlas.

Returns: The glyph count.

Definition at line 91 of file glyph_atlas.cc.

                                        {
   return std::accumulate(font_atlas_map_.begin(), font_atlas_map_.end(), 0,
                          [](const int a, const auto& b) {
                            return a + b.second.positions_.size();
                          });
 }

References impeller::saturated::b.

◆ GetTexture()

const std::shared_ptr< Texture > & impeller::GlyphAtlas::GetTexture ( ) const

Get the texture for the glyph atlas.

Returns: The texture.

Definition at line 58 of file glyph_atlas.cc.

                                                            {
   return texture_;
 }

Referenced by impeller::UpdateAtlasBitmap().

◆ GetType()

GlyphAtlas::Type impeller::GlyphAtlas::GetType ( ) const

Describes how the glyphs are represented in the texture.

Definition at line 54 of file glyph_atlas.cc.

                                          {
   return type_;
 }

Referenced by impeller::CreateAtlasBitmap(), impeller::GetImageInfo(), and impeller::UpdateAtlasBitmap().

◆ IsValid()

bool impeller::GlyphAtlas::IsValid ( ) const

Definition at line 50 of file glyph_atlas.cc.

                                {
   return !!texture_;
 }

◆ IterateGlyphs()

size_t impeller::GlyphAtlas::IterateGlyphs ( const std::function< bool(const ScaledFont &scaled_font, const SubpixelGlyph &glyph, const Rect &rect)> & iterator ) const

Iterate of all the glyphs along with their locations in the atlas.

Parameters

[in] iterator The iterator. Return false from the iterator to stop iterating.

Returns: The number of glyphs iterated over.

Definition at line 98 of file glyph_atlas.cc.

                                                                  {
   if (!iterator) {
     return 0u;
   }
  
   size_t count = 0u;
   for (const auto& font_value : font_atlas_map_) {
     for (const auto& glyph_value : font_value.second.positions_) {
       count++;
       if (!iterator(font_value.first, glyph_value.first,
                     glyph_value.second.first)) {
         return count;
       }
     }
   }
   return count;
 }

Referenced by impeller::CreateAtlasBitmap().

◆ SetTexture()

void impeller::GlyphAtlas::SetTexture ( std::shared_ptr< Texture > texture )

Set the texture for the glyph atlas.

Parameters

[in] texture The texture

Definition at line 62 of file glyph_atlas.cc.

                                                           {
   texture_ = std::move(texture);
 }

The documentation for this class was generated from the following files:

impeller/typographer/glyph_atlas.h
impeller/typographer/glyph_atlas.cc

Public Types

Public Member Functions

Detailed Description

Member Enumeration Documentation

◆ Type

Constructor & Destructor Documentation

◆ GlyphAtlas()

◆ ~GlyphAtlas()

Member Function Documentation

◆ AddTypefaceGlyphPositionAndBounds()

◆ FindFontGlyphBounds()

◆ GetFontGlyphAtlas()

◆ GetGlyphCount()

◆ GetTexture()

◆ GetType()

◆ IsValid()

◆ IterateGlyphs()

◆ SetTexture()