#include <dl_dispatcher.h>

Inheritance diagram for impeller::DlDispatcherBase:

Public Member Functions
Picture	EndRecordingAsPicture ()

bool	PrefersImpellerPaths () const override

void	setAntiAlias (bool aa) override

void	setDrawStyle (flutter::DlDrawStyle style) override

void	setColor (flutter::DlColor color) override

void	setStrokeWidth (SkScalar width) override

void	setStrokeMiter (SkScalar 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 SkRect &bounds, const flutter::SaveLayerOptions &options, uint32_t total_content_depth, flutter::DlBlendMode max_content_mode, const flutter::DlImageFilter *backdrop) override

void	restore () override

void	translate (SkScalar tx, SkScalar ty) override

void	scale (SkScalar sx, SkScalar sy) override

void	rotate (SkScalar degrees) override

void	skew (SkScalar sx, SkScalar sy) override

void	transform2DAffine (SkScalar mxx, SkScalar mxy, SkScalar mxt, SkScalar myx, SkScalar myy, SkScalar myt) override

void	transformFullPerspective (SkScalar mxx, SkScalar mxy, SkScalar mxz, SkScalar mxt, SkScalar myx, SkScalar myy, SkScalar myz, SkScalar myt, SkScalar mzx, SkScalar mzy, SkScalar mzz, SkScalar mzt, SkScalar mwx, SkScalar mwy, SkScalar mwz, SkScalar mwt) override

void	transformReset () override

void	clipRect (const SkRect &rect, ClipOp clip_op, bool is_aa) override

void	clipRRect (const SkRRect &rrect, ClipOp clip_op, bool is_aa) override

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

void	clipPath (const CacheablePath &cache, ClipOp clip_op, bool is_aa) override

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

void	drawPaint () override

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

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

void	drawRect (const SkRect &rect) override

void	drawOval (const SkRect &bounds) override

void	drawCircle (const SkPoint &center, SkScalar radius) override

void	drawRRect (const SkRRect &rrect) override

void	drawDRRect (const SkRRect &outer, const SkRRect &inner) override

void	drawPath (const SkPath &path) override

void	drawPath (const CacheablePath &cache) override

void	drawArc (const SkRect &oval_bounds, SkScalar start_degrees, SkScalar sweep_degrees, bool use_center) override

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

void	drawVertices (const flutter::DlVertices *vertices, flutter::DlBlendMode dl_mode) override

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

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

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

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

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

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

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

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

void	drawShadow (const CacheablePath &cache, const flutter::DlColor color, const SkScalar elevation, bool transparent_occluder, SkScalar dpr) override

virtual Canvas &	GetCanvas ()=0

Public Member Functions inherited from flutter::DlOpReceiver
virtual bool	PrefersImpellerPaths () const

virtual void	clipPath (const CacheablePath &cache, ClipOp clip_op, bool is_aa)

virtual void	drawPath (const CacheablePath &cache)

virtual void	drawShadow (const CacheablePath &cache, const DlColor color, const SkScalar elevation, bool transparent_occluder, SkScalar dpr)

virtual void	setAntiAlias (bool aa)=0

virtual void	setDrawStyle (DlDrawStyle style)=0

virtual void	setColor (DlColor color)=0

virtual void	setStrokeWidth (float width)=0

virtual void	setStrokeMiter (float limit)=0

virtual void	setStrokeCap (DlStrokeCap cap)=0

virtual void	setStrokeJoin (DlStrokeJoin join)=0

virtual void	setColorSource (const DlColorSource *source)=0

virtual void	setColorFilter (const DlColorFilter *filter)=0

virtual void	setInvertColors (bool invert)=0

virtual void	setBlendMode (DlBlendMode mode)=0

virtual void	setMaskFilter (const DlMaskFilter *filter)=0

virtual void	setImageFilter (const DlImageFilter *filter)=0

virtual void	save ()=0

virtual void	save (uint32_t total_content_depth)

virtual void	saveLayer (const SkRect &bounds, const SaveLayerOptions options, const DlImageFilter *backdrop=nullptr)=0

virtual void	saveLayer (const SkRect &bounds, const SaveLayerOptions &options, uint32_t total_content_depth, DlBlendMode max_content_blend_mode, const DlImageFilter *backdrop=nullptr)

virtual void	restore ()=0

virtual void	saveLayer (const SkRect bounds, const SaveLayerOptions options, const DlImageFilter backdrop=nullptr) final

virtual void	translate (SkScalar tx, SkScalar ty)=0

virtual void	scale (SkScalar sx, SkScalar sy)=0

virtual void	rotate (SkScalar degrees)=0

virtual void	skew (SkScalar sx, SkScalar sy)=0

virtual void	transform2DAffine (SkScalar mxx, SkScalar mxy, SkScalar mxt, SkScalar myx, SkScalar myy, SkScalar myt)=0

virtual void	transformFullPerspective (SkScalar mxx, SkScalar mxy, SkScalar mxz, SkScalar mxt, SkScalar myx, SkScalar myy, SkScalar myz, SkScalar myt, SkScalar mzx, SkScalar mzy, SkScalar mzz, SkScalar mzt, SkScalar mwx, SkScalar mwy, SkScalar mwz, SkScalar mwt)=0

virtual void	transformReset ()=0

virtual void	clipRect (const SkRect &rect, ClipOp clip_op, bool is_aa)=0

virtual void	clipRRect (const SkRRect &rrect, ClipOp clip_op, bool is_aa)=0

virtual void	clipPath (const SkPath &path, ClipOp clip_op, bool is_aa)=0

virtual void	drawColor (DlColor color, DlBlendMode mode)=0

virtual void	drawPaint ()=0

virtual void	drawLine (const SkPoint &p0, const SkPoint &p1)=0

virtual void	drawDashedLine (const DlPoint &p0, const DlPoint &p1, DlScalar on_length, DlScalar off_length)=0

virtual void	drawRect (const SkRect &rect)=0

virtual void	drawOval (const SkRect &bounds)=0

virtual void	drawCircle (const SkPoint &center, SkScalar radius)=0

virtual void	drawRRect (const SkRRect &rrect)=0

virtual void	drawDRRect (const SkRRect &outer, const SkRRect &inner)=0

virtual void	drawPath (const SkPath &path)=0

virtual void	drawArc (const SkRect &oval_bounds, SkScalar start_degrees, SkScalar sweep_degrees, bool use_center)=0

virtual void	drawPoints (PointMode mode, uint32_t count, const SkPoint points[])=0

virtual void	drawVertices (const DlVertices *vertices, DlBlendMode mode)=0

virtual void	drawImage (const sk_sp< DlImage > image, const SkPoint point, DlImageSampling sampling, bool render_with_attributes)=0

virtual void	drawImageRect (const sk_sp< DlImage > image, const SkRect &src, const SkRect &dst, DlImageSampling sampling, bool render_with_attributes, SrcRectConstraint constraint=SrcRectConstraint::kFast)=0

virtual void	drawImageNine (const sk_sp< DlImage > image, const SkIRect &center, const SkRect &dst, DlFilterMode filter, bool render_with_attributes)=0

virtual void	drawAtlas (const sk_sp< DlImage > atlas, const SkRSXform xform[], const SkRect tex[], const DlColor colors[], int count, DlBlendMode mode, DlImageSampling sampling, const SkRect *cull_rect, bool render_with_attributes)=0

virtual void	drawDisplayList (const sk_sp< DisplayList > display_list, SkScalar opacity=SK_Scalar1)=0

virtual void	drawTextBlob (const sk_sp< SkTextBlob > blob, SkScalar x, SkScalar y)=0

virtual void	drawTextFrame (const std::shared_ptr< impeller::TextFrame > &text_frame, SkScalar x, SkScalar y)=0

virtual void	drawShadow (const SkPath &path, const DlColor color, const SkScalar elevation, bool transparent_occluder, SkScalar dpr)=0

Additional Inherited Members
Static Public Attributes inherited from flutter::DlOpReceiver
static constexpr int	kMaxDrawPointsCount = ((1 << 29) - 1)

Protected Types inherited from flutter::DlOpReceiver
using	ClipOp = DlCanvas::ClipOp

using	PointMode = DlCanvas::PointMode

using	SrcRectConstraint = DlCanvas::SrcRectConstraint

Detailed Description

Definition at line 23 of file dl_dispatcher.h.

Member Function Documentation

◆ clipPath() [1/2]

void impeller::DlDispatcherBase::clipPath	(	const CacheablePath &	cache,
		ClipOp	clip_op,
		bool	is_aa
	)

overridevirtual

Reimplemented from flutter::DlOpReceiver.

Definition at line 757 of file dl_dispatcher.cc.

                                            {
  auto clip_op = ToClipOperation(sk_op);
 
  SkRect rect;
  if (cache.sk_path.isRect(&rect)) {
    GetCanvas().ClipRect(skia_conversions::ToRect(rect), clip_op);
  } else if (cache.sk_path.isOval(&rect)) {
    GetCanvas().ClipOval(skia_conversions::ToRect(rect), clip_op);
  } else {
    SkRRect rrect;
    if (cache.sk_path.isRRect(&rrect) && rrect.isSimple()) {
      GetCanvas().ClipRRect(skia_conversions::ToRect(rrect.rect()),
                            skia_conversions::ToSize(rrect.getSimpleRadii()),
                            clip_op);
    } else {
      GetCanvas().ClipPath(GetOrCachePath(cache), clip_op);
    }
  }
}

◆ clipPath() [2/2]

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

overridevirtual

Implements flutter::DlOpReceiver.

Definition at line 745 of file dl_dispatcher.cc.

                                                                            {
  UNIMPLEMENTED;
}

◆ clipRect()

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

overridevirtual

Implements flutter::DlOpReceiver.

Definition at line 719 of file dl_dispatcher.cc.

                                            {
  GetCanvas().ClipRect(skia_conversions::ToRect(rect),
                       ToClipOperation(clip_op));
}

◆ clipRRect()

void impeller::DlDispatcherBase::clipRRect	(	const SkRRect &	rrect,
		ClipOp	clip_op,
		bool	is_aa
	)

overridevirtual

Implements flutter::DlOpReceiver.

Definition at line 727 of file dl_dispatcher.cc.

                                             {
  auto clip_op = ToClipOperation(sk_op);
  if (rrect.isRect()) {
    GetCanvas().ClipRect(skia_conversions::ToRect(rrect.rect()), clip_op);
  } else if (rrect.isOval()) {
    GetCanvas().ClipOval(skia_conversions::ToRect(rrect.rect()), clip_op);
  } else if (rrect.isSimple()) {
    GetCanvas().ClipRRect(skia_conversions::ToRect(rrect.rect()),
                          skia_conversions::ToSize(rrect.getSimpleRadii()),
                          clip_op);
  } else {
    GetCanvas().ClipPath(skia_conversions::ToPath(rrect), clip_op);
  }
}

◆ drawArc()

void impeller::DlDispatcherBase::drawArc	(	const SkRect &	oval_bounds,
		SkScalar	start_degrees,
		SkScalar	sweep_degrees,
		bool	use_center
	)

overridevirtual

Implements flutter::DlOpReceiver.

Definition at line 911 of file dl_dispatcher.cc.

                                                {
  PathBuilder builder;
  builder.AddArc(skia_conversions::ToRect(oval_bounds), Degrees(start_degrees),
                 Degrees(sweep_degrees), use_center);
  GetCanvas().DrawPath(builder.TakePath(), paint_);
}

◆ drawAtlas()

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

overridevirtual

Implements flutter::DlOpReceiver.

Definition at line 1026 of file dl_dispatcher.cc.

                                                              {
  GetCanvas().DrawAtlas(std::make_shared<Image>(atlas->impeller_texture()),
                        skia_conversions::ToRSXForms(xform, count),
                        skia_conversions::ToRects(tex, count),
                        ToColors(colors, count), ToBlendMode(mode),
                        ToSamplerDescriptor(sampling),
                        skia_conversions::ToRect(cull_rect), paint_);
}

◆ drawCircle()

void impeller::DlDispatcherBase::drawCircle	(	const SkPoint &	center,
		SkScalar	radius
	)

overridevirtual

Implements flutter::DlOpReceiver.

Definition at line 849 of file dl_dispatcher.cc.

                                                                        {
  GetCanvas().DrawCircle(skia_conversions::ToPoint(center), radius, paint_);
}

◆ drawColor()

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

overridevirtual

Implements flutter::DlOpReceiver.

Definition at line 780 of file dl_dispatcher.cc.

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

◆ drawDashedLine()

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

overridevirtual

Implements flutter::DlOpReceiver.

Definition at line 799 of file dl_dispatcher.cc.

                                                           {
  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(flutter::ToSkPoint(p0), flutter::ToSkPoint(p1));
  }
}

◆ drawDisplayList()

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

overridevirtual

Implements flutter::DlOpReceiver.

Definition at line 1044 of file dl_dispatcher.cc.

                      {
  // 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 cull_bounds = GetCanvas().GetCurrentLocalCullingBounds();
    if (cull_bounds.has_value()) {
      Rect cull_rect = cull_bounds.value();
      display_list->Dispatch(
          *this, SkRect::MakeLTRB(cull_rect.GetLeft(), cull_rect.GetTop(),
                                  cull_rect.GetRight(), cull_rect.GetBottom()));
    } else {
      display_list->Dispatch(*this);
    }
  } else {
    display_list->Dispatch(*this);
  }
 
  // Restore all saved state back to what it was before we interpreted
  // the display_list
  GetCanvas().RestoreToCount(restore_count);
  initial_matrix_ = saved_initial_matrix;
  paint_ = saved_paint;
}

◆ drawDRRect()

void impeller::DlDispatcherBase::drawDRRect	(	const SkRRect &	outer,
		const SkRRect &	inner
	)

overridevirtual

Implements flutter::DlOpReceiver.

Definition at line 865 of file dl_dispatcher.cc.

                                                                            {
  PathBuilder builder;
  builder.AddPath(skia_conversions::ToPath(outer));
  builder.AddPath(skia_conversions::ToPath(inner));
  GetCanvas().DrawPath(builder.TakePath(FillType::kOdd), paint_);
}

◆ drawImage()

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

overridevirtual

Implements flutter::DlOpReceiver.

Definition at line 967 of file dl_dispatcher.cc.

                                                              {
  if (!image) {
    return;
  }
 
  auto texture = image->impeller_texture();
  if (!texture) {
    return;
  }
 
  const auto size = texture->GetSize();
  const auto src = SkRect::MakeWH(size.width, size.height);
  const auto dest =
      SkRect::MakeXYWH(point.fX, point.fY, 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
  );
}

◆ drawImageNine()

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

overridevirtual

Implements flutter::DlOpReceiver.

Definition at line 1012 of file dl_dispatcher.cc.

                                                                  {
  NinePatchConverter converter = {};
  converter.DrawNinePatch(
      std::make_shared<Image>(image->impeller_texture()),
      Rect::MakeLTRB(center.fLeft, center.fTop, center.fRight, center.fBottom),
      skia_conversions::ToRect(dst), ToSamplerDescriptor(filter), &GetCanvas(),
      &paint_);
}

◆ drawImageRect()

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

overridevirtual

Implements flutter::DlOpReceiver.

Definition at line 995 of file dl_dispatcher.cc.

                                                           {
  GetCanvas().DrawImageRect(
      std::make_shared<Image>(image->impeller_texture()),  // image
      skia_conversions::ToRect(src),                       // source rect
      skia_conversions::ToRect(dst),                       // destination rect
      render_with_attributes ? paint_ : Paint(),           // paint
      ToSamplerDescriptor(sampling)                        // sampling
  );
}

◆ drawLine()

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

overridevirtual

Implements flutter::DlOpReceiver.

Definition at line 794 of file dl_dispatcher.cc.

                                                                    {
  GetCanvas().DrawLine(skia_conversions::ToPoint(p0),
                       skia_conversions::ToPoint(p1), paint_);
}

◆ drawOval()

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

overridevirtual

Implements flutter::DlOpReceiver.

Definition at line 844 of file dl_dispatcher.cc.

                                                    {
  GetCanvas().DrawOval(skia_conversions::ToRect(bounds), paint_);
}

◆ drawPaint()

void impeller::DlDispatcherBase::drawPaint ( )

overridevirtual

Implements flutter::DlOpReceiver.

Definition at line 789 of file dl_dispatcher.cc.

                                 {
  GetCanvas().DrawPaint(paint_);
}

◆ drawPath() [1/2]

void impeller::DlDispatcherBase::drawPath ( const CacheablePath & cache )

overridevirtual

Reimplemented from flutter::DlOpReceiver.

Definition at line 878 of file dl_dispatcher.cc.

                                                          {
  SimplifyOrDrawPath(GetCanvas(), cache, paint_);
}

◆ drawPath() [2/2]

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

overridevirtual

Implements flutter::DlOpReceiver.

Definition at line 873 of file dl_dispatcher.cc.

                                                  {
  UNIMPLEMENTED;
}

◆ drawPoints()

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

overridevirtual

Implements flutter::DlOpReceiver.

Definition at line 922 of file dl_dispatcher.cc.

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

◆ drawRect()

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

overridevirtual

Implements flutter::DlOpReceiver.

Definition at line 839 of file dl_dispatcher.cc.

                                                  {
  GetCanvas().DrawRect(skia_conversions::ToRect(rect), paint_);
}

◆ drawRRect()

void impeller::DlDispatcherBase::drawRRect ( const SkRRect & rrect )

overridevirtual

Implements flutter::DlOpReceiver.

Definition at line 854 of file dl_dispatcher.cc.

                                                     {
  if (skia_conversions::IsNearlySimpleRRect(rrect)) {
    GetCanvas().DrawRRect(skia_conversions::ToRect(rrect.rect()),
                          skia_conversions::ToSize(rrect.getSimpleRadii()),
                          paint_);
  } else {
    GetCanvas().DrawPath(skia_conversions::ToPath(rrect), paint_);
  }
}

◆ drawShadow() [1/2]

void impeller::DlDispatcherBase::drawShadow	(	const CacheablePath &	cache,
		const flutter::DlColor	color,
		const SkScalar	elevation,
		bool	transparent_occluder,
		SkScalar	dpr
	)

overridevirtual

Reimplemented from flutter::DlOpReceiver.

Definition at line 1134 of file dl_dispatcher.cc.

                                                {
  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(), cache, paint);
 
  GetCanvas().Restore();
}

◆ drawShadow() [2/2]

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

overridevirtual

Implements flutter::DlOpReceiver.

Definition at line 1125 of file dl_dispatcher.cc.

                                                {
  UNIMPLEMENTED;
}

◆ drawTextBlob()

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

overridevirtual

Implements flutter::DlOpReceiver.

Definition at line 1106 of file dl_dispatcher.cc.

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

◆ drawTextFrame()

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

override

Definition at line 1114 of file dl_dispatcher.cc.

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

◆ drawVertices()

void impeller::DlDispatcherBase::drawVertices	(	const flutter::DlVertices *	vertices,
		flutter::DlBlendMode	dl_mode
	)

overridevirtual

Implements flutter::DlOpReceiver.

Definition at line 960 of file dl_dispatcher.cc.

                                                                {
  GetCanvas().DrawVertices(MakeVertices(vertices), ToBlendMode(dl_mode),
                           paint_);
}

◆ EndRecordingAsPicture()

Picture impeller::DlDispatcherBase::EndRecordingAsPicture ( )

Definition at line 1192 of file dl_dispatcher.cc.

                                                {
  TRACE_EVENT0("impeller", "DisplayListDispatcher::EndRecordingAsPicture");
  return GetCanvas().EndRecordingAsPicture();
}

◆ GetCanvas()

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

pure virtual

◆ PrefersImpellerPaths()

bool impeller::DlDispatcherBase::PrefersImpellerPaths ( ) const

inlineoverridevirtual

Reimplemented from flutter::DlOpReceiver.

Definition at line 28 of file dl_dispatcher.h.

28{ return true; }

◆ restore()

void impeller::DlDispatcherBase::restore ( )

overridevirtual

Implements flutter::DlOpReceiver.

Definition at line 631 of file dl_dispatcher.cc.

                               {
  GetCanvas().Restore();
}

◆ rotate()

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

overridevirtual

Implements flutter::DlOpReceiver.

Definition at line 646 of file dl_dispatcher.cc.

                                              {
  GetCanvas().Rotate(Degrees{degrees});
}

◆ save()

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

overridevirtual

Reimplemented from flutter::DlOpReceiver.

Reimplemented in impeller::DlDispatcher, and impeller::ExperimentalDlDispatcher.

Definition at line 611 of file dl_dispatcher.cc.

                                                        {
  GetCanvas().Save(total_content_depth);
}

◆ saveLayer()

void impeller::DlDispatcherBase::saveLayer	(	const SkRect &	bounds,
		const flutter::SaveLayerOptions &	options,
		uint32_t	total_content_depth,
		flutter::DlBlendMode	max_content_mode,
		const flutter::DlImageFilter *	backdrop
	)

overridevirtual

Reimplemented from flutter::DlOpReceiver.

Reimplemented in impeller::DlDispatcher, and impeller::ExperimentalDlDispatcher.

Definition at line 616 of file dl_dispatcher.cc.

                                                                       {
  auto paint = options.renders_with_attributes() ? paint_ : Paint{};
  auto promise = options.content_is_clipped()
                     ? ContentBoundsPromise::kMayClipContents
                     : ContentBoundsPromise::kContainsContents;
  GetCanvas().SaveLayer(paint, skia_conversions::ToRect(bounds),
                        ToImageFilter(backdrop), promise, total_content_depth,
                        options.can_distribute_opacity());
}

◆ scale()

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

overridevirtual

Implements flutter::DlOpReceiver.

Definition at line 641 of file dl_dispatcher.cc.

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

◆ setAntiAlias()

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

overridevirtual

Implements flutter::DlOpReceiver.

Definition at line 173 of file dl_dispatcher.cc.

                                           {
  // Nothing to do because AA is implicit.
}

◆ setBlendMode()

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

overridevirtual

Implements flutter::DlOpReceiver.

Definition at line 477 of file dl_dispatcher.cc.

                                                              {
  paint_.blend_mode = ToBlendMode(dl_mode);
}

◆ setColor()

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

overridevirtual

Implements flutter::DlOpReceiver.

Definition at line 196 of file dl_dispatcher.cc.

                                                    {
  paint_.color = {
      color.getRedF(),
      color.getGreenF(),
      color.getBlueF(),
      color.getAlphaF(),
  };
}

◆ setColorFilter()

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

overridevirtual

Implements flutter::DlOpReceiver.

Definition at line 467 of file dl_dispatcher.cc.

                                                                        {
  paint_.color_filter = ToColorFilter(filter);
}

◆ setColorSource()

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

overridevirtual

Implements flutter::DlOpReceiver.

Definition at line 281 of file dl_dispatcher.cc.

                                                                        {
  if (!source) {
    paint_.color_source = ColorSource::MakeColor();
    return;
  }
 
  std::optional<ColorSource::Type> type = ToColorSourceType(source->type());
 
  if (!type.has_value()) {
    FML_LOG(ERROR) << "Requested ColorSourceType::kUnknown";
    paint_.color_source = ColorSource::MakeColor();
    return;
  }
 
  switch (type.value()) {
    case ColorSource::Type::kColor: {
      const flutter::DlColorColorSource* color = source->asColor();
 
      paint_.color_source = ColorSource::MakeColor();
      setColor(color->color());
      FML_DCHECK(color);
      return;
    }
    case ColorSource::Type::kLinearGradient: {
      const flutter::DlLinearGradientColorSource* linear =
          source->asLinearGradient();
      FML_DCHECK(linear);
      auto start_point = skia_conversions::ToPoint(linear->start_point());
      auto end_point = skia_conversions::ToPoint(linear->end_point());
      std::vector<Color> colors;
      std::vector<float> stops;
      skia_conversions::ConvertStops(linear, colors, stops);
 
      auto tile_mode = ToTileMode(linear->tile_mode());
      auto matrix = ToMatrix(linear->matrix());
 
      paint_.color_source = ColorSource::MakeLinearGradient(
          start_point, end_point, std::move(colors), std::move(stops),
          tile_mode, matrix);
      return;
    }
    case ColorSource::Type::kConicalGradient: {
      const flutter::DlConicalGradientColorSource* conical_gradient =
          source->asConicalGradient();
      FML_DCHECK(conical_gradient);
      Point center = skia_conversions::ToPoint(conical_gradient->end_center());
      SkScalar radius = conical_gradient->end_radius();
      Point focus_center =
          skia_conversions::ToPoint(conical_gradient->start_center());
      SkScalar focus_radius = conical_gradient->start_radius();
      std::vector<Color> colors;
      std::vector<float> stops;
      skia_conversions::ConvertStops(conical_gradient, colors, stops);
 
      auto tile_mode = ToTileMode(conical_gradient->tile_mode());
      auto matrix = ToMatrix(conical_gradient->matrix());
 
      paint_.color_source = ColorSource::MakeConicalGradient(
          center, radius, std::move(colors), std::move(stops), focus_center,
          focus_radius, tile_mode, matrix);
      return;
    }
    case ColorSource::Type::kRadialGradient: {
      const flutter::DlRadialGradientColorSource* radialGradient =
          source->asRadialGradient();
      FML_DCHECK(radialGradient);
      auto center = skia_conversions::ToPoint(radialGradient->center());
      auto radius = radialGradient->radius();
      std::vector<Color> colors;
      std::vector<float> stops;
      skia_conversions::ConvertStops(radialGradient, colors, stops);
 
      auto tile_mode = ToTileMode(radialGradient->tile_mode());
      auto matrix = ToMatrix(radialGradient->matrix());
      paint_.color_source =
          ColorSource::MakeRadialGradient(center, radius, std::move(colors),
                                          std::move(stops), tile_mode, matrix);
      return;
    }
    case ColorSource::Type::kSweepGradient: {
      const flutter::DlSweepGradientColorSource* sweepGradient =
          source->asSweepGradient();
      FML_DCHECK(sweepGradient);
 
      auto center = skia_conversions::ToPoint(sweepGradient->center());
      auto start_angle = Degrees(sweepGradient->start());
      auto end_angle = Degrees(sweepGradient->end());
      std::vector<Color> colors;
      std::vector<float> stops;
      skia_conversions::ConvertStops(sweepGradient, colors, stops);
 
      auto tile_mode = ToTileMode(sweepGradient->tile_mode());
      auto matrix = ToMatrix(sweepGradient->matrix());
      paint_.color_source = ColorSource::MakeSweepGradient(
          center, start_angle, end_angle, std::move(colors), std::move(stops),
          tile_mode, matrix);
      return;
    }
    case ColorSource::Type::kImage: {
      const flutter::DlImageColorSource* image_color_source = source->asImage();
      FML_DCHECK(image_color_source &&
                 image_color_source->image()->impeller_texture());
      auto texture = image_color_source->image()->impeller_texture();
      auto x_tile_mode = ToTileMode(image_color_source->horizontal_tile_mode());
      auto y_tile_mode = ToTileMode(image_color_source->vertical_tile_mode());
      auto desc = ToSamplerDescriptor(image_color_source->sampling());
      auto matrix = ToMatrix(image_color_source->matrix());
      paint_.color_source = ColorSource::MakeImage(texture, x_tile_mode,
                                                   y_tile_mode, desc, matrix);
      return;
    }
    case ColorSource::Type::kRuntimeEffect: {
      const flutter::DlRuntimeEffectColorSource* runtime_effect_color_source =
          source->asRuntimeEffect();
      auto runtime_stage =
          runtime_effect_color_source->runtime_effect()->runtime_stage();
      auto uniform_data = runtime_effect_color_source->uniform_data();
      auto samplers = runtime_effect_color_source->samplers();
 
      std::vector<RuntimeEffectContents::TextureInput> texture_inputs;
 
      for (auto& sampler : samplers) {
        if (sampler == nullptr) {
          return;
        }
        auto* image = sampler->asImage();
        if (!sampler->asImage()) {
          UNIMPLEMENTED;
          return;
        }
        FML_DCHECK(image->image()->impeller_texture());
        texture_inputs.push_back({
            .sampler_descriptor = ToSamplerDescriptor(image->sampling()),
            .texture = image->image()->impeller_texture(),
        });
      }
 
      paint_.color_source = ColorSource::MakeRuntimeEffect(
          runtime_stage, uniform_data, texture_inputs);
      return;
    }
    case ColorSource::Type::kScene: {
#ifdef IMPELLER_ENABLE_3D
      const flutter::DlSceneColorSource* scene_color_source = source->asScene();
      std::shared_ptr<scene::Node> scene_node =
          scene_color_source->scene_node();
      Matrix camera_transform = scene_color_source->camera_matrix();
 
      paint_.color_source =
          ColorSource::MakeScene(scene_node, camera_transform);
#else   // IMPELLER_ENABLE_3D
      FML_LOG(ERROR) << "ColorSourceType::kScene can only be used if Impeller "
                        "Scene is enabled.";
#endif  // IMPELLER_ENABLE_3D
      return;
    }
  }
}

◆ setDrawStyle()

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

overridevirtual

Implements flutter::DlOpReceiver.

Definition at line 191 of file dl_dispatcher.cc.

                                                            {
  paint_.style = ToStyle(style);
}

◆ setImageFilter()

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

overridevirtual

Implements flutter::DlOpReceiver.

Definition at line 606 of file dl_dispatcher.cc.

                                                                        {
  paint_.image_filter = ToImageFilter(filter);
}

◆ setInvertColors()

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

overridevirtual

Implements flutter::DlOpReceiver.

Definition at line 472 of file dl_dispatcher.cc.

                                                  {
  paint_.invert_colors = invert;
}

◆ setMaskFilter()

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

overridevirtual

Implements flutter::DlOpReceiver.

Definition at line 495 of file dl_dispatcher.cc.

                                                                      {
  // 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;
    }
  }
}

◆ setStrokeCap()

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

overridevirtual

Implements flutter::DlOpReceiver.

Definition at line 216 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;
  }
}

◆ setStrokeJoin()

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

overridevirtual

Implements flutter::DlOpReceiver.

Definition at line 231 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;
  }
}

◆ setStrokeMiter()

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

overridevirtual

Implements flutter::DlOpReceiver.

Definition at line 211 of file dl_dispatcher.cc.

                                                    {
  paint_.stroke_miter = limit;
}

◆ setStrokeWidth()

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

overridevirtual

Implements flutter::DlOpReceiver.

Definition at line 206 of file dl_dispatcher.cc.

                                                    {
  paint_.stroke_width = width;
}

◆ skew()

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

overridevirtual

Implements flutter::DlOpReceiver.

Definition at line 651 of file dl_dispatcher.cc.

                                                    {
  GetCanvas().Skew(sx, sy);
}

◆ transform2DAffine()

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

overridevirtual

Implements flutter::DlOpReceiver.

Definition at line 656 of file dl_dispatcher.cc.

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

◆ transformFullPerspective()

void impeller::DlDispatcherBase::transformFullPerspective	(	SkScalar	mxx,
		SkScalar	mxy,
		SkScalar	mxz,
		SkScalar	mxt,
		SkScalar	myx,
		SkScalar	myy,
		SkScalar	myz,
		SkScalar	myt,
		SkScalar	mzx,
		SkScalar	mzy,
		SkScalar	mzz,
		SkScalar	mzt,
		SkScalar	mwx,
		SkScalar	mwy,
		SkScalar	mwz,
		SkScalar	mwt
	)

overridevirtual

Implements flutter::DlOpReceiver.

Definition at line 673 of file dl_dispatcher.cc.

                                                              {
  // 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);
}

◆ transformReset()

void impeller::DlDispatcherBase::transformReset ( )

overridevirtual

Implements flutter::DlOpReceiver.

Definition at line 703 of file dl_dispatcher.cc.

                                      {
  GetCanvas().ResetTransform();
  GetCanvas().Transform(initial_matrix_);
}

◆ translate()

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

overridevirtual

Implements flutter::DlOpReceiver.

Definition at line 636 of file dl_dispatcher.cc.

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

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

Additional Inherited Members

Detailed Description

Member Function Documentation

◆ clipPath() [1/2]

◆ clipPath() [2/2]

◆ clipRect()

◆ clipRRect()

◆ drawArc()

◆ drawAtlas()

◆ drawCircle()

◆ drawColor()

◆ drawDashedLine()

◆ drawDisplayList()

◆ drawDRRect()

◆ drawImage()

◆ drawImageNine()

◆ drawImageRect()

◆ drawLine()

◆ drawOval()

◆ drawPaint()

◆ drawPath() [1/2]

◆ drawPath() [2/2]

◆ drawPoints()

◆ drawRect()

◆ drawRRect()

◆ drawShadow() [1/2]

◆ drawShadow() [2/2]

◆ drawTextBlob()

◆ drawTextFrame()

◆ drawVertices()

◆ EndRecordingAsPicture()

◆ GetCanvas()

◆ PrefersImpellerPaths()

◆ restore()

◆ rotate()

◆ save()

◆ saveLayer()

◆ scale()

◆ setAntiAlias()

◆ setBlendMode()

◆ setColor()

◆ setColorFilter()

◆ setColorSource()

◆ setDrawStyle()

◆ setImageFilter()

◆ setInvertColors()

◆ setMaskFilter()

◆ setStrokeCap()

◆ setStrokeJoin()

◆ setStrokeMiter()

◆ setStrokeWidth()

◆ skew()

◆ transform2DAffine()

◆ transformFullPerspective()

◆ transformReset()

◆ translate()