#include <dl_dispatcher.h>

Inheritance diagram for impeller::DlDispatcherBase:

Public Member Functions
void	setAntiAlias (bool aa) 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	setColorSource (const flutter::DlColorSource *source) override

void	setColorFilter (const flutter::DlColorFilter *filter) override

void	setInvertColors (bool invert) override

void	setBlendMode (flutter::DlBlendMode mode) override

void	setMaskFilter (const flutter::DlMaskFilter *filter) override

void	setImageFilter (const flutter::DlImageFilter *filter) override

void	save (uint32_t total_content_depth) override

void	saveLayer (const DlRect &bounds, const flutter::SaveLayerOptions &options, uint32_t total_content_depth, flutter::DlBlendMode max_content_mode, 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	clipRect (const DlRect &rect, ClipOp clip_op, bool is_aa) override

void	clipOval (const DlRect &bounds, ClipOp clip_op, bool is_aa) override

void	clipRoundRect (const DlRoundRect &rrect, ClipOp clip_op, bool is_aa) override

void	clipPath (const DlPath &path, ClipOp clip_op, bool is_aa) override

void	drawColor (flutter::DlColor color, flutter::DlBlendMode mode) override

void	drawPaint () override

void	drawLine (const DlPoint &p0, const DlPoint &p1) override

void	drawDashedLine (const DlPoint &p0, const DlPoint &p1, DlScalar on_length, DlScalar off_length) override

void	drawRect (const DlRect &rect) override

void	drawOval (const DlRect &bounds) override

void	drawCircle (const DlPoint &center, DlScalar radius) override

void	drawRoundRect (const DlRoundRect &rrect) override

void	drawDiffRoundRect (const DlRoundRect &outer, const DlRoundRect &inner) override

void	drawPath (const DlPath &path) override

void	drawArc (const DlRect &oval_bounds, DlScalar start_degrees, DlScalar sweep_degrees, bool use_center) override

void	drawPoints (PointMode mode, uint32_t count, const DlPoint points[]) override

void	drawVertices (const std::shared_ptr< flutter::DlVertices > &vertices, flutter::DlBlendMode dl_mode) override

void	drawImage (const sk_sp< flutter::DlImage > image, const DlPoint &point, flutter::DlImageSampling sampling, bool render_with_attributes) override

void	drawImageRect (const sk_sp< flutter::DlImage > image, const DlRect &src, const DlRect &dst, flutter::DlImageSampling sampling, bool render_with_attributes, SrcRectConstraint constraint) override

void	drawImageNine (const sk_sp< flutter::DlImage > image, const DlIRect &center, const DlRect &dst, flutter::DlFilterMode filter, bool render_with_attributes) override

void	drawAtlas (const sk_sp< flutter::DlImage > atlas, const RSTransform xform[], const DlRect tex[], const flutter::DlColor colors[], int count, flutter::DlBlendMode mode, flutter::DlImageSampling sampling, const DlRect *cull_rect, bool render_with_attributes) override

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

void	drawTextBlob (const sk_sp< SkTextBlob > blob, DlScalar x, DlScalar y) override

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

void	drawShadow (const DlPath &path, const flutter::DlColor color, const DlScalar elevation, bool transparent_occluder, DlScalar dpr) override

virtual Canvas &	GetCanvas ()=0

Static Protected Member Functions
static void	SimplifyOrDrawPath (Canvas &canvas, const DlPath &cache, const Paint &paint)

Protected Attributes
Paint	paint_

Matrix	initial_matrix_

Detailed Description

Definition at line 30 of file dl_dispatcher.h.

Member Function Documentation

◆ clipOval()

void impeller::DlDispatcherBase::clipOval	(	const DlRect &	bounds,
		ClipOp	clip_op,
		bool	is_aa
	)

override

Definition at line 441 of file dl_dispatcher.cc.

                                             {
   AUTO_DEPTH_WATCHER(0u);
  
   EllipseGeometry geom(bounds);
   GetCanvas().ClipGeometry(geom, ToClipOperation(clip_op));
 }

References AUTO_DEPTH_WATCHER, impeller::Canvas::ClipGeometry(), GetCanvas(), and impeller::ToClipOperation().

◆ clipPath()

void impeller::DlDispatcherBase::clipPath	(	const DlPath &	path,
		ClipOp	clip_op,
		bool	is_aa
	)

override

Definition at line 473 of file dl_dispatcher.cc.

                                                                             {
   AUTO_DEPTH_WATCHER(0u);
  
   auto clip_op = ToClipOperation(sk_op);
  
   DlRect rect;
   if (path.IsRect(&rect)) {
     RectGeometry geom(rect);
     GetCanvas().ClipGeometry(geom, clip_op, /*is_aa=*/is_aa);
   } else if (path.IsOval(&rect)) {
     EllipseGeometry geom(rect);
     GetCanvas().ClipGeometry(geom, clip_op);
   } else {
     SkRRect rrect;
     if (path.IsSkRRect(&rrect) && rrect.isSimple()) {
       RoundRectGeometry geom(skia_conversions::ToRect(rrect.rect()),
                              skia_conversions::ToSize(rrect.getSimpleRadii()));
       GetCanvas().ClipGeometry(geom, clip_op);
     } else {
       FillPathGeometry geom(path.GetPath());
       GetCanvas().ClipGeometry(geom, clip_op);
     }
   }
 }

References AUTO_DEPTH_WATCHER, impeller::Canvas::ClipGeometry(), GetCanvas(), impeller::ToClipOperation(), impeller::skia_conversions::ToRect(), and impeller::skia_conversions::ToSize().

◆ clipRect()

void impeller::DlDispatcherBase::clipRect	(	const DlRect &	rect,
		ClipOp	clip_op,
		bool	is_aa
	)

override

Definition at line 431 of file dl_dispatcher.cc.

                                             {
   AUTO_DEPTH_WATCHER(0u);
  
   RectGeometry geom(rect);
   GetCanvas().ClipGeometry(geom, ToClipOperation(clip_op), /*is_aa=*/is_aa);
 }

References AUTO_DEPTH_WATCHER, impeller::Canvas::ClipGeometry(), GetCanvas(), and impeller::ToClipOperation().

◆ clipRoundRect()

void impeller::DlDispatcherBase::clipRoundRect	(	const DlRoundRect &	rrect,
		ClipOp	clip_op,
		bool	is_aa
	)

override

Definition at line 451 of file dl_dispatcher.cc.

                                                  {
   AUTO_DEPTH_WATCHER(0u);
  
   auto clip_op = ToClipOperation(sk_op);
   if (rrect.IsRect()) {
     RectGeometry geom(rrect.GetBounds());
     GetCanvas().ClipGeometry(geom, clip_op, /*is_aa=*/is_aa);
   } else if (rrect.IsOval()) {
     EllipseGeometry geom(rrect.GetBounds());
     GetCanvas().ClipGeometry(geom, clip_op);
   } else if (rrect.GetRadii().AreAllCornersSame()) {
     RoundRectGeometry geom(rrect.GetBounds(), rrect.GetRadii().top_left);
     GetCanvas().ClipGeometry(geom, clip_op);
   } else {
     FillPathGeometry geom(PathBuilder{}.AddRoundRect(rrect).TakePath());
     GetCanvas().ClipGeometry(geom, clip_op);
   }
 }

References impeller::PathBuilder::AddRoundRect(), AUTO_DEPTH_WATCHER, impeller::Canvas::ClipGeometry(), GetCanvas(), and impeller::ToClipOperation().

◆ drawArc()

void impeller::DlDispatcherBase::drawArc	(	const DlRect &	oval_bounds,
		DlScalar	start_degrees,
		DlScalar	sweep_degrees,
		bool	use_center
	)

override

Definition at line 639 of file dl_dispatcher.cc.

                                                 {
   AUTO_DEPTH_WATCHER(1u);
  
   if (paint_.stroke_width >
       std::max(oval_bounds.GetWidth(), oval_bounds.GetHeight())) {
     // This is a special case for rendering arcs whose stroke width is so large
     // you are effectively drawing a sector of a circle.
     // https://github.com/flutter/flutter/issues/158567
     DlRect expanded_rect = oval_bounds.Expand(Size(paint_.stroke_width / 2));
     PathBuilder builder;
     Paint fill_paint = paint_;
     fill_paint.style = Paint::Style::kFill;
     fill_paint.stroke_width = 1;
     builder.AddArc(expanded_rect, Degrees(start_degrees),
                    Degrees(sweep_degrees),
                    /*use_center=*/true);
     GetCanvas().DrawPath(builder.TakePath(), fill_paint);
   } else {
     PathBuilder builder;
     builder.AddArc(oval_bounds, Degrees(start_degrees), Degrees(sweep_degrees),
                    use_center);
     GetCanvas().DrawPath(builder.TakePath(), paint_);
   }
 }

References impeller::PathBuilder::AddArc(), AUTO_DEPTH_WATCHER, impeller::Canvas::DrawPath(), GetCanvas(), impeller::Paint::kFill, paint_, impeller::Paint::stroke_width, impeller::Paint::style, and impeller::PathBuilder::TakePath().

◆ drawAtlas()

void impeller::DlDispatcherBase::drawAtlas	(	const sk_sp< flutter::DlImage >	atlas,
		const RSTransform	xform[],
		const DlRect	tex[],
		const flutter::DlColor	colors[],
		int	count,
		flutter::DlBlendMode	mode,
		flutter::DlImageSampling	sampling,
		const DlRect *	cull_rect,
		bool	render_with_attributes
	)

override

Definition at line 776 of file dl_dispatcher.cc.

                                                               {
   AUTO_DEPTH_WATCHER(1u);
  
   auto geometry =
       DlAtlasGeometry(atlas->impeller_texture(),                        //
                       xform,                                            //
                       tex,                                              //
                       colors,                                           //
                       static_cast<size_t>(count),                       //
                       skia_conversions::ToBlendMode(mode),              //
                       skia_conversions::ToSamplerDescriptor(sampling),  //
                       skia_conversions::ToRect(cull_rect)               //
       );
   auto atlas_contents = std::make_shared<AtlasContents>();
   atlas_contents->SetGeometry(&geometry);
  
   GetCanvas().DrawAtlas(atlas_contents, paint_);
 }

References AUTO_DEPTH_WATCHER, impeller::Canvas::DrawAtlas(), GetCanvas(), paint_, impeller::skia_conversions::ToBlendMode(), impeller::skia_conversions::ToRect(), and impeller::skia_conversions::ToSamplerDescriptor().

◆ drawCircle()

void impeller::DlDispatcherBase::drawCircle	(	const DlPoint &	center,
		DlScalar	radius
	)

override

Definition at line 580 of file dl_dispatcher.cc.

                                                                         {
   AUTO_DEPTH_WATCHER(1u);
  
   GetCanvas().DrawCircle(center, radius, paint_);
 }

References AUTO_DEPTH_WATCHER, impeller::Canvas::DrawCircle(), GetCanvas(), and paint_.

◆ drawColor()

void impeller::DlDispatcherBase::drawColor	(	flutter::DlColor	color,
		flutter::DlBlendMode	mode
	)

override

Definition at line 499 of file dl_dispatcher.cc.

                                                              {
   AUTO_DEPTH_WATCHER(1u);
  
   Paint paint;
   paint.color = skia_conversions::ToColor(color);
   paint.blend_mode = skia_conversions::ToBlendMode(dl_mode);
   GetCanvas().DrawPaint(paint);
 }

References AUTO_DEPTH_WATCHER, impeller::Paint::blend_mode, impeller::Paint::color, impeller::Canvas::DrawPaint(), GetCanvas(), impeller::skia_conversions::ToBlendMode(), and impeller::skia_conversions::ToColor().

◆ drawDashedLine()

void impeller::DlDispatcherBase::drawDashedLine	(	const DlPoint &	p0,
		const DlPoint &	p1,
		DlScalar	on_length,
		DlScalar	off_length
	)

override

Definition at line 523 of file dl_dispatcher.cc.

                                                            {
   AUTO_DEPTH_WATCHER(1u);
  
   Scalar length = p0.GetDistance(p1);
   // Reasons to defer to regular DrawLine:
   //   length is non-positive - drawLine will draw appropriate "dot"
   //   off_length is non-positive - no gaps, drawLine will draw it solid
   //   on_length is negative - invalid dashing
   // Note that a 0 length "on" dash will draw "dot"s every "off" distance
   // apart
   if (length > 0.0f && on_length >= 0.0f && off_length > 0.0f) {
     Point delta = (p1 - p0) / length;  // length > 0 already tested
     PathBuilder builder;
  
     Scalar consumed = 0.0f;
     while (consumed < length) {
       builder.MoveTo(p0 + delta * consumed);
  
       Scalar dash_end = consumed + on_length;
       if (dash_end < length) {
         builder.LineTo(p0 + delta * dash_end);
       } else {
         builder.LineTo(p1);
         // Should happen anyway due to the math, but let's make it explicit
         // in case of bit errors. We're done with this line.
         break;
       }
  
       consumed = dash_end + off_length;
     }
  
     Paint stroke_paint = paint_;
     stroke_paint.style = Paint::Style::kStroke;
     GetCanvas().DrawPath(builder.TakePath(), stroke_paint);
   } else {
     drawLine(p0, p1);
   }
 }

References AUTO_DEPTH_WATCHER, drawLine(), impeller::Canvas::DrawPath(), GetCanvas(), impeller::Paint::kStroke, impeller::PathBuilder::LineTo(), impeller::PathBuilder::MoveTo(), paint_, impeller::Paint::style, and impeller::PathBuilder::TakePath().

◆ drawDiffRoundRect()

void impeller::DlDispatcherBase::drawDiffRoundRect	(	const DlRoundRect &	outer,
		const DlRoundRect &	inner
	)

override

Definition at line 594 of file dl_dispatcher.cc.

                                                                    {
   AUTO_DEPTH_WATCHER(1u);
  
   PathBuilder builder;
   builder.AddRoundRect(outer);
   builder.AddRoundRect(inner);
   builder.SetBounds(outer.GetBounds().Union(inner.GetBounds()));
   GetCanvas().DrawPath(builder.TakePath(FillType::kOdd), paint_);
 }

References impeller::PathBuilder::AddRoundRect(), AUTO_DEPTH_WATCHER, impeller::Canvas::DrawPath(), GetCanvas(), impeller::kOdd, paint_, impeller::PathBuilder::SetBounds(), and impeller::PathBuilder::TakePath().

◆ drawDisplayList()

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

override

Definition at line 804 of file dl_dispatcher.cc.

                       {
   AUTO_DEPTH_WATCHER(display_list->total_depth());
  
   // Save all values that must remain untouched after the operation.
   Paint saved_paint = paint_;
   Matrix saved_initial_matrix = initial_matrix_;
  
   // Establish a new baseline for interpreting the new DL.
   // Matrix and clip are left untouched, the current
   // transform is saved as the new base matrix, and paint
   // values are reset to defaults.
   initial_matrix_ = GetCanvas().GetCurrentTransform();
   paint_ = Paint();
  
   // Handle passed opacity in the most brute-force way by using
   // a SaveLayer. If the display_list is able to inherit the
   // opacity, this could also be handled by modulating all of its
   // attribute settings (for example, color), by the indicated
   // opacity.
   int restore_count = GetCanvas().GetSaveCount();
   if (opacity < SK_Scalar1) {
     Paint save_paint;
     save_paint.color = Color(0, 0, 0, opacity);
     GetCanvas().SaveLayer(
         save_paint, skia_conversions::ToRect(display_list->bounds()), nullptr,
         ContentBoundsPromise::kContainsContents, display_list->total_depth(),
         display_list->can_apply_group_opacity());
   } else {
     // The display list may alter the clip, which must be restored to the
     // current clip at the end of playback.
     GetCanvas().Save(display_list->total_depth());
   }
  
   // TODO(131445): Remove this restriction if we can correctly cull with
   // perspective transforms.
   if (display_list->has_rtree() && !initial_matrix_.HasPerspective()) {
     // The canvas remembers the screen-space culling bounds clipped by
     // the surface and the history of clip calls. DisplayList can cull
     // the ops based on a rectangle expressed in its "destination bounds"
     // so we need the canvas to transform those into the current local
     // coordinate space into which the DisplayList will be rendered.
     auto global_culling_bounds = GetCanvas().GetLocalCoverageLimit();
     if (global_culling_bounds.has_value()) {
       Rect cull_rect = global_culling_bounds->TransformBounds(
           GetCanvas().GetCurrentTransform().Invert());
       display_list->Dispatch(
           *this, SkRect::MakeLTRB(cull_rect.GetLeft(), cull_rect.GetTop(),
                                   cull_rect.GetRight(), cull_rect.GetBottom()));
     } else {
       // If the culling bounds are empty, this display list can be skipped
       // entirely.
     }
   } else {
     display_list->Dispatch(*this);
   }
  
   // Restore all saved state back to what it was before we interpreted
   // the display_list
   AUTO_DEPTH_CHECK();
   GetCanvas().RestoreToCount(restore_count);
   initial_matrix_ = saved_initial_matrix;
   paint_ = saved_paint;
 }

References AUTO_DEPTH_CHECK, AUTO_DEPTH_WATCHER, impeller::Paint::color, impeller::TRect< T >::GetBottom(), GetCanvas(), impeller::Canvas::GetCurrentTransform(), impeller::TRect< T >::GetLeft(), impeller::Canvas::GetLocalCoverageLimit(), impeller::TRect< T >::GetRight(), impeller::Canvas::GetSaveCount(), impeller::TRect< T >::GetTop(), impeller::Matrix::HasPerspective(), initial_matrix_, impeller::kContainsContents, paint_, impeller::Canvas::RestoreToCount(), impeller::Canvas::Save(), impeller::Canvas::SaveLayer(), impeller::skia_conversions::ToRect(), and impeller::TRect< T >::TransformBounds().

◆ drawImage()

void impeller::DlDispatcherBase::drawImage	(	const sk_sp< flutter::DlImage >	image,
		const DlPoint &	point,
		flutter::DlImageSampling	sampling,
		bool	render_with_attributes
	)

override

Definition at line 712 of file dl_dispatcher.cc.

                                                               {
   AUTO_DEPTH_WATCHER(1u);
  
   if (!image) {
     return;
   }
  
   auto texture = image->impeller_texture();
   if (!texture) {
     return;
   }
  
   const auto size = texture->GetSize();
   const auto src = DlRect::MakeWH(size.width, size.height);
   const auto dest = DlRect::MakeXYWH(point.x, point.y, size.width, size.height);
  
   drawImageRect(image,                      // image
                 src,                        // source rect
                 dest,                       // destination rect
                 sampling,                   // sampling options
                 render_with_attributes,     // render with attributes
                 SrcRectConstraint::kStrict  // constraint
   );
 }

References AUTO_DEPTH_WATCHER, and drawImageRect().

◆ drawImageNine()

void impeller::DlDispatcherBase::drawImageNine	(	const sk_sp< flutter::DlImage >	image,
		const DlIRect &	center,
		const DlRect &	dst,
		flutter::DlFilterMode	filter,
		bool	render_with_attributes
	)

override

Definition at line 760 of file dl_dispatcher.cc.

                                                                   {
   AUTO_DEPTH_WATCHER(9u);
  
   NinePatchConverter converter = {};
   converter.DrawNinePatch(image->impeller_texture(),
                           Rect::MakeLTRB(center.GetLeft(), center.GetTop(),
                                          center.GetRight(), center.GetBottom()),
                           dst, ToSamplerDescriptor(filter), &GetCanvas(),
                           &paint_);
 }

References AUTO_DEPTH_WATCHER, impeller::NinePatchConverter::DrawNinePatch(), GetCanvas(), impeller::TRect< Scalar >::MakeLTRB(), paint_, and impeller::ToSamplerDescriptor().

◆ drawImageRect()

void impeller::DlDispatcherBase::drawImageRect	(	const sk_sp< flutter::DlImage >	image,
		const DlRect &	src,
		const DlRect &	dst,
		flutter::DlImageSampling	sampling,
		bool	render_with_attributes,
		SrcRectConstraint	constraint = `SrcRectConstraint::kFast`
	)

override

Definition at line 741 of file dl_dispatcher.cc.

                                                            {
   AUTO_DEPTH_WATCHER(1u);
  
   GetCanvas().DrawImageRect(
       image->impeller_texture(),                       // image
       src,                                             // source rect
       dst,                                             // destination rect
       render_with_attributes ? paint_ : Paint(),       // paint
       skia_conversions::ToSamplerDescriptor(sampling)  // sampling
   );
 }

References AUTO_DEPTH_WATCHER, impeller::Canvas::DrawImageRect(), GetCanvas(), paint_, and impeller::skia_conversions::ToSamplerDescriptor().

Referenced by drawImage().

◆ drawLine()

void impeller::DlDispatcherBase::drawLine	(	const DlPoint &	p0,
		const DlPoint &	p1
	)

override

Definition at line 517 of file dl_dispatcher.cc.

                                                                     {
   AUTO_DEPTH_WATCHER(1u);
  
   GetCanvas().DrawLine(p0, p1, paint_);
 }

References AUTO_DEPTH_WATCHER, impeller::Canvas::DrawLine(), GetCanvas(), and paint_.

Referenced by drawDashedLine().

◆ drawOval()

void impeller::DlDispatcherBase::drawOval ( const DlRect & bounds )

override

Definition at line 573 of file dl_dispatcher.cc.

                                                     {
   AUTO_DEPTH_WATCHER(1u);
  
   GetCanvas().DrawOval(bounds, paint_);
 }

References AUTO_DEPTH_WATCHER, impeller::Canvas::DrawOval(), GetCanvas(), and paint_.

◆ drawPaint()

void impeller::DlDispatcherBase::drawPaint ( )

override

Definition at line 510 of file dl_dispatcher.cc.

                                  {
   AUTO_DEPTH_WATCHER(1u);
  
   GetCanvas().DrawPaint(paint_);
 }

References AUTO_DEPTH_WATCHER, impeller::Canvas::DrawPaint(), GetCanvas(), and paint_.

◆ drawPath()

void impeller::DlDispatcherBase::drawPath ( const DlPath & path )

override

Definition at line 606 of file dl_dispatcher.cc.

                                                   {
   AUTO_DEPTH_WATCHER(1u);
  
   SimplifyOrDrawPath(GetCanvas(), path, paint_);
 }

References AUTO_DEPTH_WATCHER, GetCanvas(), paint_, and SimplifyOrDrawPath().

◆ drawPoints()

void impeller::DlDispatcherBase::drawPoints	(	PointMode	mode,
		uint32_t	count,
		const DlPoint	points[]
	)

override

Definition at line 668 of file dl_dispatcher.cc.

                                                           {
   AUTO_DEPTH_WATCHER(1u);
  
   Paint paint = paint_;
   paint.style = Paint::Style::kStroke;
   switch (mode) {
     case flutter::DlCanvas::PointMode::kPoints: {
       // Cap::kButt is also treated as a square.
       PointStyle point_style = paint.stroke_cap == Cap::kRound
                                    ? PointStyle::kRound
                                    : PointStyle::kSquare;
       Scalar radius = paint.stroke_width;
       if (radius > 0) {
         radius /= 2.0;
       }
       GetCanvas().DrawPoints(points, count, radius, paint, point_style);
     } break;
     case flutter::DlCanvas::PointMode::kLines:
       for (uint32_t i = 1; i < count; i += 2) {
         Point p0 = points[i - 1];
         Point p1 = points[i];
         GetCanvas().DrawLine(p0, p1, paint, /*reuse_depth=*/i > 1);
       }
       break;
     case flutter::DlCanvas::PointMode::kPolygon:
       if (count > 1) {
         Point p0 = points[0];
         for (uint32_t i = 1; i < count; i++) {
           Point p1 = points[i];
           GetCanvas().DrawLine(p0, p1, paint, /*reuse_depth=*/i > 1);
           p0 = p1;
         }
       }
       break;
   }
 }

References AUTO_DEPTH_WATCHER, impeller::Canvas::DrawLine(), impeller::Canvas::DrawPoints(), GetCanvas(), impeller::kRound, impeller::kSquare, impeller::Paint::kStroke, paint_, impeller::Paint::stroke_cap, impeller::Paint::stroke_width, and impeller::Paint::style.

◆ drawRect()

void impeller::DlDispatcherBase::drawRect ( const DlRect & rect )

override

Definition at line 566 of file dl_dispatcher.cc.

                                                   {
   AUTO_DEPTH_WATCHER(1u);
  
   GetCanvas().DrawRect(rect, paint_);
 }

References AUTO_DEPTH_WATCHER, impeller::Canvas::DrawRect(), GetCanvas(), and paint_.

◆ drawRoundRect()

void impeller::DlDispatcherBase::drawRoundRect ( const DlRoundRect & rrect )

override

Definition at line 587 of file dl_dispatcher.cc.

                                                              {
   AUTO_DEPTH_WATCHER(1u);
  
   GetCanvas().DrawRoundRect(rrect, paint_);
 }

References AUTO_DEPTH_WATCHER, impeller::Canvas::DrawRoundRect(), GetCanvas(), and paint_.

◆ drawShadow()

void impeller::DlDispatcherBase::drawShadow	(	const DlPath &	path,
		const flutter::DlColor	color,
		const DlScalar	elevation,
		bool	transparent_occluder,
		DlScalar	dpr
	)

override

Definition at line 893 of file dl_dispatcher.cc.

                                                 {
   AUTO_DEPTH_WATCHER(1u);
  
   Color spot_color = skia_conversions::ToColor(color);
   spot_color.alpha *= 0.25;
  
   // Compute the spot color -- ported from SkShadowUtils::ComputeTonalColors.
   {
     Scalar max =
         std::max(std::max(spot_color.red, spot_color.green), spot_color.blue);
     Scalar min =
         std::min(std::min(spot_color.red, spot_color.green), spot_color.blue);
     Scalar luminance = (min + max) * 0.5;
  
     Scalar alpha_adjust =
         (2.6f + (-2.66667f + 1.06667f * spot_color.alpha) * spot_color.alpha) *
         spot_color.alpha;
     Scalar color_alpha =
         (3.544762f + (-4.891428f + 2.3466f * luminance) * luminance) *
         luminance;
     color_alpha = std::clamp(alpha_adjust * color_alpha, 0.0f, 1.0f);
  
     Scalar greyscale_alpha =
         std::clamp(spot_color.alpha * (1 - 0.4f * luminance), 0.0f, 1.0f);
  
     Scalar color_scale = color_alpha * (1 - greyscale_alpha);
     Scalar tonal_alpha = color_scale + greyscale_alpha;
     Scalar unpremul_scale = tonal_alpha != 0 ? color_scale / tonal_alpha : 0;
     spot_color = Color(unpremul_scale * spot_color.red,
                        unpremul_scale * spot_color.green,
                        unpremul_scale * spot_color.blue, tonal_alpha);
   }
  
   Vector3 light_position(0, -1, 1);
   Scalar occluder_z = dpr * elevation;
  
   constexpr Scalar kLightRadius = 800 / 600;  // Light radius / light height
  
   Paint paint;
   paint.style = Paint::Style::kFill;
   paint.color = spot_color;
   paint.mask_blur_descriptor = Paint::MaskBlurDescriptor{
       .style = FilterContents::BlurStyle::kNormal,
       .sigma = Radius{kLightRadius * occluder_z /
                       GetCanvas().GetCurrentTransform().GetScale().y},
   };
  
   GetCanvas().Save(1u);
   GetCanvas().PreConcat(
       Matrix::MakeTranslation(Vector2(0, -occluder_z * light_position.y)));
  
   SimplifyOrDrawPath(GetCanvas(), path, paint);
   AUTO_DEPTH_CHECK();
  
   GetCanvas().Restore();
 }

References impeller::Color::alpha, AUTO_DEPTH_CHECK, AUTO_DEPTH_WATCHER, impeller::Color::blue, impeller::Paint::color, GetCanvas(), impeller::Canvas::GetCurrentTransform(), impeller::Matrix::GetScale(), impeller::Color::green, impeller::Paint::kFill, impeller::FilterContents::kNormal, impeller::Matrix::MakeTranslation(), impeller::Paint::mask_blur_descriptor, impeller::Canvas::PreConcat(), impeller::Color::red, impeller::Canvas::Restore(), impeller::Canvas::Save(), SimplifyOrDrawPath(), impeller::Paint::MaskBlurDescriptor::style, impeller::Paint::style, impeller::skia_conversions::ToColor(), and impeller::Vector3::y.

◆ drawTextBlob()

void impeller::DlDispatcherBase::drawTextBlob	(	const sk_sp< SkTextBlob >	blob,
		DlScalar	x,
		DlScalar	y
	)

override

Definition at line 871 of file dl_dispatcher.cc.

                                                 {
   // When running with Impeller enabled Skia text blobs are converted to
   // Impeller text frames in paragraph_skia.cc
   UNIMPLEMENTED;
 }

References UNIMPLEMENTED.

◆ drawTextFrame()

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

override

Definition at line 880 of file dl_dispatcher.cc.

                 {
   AUTO_DEPTH_WATCHER(1u);
  
   GetCanvas().DrawTextFrame(text_frame,             //
                             impeller::Point{x, y},  //
                             paint_                  //
   );
 }

References AUTO_DEPTH_WATCHER, impeller::Canvas::DrawTextFrame(), GetCanvas(), paint_, and x.

◆ drawVertices()

void impeller::DlDispatcherBase::drawVertices	(	const std::shared_ptr< flutter::DlVertices > &	vertices,
		flutter::DlBlendMode	dl_mode
	)

override

Definition at line 707 of file dl_dispatcher.cc.

709 {}

◆ GetCanvas()

virtual Canvas& impeller::DlDispatcherBase::GetCanvas ( )

pure virtual

◆ restore()

void impeller::DlDispatcherBase::restore ( )

override

Definition at line 329 of file dl_dispatcher.cc.

                                {
   GetCanvas().Restore();
 }

References GetCanvas(), and impeller::Canvas::Restore().

◆ rotate()

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

override

Definition at line 348 of file dl_dispatcher.cc.

                                               {
   AUTO_DEPTH_WATCHER(0u);
  
   GetCanvas().Rotate(Degrees{degrees});
 }

References AUTO_DEPTH_WATCHER, GetCanvas(), and impeller::Canvas::Rotate().

◆ save()

void impeller::DlDispatcherBase::save ( uint32_t total_content_depth )

override

Definition at line 293 of file dl_dispatcher.cc.

                                                         {
   AUTO_DEPTH_WATCHER(1u);
  
   GetCanvas().Save(total_content_depth);
 }

References AUTO_DEPTH_WATCHER, GetCanvas(), and impeller::Canvas::Save().

◆ saveLayer()

void impeller::DlDispatcherBase::saveLayer	(	const DlRect &	bounds,
		const flutter::SaveLayerOptions &	options,
		uint32_t	total_content_depth,
		flutter::DlBlendMode	max_content_mode,
		const flutter::DlImageFilter *	backdrop,
		std::optional< int64_t >	backdrop_id
	)

override

Definition at line 300 of file dl_dispatcher.cc.

                                                                    {
   AUTO_DEPTH_WATCHER(1u);
  
   auto paint = options.renders_with_attributes() ? paint_ : Paint{};
   auto promise = options.content_is_clipped()
                      ? ContentBoundsPromise::kMayClipContents
                      : ContentBoundsPromise::kContainsContents;
   std::optional<Rect> impeller_bounds;
   // If the content is unbounded but has developer specified bounds, we take
   // the original bounds so that we clip the content as expected.
   if (!options.content_is_unbounded() || options.bounds_from_caller()) {
     impeller_bounds = bounds;
   }
  
   GetCanvas().SaveLayer(
       paint, impeller_bounds, backdrop, promise, total_content_depth,
       // Unbounded content can still have user specified bounds that require a
       // saveLayer to be created to perform the clip.
       options.can_distribute_opacity() && !options.content_is_unbounded(),
       backdrop_id  //
   );
 }

References AUTO_DEPTH_WATCHER, GetCanvas(), impeller::kContainsContents, impeller::kMayClipContents, paint_, and impeller::Canvas::SaveLayer().

◆ scale()

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

override

Definition at line 341 of file dl_dispatcher.cc.

                                                      {
   AUTO_DEPTH_WATCHER(0u);
  
   GetCanvas().Scale({sx, sy, 1.0});
 }

References AUTO_DEPTH_WATCHER, GetCanvas(), and impeller::Canvas::Scale().

◆ setAntiAlias()

void impeller::DlDispatcherBase::setAntiAlias ( bool aa )

override

Definition at line 140 of file dl_dispatcher.cc.

                                            {
   AUTO_DEPTH_WATCHER(0u);
  
   // Nothing to do because AA is implicit.
 }

References AUTO_DEPTH_WATCHER.

◆ setBlendMode()

void impeller::DlDispatcherBase::setBlendMode ( flutter::DlBlendMode mode )

override

Definition at line 243 of file dl_dispatcher.cc.

                                                               {
   AUTO_DEPTH_WATCHER(0u);
  
   paint_.blend_mode = skia_conversions::ToBlendMode(dl_mode);
 }

References AUTO_DEPTH_WATCHER, impeller::Paint::blend_mode, paint_, and impeller::skia_conversions::ToBlendMode().

◆ setColor()

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

override

Definition at line 167 of file dl_dispatcher.cc.

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

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

◆ setColorFilter()

void impeller::DlDispatcherBase::setColorFilter ( const flutter::DlColorFilter * filter )

override

Definition at line 229 of file dl_dispatcher.cc.

                                                                         {
   AUTO_DEPTH_WATCHER(0u);
  
   paint_.color_filter = filter;
 }

References AUTO_DEPTH_WATCHER, impeller::Paint::color_filter, and paint_.

◆ setColorSource()

void impeller::DlDispatcherBase::setColorSource ( const flutter::DlColorSource * source )

override

Definition at line 222 of file dl_dispatcher.cc.

                                                                         {
   AUTO_DEPTH_WATCHER(0u);
  
   paint_.color_source = source;
 }

References AUTO_DEPTH_WATCHER, impeller::Paint::color_source, and paint_.

◆ setDrawStyle()

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

override

Definition at line 160 of file dl_dispatcher.cc.

                                                             {
   AUTO_DEPTH_WATCHER(0u);
  
   paint_.style = ToStyle(style);
 }

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

◆ setImageFilter()

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

override

Definition at line 286 of file dl_dispatcher.cc.

                                                                         {
   AUTO_DEPTH_WATCHER(0u);
  
   paint_.image_filter = filter;
 }

References AUTO_DEPTH_WATCHER, impeller::Paint::image_filter, and paint_.

◆ setInvertColors()

void impeller::DlDispatcherBase::setInvertColors ( bool invert )

override

Definition at line 236 of file dl_dispatcher.cc.

                                                   {
   AUTO_DEPTH_WATCHER(0u);
  
   paint_.invert_colors = invert;
 }

References AUTO_DEPTH_WATCHER, impeller::Paint::invert_colors, and paint_.

◆ setMaskFilter()

void impeller::DlDispatcherBase::setMaskFilter ( const flutter::DlMaskFilter * filter )

override

Definition at line 263 of file dl_dispatcher.cc.

                                                                       {
   AUTO_DEPTH_WATCHER(0u);
  
   // Needs https://github.com/flutter/flutter/issues/95434
   if (filter == nullptr) {
     paint_.mask_blur_descriptor = std::nullopt;
     return;
   }
   switch (filter->type()) {
     case flutter::DlMaskFilterType::kBlur: {
       auto blur = filter->asBlur();
  
       paint_.mask_blur_descriptor = {
           .style = ToBlurStyle(blur->style()),
           .sigma = Sigma(blur->sigma()),
           .respect_ctm = blur->respectCTM(),
       };
       break;
     }
   }
 }

References AUTO_DEPTH_WATCHER, impeller::Paint::mask_blur_descriptor, paint_, and impeller::ToBlurStyle().

◆ setStrokeCap()

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

override

Definition at line 188 of file dl_dispatcher.cc.

                                                           {
   AUTO_DEPTH_WATCHER(0u);
  
   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 AUTO_DEPTH_WATCHER, impeller::kButt, impeller::kRound, impeller::kSquare, paint_, and impeller::Paint::stroke_cap.

◆ setStrokeJoin()

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

override

Definition at line 205 of file dl_dispatcher.cc.

                                                              {
   AUTO_DEPTH_WATCHER(0u);
  
   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 AUTO_DEPTH_WATCHER, impeller::kBevel, impeller::kMiter, impeller::kRound, paint_, and impeller::Paint::stroke_join.

◆ setStrokeMiter()

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

override

Definition at line 181 of file dl_dispatcher.cc.

                                                     {
   AUTO_DEPTH_WATCHER(0u);
  
   paint_.stroke_miter = limit;
 }

References AUTO_DEPTH_WATCHER, paint_, and impeller::Paint::stroke_miter.

◆ setStrokeWidth()

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

override

Definition at line 174 of file dl_dispatcher.cc.

                                                     {
   AUTO_DEPTH_WATCHER(0u);
  
   paint_.stroke_width = width;
 }

References AUTO_DEPTH_WATCHER, paint_, and impeller::Paint::stroke_width.

◆ SimplifyOrDrawPath()

void impeller::DlDispatcherBase::SimplifyOrDrawPath	(	Canvas &	canvas,
		const DlPath &	cache,
		const Paint &	paint
	)

staticprotected

Definition at line 612 of file dl_dispatcher.cc.

                                                               {
   DlRect rect;
  
   // We can't "optimize" a path into a rectangle if it's open.
   bool closed;
   if (path.IsRect(&rect, &closed) && closed) {
     canvas.DrawRect(rect, paint);
     return;
   }
  
   SkRRect rrect;
   if (path.IsSkRRect(&rrect) && rrect.isSimple()) {
     canvas.DrawRoundRect(flutter::ToDlRoundRect(rrect), paint);
     return;
   }
  
   if (path.IsOval(&rect)) {
     canvas.DrawOval(rect, paint);
     return;
   }
  
   canvas.DrawPath(path.GetPath(), paint);
 }

References impeller::Canvas::DrawOval(), impeller::Canvas::DrawPath(), impeller::Canvas::DrawRect(), and impeller::Canvas::DrawRoundRect().

Referenced by drawPath(), and drawShadow().

◆ skew()

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

override

Definition at line 355 of file dl_dispatcher.cc.

                                                     {
   AUTO_DEPTH_WATCHER(0u);
  
   GetCanvas().Skew(sx, sy);
 }

References AUTO_DEPTH_WATCHER, GetCanvas(), and impeller::Canvas::Skew().

◆ transform2DAffine()

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

override

Definition at line 362 of file dl_dispatcher.cc.

                                                        {
   AUTO_DEPTH_WATCHER(0u);
  
   // clang-format off
   transformFullPerspective(
     mxx, mxy,  0, mxt,
     myx, myy,  0, myt,
     0  ,   0,  1,   0,
     0  ,   0,  0,   1
   );
   // clang-format on
 }

References AUTO_DEPTH_WATCHER, and transformFullPerspective().

◆ transformFullPerspective()

void impeller::DlDispatcherBase::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 381 of file dl_dispatcher.cc.

                                                               {
   AUTO_DEPTH_WATCHER(0u);
  
   // The order of arguments is row-major but Impeller matrices are
   // column-major.
   // clang-format off
   auto transform = Matrix{
     mxx, myx, mzx, mwx,
     mxy, myy, mzy, mwy,
     mxz, myz, mzz, mwz,
     mxt, myt, mzt, mwt
   };
   // clang-format on
   GetCanvas().Transform(transform);
 }

References AUTO_DEPTH_WATCHER, GetCanvas(), impeller::Canvas::Transform(), and transform.

Referenced by transform2DAffine().

◆ transformReset()

void impeller::DlDispatcherBase::transformReset ( )

override

Definition at line 413 of file dl_dispatcher.cc.

                                       {
   AUTO_DEPTH_WATCHER(0u);
  
   GetCanvas().ResetTransform();
   GetCanvas().Transform(initial_matrix_);
 }

References AUTO_DEPTH_WATCHER, GetCanvas(), initial_matrix_, impeller::Canvas::ResetTransform(), and impeller::Canvas::Transform().

◆ translate()

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

override

Definition at line 334 of file dl_dispatcher.cc.

                                                          {
   AUTO_DEPTH_WATCHER(0u);
  
   GetCanvas().Translate({tx, ty, 0.0});
 }

References AUTO_DEPTH_WATCHER, GetCanvas(), and impeller::Canvas::Translate().

Member Data Documentation

◆ initial_matrix_

Matrix impeller::DlDispatcherBase::initial_matrix_

protected

Definition at line 246 of file dl_dispatcher.h.

Referenced by drawDisplayList(), and transformReset().

◆ paint_

Paint impeller::DlDispatcherBase::paint_

protected

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

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

Public Member Functions

Static Protected Member Functions

Protected Attributes

Detailed Description

Member Function Documentation

◆ clipOval()

◆ clipPath()

◆ clipRect()

◆ clipRoundRect()

◆ drawArc()

◆ drawAtlas()

◆ drawCircle()

◆ drawColor()

◆ drawDashedLine()

◆ drawDiffRoundRect()

◆ drawDisplayList()

◆ drawImage()

◆ drawImageNine()

◆ drawImageRect()

◆ drawLine()

◆ drawOval()

◆ drawPaint()

◆ drawPath()

◆ drawPoints()

◆ drawRect()

◆ drawRoundRect()

◆ drawShadow()

◆ drawTextBlob()

◆ drawTextFrame()

◆ drawVertices()

◆ GetCanvas()

◆ restore()

◆ rotate()

◆ save()

◆ saveLayer()

◆ scale()

◆ setAntiAlias()

◆ setBlendMode()

◆ setColor()

◆ setColorFilter()

◆ setColorSource()

◆ setDrawStyle()

◆ setImageFilter()

◆ setInvertColors()

◆ setMaskFilter()

◆ setStrokeCap()

◆ setStrokeJoin()

◆ setStrokeMiter()

◆ setStrokeWidth()

◆ SimplifyOrDrawPath()

◆ skew()

◆ transform2DAffine()

◆ transformFullPerspective()

◆ transformReset()

◆ translate()

Member Data Documentation

◆ initial_matrix_

◆ paint_