impeller::TypographerContextSkia Class Reference

#include <typographer_context_skia.h>

Inheritance diagram for impeller::TypographerContextSkia:

Public Member Functions
	TypographerContextSkia ()
	~TypographerContextSkia () override
std::shared_ptr< GlyphAtlasContext >	CreateGlyphAtlasContext (GlyphAtlas::Type type) const override
std::shared_ptr< GlyphAtlas >	CreateGlyphAtlas (Context &context, GlyphAtlas::Type type, HostBuffer &host_buffer, const std::shared_ptr< GlyphAtlasContext > &atlas_context, const FontGlyphMap &font_glyph_map) const override
Public Member Functions inherited from impeller::TypographerContext
virtual	~TypographerContext ()
virtual bool	IsValid () const

Static Public Member Functions
static std::shared_ptr< TypographerContext >	Make ()

Additional Inherited Members
Protected Member Functions inherited from impeller::TypographerContext
	TypographerContext ()
	Create a new context to render text that talks to an underlying graphics context. More...

Detailed Description

Definition at line 12 of file typographer_context_skia.h.

Constructor & Destructor Documentation

TypographerContextSkia()

impeller::TypographerContextSkia::TypographerContextSkia ( )

default

~TypographerContextSkia()

impeller::TypographerContextSkia::~TypographerContextSkia ( )

overridedefault

Member Function Documentation

CreateGlyphAtlas()

std::shared_ptr< GlyphAtlas > impeller::TypographerContextSkia::CreateGlyphAtlas ( Context &  context, GlyphAtlas::Type  type, HostBuffer &  host_buffer, const std::shared_ptr< GlyphAtlasContext > &  atlas_context, const FontGlyphMap &  font_glyph_map  ) const

overridevirtual

Implements impeller::TypographerContext.

Definition at line 346 of file typographer_context_skia.cc.

                                              {
  TRACE_EVENT0("impeller", __FUNCTION__);
  if (!IsValid()) {
    return nullptr;
  }
  std::shared_ptr<GlyphAtlas> last_atlas = atlas_context->GetGlyphAtlas();
  FML_DCHECK(last_atlas->GetType() == type);
 
  if (font_glyph_map.empty()) {
    return last_atlas;
  }
 
  // ---------------------------------------------------------------------------
  // Step 1: Determine if the atlas type and font glyph pairs are compatible
  //         with the current atlas and reuse if possible. For each new font and
  //         glyph pair, compute the glyph size at scale.
  // ---------------------------------------------------------------------------
  std::vector<Rect> glyph_sizes;
  std::vector<FontGlyphPair> new_glyphs;
  for (const auto& font_value : font_glyph_map) {
    const ScaledFont& scaled_font = font_value.first;
    const FontGlyphAtlas* font_glyph_atlas =
        last_atlas->GetFontGlyphAtlas(scaled_font.font, scaled_font.scale);
 
    auto metrics = scaled_font.font.GetMetrics();
 
    SkFont sk_font(
        TypefaceSkia::Cast(*scaled_font.font.GetTypeface()).GetSkiaTypeface(),
        metrics.point_size, metrics.scaleX, metrics.skewX);
    sk_font.setEdging(SkFont::Edging::kAntiAlias);
    sk_font.setHinting(SkFontHinting::kSlight);
    sk_font.setEmbolden(metrics.embolden);
    // Rather than computing the bounds at the requested point size and scaling
    // up the bounds, we scale up the font size and request the bounds. This
    // seems to give more accurate bounds information.
    sk_font.setSize(sk_font.getSize() * scaled_font.scale);
    sk_font.setSubpixel(true);
 
    if (font_glyph_atlas) {
      for (const SubpixelGlyph& glyph : font_value.second) {
        if (!font_glyph_atlas->FindGlyphBounds(glyph)) {
          new_glyphs.emplace_back(scaled_font, glyph);
          glyph_sizes.push_back(
              ComputeGlyphSize(sk_font, glyph, scaled_font.scale));
        }
      }
    } else {
      for (const SubpixelGlyph& glyph : font_value.second) {
        new_glyphs.emplace_back(scaled_font, glyph);
        glyph_sizes.push_back(
            ComputeGlyphSize(sk_font, glyph, scaled_font.scale));
      }
    }
  }
  if (new_glyphs.size() == 0) {
    return last_atlas;
  }
 
  // ---------------------------------------------------------------------------
  // Step 2: Determine if the additional missing glyphs can be appended to the
  //         existing bitmap without recreating the atlas.
  // ---------------------------------------------------------------------------
  std::vector<Rect> glyph_positions;
  glyph_positions.reserve(new_glyphs.size());
  size_t first_missing_index = 0;
 
  if (last_atlas->GetTexture()) {
    // Append all glyphs that fit into the current atlas.
    first_missing_index = AppendToExistingAtlas(
        last_atlas, new_glyphs, glyph_positions, glyph_sizes,
        atlas_context->GetAtlasSize(), atlas_context->GetHeightAdjustment(),
        atlas_context->GetRectPacker());
 
    // ---------------------------------------------------------------------------
    // Step 3a: Record the positions in the glyph atlas of the newly added
    //          glyphs.
    // ---------------------------------------------------------------------------
    for (size_t i = 0; i < first_missing_index; i++) {
      last_atlas->AddTypefaceGlyphPositionAndBounds(
          new_glyphs[i], glyph_positions[i], glyph_sizes[i]);
    }
 
    std::shared_ptr<CommandBuffer> cmd_buffer = context.CreateCommandBuffer();
    std::shared_ptr<BlitPass> blit_pass = cmd_buffer->CreateBlitPass();
 
    fml::ScopedCleanupClosure closure([&]() {
      blit_pass->EncodeCommands(context.GetResourceAllocator());
      context.GetCommandQueue()->Submit({std::move(cmd_buffer)});
    });
 
    // ---------------------------------------------------------------------------
    // Step 4a: Draw new font-glyph pairs into the a host buffer and encode
    // the uploads into the blit pass.
    // ---------------------------------------------------------------------------
    if (!UpdateAtlasBitmap(*last_atlas, blit_pass, host_buffer,
                           last_atlas->GetTexture(), new_glyphs, 0,
                           first_missing_index)) {
      return nullptr;
    }
 
    // If all glyphs fit, just return the old atlas.
    if (first_missing_index == new_glyphs.size()) {
      return last_atlas;
    }
  }
 
  int64_t height_adjustment = atlas_context->GetAtlasSize().height;
  const int64_t max_texture_height =
      context.GetResourceAllocator()->GetMaxTextureSizeSupported().height;
 
  // IF the current atlas size is as big as it can get, then "GC" and create an
  // atlas with only the required glyphs. OpenGLES cannot reliably perform the
  // blit required here, as 1) it requires attaching textures as read and write
  // framebuffers which has substantially smaller size limits that max textures
  // and 2) is missing a GLES 2.0 implementation and cap check.
  bool blit_old_atlas = true;
  std::shared_ptr<GlyphAtlas> new_atlas = last_atlas;
  if (atlas_context->GetAtlasSize().height >= max_texture_height ||
      context.GetBackendType() == Context::BackendType::kOpenGLES) {
    blit_old_atlas = false;
    first_missing_index = 0;
    glyph_positions.clear();
    height_adjustment = 0;
    new_atlas = std::make_shared<GlyphAtlas>(type);
    atlas_context->UpdateRectPacker(nullptr);
    atlas_context->UpdateGlyphAtlas(new_atlas, {0, 0}, 0);
  }
 
  // A new glyph atlas must be created.
  ISize atlas_size = ComputeNextAtlasSize(atlas_context,        //
                                          new_glyphs,           //
                                          glyph_positions,      //
                                          glyph_sizes,          //
                                          first_missing_index,  //
                                          max_texture_height    //
  );
 
  atlas_context->UpdateGlyphAtlas(new_atlas, atlas_size, height_adjustment);
  if (atlas_size.IsEmpty()) {
    return nullptr;
  }
  FML_DCHECK(new_glyphs.size() == glyph_positions.size());
 
  TextureDescriptor descriptor;
  switch (type) {
    case GlyphAtlas::Type::kAlphaBitmap:
      descriptor.format =
          context.GetCapabilities()->GetDefaultGlyphAtlasFormat();
      break;
    case GlyphAtlas::Type::kColorBitmap:
      descriptor.format = PixelFormat::kR8G8B8A8UNormInt;
      break;
  }
  descriptor.size = atlas_size;
  descriptor.storage_mode = StorageMode::kDevicePrivate;
  descriptor.usage = TextureUsage::kShaderRead;
  std::shared_ptr<Texture> new_texture =
      context.GetResourceAllocator()->CreateTexture(descriptor);
  if (!new_texture) {
    return nullptr;
  }
 
  new_texture->SetLabel("GlyphAtlas");
 
  std::shared_ptr<CommandBuffer> cmd_buffer = context.CreateCommandBuffer();
  std::shared_ptr<BlitPass> blit_pass = cmd_buffer->CreateBlitPass();
 
  // The R8/A8 textures used for certain glyphs is not supported as color
  // attachments in most graphics drivers. For other textures, most framebuffer
  // attachments have a much smaller size limit than the max texture size.
  {
    TRACE_EVENT0("flutter", "ClearGlyphAtlas");
    size_t byte_size =
        new_texture->GetTextureDescriptor().GetByteSizeOfBaseMipLevel();
    BufferView buffer_view =
        host_buffer.Emplace(nullptr, byte_size, DefaultUniformAlignment());
 
    ::memset(buffer_view.buffer->OnGetContents() + buffer_view.range.offset, 0,
             byte_size);
    buffer_view.buffer->Flush();
    blit_pass->AddCopy(buffer_view, new_texture);
  }
 
  fml::ScopedCleanupClosure closure([&]() {
    blit_pass->EncodeCommands(context.GetResourceAllocator());
    context.GetCommandQueue()->Submit({std::move(cmd_buffer)});
  });
 
  // Blit the old texture to the top left of the new atlas.
  if (new_atlas->GetTexture() && blit_old_atlas) {
    blit_pass->AddCopy(new_atlas->GetTexture(), new_texture,
                       IRect::MakeSize(new_atlas->GetTexture()->GetSize()),
                       {0, 0});
  }
 
  // Now append all remaining glyphs. This should never have any missing data...
  new_atlas->SetTexture(std::move(new_texture));
 
  // ---------------------------------------------------------------------------
  // Step 3a: Record the positions in the glyph atlas of the newly added
  //          glyphs.
  // ---------------------------------------------------------------------------
  for (size_t i = first_missing_index; i < glyph_positions.size(); i++) {
    new_atlas->AddTypefaceGlyphPositionAndBounds(
        new_glyphs[i], glyph_positions[i], glyph_sizes[i]);
  }
 
  // ---------------------------------------------------------------------------
  // Step 4a: Draw new font-glyph pairs into the a host buffer and encode
  // the uploads into the blit pass.
  // ---------------------------------------------------------------------------
  if (!UpdateAtlasBitmap(*new_atlas, blit_pass, host_buffer,
                         new_atlas->GetTexture(), new_glyphs,
                         first_missing_index, new_glyphs.size())) {
    return nullptr;
  }
  // ---------------------------------------------------------------------------
  // Step 8b: Record the texture in the glyph atlas.
  // ---------------------------------------------------------------------------
 
  return new_atlas;
}

References impeller::AppendToExistingAtlas(), buffer_view, impeller::BackendCast< TypefaceSkia, Typeface >::Cast(), impeller::ComputeGlyphSize(), impeller::ComputeNextAtlasSize(), impeller::Context::CreateCommandBuffer(), impeller::DefaultUniformAlignment(), impeller::HostBuffer::Emplace(), impeller::FontGlyphAtlas::FindGlyphBounds(), impeller::ScaledFont::font, impeller::TextureDescriptor::format, impeller::Context::GetBackendType(), impeller::Context::GetCapabilities(), impeller::Context::GetCommandQueue(), impeller::Font::GetMetrics(), impeller::Context::GetResourceAllocator(), impeller::TypefaceSkia::GetSkiaTypeface(), impeller::Font::GetTypeface(), impeller::TSize< T >::IsEmpty(), impeller::TypographerContext::IsValid(), impeller::GlyphAtlas::kAlphaBitmap, impeller::GlyphAtlas::kColorBitmap, impeller::kDevicePrivate, impeller::Context::kOpenGLES, impeller::kR8G8B8A8UNormInt, impeller::kShaderRead, impeller::TRect< T >::MakeSize(), impeller::ScaledFont::scale, impeller::TextureDescriptor::size, impeller::TextureDescriptor::storage_mode, type, impeller::UpdateAtlasBitmap(), and impeller::TextureDescriptor::usage.

CreateGlyphAtlasContext()

std::shared_ptr< GlyphAtlasContext > impeller::TypographerContextSkia::CreateGlyphAtlasContext ( GlyphAtlas::Type  type ) const

overridevirtual

Implements impeller::TypographerContext.

Definition at line 87 of file typographer_context_skia.cc.

                                                                         {
  return std::make_shared<GlyphAtlasContext>(type);
}

References type.

Make()

std::shared_ptr< TypographerContext > impeller::TypographerContextSkia::Make ( )

static

Definition at line 78 of file typographer_context_skia.cc.

                                                               {
  return std::make_shared<TypographerContextSkia>();
}

Referenced by impeller::DlPlayground::OpenPlaygroundHere(), and impeller::testing::TEST_P().

---

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

• impeller/typographer/backends/skia/typographer_context_skia.h
• impeller/typographer/backends/skia/typographer_context_skia.cc