#include <dl_builder.h>

Inheritance diagram for flutter::DisplayListBuilder:

Public Member Functions
	DisplayListBuilder (bool prepare_rtree)

	DisplayListBuilder (const DlRect &cull_rect=kMaxCullRect, bool prepare_rtree=false)

	DisplayListBuilder (DlScalar width, DlScalar height)

	~DisplayListBuilder ()

DlISize	GetBaseLayerDimensions () const override

SkImageInfo	GetImageInfo () const override

size_t	GetRecordCount () const
	Return the number of records currently recorded in the builder.

bool	IsEmpty () const
	Return true if the builder has not yet recorded any commands.

void	Save () override

void	SaveLayer (const std::optional< DlRect > &bounds, const DlPaint paint=nullptr, const DlImageFilter backdrop=nullptr, std::optional< int64_t > backdrop_id=std::nullopt) override

void	Restore () override

int	GetSaveCount () const override

void	RestoreToCount (int restore_count) 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	Transform (const DlMatrix &matrix) override

void	SetTransform (const DlMatrix &matrix) override

DlMatrix	GetMatrix () const override

void	ClipRect (const DlRect &rect, DlClipOp clip_op=DlClipOp::kIntersect, bool is_aa=false) override

void	ClipOval (const DlRect &bounds, DlClipOp clip_op=DlClipOp::kIntersect, bool is_aa=false) override

void	ClipRoundRect (const DlRoundRect &rrect, DlClipOp clip_op=DlClipOp::kIntersect, bool is_aa=false) override

void	ClipRoundSuperellipse (const DlRoundSuperellipse &rse, DlClipOp clip_op=DlClipOp::kIntersect, bool is_aa=false) override

void	ClipPath (const DlPath &path, DlClipOp clip_op=DlClipOp::kIntersect, bool is_aa=false) override

DlRect	GetDestinationClipCoverage () const override

DlRect	GetLocalClipCoverage () const override

bool	QuickReject (const DlRect &bounds) const override

void	DrawPaint (const DlPaint &paint) override

void	DrawColor (DlColor color, DlBlendMode mode) override

void	DrawLine (const DlPoint &p0, const DlPoint &p1, const DlPaint &paint) override

void	DrawDashedLine (const DlPoint &p0, const DlPoint &p1, DlScalar on_length, DlScalar off_length, const DlPaint &paint) override

void	DrawRect (const DlRect &rect, const DlPaint &paint) override

void	DrawOval (const DlRect &bounds, const DlPaint &paint) override

void	DrawCircle (const DlPoint &center, DlScalar radius, const DlPaint &paint) override

void	DrawRoundRect (const DlRoundRect &rrect, const DlPaint &paint) override

void	DrawDiffRoundRect (const DlRoundRect &outer, const DlRoundRect &inner, const DlPaint &paint) override

void	DrawRoundSuperellipse (const DlRoundSuperellipse &rse, const DlPaint &paint) override

void	DrawPath (const DlPath &path, const DlPaint &paint) override

void	DrawArc (const DlRect &bounds, DlScalar start, DlScalar sweep, bool useCenter, const DlPaint &paint) override

void	DrawPoints (DlPointMode mode, uint32_t count, const DlPoint pts[], const DlPaint &paint) override

void	DrawVertices (const std::shared_ptr< DlVertices > &vertices, DlBlendMode mode, const DlPaint &paint) override

void	DrawImage (const sk_sp< DlImage > &image, const DlPoint &point, DlImageSampling sampling, const DlPaint *paint=nullptr) override

void	DrawImageRect (const sk_sp< DlImage > &image, const DlRect &src, const DlRect &dst, DlImageSampling sampling, const DlPaint *paint=nullptr, DlSrcRectConstraint constraint=DlSrcRectConstraint::kFast) override

void	DrawImageNine (const sk_sp< DlImage > &image, const DlIRect &center, const DlRect &dst, DlFilterMode filter, const DlPaint *paint=nullptr) override

void	DrawAtlas (const sk_sp< DlImage > &atlas, const DlRSTransform xform[], const DlRect tex[], const DlColor colors[], int count, DlBlendMode mode, DlImageSampling sampling, const DlRect cullRect, const DlPaint paint=nullptr) override

void	DrawDisplayList (const sk_sp< DisplayList > display_list, DlScalar opacity=SK_Scalar1) override

void	DrawText (const std::shared_ptr< DlText > &text, DlScalar x, DlScalar y, const DlPaint &paint) override

void	DrawShadow (const DlPath &path, const DlColor color, const DlScalar elevation, bool transparent_occluder, DlScalar dpr) override
	Draws the shadow of the given \|path\| rendered in the provided \|color\| (which is only consulted for its opacity) as would be produced by a directional light source uniformly shining in the device space direction {0, -1, 1} against a backdrop which is \|elevation * dpr\| device coordinates below the \|path\| in the Z direction.

void	Flush () override

sk_sp< DisplayList >	Build ()

virtual void	DrawImageRect (const sk_sp< DlImage > &image, const DlRect &src, const DlRect &dst, DlImageSampling sampling, const DlPaint *paint=nullptr, DlSrcRectConstraint constraint=DlSrcRectConstraint::kFast)=0

virtual void	DrawImageRect (const sk_sp< DlImage > &image, const DlIRect &src, const DlRect &dst, DlImageSampling sampling, const DlPaint *paint=nullptr, DlSrcRectConstraint constraint=DlSrcRectConstraint::kFast)

void	DrawImageRect (const sk_sp< DlImage > &image, const DlRect &dst, DlImageSampling sampling, const DlPaint *paint=nullptr, DlSrcRectConstraint constraint=DlSrcRectConstraint::kFast)

Public Member Functions inherited from flutter::DlCanvas
virtual	~DlCanvas ()=default

void	Clear (DlColor color)

void	DrawImageRect (const sk_sp< DlImage > &image, const DlRect &dst, DlImageSampling sampling, const DlPaint *paint=nullptr, DlSrcRectConstraint constraint=DlSrcRectConstraint::kFast)

Static Public Attributes
static constexpr DlRect	kMaxCullRect

Static Public Attributes inherited from flutter::DlCanvas
static constexpr DlScalar	kShadowLightHeight = 600

static constexpr DlScalar	kShadowLightRadius = 800

Friends
DlOpReceiver &	DisplayListBuilderBenchmarkAccessor (DisplayListBuilder &builder)

DlOpReceiver &	DisplayListBuilderTestingAccessor (DisplayListBuilder &builder)

DlPaint	DisplayListBuilderTestingAttributes (DisplayListBuilder &builder)

int	DisplayListBuilderTestingLastOpIndex (DisplayListBuilder &builder)

Additional Inherited Members
Static Public Member Functions inherited from flutter::DlCanvas
static DlRect	ComputeShadowBounds (const DlPath &path, float elevation, DlScalar dpr, const DlMatrix &ctm)
	Compute the local coverage for a \|DrawShadow\| operation using the given parameters (excluding the color and the transparent occluder parameters which do not affect the bounds).

Detailed Description

Definition at line 27 of file dl_builder.h.

Constructor & Destructor Documentation

◆ DisplayListBuilder() [1/3]

flutter::DisplayListBuilder::DisplayListBuilder ( bool prepare_rtree )

inlineexplicit

Definition at line 35 of file dl_builder.h.

36 : DisplayListBuilder(kMaxCullRect, prepare_rtree) {}

flutter::DisplayListBuilder::kMaxCullRect

static constexpr DlRect kMaxCullRect

Definition dl_builder.h:32

flutter::DisplayListBuilder::DisplayListBuilder

DisplayListBuilder(bool prepare_rtree)

Definition dl_builder.h:35

◆ DisplayListBuilder() [2/3]

flutter::DisplayListBuilder::DisplayListBuilder	(	const DlRect &	cull_rect = `kMaxCullRect`,
		bool	prepare_rtree = `false`
	)

explicit

Definition at line 224 of file dl_builder.cc.

    : original_cull_rect_(ProtectEmpty(cull_rect)) {
  Init(prepare_rtree);
}

◆ DisplayListBuilder() [3/3]

flutter::DisplayListBuilder::DisplayListBuilder	(	DlScalar	width,
		DlScalar	height
	)

inline

Definition at line 41 of file dl_builder.h.

42 : DisplayListBuilder(DlRect::MakeWH(width, height)) {}

height

int32_t height

Definition serialization_callbacks.cc:1

width

int32_t width

Definition serialization_callbacks.cc:0

impeller::TRect< Scalar >::MakeWH

static constexpr TRect MakeWH(Type width, Type height)

Definition rect.h:140

◆ ~DisplayListBuilder()

flutter::DisplayListBuilder::~DisplayListBuilder ( )

Definition at line 241 of file dl_builder.cc.

                                        {
  DisplayList::DisposeOps(storage_, offsets_);
}

Member Function Documentation

◆ Build()

sk_sp< DisplayList > flutter::DisplayListBuilder::Build ( )

Definition at line 161 of file dl_builder.cc.

                                             {
  while (save_stack_.size() > 1) {
    restore();
  }
 
  int count = render_op_count_;
  size_t nested_bytes = nested_bytes_;
  int nested_count = nested_op_count_;
  uint32_t total_depth = depth_;
  bool opacity_compatible = current_layer().is_group_opacity_compatible();
  bool is_safe = is_ui_thread_safe_;
  bool affects_transparency = current_layer().affects_transparent_layer;
  bool root_has_backdrop_filter = current_layer().contains_backdrop_filter;
  bool root_is_unbounded = current_layer().is_unbounded;
  DlBlendMode max_root_blend_mode = current_layer().max_blend_mode;
 
  sk_sp<DlRTree> rtree;
  DlRect bounds;
  if (rtree_data_.has_value()) {
    auto& rects = rtree_data_->rects;
    auto& indices = rtree_data_->indices;
    rtree = sk_make_sp<DlRTree>(rects.data(), rects.size(), indices.data(),
                                [](int id) { return id >= 0; });
    // RTree bounds may be tighter due to applying filter bounds
    // adjustments to each op as we restore layers rather than to
    // the entire layer bounds.
    bounds = rtree->bounds();
    rtree_data_.reset();
  } else {
    bounds = current_layer().global_space_accumulator.GetBounds();
  }
 
  render_op_count_ = op_index_ = 0;
  nested_bytes_ = nested_op_count_ = 0;
  depth_ = 0;
  is_ui_thread_safe_ = true;
  current_opacity_compatibility_ = true;
  render_op_depth_cost_ = 1u;
  current_ = DlPaint();
 
  save_stack_.pop_back();
  Init(rtree != nullptr);
 
  storage_.trim();
  DisplayListStorage storage;
  std::vector<size_t> offsets;
  std::swap(offsets, offsets_);
  std::swap(storage, storage_);
 
  return sk_sp<DisplayList>(new DisplayList(
      std::move(storage), std::move(offsets), count, nested_bytes, nested_count,
      total_depth, bounds, opacity_compatible, is_safe, affects_transparency,
      max_root_blend_mode, root_has_backdrop_filter, root_is_unbounded,
      std::move(rtree)));
}

References flutter::DisplayListStorage::trim().

◆ ClipOval()

void flutter::DisplayListBuilder::ClipOval	(	const DlRect &	bounds,
		DlClipOp	clip_op = `DlClipOp::kIntersect`,
		bool	is_aa = `false`
	)

overridevirtual

Implements flutter::DlCanvas.

Definition at line 1064 of file dl_builder.cc.

                                              {
  if (!bounds.IsFinite()) {
    return;
  }
  if (current_info().is_nop) {
    return;
  }
  if (current_info().has_valid_clip && clip_op == DlClipOp::kIntersect &&
      layer_local_state().oval_covers_cull(bounds)) {
    return;
  }
  global_state().clipOval(bounds, clip_op, is_aa);
  layer_local_state().clipOval(bounds, clip_op, is_aa);
  if (global_state().is_cull_rect_empty() ||
      layer_local_state().is_cull_rect_empty()) {
    current_info().is_nop = true;
    return;
  }
  current_info().has_valid_clip = true;
  checkForDeferredSave();
  switch (clip_op) {
    case DlClipOp::kIntersect:
      Push<ClipIntersectOvalOp>(0, bounds, is_aa);
      break;
    case DlClipOp::kDifference:
      Push<ClipDifferenceOvalOp>(0, bounds, is_aa);
      break;
  }
}

References flutter::DisplayListMatrixClipState::clipOval(), impeller::TRect< T >::IsFinite(), flutter::kDifference, and flutter::kIntersect.

Referenced by impeller::interop::DisplayListBuilder::ClipOval(), ClipPath(), ClipRoundRect(), ClipRoundSuperellipse(), flutter::testing::TEST_F(), flutter::testing::TEST_F(), flutter::testing::TEST_F(), flutter::testing::TEST_F(), flutter::testing::TEST_F(), impeller::testing::TEST_P(), and impeller::testing::TEST_P().

◆ ClipPath()

void flutter::DisplayListBuilder::ClipPath	(	const DlPath &	path,
		DlClipOp	clip_op = `DlClipOp::kIntersect`,
		bool	is_aa = `false`
	)

overridevirtual

Implements flutter::DlCanvas.

Definition at line 1167 of file dl_builder.cc.

                                              {
  if (current_info().is_nop) {
    return;
  }
  {
    DlRect rect;
    if (path.IsRect(&rect)) {
      ClipRect(rect, clip_op, is_aa);
      return;
    }
    if (path.IsOval(&rect)) {
      ClipOval(rect, clip_op, is_aa);
      return;
    }
    DlRoundRect rrect;
    if (path.IsRoundRect(&rrect)) {
      ClipRoundRect(rrect, clip_op, is_aa);
      return;
    }
  }
  global_state().clipPath(path, clip_op, is_aa);
  layer_local_state().clipPath(path, clip_op, is_aa);
  if (global_state().is_cull_rect_empty() ||
      layer_local_state().is_cull_rect_empty()) {
    current_info().is_nop = true;
    return;
  }
  current_info().has_valid_clip = true;
  checkForDeferredSave();
  switch (clip_op) {
    case DlClipOp::kIntersect:
      Push<ClipIntersectPathOp>(0, path, is_aa);
      break;
    case DlClipOp::kDifference:
      Push<ClipDifferencePathOp>(0, path, is_aa);
      break;
  }
}

References ClipOval(), flutter::DisplayListMatrixClipState::clipPath(), ClipRect(), ClipRoundRect(), flutter::kDifference, flutter::kIntersect, and flutter::path.

◆ ClipRect()

void flutter::DisplayListBuilder::ClipRect	(	const DlRect &	rect,
		DlClipOp	clip_op = `DlClipOp::kIntersect`,
		bool	is_aa = `false`
	)

overridevirtual

Implements flutter::DlCanvas.

Definition at line 1033 of file dl_builder.cc.

                                              {
  if (!rect.IsFinite()) {
    return;
  }
  if (current_info().is_nop) {
    return;
  }
  if (current_info().has_valid_clip && clip_op == DlClipOp::kIntersect &&
      layer_local_state().rect_covers_cull(rect)) {
    return;
  }
  global_state().clipRect(rect, clip_op, is_aa);
  layer_local_state().clipRect(rect, clip_op, is_aa);
  if (global_state().is_cull_rect_empty() ||
      layer_local_state().is_cull_rect_empty()) {
    current_info().is_nop = true;
    return;
  }
  current_info().has_valid_clip = true;
  checkForDeferredSave();
  switch (clip_op) {
    case DlClipOp::kIntersect:
      Push<ClipIntersectRectOp>(0, rect, is_aa);
      break;
    case DlClipOp::kDifference:
      Push<ClipDifferenceRectOp>(0, rect, is_aa);
      break;
  }
}

References flutter::DisplayListMatrixClipState::clipRect(), impeller::TRect< T >::IsFinite(), flutter::kDifference, and flutter::kIntersect.

◆ ClipRoundRect()

void flutter::DisplayListBuilder::ClipRoundRect	(	const DlRoundRect &	rrect,
		DlClipOp	clip_op = `DlClipOp::kIntersect`,
		bool	is_aa = `false`
	)

overridevirtual

Implements flutter::DlCanvas.

Definition at line 1095 of file dl_builder.cc.

                                                   {
  if (rrect.IsRect()) {
    ClipRect(rrect.GetBounds(), clip_op, is_aa);
    return;
  }
  if (rrect.IsOval()) {
    ClipOval(rrect.GetBounds(), clip_op, is_aa);
    return;
  }
  if (current_info().is_nop) {
    return;
  }
  if (current_info().has_valid_clip && clip_op == DlClipOp::kIntersect &&
      layer_local_state().rrect_covers_cull(rrect)) {
    return;
  }
  global_state().clipRRect(rrect, clip_op, is_aa);
  layer_local_state().clipRRect(rrect, clip_op, is_aa);
  if (global_state().is_cull_rect_empty() ||
      layer_local_state().is_cull_rect_empty()) {
    current_info().is_nop = true;
    return;
  }
  current_info().has_valid_clip = true;
  checkForDeferredSave();
  switch (clip_op) {
    case DlClipOp::kIntersect:
      Push<ClipIntersectRoundRectOp>(0, rrect, is_aa);
      break;
    case DlClipOp::kDifference:
      Push<ClipDifferenceRoundRectOp>(0, rrect, is_aa);
      break;
  }
}

References ClipOval(), ClipRect(), flutter::DisplayListMatrixClipState::clipRRect(), impeller::RoundRect::GetBounds(), impeller::RoundRect::IsOval(), impeller::RoundRect::IsRect(), flutter::kDifference, and flutter::kIntersect.

◆ ClipRoundSuperellipse()

void flutter::DisplayListBuilder::ClipRoundSuperellipse	(	const DlRoundSuperellipse &	rse,
		DlClipOp	clip_op = `DlClipOp::kIntersect`,
		bool	is_aa = `false`
	)

overridevirtual

Implements flutter::DlCanvas.

Definition at line 1131 of file dl_builder.cc.

                                                           {
  if (rse.IsRect()) {
    ClipRect(rse.GetBounds(), clip_op, is_aa);
    return;
  }
  if (rse.IsOval()) {
    ClipOval(rse.GetBounds(), clip_op, is_aa);
    return;
  }
  if (current_info().is_nop) {
    return;
  }
  if (current_info().has_valid_clip && clip_op == DlClipOp::kIntersect &&
      layer_local_state().rsuperellipse_covers_cull(rse)) {
    return;
  }
  global_state().clipRSuperellipse(rse, clip_op, is_aa);
  layer_local_state().clipRSuperellipse(rse, clip_op, is_aa);
  if (global_state().is_cull_rect_empty() ||
      layer_local_state().is_cull_rect_empty()) {
    current_info().is_nop = true;
    return;
  }
  current_info().has_valid_clip = true;
  checkForDeferredSave();
  switch (clip_op) {
    case DlClipOp::kIntersect:
      Push<ClipIntersectRoundSuperellipseOp>(0, rse, is_aa);
      break;
    case DlClipOp::kDifference:
      Push<ClipDifferenceRoundSuperellipseOp>(0, rse, is_aa);
      break;
  }
}

References ClipOval(), ClipRect(), flutter::DisplayListMatrixClipState::clipRSuperellipse(), impeller::RoundSuperellipse::GetBounds(), impeller::RoundSuperellipse::IsOval(), impeller::RoundSuperellipse::IsRect(), flutter::kDifference, and flutter::kIntersect.

◆ DrawArc()

void flutter::DisplayListBuilder::DrawArc	(	const DlRect &	bounds,
		DlScalar	start,
		DlScalar	sweep,
		bool	useCenter,
		const DlPaint &	paint
	)

overridevirtual

Implements flutter::DlCanvas.

Definition at line 1455 of file dl_builder.cc.

                                                       {
  SetAttributesFromPaint(
      paint, useCenter ? kDrawArcWithCenterFlags : kDrawArcNoCenterFlags);
  drawArc(bounds, start, sweep, useCenter);
}

References flutter::DisplayListOpFlags::kDrawArcNoCenterFlags, flutter::DisplayListOpFlags::kDrawArcWithCenterFlags, and start.

Referenced by flutter::testing::BM_DrawArc(), canvas_drawArc(), flutter::testing::TEST(), flutter::testing::TEST(), flutter::testing::TEST_F(), impeller::testing::TEST_P(), impeller::testing::TEST_P(), and impeller::testing::TEST_P().

◆ DrawAtlas()

void flutter::DisplayListBuilder::DrawAtlas	(	const sk_sp< DlImage > &	atlas,
		const DlRSTransform	xform[],
		const DlRect	tex[],
		const DlColor	colors[],
		int	count,
		DlBlendMode	mode,
		DlImageSampling	sampling,
		const DlRect *	cullRect,
		const DlPaint *	paint = `nullptr`
	)

overridevirtual

Implements flutter::DlCanvas.

Definition at line 1740 of file dl_builder.cc.

                                                         {
  if (paint != nullptr) {
    SetAttributesFromPaint(*paint,
                           DisplayListOpFlags::kDrawAtlasWithPaintFlags);
    drawAtlas(atlas, xform, tex, colors, count, mode, sampling, cull_rect,
              true);
  } else {
    drawAtlas(atlas, xform, tex, colors, count, mode, sampling, cull_rect,
              false);
  }
}

References flutter::DisplayListOpFlags::kDrawAtlasWithPaintFlags, and flutter::mode.

Referenced by canvas_drawAtlas(), flutter::testing::TEST(), flutter::testing::TEST(), flutter::testing::TEST_F(), impeller::testing::TEST_P(), impeller::testing::TEST_P(), impeller::testing::TEST_P(), impeller::testing::TEST_P(), impeller::testing::TEST_P(), impeller::testing::TEST_P(), impeller::testing::TEST_P(), impeller::testing::TEST_P(), and impeller::testing::TEST_P().

◆ DrawCircle()

void flutter::DisplayListBuilder::DrawCircle	(	const DlPoint &	center,
		DlScalar	radius,
		const DlPaint &	paint
	)

overridevirtual

Implements flutter::DlCanvas.

Definition at line 1311 of file dl_builder.cc.

                                                          {
  SetAttributesFromPaint(paint, DisplayListOpFlags::kDrawCircleFlags);
  drawCircle(center, radius);
}

References flutter::DisplayListOpFlags::kDrawCircleFlags.

◆ DrawColor()

void flutter::DisplayListBuilder::DrawColor	(	DlColor	color,
		DlBlendMode	mode
	)

overridevirtual

Implements flutter::DlCanvas.

Definition at line 1224 of file dl_builder.cc.

                                                                  {
  OpResult result = PaintResult(DlPaint(color).setBlendMode(mode));
  if (result != OpResult::kNoEffect && AccumulateUnbounded()) {
    Push<DrawColorOp>(0, color, mode);
    CheckLayerOpacityCompatibility(mode);
    UpdateLayerResult(result, mode);
  }
}

References flutter::mode.

◆ DrawDashedLine()

void flutter::DisplayListBuilder::DrawDashedLine	(	const DlPoint &	p0,
		const DlPoint &	p1,
		DlScalar	on_length,
		DlScalar	off_length,
		const DlPaint &	paint
	)

overridevirtual

Implements flutter::DlCanvas.

Definition at line 1263 of file dl_builder.cc.

                                                              {
  SetAttributesFromPaint(paint, DisplayListOpFlags::kDrawLineFlags);
  drawDashedLine(p0, p1, on_length, off_length);
}

References flutter::DisplayListOpFlags::kDrawLineFlags, and p1.

Referenced by impeller::interop::DisplayListBuilder::DrawDashedLine(), and flutter::testing::TEST().

◆ DrawDiffRoundRect()

void flutter::DisplayListBuilder::DrawDiffRoundRect	(	const DlRoundRect &	outer,
		const DlRoundRect &	inner,
		const DlPaint &	paint
	)

overridevirtual

Implements flutter::DlCanvas.

Definition at line 1349 of file dl_builder.cc.

                                                                 {
  if (auto rrect_and_paint = DiffRoundRectToRoundRect(outer, inner, paint)) {
    DrawRoundRect(rrect_and_paint->first, rrect_and_paint->second);
    return;
  }
  SetAttributesFromPaint(paint, DisplayListOpFlags::kDrawDRRectFlags);
  drawDiffRoundRect(outer, inner);
}

References DrawRoundRect(), and flutter::DisplayListOpFlags::kDrawDRRectFlags.

Referenced by flutter::testing::BM_DrawDRRect(), canvas_drawDRRect(), impeller::interop::DisplayListBuilder::DrawRoundedRectDifference(), flutter::testing::TEST(), flutter::testing::TEST_F(), flutter::testing::TEST_F(), flutter::testing::TEST_F(), flutter::testing::TEST_F(), impeller::testing::TEST_P(), and impeller::testing::TEST_P().

◆ DrawDisplayList()

void flutter::DisplayListBuilder::DrawDisplayList	(	const sk_sp< DisplayList >	display_list,
		DlScalar	opacity = `SK_Scalar1`
	)

overridevirtual

Implements flutter::DlCanvas.

Definition at line 1760 of file dl_builder.cc.

                                                           {
  if (!std::isfinite(opacity) || opacity <= SK_ScalarNearlyZero ||
      display_list->op_count() == 0 || display_list->GetBounds().IsEmpty() ||
      current_info().is_nop) {
    return;
  }
  const DlRect bounds = display_list->GetBounds();
  bool accumulated;
  sk_sp<const DlRTree> rtree;
  if (display_list->root_is_unbounded()) {
    accumulated = AccumulateUnbounded();
  } else if (!rtree_data_.has_value() || !(rtree = display_list->rtree())) {
    accumulated = AccumulateOpBounds(bounds, kDrawDisplayListFlags);
  } else {
    std::list<DlRect> rects =
        rtree->searchAndConsolidateRects(GetLocalClipCoverage(), false);
    accumulated = false;
    for (const DlRect& rect : rects) {
      // TODO (https://github.com/flutter/flutter/issues/114919): Attributes
      // are not necessarily `kDrawDisplayListFlags`.
      if (AccumulateOpBounds(rect, kDrawDisplayListFlags)) {
        accumulated = true;
      }
    }
  }
  if (!accumulated) {
    return;
  }
 
  DlPaint current_paint = current_;
  Push<DrawDisplayListOp>(0, display_list,
                          opacity < SK_Scalar1 ? opacity : SK_Scalar1);
 
  // This depth increment accounts for every draw call in the child
  // DisplayList and is in addition to the implicit depth increment
  // that was performed when we pushed the DrawDisplayListOp. The
  // eventual dispatcher can use or ignore the implicit depth increment
  // as it sees fit depending on whether it needs to do rendering
  // before or after the drawDisplayList op, but it must be accounted
  // for if the depth value accounting is to remain consistent between
  // the recording and dispatching process.
  depth_ += display_list->total_depth();
 
  is_ui_thread_safe_ = is_ui_thread_safe_ && display_list->isUIThreadSafe();
  // Not really necessary if the developer is interacting with us via
  // our attribute-state-less DlCanvas methods, but this avoids surprises
  // for those who may have been using the stateful Dispatcher methods.
  SetAttributesFromPaint(current_paint,
                         DisplayListOpFlags::kSaveLayerWithPaintFlags);
 
  // The non-nested op count accumulated in the |Push| method will include
  // this call to |drawDisplayList| for non-nested op count metrics.
  // But, for nested op count metrics we want the |drawDisplayList| call itself
  // to be transparent. So we subtract 1 from our accumulated nested count to
  // balance out against the 1 that was accumulated into the regular count.
  // This behavior is identical to the way SkPicture computed nested op counts.
  nested_op_count_ += display_list->op_count(true) - 1;
  nested_bytes_ += display_list->bytes(true);
  UpdateLayerOpacityCompatibility(display_list->can_apply_group_opacity());
  // Nop DisplayLists are eliminated above so we either affect transparent
  // pixels or we do not. We should not have [kNoEffect].
  UpdateLayerResult(display_list->modifies_transparent_black()
                        ? OpResult::kAffectsAll
                        : OpResult::kPreservesTransparency,
                    display_list->max_root_blend_mode());
  if (display_list->root_has_backdrop_filter()) {
    current_layer().contains_backdrop_filter = true;
  }
}

References GetLocalClipCoverage(), flutter::DisplayListOpFlags::kDrawDisplayListFlags, and flutter::DisplayListOpFlags::kSaveLayerWithPaintFlags.

Referenced by canvas_drawPicture(), impeller::interop::DisplayListBuilder::DrawDisplayList(), flutter::testing::GetSampleNestedDisplayList(), flutter::testing::TEST(), flutter::testing::TEST_F(), flutter::testing::TEST_F(), flutter::testing::TEST_F(), flutter::testing::TEST_F(), flutter::testing::TEST_F(), flutter::testing::TEST_F(), flutter::testing::TEST_F(), flutter::testing::TEST_F(), flutter::testing::TEST_F(), impeller::testing::TEST_P(), and impeller::testing::TEST_P().

◆ DrawImage()

void flutter::DisplayListBuilder::DrawImage	(	const sk_sp< DlImage > &	image,
		const DlPoint &	point,
		DlImageSampling	sampling,
		const DlPaint *	paint = `nullptr`
	)

overridevirtual

Implements flutter::DlCanvas.

Definition at line 1590 of file dl_builder.cc.

                                                         {
  if (paint != nullptr) {
    SetAttributesFromPaint(*paint,
                           DisplayListOpFlags::kDrawImageWithPaintFlags);
    drawImage(image, point, sampling, true);
  } else {
    drawImage(image, point, sampling, false);
  }
}

References image, and flutter::DisplayListOpFlags::kDrawImageWithPaintFlags.

◆ DrawImageNine()

void flutter::DisplayListBuilder::DrawImageNine	(	const sk_sp< DlImage > &	image,
		const DlIRect &	center,
		const DlRect &	dst,
		DlFilterMode	filter,
		const DlPaint *	paint = `nullptr`
	)

overridevirtual

Implements flutter::DlCanvas.

Definition at line 1652 of file dl_builder.cc.

                                                             {
  if (paint != nullptr) {
    SetAttributesFromPaint(*paint,
                           DisplayListOpFlags::kDrawImageNineWithPaintFlags);
    drawImageNine(image, center, dst, filter, true);
  } else {
    drawImageNine(image, center, dst, filter, false);
  }
}

References image, and flutter::DisplayListOpFlags::kDrawImageNineWithPaintFlags.

Referenced by flutter::testing::BM_DrawImageNine(), canvas_drawImageNine(), flutter::testing::TEST(), flutter::testing::TEST(), flutter::testing::TEST_F(), impeller::testing::TEST_P(), impeller::testing::TEST_P(), impeller::testing::TEST_P(), impeller::testing::TEST_P(), impeller::testing::TEST_P(), impeller::testing::TEST_P(), and impeller::testing::TEST_P().

◆ DrawImageRect() [1/4]

virtual void flutter::DlCanvas::DrawImageRect	(	const sk_sp< DlImage > &	image,
		const DlIRect &	src,
		const DlRect &	dst,
		DlImageSampling	sampling,
		const DlPaint *	paint = `nullptr`,
		DlSrcRectConstraint	constraint = `DlSrcRectConstraint::kFast`
	)

inlinevirtual

Reimplemented from flutter::DlCanvas.

Definition at line 149 of file dl_canvas.h.

                                                                 {
    auto float_src = DlRect::MakeLTRB(src.GetLeft(), src.GetTop(),
                                      src.GetRight(), src.GetBottom());
    DrawImageRect(image, float_src, dst, sampling, paint, constraint);
  }

◆ DrawImageRect() [2/4]

void flutter::DlCanvas::DrawImageRect	(	const sk_sp< DlImage > &	image,
		const DlRect &	dst,
		DlImageSampling	sampling,
		const DlPaint *	paint = `nullptr`,
		DlSrcRectConstraint	constraint = `DlSrcRectConstraint::kFast`
	)

inline

Definition at line 160 of file dl_canvas.h.

                                                                 {
    DrawImageRect(image, image->GetBounds(), dst, sampling, paint, constraint);
  }

◆ DrawImageRect() [3/4]

void flutter::DisplayListBuilder::DrawImageRect	(	const sk_sp< DlImage > &	image,
		const DlRect &	src,
		const DlRect &	dst,
		DlImageSampling	sampling,
		const DlPaint *	paint = `nullptr`,
		DlSrcRectConstraint	constraint = `DlSrcRectConstraint::kFast`
	)

overridevirtual

Implements flutter::DlCanvas.

Definition at line 1620 of file dl_builder.cc.

                                                                       {
  if (paint != nullptr) {
    SetAttributesFromPaint(*paint,
                           DisplayListOpFlags::kDrawImageRectWithPaintFlags);
    drawImageRect(image, src, dst, sampling, true, constraint);
  } else {
    drawImageRect(image, src, dst, sampling, false, constraint);
  }
}

References image, and flutter::DisplayListOpFlags::kDrawImageRectWithPaintFlags.

◆ DrawImageRect() [4/4]

virtual void flutter::DlCanvas::DrawImageRect	(	const sk_sp< DlImage > &	image,
		const DlRect &	src,
		const DlRect &	dst,
		DlImageSampling	sampling,
		const DlPaint *	paint = `nullptr`,
		DlSrcRectConstraint	constraint = `DlSrcRectConstraint::kFast`
	)

virtual

Implements flutter::DlCanvas.

◆ DrawLine()

void flutter::DisplayListBuilder::DrawLine	(	const DlPoint &	p0,
		const DlPoint &	p1,
		const DlPaint &	paint
	)

overridevirtual

Implements flutter::DlCanvas.

Definition at line 1243 of file dl_builder.cc.

                                                        {
  SetAttributesFromPaint(paint, DisplayListOpFlags::kDrawLineFlags);
  drawLine(p0, p1);
}

References flutter::DisplayListOpFlags::kDrawLineFlags, and p1.

◆ DrawOval()

void flutter::DisplayListBuilder::DrawOval	(	const DlRect &	bounds,
		const DlPaint &	paint
	)

overridevirtual

Implements flutter::DlCanvas.

Definition at line 1295 of file dl_builder.cc.

                                                                            {
  SetAttributesFromPaint(paint, DisplayListOpFlags::kDrawOvalFlags);
  drawOval(bounds);
}

References flutter::DisplayListOpFlags::kDrawOvalFlags.

Referenced by flutter::testing::BM_DrawOval(), canvas_drawOval(), impeller::interop::DisplayListBuilder::DrawOval(), DrawPath(), impeller::testing::MaskBlurVariantTest(), flutter::testing::TEST(), flutter::testing::TEST(), flutter::testing::TEST_F(), flutter::testing::TEST_F(), flutter::testing::TEST_F(), flutter::testing::TEST_F(), impeller::testing::TEST_P(), and impeller::testing::TEST_P().

◆ DrawPaint()

void flutter::DisplayListBuilder::DrawPaint ( const DlPaint & paint )

overridevirtual

Implements flutter::DlCanvas.

Definition at line 1220 of file dl_builder.cc.

                                                       {
  SetAttributesFromPaint(paint, DisplayListOpFlags::kDrawPaintFlags);
  drawPaint();
}

References flutter::DisplayListOpFlags::kDrawPaintFlags.

◆ DrawPath()

void flutter::DisplayListBuilder::DrawPath	(	const DlPath &	path,
		const DlPaint &	paint
	)

overridevirtual

Implements flutter::DlCanvas.

Definition at line 1401 of file dl_builder.cc.

                                                                          {
  DlRect rect;
  bool closed;
  if (path.IsRect(&rect, &closed) &&
      (paint.getDrawStyle() == DlDrawStyle::kFill || closed)) {
    DrawRect(rect, paint);
    return;
  }
 
  DlRoundRect rrect;
  if (path.IsRoundRect(&rrect)) {
    DrawRoundRect(rrect, paint);
    return;
  }
 
  DlRect oval_bounds;
  if (path.IsOval(&oval_bounds)) {
    DrawOval(oval_bounds, paint);
    return;
  }
 
  DlPoint start;
  DlPoint end;
  if (path.IsLine(&start, &end)) {
    DrawLine(start, end, paint);
    return;
  }
 
  SetAttributesFromPaint(paint, DisplayListOpFlags::kDrawPathFlags);
  drawPath(path);
}

References DrawLine(), DrawOval(), DrawRect(), DrawRoundRect(), end, flutter::DlPaint::getDrawStyle(), flutter::DisplayListOpFlags::kDrawPathFlags, flutter::kFill, flutter::path, and start.

◆ DrawPoints()

void flutter::DisplayListBuilder::DrawPoints	(	DlPointMode	mode,
		uint32_t	count,
		const DlPoint	pts[],
		const DlPaint &	paint
	)

overridevirtual

Implements flutter::DlCanvas.

Definition at line 1528 of file dl_builder.cc.

                                                          {
  SetAttributesFromPaint(paint, FlagsForPointMode(mode));
  drawPoints(mode, count, pts);
}

References flutter::mode.

Referenced by flutter::testing::BM_DrawPoints(), canvas_drawPoints(), flutter::testing::TEST(), flutter::testing::TEST(), flutter::testing::TEST_F(), flutter::testing::TEST_F(), flutter::testing::TEST_F(), flutter::testing::TEST_F(), impeller::testing::TEST_P(), impeller::testing::TEST_P(), impeller::testing::TEST_P(), impeller::testing::TEST_P(), impeller::testing::TEST_P(), impeller::testing::TEST_P(), and impeller::testing::TEST_P().

◆ DrawRect()

void flutter::DisplayListBuilder::DrawRect	(	const DlRect &	rect,
		const DlPaint &	paint
	)

overridevirtual

Implements flutter::DlCanvas.

Definition at line 1281 of file dl_builder.cc.

                                                                          {
  SetAttributesFromPaint(paint, DisplayListOpFlags::kDrawRectFlags);
  drawRect(rect);
}

References flutter::DisplayListOpFlags::kDrawRectFlags.

◆ DrawRoundRect()

void flutter::DisplayListBuilder::DrawRoundRect	(	const DlRoundRect &	rrect,
		const DlPaint &	paint
	)

overridevirtual

Implements flutter::DlCanvas.

Definition at line 1333 of file dl_builder.cc.

                                                             {
  SetAttributesFromPaint(paint, DisplayListOpFlags::kDrawRRectFlags);
  drawRoundRect(rrect);
}

References flutter::DisplayListOpFlags::kDrawRRectFlags.

◆ DrawRoundSuperellipse()

void flutter::DisplayListBuilder::DrawRoundSuperellipse	(	const DlRoundSuperellipse &	rse,
		const DlPaint &	paint
	)

overridevirtual

Implements flutter::DlCanvas.

Definition at line 1384 of file dl_builder.cc.

                                                                     {
  SetAttributesFromPaint(paint, DisplayListOpFlags::kDrawRSuperellipseFlags);
  drawRoundSuperellipse(rse);
}

References flutter::DisplayListOpFlags::kDrawRSuperellipseFlags.

Referenced by flutter::testing::BM_DrawRSE(), impeller::testing::TEST_P(), impeller::testing::TEST_P(), impeller::testing::TEST_P(), impeller::testing::TEST_P(), impeller::testing::TEST_P(), and impeller::testing::TEST_P().

◆ DrawShadow()

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

overridevirtual

Draws the shadow of the given |path| rendered in the provided |color| (which is only consulted for its opacity) as would be produced by a directional light source uniformly shining in the device space direction {0, -1, 1} against a backdrop which is |elevation * dpr| device coordinates below the |path| in the Z direction.

Normally the renderer might consider omitting the rendering of any of the shadow pixels that fall under the |path| itself, as an optimization, unless the |transparent_occluder| flag is specified which would indicate that the optimization isn't appropriate.

See also: |ComputeShadowBounds|

Implements flutter::DlCanvas.

Definition at line 1868 of file dl_builder.cc.

                                                  {
  OpResult result = PaintResult(DlPaint(color));
  if (result != OpResult::kNoEffect) {
    DlRect shadow_bounds =
        DlCanvas::ComputeShadowBounds(path, elevation, dpr, GetMatrix());
    if (AccumulateOpBounds(shadow_bounds, kDrawShadowFlags)) {
      transparent_occluder  //
          ? Push<DrawShadowTransparentOccluderOp>(0, path, color, elevation,
                                                  dpr)
          : Push<DrawShadowOp>(0, path, color, elevation, dpr);
      UpdateLayerOpacityCompatibility(false);
      UpdateLayerResult(result, DlBlendMode::kSrcOver);
    }
  }
}

References flutter::DlCanvas::ComputeShadowBounds(), GetMatrix(), flutter::DisplayListOpFlags::kDrawShadowFlags, and flutter::path.

Referenced by flutter::testing::BM_DrawShadow(), canvas_drawShadow(), impeller::interop::DisplayListBuilder::DrawShadow(), flutter::testing::TEST(), flutter::testing::TEST(), flutter::testing::TEST_F(), impeller::testing::TEST_P(), and impeller::testing::TEST_P().

◆ DrawText()

void flutter::DisplayListBuilder::DrawText	(	const std::shared_ptr< DlText > &	text,
		DlScalar	x,
		DlScalar	y,
		const DlPaint &	paint
	)

overridevirtual

Implements flutter::DlCanvas.

Definition at line 1860 of file dl_builder.cc.

                                                        {
  SetAttributesFromPaint(paint, DisplayListOpFlags::kDrawTextFlags);
  drawText(text, x, y);
}

References flutter::DisplayListOpFlags::kDrawTextFlags, text, x, and y.

Referenced by flutter::testing::BM_DrawTextBlob(), flutter::testing::TEST(), flutter::testing::TEST(), flutter::testing::TEST_F(), impeller::testing::TEST_P(), impeller::testing::TEST_P(), impeller::testing::TEST_P(), impeller::testing::TEST_P(), impeller::testing::TEST_P(), impeller::testing::TEST_P(), impeller::testing::TEST_P(), and impeller::testing::TEST_P().

◆ DrawVertices()

void flutter::DisplayListBuilder::DrawVertices	(	const std::shared_ptr< DlVertices > &	vertices,
		DlBlendMode	mode,
		const DlPaint &	paint
	)

overridevirtual

Implements flutter::DlCanvas.

Definition at line 1560 of file dl_builder.cc.

                          {
  SetAttributesFromPaint(paint, DisplayListOpFlags::kDrawVerticesFlags);
  drawVertices(vertices, mode);
}

References flutter::DisplayListOpFlags::kDrawVerticesFlags, and flutter::mode.

◆ Flush()

void flutter::DisplayListBuilder::Flush ( )

inlineoverridevirtual

Implements flutter::DlCanvas.

Definition at line 252 of file dl_builder.h.

252{}

◆ GetBaseLayerDimensions()

DlISize flutter::DisplayListBuilder::GetBaseLayerDimensions ( ) const

overridevirtual

Implements flutter::DlCanvas.

Definition at line 253 of file dl_builder.cc.

                                                         {
  return DlIRect::RoundOut(original_cull_rect_).GetSize();
}

References impeller::TRect< T >::RoundOut().

Referenced by GetImageInfo().

◆ GetDestinationClipCoverage()

DlRect flutter::DisplayListBuilder::GetDestinationClipCoverage ( ) const

inlineoverridevirtual

Conservative estimate of the bounds of all outstanding clip operations measured in the coordinate space within which this DisplayList will be rendered.

Implements flutter::DlCanvas.

Definition at line 138 of file dl_builder.h.

                                                     {
    return global_state().GetDeviceCullCoverage();
  }

References flutter::DisplayListMatrixClipState::GetDeviceCullCoverage().

◆ GetImageInfo()

SkImageInfo flutter::DisplayListBuilder::GetImageInfo ( ) const

overridevirtual

Implements flutter::DlCanvas.

Definition at line 257 of file dl_builder.cc.

                                                   {
  DlISize size = GetBaseLayerDimensions();
  return SkImageInfo::MakeUnknown(size.width, size.height);
}

References GetBaseLayerDimensions(), and flutter::size.

◆ GetLocalClipCoverage()

DlRect flutter::DisplayListBuilder::GetLocalClipCoverage ( ) const

inlineoverridevirtual

Conservative estimate of the bounds of all outstanding clip operations transformed into the local coordinate space in which currently recorded rendering operations are interpreted.

Implements flutter::DlCanvas.

Definition at line 145 of file dl_builder.h.

                                               {
    return global_state().GetLocalCullCoverage();
  }

References flutter::DisplayListMatrixClipState::GetLocalCullCoverage().

Referenced by canvas_getLocalClipBounds(), flutter::testing::DisplayListTestBase< BaseT >::check_defaults(), DrawDisplayList(), flutter::testing::TEST_F(), flutter::testing::TEST_F(), flutter::testing::TEST_F(), flutter::testing::TEST_F(), flutter::testing::TEST_F(), flutter::testing::TEST_F(), flutter::testing::TEST_F(), flutter::testing::TEST_F(), flutter::testing::TEST_F(), and flutter::testing::TEST_F().

◆ GetMatrix()

DlMatrix flutter::DisplayListBuilder::GetMatrix ( ) const

inlineoverridevirtual

Returns the 4x4 full perspective transform representing all transform operations executed so far in this DisplayList within the enclosing save stack.

Implements flutter::DlCanvas.

Definition at line 111 of file dl_builder.h.

111{ return global_state().matrix(); }

flutter::DisplayListMatrixClipState::matrix

const DlMatrix & matrix() const

Definition dl_matrix_clip_tracker.h:39

References flutter::DisplayListMatrixClipState::matrix().

◆ GetRecordCount()

size_t flutter::DisplayListBuilder::GetRecordCount ( ) const

Return the number of records currently recorded in the builder.

Returns: The number of records already recorded.

Definition at line 245 of file dl_builder.cc.

                                                {
  return offsets_.size();
}

◆ GetSaveCount()

int flutter::DisplayListBuilder::GetSaveCount ( ) const

inlineoverridevirtual

Implements flutter::DlCanvas.

Definition at line 71 of file dl_builder.h.

71{ return save_stack_.size(); }

Referenced by canvas_getSaveCount(), canvas_restoreToCount(), flutter::testing::DisplayListTestBase< BaseT >::check_defaults(), impeller::interop::DisplayListBuilder::GetSaveCount(), RestoreToCount(), flutter::testing::TEST(), flutter::testing::TEST(), flutter::testing::TEST(), and impeller::testing::TEST_P().

◆ IsEmpty()

bool flutter::DisplayListBuilder::IsEmpty ( ) const

Return true if the builder has not yet recorded any commands.

Returns: Whether the builder is empty.

Definition at line 249 of file dl_builder.cc.

                                       {
  return offsets_.empty();
}

Referenced by flutter::testing::DlSurfaceInstanceImpeller::Clear().

◆ QuickReject()

bool flutter::DisplayListBuilder::QuickReject ( const DlRect & bounds ) const

overridevirtual

Return true iff the supplied bounds are easily shown to be outside of the current clip bounds. This method may conservatively return false if it cannot make the determination.

Implements flutter::DlCanvas.

Definition at line 1208 of file dl_builder.cc.

                                                               {
  return global_state().content_culled(bounds);
}

References flutter::DisplayListMatrixClipState::content_culled().

Referenced by canvas_quickReject().

◆ Restore()

void flutter::DisplayListBuilder::Restore ( )

overridevirtual

Implements flutter::DlCanvas.

Definition at line 662 of file dl_builder.cc.

                                 {
  if (save_stack_.size() <= 1) {
    return;
  }
 
  if (!current_info().has_deferred_save_op) {
    SaveOpBase* op = reinterpret_cast<SaveOpBase*>(storage_.base() +
                                                   current_info().save_offset);
    FML_CHECK(op->type == DisplayListOpType::kSave ||
              op->type == DisplayListOpType::kSaveLayer ||
              op->type == DisplayListOpType::kSaveLayerBackdrop);
 
    op->restore_index = op_index_;
    op->total_content_depth = depth_ - current_info().save_depth;
 
    if (current_info().is_save_layer) {
      RestoreLayer();
    }
 
    // Wait until all outgoing bounds information for the saveLayer is
    // recorded before pushing the record to the buffer so that any rtree
    // bounds will be attributed to the op_index of the restore op.
    Push<RestoreOp>(0);
  } else {
    FML_DCHECK(!current_info().is_save_layer);
  }
 
  save_stack_.pop_back();
}

References flutter::DisplayListStorage::base(), FML_CHECK, FML_DCHECK, flutter::SaveOpBase::restore_index, flutter::SaveOpBase::total_content_depth, and flutter::DLOp::type.

◆ RestoreToCount()

void flutter::DisplayListBuilder::RestoreToCount ( int restore_count )

overridevirtual

Implements flutter::DlCanvas.

Definition at line 898 of file dl_builder.cc.

                                                         {
  FML_DCHECK(restore_count <= GetSaveCount());
  while (restore_count < GetSaveCount() && GetSaveCount() > 1) {
    restore();
  }
}

References FML_DCHECK, and GetSaveCount().

Referenced by canvas_restoreToCount(), impeller::interop::DisplayListBuilder::RestoreToCount(), and impeller::testing::TEST_P().

◆ Rotate()

void flutter::DisplayListBuilder::Rotate ( DlScalar degrees )

overridevirtual

Implements flutter::DlCanvas.

Definition at line 921 of file dl_builder.cc.

                                                {
  if (SkScalarMod(degrees, 360.0) != 0.0) {
    checkForDeferredSave();
    Push<RotateOp>(0, degrees);
    global_state().rotate(DlDegrees(degrees));
    layer_local_state().rotate(DlDegrees(degrees));
  }
}

References flutter::DisplayListMatrixClipState::rotate().

◆ Save()

void flutter::DisplayListBuilder::Save ( )

overridevirtual

Implements flutter::DlCanvas.

Definition at line 501 of file dl_builder.cc.

                              {
  bool was_nop = current_info().is_nop;
  save_stack_.emplace_back(&current_info());
  current_info().is_nop = was_nop;
 
  FML_DCHECK(save_stack_.size() >= 2u);
  FML_DCHECK(current_info().has_deferred_save_op);
}

References FML_DCHECK.

◆ SaveLayer()

void flutter::DisplayListBuilder::SaveLayer	(	const std::optional< DlRect > &	bounds,
		const DlPaint *	paint = `nullptr`,
		const DlImageFilter *	backdrop = `nullptr`,
		std::optional< int64_t >	backdrop_id = `std::nullopt`
	)

overridevirtual

Implements flutter::DlCanvas.

Definition at line 642 of file dl_builder.cc.

                                                                     {
  SaveLayerOptions options;
  DlRect temp_bounds;
  if (bounds.has_value()) {
    options = options.with_bounds_from_caller();
    temp_bounds = *bounds;
  } else {
    FML_DCHECK(temp_bounds.IsEmpty());
  }
  if (paint != nullptr) {
    options = options.with_renders_with_attributes();
    SetAttributesFromPaint(*paint,
                           DisplayListOpFlags::kSaveLayerWithPaintFlags);
  }
  saveLayer(temp_bounds, options, backdrop, backdrop_id);
}

References FML_DCHECK, impeller::TRect< T >::IsEmpty(), flutter::DisplayListOpFlags::kSaveLayerWithPaintFlags, flutter::SaveLayerOptions::with_bounds_from_caller(), and flutter::SaveLayerOptions::with_renders_with_attributes().

◆ Scale()

void flutter::DisplayListBuilder::Scale	(	DlScalar	sx,
		DlScalar	sy
	)

overridevirtual

Implements flutter::DlCanvas.

Definition at line 913 of file dl_builder.cc.

                                                       {
  if (std::isfinite(sx) && std::isfinite(sy) && (sx != 1.0 || sy != 1.0)) {
    checkForDeferredSave();
    Push<ScaleOp>(0, sx, sy);
    global_state().scale(sx, sy);
    layer_local_state().scale(sx, sy);
  }
}

References flutter::DisplayListMatrixClipState::scale().

◆ SetTransform()

void flutter::DisplayListBuilder::SetTransform ( const DlMatrix & matrix )

inlineoverridevirtual

Implements flutter::DlCanvas.

Definition at line 102 of file dl_builder.h.

                                                     {
    TransformReset();
    Transform(matrix);
  }

References Transform(), and TransformReset().

Referenced by impeller::interop::DisplayListBuilder::SetTransform(), flutter::testing::TEST(), and flutter::testing::TEST().

◆ Skew()

void flutter::DisplayListBuilder::Skew	(	DlScalar	sx,
		DlScalar	sy
	)

overridevirtual

Implements flutter::DlCanvas.

Definition at line 929 of file dl_builder.cc.

                                                      {
  if (std::isfinite(sx) && std::isfinite(sy) && (sx != 0.0 || sy != 0.0)) {
    checkForDeferredSave();
    Push<SkewOp>(0, sx, sy);
    global_state().skew(sx, sy);
    layer_local_state().skew(sx, sy);
  }
}

References flutter::DisplayListMatrixClipState::skew().

Referenced by canvas_skew(), flutter::testing::TEST_F(), flutter::testing::TEST_F(), flutter::testing::TEST_F(), flutter::testing::TEST_F(), flutter::testing::TEST_F(), flutter::testing::TEST_F(), and impeller::testing::TEST_P().

◆ Transform()

void flutter::DisplayListBuilder::Transform ( const DlMatrix & matrix )

overridevirtual

Implements flutter::DlCanvas.

Definition at line 1025 of file dl_builder.cc.

                                                         {
  TransformFullPerspective(
      matrix.e[0][0], matrix.e[1][0], matrix.e[2][0], matrix.e[3][0],
      matrix.e[0][1], matrix.e[1][1], matrix.e[2][1], matrix.e[3][1],
      matrix.e[0][2], matrix.e[1][2], matrix.e[2][2], matrix.e[3][2],
      matrix.e[0][3], matrix.e[1][3], matrix.e[2][3], matrix.e[3][3]);
}

References impeller::Matrix::e, and TransformFullPerspective().

◆ Transform2DAffine()

void flutter::DisplayListBuilder::Transform2DAffine	(	DlScalar	mxx,
		DlScalar	mxy,
		DlScalar	mxt,
		DlScalar	myx,
		DlScalar	myy,
		DlScalar	myt
	)

overridevirtual

Implements flutter::DlCanvas.

Definition at line 941 of file dl_builder.cc.

                                              {
  if (std::isfinite(mxx) && std::isfinite(myx) &&
      std::isfinite(mxy) && std::isfinite(myy) &&
      std::isfinite(mxt) && std::isfinite(myt)) {
    if (mxx == 1 && mxy == 0 &&
        myx == 0 && myy == 1) {
      Translate(mxt, myt);
    } else {
      checkForDeferredSave();
      Push<Transform2DAffineOp>(0,
                                mxx, mxy, mxt,
                                myx, myy, myt);
      global_state().transform2DAffine(mxx, mxy, mxt,
                                       myx, myy, myt);
      layer_local_state().transform2DAffine(mxx, mxy, mxt,
                                            myx, myy, myt);
    }
  }
}

References flutter::DisplayListMatrixClipState::transform2DAffine(), and Translate().

Referenced by flutter::testing::TEST_F(), flutter::testing::TEST_F(), flutter::testing::TEST_F(), flutter::testing::TEST_F(), flutter::testing::TEST_F(), and flutter::testing::TEST_F().

◆ TransformFullPerspective()

void flutter::DisplayListBuilder::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
	)

overridevirtual

Implements flutter::DlCanvas.

Definition at line 963 of file dl_builder.cc.

                                                            {
  if (                        mxz == 0 &&
                              myz == 0 &&
      mzx == 0 && mzy == 0 && mzz == 1 && mzt == 0 &&
      mwx == 0 && mwy == 0 && mwz == 0 && mwt == 1) {
    transform2DAffine(mxx, mxy, mxt,
                      myx, myy, myt);
  } else if (std::isfinite(mxx) && std::isfinite(mxy) &&
             std::isfinite(mxz) && std::isfinite(mxt) &&
             std::isfinite(myx) && std::isfinite(myy) &&
             std::isfinite(myz) && std::isfinite(myt) &&
             std::isfinite(mzx) && std::isfinite(mzy) &&
             std::isfinite(mzz) && std::isfinite(mzt) &&
             std::isfinite(mwx) && std::isfinite(mwy) &&
             std::isfinite(mwz) && std::isfinite(mwt)) {
    checkForDeferredSave();
    Push<TransformFullPerspectiveOp>(0,
                                     mxx, mxy, mxz, mxt,
                                     myx, myy, myz, myt,
                                     mzx, mzy, mzz, mzt,
                                     mwx, mwy, mwz, mwt);
    global_state().transformFullPerspective(mxx, mxy, mxz, mxt,
                                            myx, myy, myz, myt,
                                            mzx, mzy, mzz, mzt,
                                            mwx, mwy, mwz, mwt);
    layer_local_state().transformFullPerspective(mxx, mxy, mxz, mxt,
                                                 myx, myy, myz, myt,
                                                 mzx, mzy, mzz, mzt,
                                                 mwx, mwy, mwz, mwt);
  }
}

References flutter::DisplayListMatrixClipState::transformFullPerspective().

Referenced by flutter::BM_DisplayListBuilderWithPerspective(), flutter::testing::TEST_F(), flutter::testing::TEST_F(), flutter::testing::TEST_F(), flutter::testing::TEST_F(), flutter::testing::TEST_F(), flutter::testing::TEST_F(), flutter::testing::TEST_F(), flutter::testing::TEST_F(), flutter::testing::TEST_F(), flutter::testing::TEST_F(), flutter::testing::TEST_F(), impeller::testing::TEST_P(), impeller::testing::TEST_P(), and Transform().

◆ TransformReset()

void flutter::DisplayListBuilder::TransformReset ( )

overridevirtual

Implements flutter::DlCanvas.

Definition at line 999 of file dl_builder.cc.

                                        {
  checkForDeferredSave();
  Push<TransformResetOp>(0);
 
  // The matrices in layer_tracker_ and tracker_ are similar, but
  // start at a different base transform. The tracker_ potentially
  // has some number of transform operations on it that prefix the
  // operations accumulated in layer_tracker_. So we can't set them both
  // to identity in parallel as they would no longer maintain their
  // relationship to each other.
  // Instead we reinterpret this operation as transforming by the
  // inverse of the current transform. Doing so to tracker_ sets it
  // to identity so we can avoid the math there, but we must do the
  // math the long way for layer_tracker_. This becomes:
  //   layer_tracker_.transform(tracker_.inverse());
  if (!layer_local_state().inverseTransform(global_state())) {
    // If the inverse operation failed then that means that either
    // the matrix above the current layer was singular, or the matrix
    // became singular while we were accumulating the current layer.
    // In either case, we should no longer be accumulating any
    // contents so we set the layer tracking transform to a singular one.
    layer_local_state().setTransform(DlMatrix::MakeScale({0.0f, 0.0f, 0.0f}));
  }
 
  global_state().setIdentity();
}

References impeller::Matrix::MakeScale(), flutter::DisplayListMatrixClipState::setIdentity(), and flutter::DisplayListMatrixClipState::setTransform().

Referenced by impeller::interop::DisplayListBuilder::ResetTransform(), SetTransform(), flutter::testing::TEST_F(), flutter::testing::TEST_F(), flutter::testing::TEST_F(), flutter::testing::TEST_F(), flutter::testing::TEST_F(), flutter::testing::TEST_F(), and flutter::testing::TEST_F().

◆ Translate()

void flutter::DisplayListBuilder::Translate	(	DlScalar	tx,
		DlScalar	ty
	)

overridevirtual

Implements flutter::DlCanvas.

Definition at line 905 of file dl_builder.cc.

                                                           {
  if (std::isfinite(tx) && std::isfinite(ty) && (tx != 0.0 || ty != 0.0)) {
    checkForDeferredSave();
    Push<TranslateOp>(0, tx, ty);
    global_state().translate(tx, ty);
    layer_local_state().translate(tx, ty);
  }
}

References flutter::DisplayListMatrixClipState::translate().

Friends And Related Symbol Documentation

◆ DisplayListBuilderBenchmarkAccessor

DlOpReceiver & DisplayListBuilderBenchmarkAccessor ( DisplayListBuilder & builder )

friend

Definition at line 11 of file dl_builder_benchmarks.cc.

                                                                               {
  return builder.asReceiver();
}

◆ DisplayListBuilderTestingAccessor

DlOpReceiver & DisplayListBuilderTestingAccessor ( DisplayListBuilder & builder )

friend

Definition at line 36 of file display_list_unittests.cc.

                                                                             {
  return builder.asReceiver();
}

◆ DisplayListBuilderTestingAttributes

DlPaint DisplayListBuilderTestingAttributes ( DisplayListBuilder & builder )

friend

Definition at line 40 of file display_list_unittests.cc.

                                                                         {
  return builder.CurrentAttributes();
}

◆ DisplayListBuilderTestingLastOpIndex

int DisplayListBuilderTestingLastOpIndex ( DisplayListBuilder & builder )

friend

Definition at line 44 of file display_list_unittests.cc.

                                                                      {
  return builder.LastOpIndex();
}

Member Data Documentation

◆ kMaxCullRect

constexpr DlRect flutter::DisplayListBuilder::kMaxCullRect

staticconstexpr

Initial value:

=

DlRect::MakeLTRB(-1E9F, -1E9F, 1E9F, 1E9F)

Definition at line 32 of file dl_builder.h.

Referenced by flutter::DisplayListMatrixClipState::GetLocalCullCoverage().

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

display_list/dl_builder.h
display_list/dl_builder.cc

Public Member Functions

Static Public Attributes

Friends

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ DisplayListBuilder() [1/3]

◆ DisplayListBuilder() [2/3]

◆ DisplayListBuilder() [3/3]

◆ ~DisplayListBuilder()

Member Function Documentation

◆ Build()

◆ ClipOval()

◆ ClipPath()

◆ ClipRect()

◆ ClipRoundRect()

◆ ClipRoundSuperellipse()

◆ DrawArc()

◆ DrawAtlas()

◆ DrawCircle()

◆ DrawColor()

◆ DrawDashedLine()

◆ DrawDiffRoundRect()

◆ DrawDisplayList()

◆ DrawImage()

◆ DrawImageNine()

◆ DrawImageRect() [1/4]

◆ DrawImageRect() [2/4]

◆ DrawImageRect() [3/4]

◆ DrawImageRect() [4/4]

◆ DrawLine()

◆ DrawOval()

◆ DrawPaint()

◆ DrawPath()

◆ DrawPoints()

◆ DrawRect()

◆ DrawRoundRect()

◆ DrawRoundSuperellipse()

◆ DrawShadow()

◆ DrawText()

◆ DrawVertices()

◆ Flush()

◆ GetBaseLayerDimensions()

◆ GetDestinationClipCoverage()

◆ GetImageInfo()

◆ GetLocalClipCoverage()

◆ GetMatrix()

◆ GetRecordCount()

◆ GetSaveCount()

◆ IsEmpty()

◆ QuickReject()

◆ Restore()

◆ RestoreToCount()

◆ Rotate()

◆ Save()

◆ SaveLayer()

◆ Scale()

◆ SetTransform()

◆ Skew()

◆ Transform()

◆ Transform2DAffine()

◆ TransformFullPerspective()

◆ TransformReset()

◆ Translate()

Friends And Related Symbol Documentation

◆ DisplayListBuilderBenchmarkAccessor

◆ DisplayListBuilderTestingAccessor

◆ DisplayListBuilderTestingAttributes

◆ DisplayListBuilderTestingLastOpIndex

Member Data Documentation

◆ kMaxCullRect