#include <dl_dispatcher.h>

Inheritance diagram for impeller::DlDispatcherBase:

Public Member Functions
	DlDispatcherBase ()

virtual	~DlDispatcherBase ()=default

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, flutter::DlClipOp clip_op, bool is_aa) override

void	clipOval (const DlRect &bounds, flutter::DlClipOp clip_op, bool is_aa) override

void	clipRoundRect (const DlRoundRect &rrect, flutter::DlClipOp clip_op, bool is_aa) override

void	clipRoundSuperellipse (const DlRoundSuperellipse &rse, flutter::DlClipOp clip_op, bool is_aa) override

void	clipPath (const DlPath &path, flutter::DlClipOp 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	drawRoundSuperellipse (const DlRoundSuperellipse &rse) 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 (flutter::DlPointMode 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, flutter::DlSrcRectConstraint 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	drawText (const std::shared_ptr< flutter::DlText > &text, 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

virtual const ContentContext &	GetContentContext () const =0

std::shared_ptr< Texture >	GetTexture (const sk_sp< flutter::DlImage > &image)

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

Protected Attributes
Paint	paint_

Matrix	initial_matrix_

Detailed Description

Important implementation note.

The Impeller DisplayList Dispatcher implementation is divided into two parts and conducted in two passes.

The first pass is conducted using the FirstPassDispatcher which examines the rendering ops for important conditions needed by the rendering pass and computes some needed information for them.

The second pass is conducted using CanvasDlDispatcher to perform the actual rendering using a Canvas and data provided by the first pass.

@important It is important to note that the 2 passes perform slightly different DisplayList culling and may process different subsets of the frame's operations. See https://github.com/flutter/flutter/issues/182639

Given the above issue any data precomputed by the first pass should be presented in a way that doesn't assume a 1:1 correlation of the rendering operations in both passes (perhaps provide it in a map instead of a vector). While we have not yet observed and cases where an operation is missed during the first pass but still processed in the rendering pass, it would be wise to include a backup plan in the canvas dispatcher for when the data was not forwarded. Base (virtual) dispatcher utility class to implement most DlOpReceiver operations for other specific classes.

Definition at line 65 of file dl_dispatcher.h.

Constructor & Destructor Documentation

◆ DlDispatcherBase()

impeller::DlDispatcherBase::DlDispatcherBase ( )

inlineexplicit

Definition at line 67 of file dl_dispatcher.h.

67 {}

◆ ~DlDispatcherBase()

virtual impeller::DlDispatcherBase::~DlDispatcherBase ( )

virtualdefault

Member Function Documentation

◆ clipOval()

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

override

Definition at line 435 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,
		flutter::DlClipOp	clip_op,
		bool	is_aa
	)

override

Definition at line 486 of file dl_dispatcher.cc.

                                             {
   AUTO_DEPTH_WATCHER(0u);
  
   auto clip_op = ToClipOperation(sk_op);
  
   DlRect rect;
   if (path.IsRect(&rect)) {
     FillRectGeometry 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 {
     DlRoundRect rrect;
     if (path.IsRoundRect(&rrect) && rrect.GetRadii().AreAllCornersSame()) {
       RoundRectGeometry geom(rrect.GetBounds(), rrect.GetRadii().top_left);
       GetCanvas().ClipGeometry(geom, clip_op);
     } else {
       FillPathGeometry geom(path);
       GetCanvas().ClipGeometry(geom, clip_op);
     }
   }
 }

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

◆ clipRect()

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

override

Definition at line 425 of file dl_dispatcher.cc.

                                             {
   AUTO_DEPTH_WATCHER(0u);
  
   FillRectGeometry 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,
		flutter::DlClipOp	clip_op,
		bool	is_aa
	)

override

Definition at line 445 of file dl_dispatcher.cc.

                                                  {
   AUTO_DEPTH_WATCHER(0u);
  
   auto clip_op = ToClipOperation(sk_op);
   if (rrect.IsRect()) {
     FillRectGeometry 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 {
     FillRoundRectGeometry geom(rrect);
     GetCanvas().ClipGeometry(geom, clip_op);
   }
 }

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

◆ clipRoundSuperellipse()

void impeller::DlDispatcherBase::clipRoundSuperellipse	(	const DlRoundSuperellipse &	rse,
		flutter::DlClipOp	clip_op,
		bool	is_aa
	)

override

Definition at line 467 of file dl_dispatcher.cc.

                                                          {
   AUTO_DEPTH_WATCHER(0u);
  
   auto clip_op = ToClipOperation(sk_op);
   if (rse.IsRect()) {
     FillRectGeometry geom(rse.GetBounds());
     GetCanvas().ClipGeometry(geom, clip_op, /*is_aa=*/is_aa);
   } else if (rse.IsOval()) {
     EllipseGeometry geom(rse.GetBounds());
     GetCanvas().ClipGeometry(geom, clip_op);
   } else {
     RoundSuperellipseGeometry geom(rse.GetBounds(), rse.GetRadii());
     GetCanvas().ClipGeometry(geom, clip_op);
   }
 }

References 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 631 of file dl_dispatcher.cc.

                                                 {
   AUTO_DEPTH_WATCHER(1u);
  
   GetCanvas().DrawArc(Arc(oval_bounds, Degrees(start_degrees),
                           Degrees(sweep_degrees), use_center),
                       paint_);
 }

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

◆ 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 759 of file dl_dispatcher.cc.

                                                               {
   AUTO_DEPTH_WATCHER(1u);
  
   auto geometry =
       DlAtlasGeometry(GetTexture(atlas),                                //
                       xform,                                            //
                       tex,                                              //
                       colors,                                           //
                       static_cast<size_t>(count),                       //
                       mode,                                             //
                       skia_conversions::ToSamplerDescriptor(sampling),  //
                       ToOptRect(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(), GetTexture(), paint_, impeller::ToOptRect(), and impeller::skia_conversions::ToSamplerDescriptor().

◆ drawCircle()

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

override

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

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

References AUTO_DEPTH_WATCHER, impeller::Paint::blend_mode, impeller::Paint::color, impeller::Canvas::DrawPaint(), GetCanvas(), 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 538 of file dl_dispatcher.cc.

                                                            {
   AUTO_DEPTH_WATCHER(1u);
  
   GetCanvas().DrawDashedLine(p0, p1, on_length, off_length, paint_);
 }

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

◆ drawDiffRoundRect()

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

override

Definition at line 576 of file dl_dispatcher.cc.

                                                                    {
   AUTO_DEPTH_WATCHER(1u);
  
   GetCanvas().DrawDiffRoundRect(outer, inner, paint_);
 }

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

◆ drawDisplayList()

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

override

Definition at line 787 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, display_list->GetBounds(), 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, cull_rect);
     } 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, GetCanvas(), impeller::Canvas::GetCurrentTransform(), impeller::Canvas::GetLocalCoverageLimit(), impeller::Canvas::GetSaveCount(), impeller::Matrix::HasPerspective(), initial_matrix_, impeller::kContainsContents, paint_, impeller::Canvas::RestoreToCount(), impeller::Canvas::Save(), impeller::Canvas::SaveLayer(), 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 695 of file dl_dispatcher.cc.

                                                               {
   AUTO_DEPTH_WATCHER(1u);
  
   if (!image) {
     return;
   }
  
   auto texture = GetTexture(image);
   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
                 flutter::DlSrcRectConstraint::kStrict  // constraint
   );
 }

References AUTO_DEPTH_WATCHER, drawImageRect(), and GetTexture().

◆ 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 743 of file dl_dispatcher.cc.

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

References AUTO_DEPTH_WATCHER, impeller::NinePatchConverter::DrawNinePatch(), GetCanvas(), GetTexture(), 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,
		flutter::DlSrcRectConstraint	constraint = `flutter::DlSrcRectConstraint::kFast`
	)

override

Definition at line 724 of file dl_dispatcher.cc.

                                                                           {
   AUTO_DEPTH_WATCHER(1u);
  
   GetCanvas().DrawImageRect(
       GetTexture(image),                               // 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(), GetTexture(), paint_, and impeller::skia_conversions::ToSamplerDescriptor().

Referenced by drawImage().

◆ drawLine()

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

override

Definition at line 531 of file dl_dispatcher.cc.

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

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

◆ drawOval()

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

override

Definition at line 555 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 524 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 591 of file dl_dispatcher.cc.

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

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

◆ drawPoints()

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

override

Definition at line 643 of file dl_dispatcher.cc.

                                                           {
   AUTO_DEPTH_WATCHER(1u);
  
   Paint paint = paint_;
   paint.style = Paint::Style::kStroke;
   switch (mode) {
     case flutter::DlPointMode::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::DlPointMode::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::DlPointMode::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::StrokeParameters::cap, impeller::Canvas::DrawLine(), impeller::Canvas::DrawPoints(), GetCanvas(), impeller::kRound, impeller::kSquare, impeller::Paint::kStroke, p1, paint_, points, impeller::Paint::stroke, impeller::Paint::style, and impeller::StrokeParameters::width.

◆ drawRect()

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

override

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

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

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

◆ drawRoundSuperellipse()

void impeller::DlDispatcherBase::drawRoundSuperellipse ( const DlRoundSuperellipse & rse )

override

Definition at line 584 of file dl_dispatcher.cc.

                                                                            {
   AUTO_DEPTH_WATCHER(1u);
  
   GetCanvas().DrawRoundSuperellipse(rse, paint_);
 }

References AUTO_DEPTH_WATCHER, impeller::Canvas::DrawRoundSuperellipse(), 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 869 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.

◆ drawText()

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

override

Definition at line 852 of file dl_dispatcher.cc.

                                             {
   AUTO_DEPTH_WATCHER(1u);
  
   auto text_frame = text->GetTextFrame();
  
   // When running with Impeller enabled Skia text blobs are converted to
   // Impeller text frames in paragraph_skia.cc
   FML_CHECK(text_frame != nullptr);
   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 690 of file dl_dispatcher.cc.

692 {}

◆ GetCanvas()

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

pure virtual

◆ GetContentContext()

virtual const ContentContext& impeller::DlDispatcherBase::GetContentContext ( ) const

pure virtual

Referenced by GetTexture().

◆ GetTexture()

std::shared_ptr< Texture > impeller::DlDispatcherBase::GetTexture ( const sk_sp< flutter::DlImage > & image )

Definition at line 682 of file dl_dispatcher.cc.

                                         {
   if (!image) {
     return nullptr;
   }
   return image->asImpellerImage()->GetCachedTexture(GetContentContext());
 }

References GetContentContext().

Referenced by drawAtlas(), drawImage(), drawImageNine(), and drawImageRect().

◆ restore()

void impeller::DlDispatcherBase::restore ( )

override

Definition at line 338 of file dl_dispatcher.cc.

                                {
   GetCanvas().Restore();
 }

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

◆ rotate()

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

override

Definition at line 357 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 302 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 309 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 350 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 149 of file dl_dispatcher.cc.

                                            {
   AUTO_DEPTH_WATCHER(0u);
  
   paint_.anti_alias = aa;
 }

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

◆ setBlendMode()

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

override

Definition at line 252 of file dl_dispatcher.cc.

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

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

◆ setColor()

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

override

Definition at line 176 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 238 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 231 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 169 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 295 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 245 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 272 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 197 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::StrokeParameters::cap, impeller::kButt, impeller::kRound, impeller::kSquare, paint_, and impeller::Paint::stroke.

◆ setStrokeJoin()

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

override

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

◆ setStrokeMiter()

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

override

Definition at line 190 of file dl_dispatcher.cc.

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

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

◆ setStrokeWidth()

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

override

Definition at line 183 of file dl_dispatcher.cc.

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

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

◆ SimplifyOrDrawPath()

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

staticprotected

Definition at line 597 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;
   }
  
   DlRoundRect rrect;
   if (path.IsRoundRect(&rrect) && rrect.GetRadii().AreAllCornersSame()) {
     canvas.DrawRoundRect(rrect, paint);
     return;
   }
  
   if (path.IsOval(&rect)) {
     canvas.DrawOval(rect, paint);
     return;
   }
  
   DlPoint start;
   DlPoint end;
   if (path.IsLine(&start, &end)) {
     canvas.DrawLine(start, end, paint);
     return;
   }
  
   canvas.DrawPath(path, paint);
 }

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

Referenced by drawShadow().

◆ skew()

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

override

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

                                               {
   AUTO_DEPTH_WATCHER(0u);
  
   transformFullPerspective(
       mxx, mxy,  0, mxt,
       myx, myy,  0, myt,
       0  ,   0,  1,   0,
       0  ,   0,  0,   1
   );
 }

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

                                                             {
   AUTO_DEPTH_WATCHER(0u);
  
   // The order of arguments is row-major but Impeller matrices are
   // column-major.
   auto transform = Matrix{
       mxx, myx, mzx, mwx,
       mxy, myy, mzy, mwy,
       mxz, myz, mzz, mwz,
       mxt, myt, mzt, mwt
   };
   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 408 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 343 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 298 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

Constructor & Destructor Documentation

◆ DlDispatcherBase()

◆ ~DlDispatcherBase()

Member Function Documentation

◆ clipOval()

◆ clipPath()

◆ clipRect()

◆ clipRoundRect()

◆ clipRoundSuperellipse()

◆ drawArc()

◆ drawAtlas()

◆ drawCircle()

◆ drawColor()

◆ drawDashedLine()

◆ drawDiffRoundRect()

◆ drawDisplayList()

◆ drawImage()

◆ drawImageNine()

◆ drawImageRect()

◆ drawLine()

◆ drawOval()

◆ drawPaint()

◆ drawPath()

◆ drawPoints()

◆ drawRect()

◆ drawRoundRect()

◆ drawRoundSuperellipse()

◆ drawShadow()

◆ drawText()

◆ drawVertices()

◆ GetCanvas()

◆ GetContentContext()

◆ GetTexture()

◆ 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_