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	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
std::pair< std::unordered_map< int64_t, BackdropData >, size_t >	TakeBackdropData ()

Detailed Description

Performs a first pass over the display list to collect infomation. Collects things like text frames and backdrop filters.

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

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

~FirstPassDispatcher()

impeller::FirstPassDispatcher::~FirstPassDispatcher

(

)

Definition at line 991 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 1130 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().

drawTextFrame()

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

override

Definition at line 1094 of file dl_dispatcher.cc.

                {
  GlyphProperties properties;
  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);
  }
  auto scale = TextFrame::RoundScaledFontSize(
      (matrix_ * Matrix::MakeTranslation(Point(x, y))).GetMaxBasisLengthXY());
 
  renderer_.GetLazyGlyphAtlas()->AddTextFrame(
      text_frame,   //
      scale,        //
      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::Matrix::MakeTranslation(), impeller::TextFrame::RoundScaledFontSize(), scale(), impeller::Paint::stroke, impeller::GlyphProperties::stroke, impeller::Paint::style, impeller::Color::WithAlpha(), and x.

restore()

void impeller::FirstPassDispatcher::restore ( )

override

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

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

References impeller::Matrix::MakeRotationZ().

save()

void impeller::FirstPassDispatcher::save ( )

override

Definition at line 995 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 1000 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::backdrop_count, data, impeller::TRect< Scalar >::MakeLTRB(), impeller::TRect< Scalar >::MakeMaximum(), and save().

scale()

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

override

Definition at line 1051 of file dl_dispatcher.cc.

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

References impeller::Matrix::Scale().

Referenced by drawTextFrame().

setColor()

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

override

Definition at line 1164 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 1159 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 1209 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 1179 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 1194 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 1174 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 1169 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 1059 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 1218 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 1065 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 1076 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 1090 of file dl_dispatcher.cc.

                                         {
  matrix_ = Matrix();
}

translate()

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

override

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