impeller::FirstPassDispatcher Class Reference

#include <dl_dispatcher.h>

Inheritance diagram for impeller::FirstPassDispatcher:

Public Member Functions
	FirstPassDispatcher (const ContentContext &renderer, const Matrix &initial_matrix, const Rect cull_rect)
	~FirstPassDispatcher ()
void	save () override
void	saveLayer (const DlRect &bounds, const flutter::SaveLayerOptions options, const flutter::DlImageFilter *backdrop, std::optional< int64_t > backdrop_id) 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	drawText (const std::shared_ptr< flutter::DlText > &text, 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
std::pair< std::unordered_map< int64_t, BackdropData >, size_t >	TakeBackdropData ()

Detailed Description

Performs a first pass over the display list to collect information that will be useful in a second pass by the CanvasDlDispatcher. This class collects things like text frames and backdrop filters.

Definition at line 345 of file dl_dispatcher.h.

Constructor & Destructor Documentation

FirstPassDispatcher()

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

Definition at line 966 of file dl_dispatcher.cc.

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

~FirstPassDispatcher()

impeller::FirstPassDispatcher::~FirstPassDispatcher

(

)

Definition at line 973 of file dl_dispatcher.cc.

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

Member Function Documentation

drawDisplayList()

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

override

Definition at line 1117 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()) {
      DlIRect cull_rect = DlIRect::RoundOut(local_cull_bounds);
      display_list->Dispatch(*this, cull_rect);
    }
  }
 
  restore();
  paint_ = old_paint;
  has_image_filter_ = old_has_image_filter;
  FML_DCHECK(stack_depth == stack_.size());
}

References impeller::Matrix::HasPerspective(), impeller::TRect< T >::IsEmpty(), impeller::TRect< T >::IsMaximum(), restore(), and save().

drawText()

void impeller::FirstPassDispatcher::drawText ( const std::shared_ptr< flutter::DlText > &  text, DlScalar  x, DlScalar  y  )

override

Definition at line 1079 of file dl_dispatcher.cc.

                                               {
  GlyphProperties properties;
  auto text_frame = text->GetTextFrame();
  if (text_frame == nullptr) {
    return;
  }
 
  if (paint_.style == Paint::Style::kStroke) {
    properties.stroke = paint_.stroke;
  }
 
  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);
  }
 
  renderer_.GetLazyGlyphAtlas()->AddTextFrame(
      text_frame,   //
      Point(x, y),  //
      matrix_,
      (properties.stroke.has_value() || text_frame->HasColor())  //
          ? std::optional<GlyphProperties>(properties)           //
          : std::nullopt                                         //
  );
}

References impeller::Paint::color, impeller::GlyphProperties::color, impeller::ContentContext::GetLazyGlyphAtlas(), impeller::Paint::kStroke, impeller::Paint::stroke, impeller::GlyphProperties::stroke, impeller::Paint::style, impeller::Color::WithAlpha(), and x.

restore()

void impeller::FirstPassDispatcher::restore ( )

override

Definition at line 1023 of file dl_dispatcher.cc.

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

Referenced by drawDisplayList().

rotate()

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

override

Definition at line 1037 of file dl_dispatcher.cc.

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

References impeller::Matrix::MakeRotationZ().

save()

void impeller::FirstPassDispatcher::save ( )

override

Definition at line 977 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::FirstPassDispatcher::saveLayer ( const DlRect &  bounds, const flutter::SaveLayerOptions  options, const flutter::DlImageFilter *  backdrop, std::optional< int64_t >  backdrop_id  )

override

Definition at line 982 of file dl_dispatcher.cc.

                                                                      {
  save();
 
  backdrop_count_ += (backdrop == nullptr ? 0 : 1);
  if (backdrop != nullptr && backdrop_id.has_value()) {
    std::shared_ptr<flutter::DlImageFilter> shared_backdrop =
        backdrop->shared();
    std::unordered_map<int64_t, BackdropData>::iterator existing =
        backdrop_data_.find(backdrop_id.value());
    if (existing == backdrop_data_.end()) {
      backdrop_data_[backdrop_id.value()] =
          BackdropData{.backdrop_count = 1, .last_backdrop = shared_backdrop};
    } else {
      BackdropData& data = existing->second;
      data.backdrop_count++;
      if (data.all_filters_equal) {
        data.all_filters_equal = (*data.last_backdrop == *shared_backdrop);
        data.last_backdrop = shared_backdrop;
      }
    }
  }
 
  // 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::BackdropData::all_filters_equal, impeller::BackdropData::backdrop_count, impeller::BackdropData::last_backdrop, impeller::TRect< Scalar >::MakeLTRB(), impeller::TRect< Scalar >::MakeMaximum(), and save().

scale()

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

override

Definition at line 1033 of file dl_dispatcher.cc.

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

References impeller::Matrix::Scale().

setColor()

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

override

Definition at line 1151 of file dl_dispatcher.cc.

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

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

setDrawStyle()

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

override

Definition at line 1146 of file dl_dispatcher.cc.

                                                               {
  paint_.style = ToStyle(style);
}

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

setImageFilter()

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

override

Definition at line 1196 of file dl_dispatcher.cc.

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

setStrokeCap()

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

override

Definition at line 1166 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::StrokeParameters::cap, impeller::kButt, impeller::kRound, impeller::kSquare, and impeller::Paint::stroke.

setStrokeJoin()

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

override

Definition at line 1181 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::StrokeParameters::join, impeller::kBevel, impeller::kMiter, impeller::kRound, and impeller::Paint::stroke.

setStrokeMiter()

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

override

Definition at line 1161 of file dl_dispatcher.cc.

                                                       {
  paint_.stroke.miter_limit = limit;
}

References impeller::StrokeParameters::miter_limit, and impeller::Paint::stroke.

setStrokeWidth()

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

override

Definition at line 1156 of file dl_dispatcher.cc.

                                                       {
  paint_.stroke.width = width;
}

References impeller::Paint::stroke, and impeller::StrokeParameters::width.

skew()

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

override

Definition at line 1041 of file dl_dispatcher.cc.

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

References impeller::Matrix::MakeSkew().

TakeBackdropData()

std::pair< std::unordered_map< int64_t, BackdropData >, size_t > impeller::FirstPassDispatcher::TakeBackdropData

(

)

Definition at line 1211 of file dl_dispatcher.cc.

                                      {
  std::unordered_map<int64_t, BackdropData> temp;
  std::swap(temp, backdrop_data_);
  return std::make_pair(temp, backdrop_count_);
}

Referenced by impeller::DisplayListToTexture(), and impeller::RenderToTarget().

transform2DAffine()

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

override

Definition at line 1047 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::FirstPassDispatcher::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 1061 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::FirstPassDispatcher::transformReset ( )

override

Definition at line 1075 of file dl_dispatcher.cc.

                                         {
  matrix_ = Matrix();
}

translate()

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

override

Definition at line 1029 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