impeller::TextFrameDispatcher Class Reference

Performs a first pass over the display list to collect all text frames. More...

#include <dl_dispatcher.h>

Inheritance diagram for impeller::TextFrameDispatcher:

Public Member Functions
	TextFrameDispatcher (const ContentContext &renderer, const Matrix &initial_matrix, const Rect cull_rect)
	~TextFrameDispatcher ()
void	save () override
void	saveLayer (const DlRect &bounds, const flutter::SaveLayerOptions options, const flutter::DlImageFilter *backdrop) override
void	restore () override
void	translate (DlScalar tx, DlScalar ty) override
void	scale (DlScalar sx, DlScalar sy) override
void	rotate (DlScalar degrees) override
void	skew (DlScalar sx, DlScalar sy) override
void	transform2DAffine (DlScalar mxx, DlScalar mxy, DlScalar mxt, DlScalar myx, DlScalar myy, DlScalar myt) override
void	transformFullPerspective (DlScalar mxx, DlScalar mxy, DlScalar mxz, DlScalar mxt, DlScalar myx, DlScalar myy, DlScalar myz, DlScalar myt, DlScalar mzx, DlScalar mzy, DlScalar mzz, DlScalar mzt, DlScalar mwx, DlScalar mwy, DlScalar mwz, DlScalar mwt) override
void	transformReset () override
void	drawTextFrame (const std::shared_ptr< impeller::TextFrame > &text_frame, DlScalar x, DlScalar y) override
void	drawDisplayList (const sk_sp< flutter::DisplayList > display_list, DlScalar opacity) override
void	setDrawStyle (flutter::DlDrawStyle style) override
void	setColor (flutter::DlColor color) override
void	setStrokeWidth (DlScalar width) override
void	setStrokeMiter (DlScalar limit) override
void	setStrokeCap (flutter::DlStrokeCap cap) override
void	setStrokeJoin (flutter::DlStrokeJoin join) override
void	setImageFilter (const flutter::DlImageFilter *filter) override

Detailed Description

Performs a first pass over the display list to collect all text frames.

Definition at line 288 of file dl_dispatcher.h.

Constructor & Destructor Documentation

TextFrameDispatcher()

impeller::TextFrameDispatcher::TextFrameDispatcher	(	const ContentContext &	renderer,
		const Matrix &	initial_matrix,
		const Rect	cull_rect
	)

Definition at line 979 of file dl_dispatcher.cc.

    : renderer_(renderer), matrix_(initial_matrix) {
  cull_rect_state_.push_back(cull_rect);
}

~TextFrameDispatcher()

impeller::TextFrameDispatcher::~TextFrameDispatcher

(

)

Definition at line 986 of file dl_dispatcher.cc.

                                          {
  FML_DCHECK(cull_rect_state_.size() == 1);
}

Member Function Documentation

drawDisplayList()

void impeller::TextFrameDispatcher::drawDisplayList ( const sk_sp< flutter::DisplayList >  display_list, DlScalar  opacity  )

override

Definition at line 1104 of file dl_dispatcher.cc.

                      {
  [[maybe_unused]] size_t stack_depth = stack_.size();
  save();
  Paint old_paint = paint_;
  paint_ = Paint{};
  bool old_has_image_filter = has_image_filter_;
  has_image_filter_ = false;
 
  if (matrix_.HasPerspective()) {
    display_list->Dispatch(*this);
  } else {
    Rect local_cull_bounds = GetCurrentLocalCullingBounds();
    if (local_cull_bounds.IsMaximum()) {
      display_list->Dispatch(*this);
    } else if (!local_cull_bounds.IsEmpty()) {
      IRect cull_rect = IRect::RoundOut(local_cull_bounds);
      display_list->Dispatch(*this, SkIRect::MakeLTRB(cull_rect.GetLeft(),   //
                                                      cull_rect.GetTop(),    //
                                                      cull_rect.GetRight(),  //
                                                      cull_rect.GetBottom()  //
                                                      ));
    }
  }
 
  restore();
  paint_ = old_paint;
  has_image_filter_ = old_has_image_filter;
  FML_DCHECK(stack_depth == stack_.size());
}

References impeller::TRect< T >::GetBottom(), impeller::TRect< T >::GetLeft(), impeller::TRect< T >::GetRight(), impeller::TRect< T >::GetTop(), impeller::Matrix::HasPerspective(), impeller::TRect< T >::IsEmpty(), impeller::TRect< T >::IsMaximum(), restore(), impeller::TRect< T >::RoundOut(), and save().

drawTextFrame()

void impeller::TextFrameDispatcher::drawTextFrame ( const std::shared_ptr< impeller::TextFrame > &  text_frame, DlScalar  x, DlScalar  y  )

override

Definition at line 1069 of file dl_dispatcher.cc.

                {
  GlyphProperties properties;
  if (paint_.style == Paint::Style::kStroke) {
    properties.stroke = true;
    properties.stroke_cap = paint_.stroke_cap;
    properties.stroke_join = paint_.stroke_join;
    properties.stroke_miter = paint_.stroke_miter;
    properties.stroke_width = paint_.stroke_width;
  }
  if (text_frame->HasColor()) {
    // Alpha is always applied when rendering, remove it here so
    // we do not double-apply the alpha.
    properties.color = paint_.color.WithAlpha(1.0);
  }
  auto scale =
      (matrix_ * Matrix::MakeTranslation(Point(x, y))).GetMaxBasisLengthXY();
  renderer_.GetLazyGlyphAtlas()->AddTextFrame(*text_frame,  //
                                              scale,        //
                                              Point(x, y),  //
                                              properties    //
  );
}

References impeller::GlyphProperties::color, impeller::Paint::color, impeller::ContentContext::GetLazyGlyphAtlas(), impeller::Paint::kStroke, impeller::Matrix::MakeTranslation(), scale(), impeller::GlyphProperties::stroke, impeller::GlyphProperties::stroke_cap, impeller::Paint::stroke_cap, impeller::GlyphProperties::stroke_join, impeller::Paint::stroke_join, impeller::GlyphProperties::stroke_miter, impeller::Paint::stroke_miter, impeller::GlyphProperties::stroke_width, impeller::Paint::stroke_width, impeller::Paint::style, and impeller::Color::WithAlpha().

restore()

void impeller::TextFrameDispatcher::restore ( )

override

Definition at line 1016 of file dl_dispatcher.cc.

                                  {
  matrix_ = stack_.back();
  stack_.pop_back();
  cull_rect_state_.pop_back();
}

Referenced by drawDisplayList().

rotate()

void impeller::TextFrameDispatcher::rotate ( DlScalar  degrees )

override

Definition at line 1030 of file dl_dispatcher.cc.

                                                 {
  matrix_ = matrix_ * Matrix::MakeRotationZ(Degrees(degrees));
}

References impeller::Matrix::MakeRotationZ().

save()

void impeller::TextFrameDispatcher::save ( )

override

Definition at line 990 of file dl_dispatcher.cc.

                               {
  stack_.emplace_back(matrix_);
  cull_rect_state_.push_back(cull_rect_state_.back());
}

Referenced by drawDisplayList(), and saveLayer().

saveLayer()

void impeller::TextFrameDispatcher::saveLayer ( const DlRect &  bounds, const flutter::SaveLayerOptions  options, const flutter::DlImageFilter *  backdrop  )

override

Definition at line 995 of file dl_dispatcher.cc.

                                                                          {
  save();
 
  // This dispatcher does not track enough state to accurately compute
  // cull rects with image filters.
  auto global_cull_rect = cull_rect_state_.back();
  if (has_image_filter_ || global_cull_rect.IsMaximum()) {
    cull_rect_state_.back() = Rect::MakeMaximum();
  } else {
    auto global_save_bounds = bounds.TransformBounds(matrix_);
    auto new_cull_rect = global_cull_rect.Intersection(global_save_bounds);
    if (new_cull_rect.has_value()) {
      cull_rect_state_.back() = new_cull_rect.value();
    } else {
      cull_rect_state_.back() = Rect::MakeLTRB(0, 0, 0, 0);
    }
  }
}

References impeller::TRect< Scalar >::MakeLTRB(), impeller::TRect< Scalar >::MakeMaximum(), and save().

scale()

void impeller::TextFrameDispatcher::scale ( DlScalar  sx, DlScalar  sy  )

override

Definition at line 1026 of file dl_dispatcher.cc.

                                                        {
  matrix_ = matrix_.Scale({sx, sy, 1.0f});
}

References impeller::Matrix::Scale().

Referenced by drawTextFrame().

setColor()

void impeller::TextFrameDispatcher::setColor ( flutter::DlColor  color )

override

Definition at line 1142 of file dl_dispatcher.cc.

                                                       {
  paint_.color = skia_conversions::ToColor(color);
}

References color, impeller::Paint::color, and impeller::skia_conversions::ToColor().

setDrawStyle()

void impeller::TextFrameDispatcher::setDrawStyle ( flutter::DlDrawStyle  style )

override

Definition at line 1137 of file dl_dispatcher.cc.

                                                               {
  paint_.style = ToStyle(style);
}

References impeller::Paint::style, and impeller::ToStyle().

setImageFilter()

void impeller::TextFrameDispatcher::setImageFilter ( const flutter::DlImageFilter *  filter )

override

Definition at line 1187 of file dl_dispatcher.cc.

                                                                           {
  if (filter == nullptr) {
    has_image_filter_ = false;
  } else {
    has_image_filter_ = true;
  }
}

setStrokeCap()

void impeller::TextFrameDispatcher::setStrokeCap ( flutter::DlStrokeCap  cap )

override

Definition at line 1157 of file dl_dispatcher.cc.

                                                             {
  switch (cap) {
    case flutter::DlStrokeCap::kButt:
      paint_.stroke_cap = Cap::kButt;
      break;
    case flutter::DlStrokeCap::kRound:
      paint_.stroke_cap = Cap::kRound;
      break;
    case flutter::DlStrokeCap::kSquare:
      paint_.stroke_cap = Cap::kSquare;
      break;
  }
}

References impeller::kButt, impeller::kRound, impeller::kSquare, and impeller::Paint::stroke_cap.

setStrokeJoin()

void impeller::TextFrameDispatcher::setStrokeJoin ( flutter::DlStrokeJoin  join )

override

Definition at line 1172 of file dl_dispatcher.cc.

                                                                {
  switch (join) {
    case flutter::DlStrokeJoin::kMiter:
      paint_.stroke_join = Join::kMiter;
      break;
    case flutter::DlStrokeJoin::kRound:
      paint_.stroke_join = Join::kRound;
      break;
    case flutter::DlStrokeJoin::kBevel:
      paint_.stroke_join = Join::kBevel;
      break;
  }
}

References impeller::kBevel, impeller::kMiter, impeller::kRound, and impeller::Paint::stroke_join.

setStrokeMiter()

void impeller::TextFrameDispatcher::setStrokeMiter ( DlScalar  limit )

override

Definition at line 1152 of file dl_dispatcher.cc.

                                                       {
  paint_.stroke_miter = limit;
}

References impeller::Paint::stroke_miter.

setStrokeWidth()

void impeller::TextFrameDispatcher::setStrokeWidth ( DlScalar  width )

override

Definition at line 1147 of file dl_dispatcher.cc.

                                                       {
  paint_.stroke_width = width;
}

References impeller::Paint::stroke_width.

skew()

void impeller::TextFrameDispatcher::skew ( DlScalar  sx, DlScalar  sy  )

override

Definition at line 1034 of file dl_dispatcher.cc.

                                                       {
  matrix_ = matrix_ * Matrix::MakeSkew(sx, sy);
}

References impeller::Matrix::MakeSkew().

transform2DAffine()

void impeller::TextFrameDispatcher::transform2DAffine ( DlScalar  mxx, DlScalar  mxy, DlScalar  mxt, DlScalar  myx, DlScalar  myy, DlScalar  myt  )

override

Definition at line 1040 of file dl_dispatcher.cc.

                                                                                        {
    matrix_ = matrix_ * Matrix::MakeColumn(
        mxx,  myx,  0.0f, 0.0f,
        mxy,  myy,  0.0f, 0.0f,
        0.0f, 0.0f, 1.0f, 0.0f,
        mxt,  myt,  0.0f, 1.0f
    );
  }

References impeller::Matrix::MakeColumn().

transformFullPerspective()

void impeller::TextFrameDispatcher::transformFullPerspective ( DlScalar  mxx, DlScalar  mxy, DlScalar  mxz, DlScalar  mxt, DlScalar  myx, DlScalar  myy, DlScalar  myz, DlScalar  myt, DlScalar  mzx, DlScalar  mzy, DlScalar  mzz, DlScalar  mzt, DlScalar  mwx, DlScalar  mwy, DlScalar  mwz, DlScalar  mwt  )

override

Definition at line 1051 of file dl_dispatcher.cc.

                                                              {
    matrix_ = matrix_ * Matrix::MakeColumn(
        mxx, myx, mzx, mwx,
        mxy, myy, mzy, mwy,
        mxz, myz, mzz, mwz,
        mxt, myt, mzt, mwt
    );
  }

References impeller::Matrix::MakeColumn().

transformReset()

void impeller::TextFrameDispatcher::transformReset ( )

override

Definition at line 1065 of file dl_dispatcher.cc.

                                         {
  matrix_ = Matrix();
}

translate()

void impeller::TextFrameDispatcher::translate ( DlScalar  tx, DlScalar  ty  )

override

Definition at line 1022 of file dl_dispatcher.cc.

                                                            {
  matrix_ = matrix_.Translate({tx, ty});
}

References impeller::Matrix::Translate().

---

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

• impeller/display_list/dl_dispatcher.h
• impeller/display_list/dl_dispatcher.cc