flutter::DisplayListMatrixClipState Class Reference

#include <dl_matrix_clip_tracker.h>

Public Member Functions
	DisplayListMatrixClipState (const DlRect &cull_rect, const DlMatrix &matrix=DlMatrix())
	DisplayListMatrixClipState (const DisplayListMatrixClipState &other)=default
void	resetDeviceCullRect (const DlRect &cull_rect)
void	resetLocalCullRect (const DlRect &cull_rect)
bool	using_4x4_matrix () const
bool	is_matrix_invertable () const
bool	has_perspective () const
const DlMatrix &	matrix () const
DlRect	GetLocalCullCoverage () const
DlRect	GetDeviceCullCoverage () const
bool	rect_covers_cull (const DlRect &content) const
bool	oval_covers_cull (const DlRect &content_bounds) const
bool	rrect_covers_cull (const DlRoundRect &content) const
bool	rsuperellipse_covers_cull (const DlRoundSuperellipse &content) const
bool	content_culled (const DlRect &content_bounds) const
bool	is_cull_rect_empty () const
void	translate (DlScalar tx, DlScalar ty)
void	scale (DlScalar sx, DlScalar sy)
void	skew (DlScalar skx, DlScalar sky)
void	rotate (DlRadians angle)
void	transform (const DlMatrix &matrix)
void	transform2DAffine (DlScalar mxx, DlScalar mxy, DlScalar mxt, DlScalar myx, DlScalar myy, DlScalar myt)
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)
void	setTransform (const DlMatrix &matrix)
void	setIdentity ()
bool	inverseTransform (const DisplayListMatrixClipState &other_tracker)
bool	mapRect (DlRect *rect) const
bool	mapRect (const DlRect &src, DlRect *mapped) const
bool	mapAndClipRect (DlRect *rect) const
	Maps the rect by the current matrix and then clips it against the current cull rect, returning true if the result is non-empty.
bool	mapAndClipRect (const DlRect &src, DlRect *mapped) const
void	clipRect (const DlRect &rect, DlClipOp op, bool is_aa)
void	clipOval (const DlRect &bounds, DlClipOp op, bool is_aa)
void	clipRRect (const DlRoundRect &rrect, DlClipOp op, bool is_aa)
void	clipRSuperellipse (const DlRoundSuperellipse &rse, DlClipOp op, bool is_aa)
void	clipPath (const DlPath &path, DlClipOp op, bool is_aa)

Static Public Member Functions
static bool	TransformedRectCoversBounds (const DlRect &local_rect, const DlMatrix &matrix, const DlRect &cull_bounds)
	Checks if the local rect, when transformed by the matrix, completely covers the indicated culling bounds.
static bool	TransformedOvalCoversBounds (const DlRect &local_oval_bounds, const DlMatrix &matrix, const DlRect &cull_bounds)
	Checks if an oval defined by the local bounds, when transformed by the matrix, completely covers the indicated culling bounds.
static bool	TransformedRRectCoversBounds (const DlRoundRect &local_rrect, const DlMatrix &matrix, const DlRect &cull_bounds)
	Checks if the local round rect, when transformed by the matrix, completely covers the indicated culling bounds.
static bool	TransformedRoundSuperellipseCoversBounds (const DlRoundSuperellipse &local_rse, const DlMatrix &matrix, const DlRect &cull_bounds)
	Checks if the local round superellipse, when transformed by the matrix, completely covers the indicated culling bounds.

Detailed Description

Definition at line 17 of file dl_matrix_clip_tracker.h.

Constructor & Destructor Documentation

DisplayListMatrixClipState() [1/2]

flutter::DisplayListMatrixClipState::DisplayListMatrixClipState ( const DlRect &  cull_rect, const DlMatrix &  matrix = DlMatrix()  )

explicit

Definition at line 20 of file dl_matrix_clip_tracker.cc.

    : cull_rect_(ProtectEmpty(cull_rect)), matrix_(matrix) {}

DisplayListMatrixClipState() [2/2]

flutter::DisplayListMatrixClipState::DisplayListMatrixClipState ( const DisplayListMatrixClipState &  other )

default

Member Function Documentation

clipOval()

void flutter::DisplayListMatrixClipState::clipOval	(	const DlRect &	bounds,
		DlClipOp	op,
		bool	is_aa
	)

Definition at line 53 of file dl_matrix_clip_tracker.cc.

                                                      {
  if (!bounds.IsFinite()) {
    return;
  }
  switch (op) {
    case DlClipOp::kIntersect:
      adjustCullRect(bounds, op, is_aa);
      break;
    case DlClipOp::kDifference:
      if (oval_covers_cull(bounds)) {
        cull_rect_ = DlRect();
      }
      break;
  }
}

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

Referenced by flutter::DisplayListBuilder::ClipOval(), clipRRect(), and clipRSuperellipse().

clipPath()

void flutter::DisplayListMatrixClipState::clipPath	(	const DlPath &	path,
		DlClipOp	op,
		bool	is_aa
	)

Definition at line 140 of file dl_matrix_clip_tracker.cc.

                                                      {
  DlRect bounds = path.GetBounds();
  if (path.IsRect(nullptr)) {
    return clipRect(bounds, op, is_aa);
  }
  switch (op) {
    case DlClipOp::kIntersect:
      adjustCullRect(bounds, op, is_aa);
      break;
    case DlClipOp::kDifference:
      break;
  }
}

References clipRect(), flutter::kDifference, flutter::kIntersect, and flutter::path.

Referenced by flutter::DisplayListBuilder::ClipPath(), flutter::PrerollDelegate::clipPath(), and flutter::testing::TEST().

clipRect()

void flutter::DisplayListMatrixClipState::clipRect	(	const DlRect &	rect,
		DlClipOp	op,
		bool	is_aa
	)

Definition at line 45 of file dl_matrix_clip_tracker.cc.

                                                      {
  if (rect.IsFinite()) {
    adjustCullRect(rect, op, is_aa);
  }
}

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

Referenced by clipPath(), flutter::DisplayListBuilder::ClipRect(), flutter::PrerollDelegate::clipRect(), clipRRect(), clipRSuperellipse(), and flutter::testing::TEST().

clipRRect()

void flutter::DisplayListMatrixClipState::clipRRect	(	const DlRoundRect &	rrect,
		DlClipOp	op,
		bool	is_aa
	)

Definition at line 85 of file dl_matrix_clip_tracker.cc.

                                                       {
  DlRect bounds = rrect.GetBounds();
  if (rrect.IsRect()) {
    return clipRect(bounds, op, is_aa);
  }
  if (rrect.IsOval()) {
    return clipOval(bounds, op, is_aa);
  }
  switch (op) {
    case DlClipOp::kIntersect:
      adjustCullRect(bounds, op, is_aa);
      break;
    case DlClipOp::kDifference: {
      if (rrect_covers_cull(rrect)) {
        cull_rect_ = DlRect();
        return;
      }
      auto safe_rects = RoundingRadiiSafeRects(bounds, rrect.GetRadii());
      adjustCullRect(safe_rects[0], op, is_aa);
      adjustCullRect(safe_rects[1], op, is_aa);
      break;
    }
  }
}

References clipOval(), clipRect(), impeller::RoundRect::GetBounds(), impeller::RoundRect::GetRadii(), impeller::RoundRect::IsOval(), impeller::RoundRect::IsRect(), flutter::kDifference, flutter::kIntersect, and rrect_covers_cull().

Referenced by flutter::DisplayListBuilder::ClipRoundRect(), flutter::PrerollDelegate::clipRRect(), and flutter::testing::TEST().

clipRSuperellipse()

void flutter::DisplayListMatrixClipState::clipRSuperellipse	(	const DlRoundSuperellipse &	rse,
		DlClipOp	op,
		bool	is_aa
	)

Definition at line 112 of file dl_matrix_clip_tracker.cc.

                {
  DlRect bounds = rse.GetBounds();
  if (rse.IsRect()) {
    return clipRect(bounds, op, is_aa);
  }
  if (rse.IsOval()) {
    return clipOval(bounds, op, is_aa);
  }
  switch (op) {
    case DlClipOp::kIntersect:
      adjustCullRect(bounds, op, is_aa);
      break;
    case DlClipOp::kDifference: {
      if (rsuperellipse_covers_cull(rse)) {
        cull_rect_ = DlRect();
        return;
      }
      auto safe_rects = RoundingRadiiSafeRects(bounds, rse.GetRadii());
      adjustCullRect(safe_rects[0], op, is_aa);
      adjustCullRect(safe_rects[1], op, is_aa);
      break;
    }
  }
}

References clipOval(), clipRect(), impeller::RoundSuperellipse::GetBounds(), impeller::RoundSuperellipse::GetRadii(), impeller::RoundSuperellipse::IsOval(), impeller::RoundSuperellipse::IsRect(), flutter::kDifference, flutter::kIntersect, and rsuperellipse_covers_cull().

Referenced by flutter::DisplayListBuilder::ClipRoundSuperellipse(), and flutter::PrerollDelegate::clipRSuperellipse().

content_culled()

bool flutter::DisplayListMatrixClipState::content_culled

(

const DlRect &

content_bounds

)

const

Definition at line 156 of file dl_matrix_clip_tracker.cc.

                                        {
  if (cull_rect_.IsEmpty() || content_bounds.IsEmpty()) {
    return true;
  }
  if (!is_matrix_invertable()) {
    return true;
  }
  if (has_perspective()) {
    return false;
  }
  DlRect mapped;
  mapRect(content_bounds, &mapped);
  return !mapped.IntersectsWithRect(cull_rect_);
}

References has_perspective(), impeller::TRect< T >::IntersectsWithRect(), is_matrix_invertable(), impeller::TRect< T >::IsEmpty(), and mapRect().

Referenced by flutter::PrerollDelegate::content_culled(), and flutter::DisplayListBuilder::QuickReject().

GetDeviceCullCoverage()

DlRect flutter::DisplayListMatrixClipState::GetDeviceCullCoverage ( ) const

inline

Definition at line 42 of file dl_matrix_clip_tracker.h.

{ return cull_rect_; }

Referenced by flutter::PrerollDelegate::device_cull_rect(), flutter::DisplayListBuilder::GetDestinationClipCoverage(), flutter::testing::TEST(), flutter::testing::TEST(), flutter::testing::TEST(), flutter::testing::TEST(), flutter::testing::TEST(), flutter::testing::TEST(), flutter::testing::TEST(), flutter::testing::TEST(), flutter::testing::TEST(), flutter::testing::TEST(), flutter::testing::TEST(), flutter::testing::TEST(), flutter::testing::TEST(), flutter::testing::TEST(), flutter::testing::TEST(), and flutter::testing::TEST().

GetLocalCullCoverage()

DlRect flutter::DisplayListMatrixClipState::GetLocalCullCoverage

(

)

const

Definition at line 235 of file dl_matrix_clip_tracker.cc.

                                                              {
  if (cull_rect_.IsEmpty()) {
    return DlRect();
  }
  if (!is_matrix_invertable()) {
    return DlRect();
  }
  if (matrix_.HasPerspective2D()) {
    // We could do a 4-point long-form conversion, but since this is
    // only used for culling, let's just return a non-constricting
    // cull rect.
    return DisplayListBuilder::kMaxCullRect;
  }
  DlMatrix inverse = matrix_.Invert();
  // We eliminated perspective above so we can use the cheaper non-clipping
  // bounds transform method.
  return cull_rect_.TransformBounds(inverse);
}

References impeller::Matrix::HasPerspective2D(), impeller::Matrix::Invert(), is_matrix_invertable(), impeller::TRect< T >::IsEmpty(), flutter::DisplayListBuilder::kMaxCullRect, and impeller::TRect< T >::TransformBounds().

Referenced by flutter::DisplayListBuilder::GetLocalClipCoverage(), flutter::PrerollDelegate::local_cull_rect(), flutter::testing::TEST(), flutter::testing::TEST(), flutter::testing::TEST(), flutter::testing::TEST(), flutter::testing::TEST(), flutter::testing::TEST(), flutter::testing::TEST(), flutter::testing::TEST(), flutter::testing::TEST(), flutter::testing::TEST(), flutter::testing::TEST(), and flutter::testing::TEST().

has_perspective()

bool flutter::DisplayListMatrixClipState::has_perspective ( ) const

inline

Definition at line 37 of file dl_matrix_clip_tracker.h.

{ return matrix_.HasPerspective(); }

References impeller::Matrix::HasPerspective().

Referenced by content_culled().

inverseTransform()

bool flutter::DisplayListMatrixClipState::inverseTransform

(

const DisplayListMatrixClipState &

other_tracker

)

Definition at line 24 of file dl_matrix_clip_tracker.cc.

                                               {
  if (tracker.is_matrix_invertable()) {
    matrix_ = matrix_ * tracker.matrix_.Invert();
    return true;
  }
  return false;
}

References impeller::Matrix::Invert(), and is_matrix_invertable().

is_cull_rect_empty()

bool flutter::DisplayListMatrixClipState::is_cull_rect_empty ( ) const

inline

Definition at line 50 of file dl_matrix_clip_tracker.h.

{ return cull_rect_.IsEmpty(); }

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

is_matrix_invertable()

bool flutter::DisplayListMatrixClipState::is_matrix_invertable ( ) const

inline

Definition at line 36 of file dl_matrix_clip_tracker.h.

{ return matrix_.IsInvertible(); }

References impeller::Matrix::IsInvertible().

Referenced by content_culled(), GetLocalCullCoverage(), and inverseTransform().

mapAndClipRect() [1/2]

bool flutter::DisplayListMatrixClipState::mapAndClipRect	(	const DlRect &	src,
		DlRect *	mapped
	)		const

Definition at line 33 of file dl_matrix_clip_tracker.cc.

                                                                      {
  DlRect dl_mapped = src.TransformAndClipBounds(matrix_);
  auto dl_intersected = dl_mapped.Intersection(cull_rect_);
  if (dl_intersected.has_value()) {
    *mapped = dl_intersected.value();
    return true;
  }
  *mapped = DlRect();
  return false;
}

References impeller::TRect< T >::Intersection(), and impeller::TRect< T >::TransformAndClipBounds().

mapAndClipRect() [2/2]

bool flutter::DisplayListMatrixClipState::mapAndClipRect ( DlRect *  rect ) const

inline

Maps the rect by the current matrix and then clips it against the current cull rect, returning true if the result is non-empty.

Definition at line 104 of file dl_matrix_clip_tracker.h.

                                          {
    return mapAndClipRect(*rect, rect);
  }

References mapAndClipRect().

Referenced by mapAndClipRect().

mapRect() [1/2]

bool flutter::DisplayListMatrixClipState::mapRect ( const DlRect &  src, DlRect *  mapped  ) const

inline

Definition at line 97 of file dl_matrix_clip_tracker.h.

                                                        {
    *mapped = src.TransformAndClipBounds(matrix_);
    return matrix_.IsAligned2D();
  }

References impeller::Matrix::IsAligned2D(), and impeller::TRect< T >::TransformAndClipBounds().

mapRect() [2/2]

bool flutter::DisplayListMatrixClipState::mapRect ( DlRect *  rect ) const

inline

Definition at line 96 of file dl_matrix_clip_tracker.h.

{ return mapRect(*rect, rect); }

References mapRect().

Referenced by flutter::DiffContext::AddLayerBounds(), content_culled(), mapRect(), and resetLocalCullRect().

matrix()

const DlMatrix & flutter::DisplayListMatrixClipState::matrix ( ) const

inline

Definition at line 39 of file dl_matrix_clip_tracker.h.

{ return matrix_; }

Referenced by flutter::DisplayListBuilder::GetMatrix(), flutter::PrerollDelegate::matrix(), setTransform(), flutter::testing::TEST(), flutter::testing::TEST(), flutter::testing::TEST(), flutter::testing::TEST(), flutter::testing::TEST(), flutter::testing::TEST(), flutter::testing::TEST(), flutter::testing::TEST(), flutter::testing::TEST(), flutter::testing::TEST(), flutter::testing::TEST(), flutter::testing::TEST(), flutter::testing::TEST(), flutter::testing::TEST(), flutter::testing::TEST(), transform(), TransformedOvalCoversBounds(), TransformedRectCoversBounds(), TransformedRoundSuperellipseCoversBounds(), and TransformedRRectCoversBounds().

oval_covers_cull()

bool flutter::DisplayListMatrixClipState::oval_covers_cull

(

const DlRect &

content_bounds

)

const

Definition at line 286 of file dl_matrix_clip_tracker.cc.

                                                                            {
  return TransformedOvalCoversBounds(bounds, matrix_, cull_rect_);
}

References TransformedOvalCoversBounds().

Referenced by clipOval(), flutter::testing::TEST(), flutter::testing::TEST(), and flutter::testing::TEST().

rect_covers_cull()

bool flutter::DisplayListMatrixClipState::rect_covers_cull

(

const DlRect &

content

)

const

Definition at line 254 of file dl_matrix_clip_tracker.cc.

                                                                             {
  return TransformedRectCoversBounds(content, matrix_, cull_rect_);
}

References content, and TransformedRectCoversBounds().

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

resetDeviceCullRect()

void flutter::DisplayListMatrixClipState::resetDeviceCullRect

(

const DlRect &

cull_rect

)

Definition at line 172 of file dl_matrix_clip_tracker.cc.

                                                                            {
  if (cull_rect.IsEmpty()) {
    cull_rect_ = DlRect();
  } else {
    cull_rect_ = cull_rect;
  }
}

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

resetLocalCullRect()

void flutter::DisplayListMatrixClipState::resetLocalCullRect

(

const DlRect &

cull_rect

)

Definition at line 180 of file dl_matrix_clip_tracker.cc.

                                                                           {
  if (!cull_rect.IsEmpty()) {
    mapRect(cull_rect, &cull_rect_);
    if (!cull_rect_.IsEmpty()) {
      return;
    }
  }
  cull_rect_ = DlRect();
}

References impeller::TRect< T >::IsEmpty(), and mapRect().

rotate()

void flutter::DisplayListMatrixClipState::rotate ( DlRadians  angle )

inline

Definition at line 61 of file dl_matrix_clip_tracker.h.

                               {
    matrix_ = matrix_ * DlMatrix::MakeRotationZ(angle);
  }

References impeller::Matrix::MakeRotationZ().

Referenced by flutter::DisplayListBuilder::Rotate(), flutter::testing::TEST(), flutter::testing::TEST(), and flutter::testing::TEST().

rrect_covers_cull()

bool flutter::DisplayListMatrixClipState::rrect_covers_cull

(

const DlRoundRect &

content

)

const

Definition at line 317 of file dl_matrix_clip_tracker.cc.

                                      {
  return TransformedRRectCoversBounds(content, matrix_, cull_rect_);
}

References content, and TransformedRRectCoversBounds().

Referenced by clipRRect(), and flutter::testing::TEST().

rsuperellipse_covers_cull()

bool flutter::DisplayListMatrixClipState::rsuperellipse_covers_cull

(

const DlRoundSuperellipse &

content

)

const

Definition at line 365 of file dl_matrix_clip_tracker.cc.

                                              {
  return TransformedRoundSuperellipseCoversBounds(content, matrix_, cull_rect_);
}

References content, and TransformedRoundSuperellipseCoversBounds().

Referenced by clipRSuperellipse().

scale()

void flutter::DisplayListMatrixClipState::scale ( DlScalar  sx, DlScalar  sy  )

inline

Definition at line 55 of file dl_matrix_clip_tracker.h.

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

References impeller::Matrix::Scale().

Referenced by flutter::DisplayListBuilder::Scale(), flutter::testing::TEST(), flutter::testing::TEST(), flutter::testing::TEST(), flutter::testing::TEST(), TransformedOvalCoversBounds(), and TransformedRRectCoversBounds().

setIdentity()

void flutter::DisplayListMatrixClipState::setIdentity ( )

inline

Definition at line 90 of file dl_matrix_clip_tracker.h.

{ matrix_ = DlMatrix(); }

Referenced by flutter::DisplayListBuilder::TransformReset().

setTransform()

void flutter::DisplayListMatrixClipState::setTransform ( const DlMatrix &  matrix )

inline

Definition at line 89 of file dl_matrix_clip_tracker.h.

{ matrix_ = matrix; }

References matrix().

Referenced by flutter::PrerollDelegate::integralTransform(), flutter::testing::TEST(), and flutter::DisplayListBuilder::TransformReset().

skew()

void flutter::DisplayListMatrixClipState::skew ( DlScalar  skx, DlScalar  sky  )

inline

Definition at line 58 of file dl_matrix_clip_tracker.h.

                                        {
    matrix_ = matrix_ * DlMatrix::MakeSkew(skx, sky);
  }

References impeller::Matrix::MakeSkew().

Referenced by flutter::DisplayListBuilder::Skew(), and flutter::testing::TEST().

transform()

void flutter::DisplayListMatrixClipState::transform ( const DlMatrix &  matrix )

inline

Definition at line 64 of file dl_matrix_clip_tracker.h.

{ matrix_ = matrix_ * matrix; }

References matrix().

Referenced by flutter::testing::TEST(), and flutter::PrerollDelegate::transform().

transform2DAffine()

void flutter::DisplayListMatrixClipState::transform2DAffine ( DlScalar  mxx, DlScalar  mxy, DlScalar  mxt, DlScalar  myx, DlScalar  myy, DlScalar  myt  )

inline

Definition at line 66 of file dl_matrix_clip_tracker.h.

                                                {
    matrix_ = matrix_ * DlMatrix::MakeColumn(
         mxx,  myx, 0.0f, 0.0f,
         mxy,  myy, 0.0f, 0.0f,
        0.0f, 0.0f, 1.0f, 0.0f,
         mxt,  myt, 0.0f, 1.0f
    );
  }

References impeller::Matrix::MakeColumn().

Referenced by flutter::testing::TEST(), and flutter::DisplayListBuilder::Transform2DAffine().

TransformedOvalCoversBounds()

bool flutter::DisplayListMatrixClipState::TransformedOvalCoversBounds ( const DlRect &  local_oval_bounds, const DlMatrix &  matrix, const DlRect &  cull_bounds  )

static

Checks if an oval defined by the local bounds, when transformed by the matrix, completely covers the indicated culling bounds.

This utility method helps answer the question of whether a clip oval being intersected under a transform is essentially obsolete because it will not reduce the already existing clip culling bounds.

Definition at line 290 of file dl_matrix_clip_tracker.cc.

                               {
  if (local_oval_bounds.IsEmpty()) {
    return false;
  }
  if (cull_bounds.IsEmpty()) {
    return true;
  }
  DlPoint corners[4];
  if (!GetLocalCorners(corners, cull_bounds, matrix)) {
    return false;
  }
  DlPoint center = local_oval_bounds.GetCenter();
  DlSize scale = 2.0 / local_oval_bounds.GetSize();
  for (auto corner : corners) {
    if (!local_oval_bounds.Contains(corner)) {
      return false;
    }
    if (((corner - center) * scale).GetLengthSquared() >= 1.0) {
      return false;
    }
  }
  return true;
}

References impeller::TRect< T >::Contains(), impeller::TRect< T >::GetCenter(), impeller::TRect< T >::GetSize(), impeller::TRect< T >::IsEmpty(), matrix(), and scale().

Referenced by oval_covers_cull(), flutter::testing::TEST(), flutter::testing::TEST(), flutter::testing::TEST(), TransformedRoundSuperellipseCoversBounds(), and TransformedRRectCoversBounds().

TransformedRectCoversBounds()

bool flutter::DisplayListMatrixClipState::TransformedRectCoversBounds ( const DlRect &  local_rect, const DlMatrix &  matrix, const DlRect &  cull_bounds  )

static

Checks if the local rect, when transformed by the matrix, completely covers the indicated culling bounds.

This utility method helps answer the question of whether a clip rectangle being intersected under a transform is essentially obsolete because it will not reduce the already existing clip culling bounds.

Definition at line 258 of file dl_matrix_clip_tracker.cc.

                               {
  if (local_rect.IsEmpty()) {
    return false;
  }
  if (cull_bounds.IsEmpty()) {
    return true;
  }
  if (matrix.IsAligned2D()) {
    // This transform-to-device calculation is faster and more accurate
    // for rect-to-rect aligned transformations, but not accurate under
    // (non-quadrant) rotations and skews.
    return local_rect.TransformAndClipBounds(matrix).Contains(cull_bounds);
  }
  DlPoint corners[4];
  if (!GetLocalCorners(corners, cull_bounds, matrix)) {
    return false;
  }
  for (auto corner : corners) {
    if (!local_rect.ContainsInclusive(corner)) {
      return false;
    }
  }
  return true;
}

References impeller::TRect< T >::Contains(), impeller::TRect< T >::ContainsInclusive(), impeller::Matrix::IsAligned2D(), impeller::TRect< T >::IsEmpty(), matrix(), and impeller::TRect< T >::TransformAndClipBounds().

Referenced by rect_covers_cull(), flutter::testing::TEST(), flutter::testing::TEST(), flutter::testing::TEST(), flutter::testing::TEST(), TransformedRoundSuperellipseCoversBounds(), and TransformedRRectCoversBounds().

TransformedRoundSuperellipseCoversBounds()

bool flutter::DisplayListMatrixClipState::TransformedRoundSuperellipseCoversBounds ( const DlRoundSuperellipse &  local_rse, const DlMatrix &  matrix, const DlRect &  cull_bounds  )

static

Checks if the local round superellipse, when transformed by the matrix, completely covers the indicated culling bounds.

This utility method helps answer the question of whether a clip round superellipse being intersected under a transform is essentially obsolete because it will not reduce the already existing clip culling bounds.

Definition at line 370 of file dl_matrix_clip_tracker.cc.

                               {
  if (local_rse.IsEmpty()) {
    return false;
  }
  if (cull_bounds.IsEmpty()) {
    return true;
  }
  if (local_rse.IsRect()) {
    return TransformedRectCoversBounds(local_rse.GetBounds(), matrix,
                                       cull_bounds);
  }
  if (local_rse.IsOval()) {
    return TransformedOvalCoversBounds(local_rse.GetBounds(), matrix,
                                       cull_bounds);
  }
  DlPoint corners[4];
  if (!GetLocalCorners(corners, cull_bounds, matrix)) {
    return false;
  }
  auto outer = local_rse.GetBounds();
  auto param = impeller::RoundSuperellipseParam::MakeBoundsRadii(
      outer, local_rse.GetRadii());
  for (auto corner : corners) {
    if (!outer.Contains(corner)) {
      return false;
    }
    if (!param.Contains(corner)) {
      return false;
    }
  }
  return true;
}

References impeller::RoundSuperellipse::GetBounds(), impeller::RoundSuperellipse::GetRadii(), impeller::TRect< T >::IsEmpty(), impeller::RoundSuperellipse::IsEmpty(), impeller::RoundSuperellipse::IsOval(), impeller::RoundSuperellipse::IsRect(), impeller::RoundSuperellipseParam::MakeBoundsRadii(), matrix(), TransformedOvalCoversBounds(), and TransformedRectCoversBounds().

Referenced by rsuperellipse_covers_cull().

TransformedRRectCoversBounds()

bool flutter::DisplayListMatrixClipState::TransformedRRectCoversBounds ( const DlRoundRect &  local_rrect, const DlMatrix &  matrix, const DlRect &  cull_bounds  )

static

Checks if the local round rect, when transformed by the matrix, completely covers the indicated culling bounds.

This utility method helps answer the question of whether a clip rrect being intersected under a transform is essentially obsolete because it will not reduce the already existing clip culling bounds.

Definition at line 322 of file dl_matrix_clip_tracker.cc.

                               {
  if (local_rrect.IsEmpty()) {
    return false;
  }
  if (cull_bounds.IsEmpty()) {
    return true;
  }
  if (local_rrect.IsRect()) {
    return TransformedRectCoversBounds(local_rrect.GetBounds(), matrix,
                                       cull_bounds);
  }
  if (local_rrect.IsOval()) {
    return TransformedOvalCoversBounds(local_rrect.GetBounds(), matrix,
                                       cull_bounds);
  }
  if (!local_rrect.GetRadii().AreAllCornersSame()) {
    return false;
  }
  DlPoint corners[4];
  if (!GetLocalCorners(corners, cull_bounds, matrix)) {
    return false;
  }
  auto outer = local_rrect.GetBounds();
  auto center = outer.GetCenter();
  auto radii = local_rrect.GetRadii().top_left;
  auto inner = outer.GetSize() * 0.5 - radii;
  auto scale = 1.0 / radii;
  for (auto corner : corners) {
    if (!outer.Contains(corner)) {
      return false;
    }
    auto rel = (corner - center).Abs() - inner;
    if (rel.x > 0.0f && rel.y > 0.0f &&
        (rel * scale).GetLengthSquared() >= 1.0f) {
      return false;
    }
  }
  return true;
}

References impeller::RoundingRadii::AreAllCornersSame(), impeller::RoundRect::GetBounds(), impeller::RoundRect::GetRadii(), impeller::TRect< T >::IsEmpty(), impeller::RoundRect::IsEmpty(), impeller::RoundRect::IsOval(), impeller::RoundRect::IsRect(), matrix(), scale(), impeller::RoundingRadii::top_left, TransformedOvalCoversBounds(), and TransformedRectCoversBounds().

Referenced by rrect_covers_cull(), and flutter::testing::TEST().

transformFullPerspective()

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

inline

Definition at line 76 of file dl_matrix_clip_tracker.h.

                                                              {
    matrix_ = matrix_ * DlMatrix::MakeColumn(
        mxx, myx, mzx, mwx,
        mxy, myy, mzy, mwy,
        mxz, myz, mzz, mwz,
        mxt, myt, mzt, mwt
    );
  }

References impeller::Matrix::MakeColumn().

Referenced by flutter::testing::TEST(), flutter::testing::TEST(), and flutter::DisplayListBuilder::TransformFullPerspective().

translate()

void flutter::DisplayListMatrixClipState::translate ( DlScalar  tx, DlScalar  ty  )

inline

Definition at line 52 of file dl_matrix_clip_tracker.h.

                                           {
    matrix_ = matrix_.Translate({tx, ty});
  }

References impeller::Matrix::Translate().

Referenced by flutter::testing::TEST(), flutter::DisplayListBuilder::Translate(), and flutter::PrerollDelegate::translate().

using_4x4_matrix()

bool flutter::DisplayListMatrixClipState::using_4x4_matrix ( ) const

inline

Definition at line 35 of file dl_matrix_clip_tracker.h.

{ return !matrix_.IsAffine(); }

References impeller::Matrix::IsAffine().

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

---

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

• display_list/utils/dl_matrix_clip_tracker.h
• display_list/utils/dl_matrix_clip_tracker.cc