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 359 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 980 of file dl_dispatcher.cc.

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

~FirstPassDispatcher()

impeller::FirstPassDispatcher::~FirstPassDispatcher

(

)

Definition at line 987 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 1128 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 1093 of file dl_dispatcher.cc.

                                               {
  GlyphProperties properties;
  auto text_frame = text->GetTextFrame();
  if (text_frame == nullptr) {
    return;
  }
 
  properties.stroke = paint_.GetStroke();
 
  if (text_frame->HasColor()) {
    // Alpha is always applied when rendering, remove it here so
    // we do not double-apply the alpha.
    properties.tone_or_color = paint_.color.WithAlpha(1.0);
  } else {
    properties.tone_or_color = GlyphProperties::ComputeTone(paint_.color);
  }
 
  renderer_.GetLazyGlyphAtlas()->AddTextFrame(text_frame,   //
                                              Point(x, y),  //
                                              matrix_,      //
                                              properties    //
  );
}

References impeller::Paint::color, impeller::GlyphProperties::ComputeTone(), impeller::ContentContext::GetLazyGlyphAtlas(), impeller::Paint::GetStroke(), impeller::GlyphProperties::stroke, impeller::GlyphProperties::tone_or_color, impeller::Color::WithAlpha(), and x.

restore()

void impeller::FirstPassDispatcher::restore ( )

override

Definition at line 1037 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 1051 of file dl_dispatcher.cc.

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

References impeller::Matrix::MakeRotationZ().

save()

void impeller::FirstPassDispatcher::save ( )

override

Definition at line 991 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 996 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 1047 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 1162 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 1157 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 1207 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 1177 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 1192 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 1172 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 1167 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 1055 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 1222 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 1061 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 1075 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 1089 of file dl_dispatcher.cc.

                                         {
  matrix_ = Matrix();
}

translate()

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

override

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