flutter::DisplayListMatrixClipState Class Reference

#include <dl_matrix_clip_tracker.h>

Public Member Functions
	DisplayListMatrixClipState (const DlRect &cull_rect, const DlMatrix &matrix=DlMatrix())
	DisplayListMatrixClipState (const SkRect &cull_rect)
	DisplayListMatrixClipState (const SkRect &cull_rect, const SkMatrix &matrix)
	DisplayListMatrixClipState (const SkRect &cull_rect, const SkM44 &matrix)
	DisplayListMatrixClipState (const DisplayListMatrixClipState &other)=default
void	resetDeviceCullRect (const DlRect &cull_rect)
void	resetDeviceCullRect (const SkRect &cull_rect)
void	resetLocalCullRect (const DlRect &cull_rect)
void	resetLocalCullRect (const SkRect &cull_rect)
bool	using_4x4_matrix () const
bool	is_matrix_invertable () const
bool	has_perspective () const
const DlMatrix &	matrix () const
SkM44	matrix_4x4 () const
SkMatrix	matrix_3x3 () const
SkRect	local_cull_rect () const
SkRect	device_cull_rect () const
bool	rect_covers_cull (const DlRect &content) const
bool	rect_covers_cull (const SkRect &content) const
bool	oval_covers_cull (const DlRect &content_bounds) const
bool	oval_covers_cull (const SkRect &content_bounds) const
bool	rrect_covers_cull (const SkRRect &content) const
bool	content_culled (const DlRect &content_bounds) const
bool	content_culled (const SkRect &content_bounds) const
bool	is_cull_rect_empty () const
void	translate (SkScalar tx, SkScalar ty)
void	scale (SkScalar sx, SkScalar sy)
void	skew (SkScalar skx, SkScalar sky)
void	rotate (SkScalar degrees)
void	transform (const DlMatrix &matrix)
void	transform (const SkM44 &m44)
void	transform (const SkMatrix &matrix)
void	transform2DAffine (SkScalar mxx, SkScalar mxy, SkScalar mxt, SkScalar myx, SkScalar myy, SkScalar myt)
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)
void	setTransform (const DlMatrix &matrix)
void	setTransform (const SkMatrix &matrix)
void	setTransform (const SkM44 &m44)
void	setIdentity ()
bool	inverseTransform (const DisplayListMatrixClipState &other_tracker)
bool	mapRect (DlRect *rect) const
bool	mapRect (const DlRect &src, DlRect *mapped) const
bool	mapRect (SkRect *rect) const
bool	mapRect (const SkRect &src, SkRect *mapped) const
bool	mapAndClipRect (SkRect *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. More...
bool	mapAndClipRect (const SkRect &src, SkRect *mapped) const
void	clipRect (const DlRect &rect, ClipOp op, bool is_aa)
void	clipRect (const SkRect &rect, ClipOp op, bool is_aa)
void	clipRRect (const SkRRect &rrect, ClipOp op, bool is_aa)
void	clipPath (const SkPath &path, ClipOp op, bool is_aa)

Static Public Member Functions
static bool	is_3x3 (const SkM44 &m44)

Detailed Description

Definition at line 23 of file dl_matrix_clip_tracker.h.

Constructor & Destructor Documentation

DisplayListMatrixClipState() [1/5]

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

explicit

Definition at line 33 of file dl_matrix_clip_tracker.cc.

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

DisplayListMatrixClipState() [2/5]

flutter::DisplayListMatrixClipState::DisplayListMatrixClipState ( const SkRect &  cull_rect )

explicit

Definition at line 37 of file dl_matrix_clip_tracker.cc.

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

DisplayListMatrixClipState() [3/5]

flutter::DisplayListMatrixClipState::DisplayListMatrixClipState	(	const SkRect &	cull_rect,
		const SkMatrix &	matrix
	)

Definition at line 40 of file dl_matrix_clip_tracker.cc.

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

DisplayListMatrixClipState() [4/5]

flutter::DisplayListMatrixClipState::DisplayListMatrixClipState	(	const SkRect &	cull_rect,
		const SkM44 &	matrix
	)

Definition at line 44 of file dl_matrix_clip_tracker.cc.

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

DisplayListMatrixClipState() [5/5]

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

default

Member Function Documentation

clipPath()

void flutter::DisplayListMatrixClipState::clipPath	(	const SkPath &	path,
		ClipOp	op,
		bool	is_aa
	)

Definition at line 108 of file dl_matrix_clip_tracker.cc.

                                                      {
  // Map "kDifference of inverse path" to "kIntersect of the original path" and
  // map "kIntersect of inverse path" to "kDifference of the original path"
  if (path.isInverseFillType()) {
    switch (op) {
      case ClipOp::kIntersect:
        op = ClipOp::kDifference;
        break;
      case ClipOp::kDifference:
        op = ClipOp::kIntersect;
        break;
    }
  }
 
  DlRect bounds = ToDlRect(path.getBounds());
  if (path.isRect(nullptr)) {
    return clipRect(bounds, op, is_aa);
  }
  switch (op) {
    case ClipOp::kIntersect:
      adjustCullRect(bounds, op, is_aa);
      break;
    case ClipOp::kDifference:
      break;
  }
}

clipRect() [1/2]

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

Definition at line 69 of file dl_matrix_clip_tracker.cc.

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

clipRect() [2/2]

void flutter::DisplayListMatrixClipState::clipRect ( const SkRect &  rect, ClipOp  op, bool  is_aa  )

inline

Definition at line 149 of file dl_matrix_clip_tracker.h.

                                                           {
    clipRect(ToDlRect(rect), op, is_aa);
  }

clipRRect()

void flutter::DisplayListMatrixClipState::clipRRect	(	const SkRRect &	rrect,
		ClipOp	op,
		bool	is_aa
	)

Definition at line 77 of file dl_matrix_clip_tracker.cc.

                                                       {
  DlRect bounds = ToDlRect(rrect.getBounds());
  if (rrect.isRect()) {
    return clipRect(bounds, op, is_aa);
  }
  switch (op) {
    case ClipOp::kIntersect:
      adjustCullRect(bounds, op, is_aa);
      break;
    case ClipOp::kDifference: {
      if (rrect_covers_cull(rrect)) {
        cull_rect_ = DlRect();
        return;
      }
      auto upper_left = rrect.radii(SkRRect::kUpperLeft_Corner);
      auto upper_right = rrect.radii(SkRRect::kUpperRight_Corner);
      auto lower_left = rrect.radii(SkRRect::kLowerLeft_Corner);
      auto lower_right = rrect.radii(SkRRect::kLowerRight_Corner);
      DlRect safe = bounds.Expand(-std::max(upper_left.fX, lower_left.fX), 0,
                                  -std::max(upper_right.fX, lower_right.fX), 0);
      adjustCullRect(safe, op, is_aa);
      safe = bounds.Expand(0, -std::max(upper_left.fY, upper_right.fY),  //
                           0, -std::max(lower_left.fY, lower_right.fY));
      adjustCullRect(safe, op, is_aa);
      break;
    }
  }
}

content_culled() [1/2]

bool flutter::DisplayListMatrixClipState::content_culled

(

const DlRect &

content_bounds

)

const

Definition at line 137 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_);
}

content_culled() [2/2]

bool flutter::DisplayListMatrixClipState::content_culled ( const SkRect &  content_bounds ) const

inline

Definition at line 77 of file dl_matrix_clip_tracker.h.

                                                          {
    return content_culled(ToDlRect(content_bounds));
  }

device_cull_rect()

SkRect flutter::DisplayListMatrixClipState::device_cull_rect ( ) const

inline

Definition at line 64 of file dl_matrix_clip_tracker.h.

{ return ToSkRect(cull_rect_); }

has_perspective()

bool flutter::DisplayListMatrixClipState::has_perspective ( ) const

inline

Definition at line 57 of file dl_matrix_clip_tracker.h.

{ return matrix_.HasPerspective(); }

inverseTransform()

bool flutter::DisplayListMatrixClipState::inverseTransform

(

const DisplayListMatrixClipState &

other_tracker

)

Definition at line 48 of file dl_matrix_clip_tracker.cc.

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

is_3x3()

bool flutter::DisplayListMatrixClipState::is_3x3 ( const SkM44 &  m44 )

static

Definition at line 12 of file dl_matrix_clip_tracker.cc.

                                                      {
  // clang-format off
  return (                                      m.rc(0, 2) == 0 &&
                                                m.rc(1, 2) == 0 &&
          m.rc(2, 0) == 0 && m.rc(2, 1) == 0 && m.rc(2, 2) == 1 && m.rc(2, 3) == 0 &&
                                                m.rc(3, 2) == 0);
  // clang-format on
}

is_cull_rect_empty()

bool flutter::DisplayListMatrixClipState::is_cull_rect_empty ( ) const

inline

Definition at line 80 of file dl_matrix_clip_tracker.h.

{ return cull_rect_.IsEmpty(); }

is_matrix_invertable()

bool flutter::DisplayListMatrixClipState::is_matrix_invertable ( ) const

inline

Definition at line 56 of file dl_matrix_clip_tracker.h.

{ return matrix_.GetDeterminant() != 0.0f; }

local_cull_rect()

SkRect flutter::DisplayListMatrixClipState::local_cull_rect

(

)

const

Definition at line 216 of file dl_matrix_clip_tracker.cc.

                                                         {
  if (cull_rect_.IsEmpty()) {
    return SkRect::MakeEmpty();
  }
  if (!is_matrix_invertable()) {
    return SkRect::MakeEmpty();
  }
  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 ToSkRect(cull_rect_.TransformBounds(inverse));
}

mapAndClipRect() [1/2]

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

Definition at line 57 of file dl_matrix_clip_tracker.cc.

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

mapAndClipRect() [2/2]

bool flutter::DisplayListMatrixClipState::mapAndClipRect ( SkRect *  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 143 of file dl_matrix_clip_tracker.h.

                                          {
    return mapAndClipRect(*rect, rect);
  }

mapRect() [1/4]

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

inline

Definition at line 131 of file dl_matrix_clip_tracker.h.

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

mapRect() [2/4]

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

inline

Definition at line 136 of file dl_matrix_clip_tracker.h.

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

mapRect() [3/4]

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

inline

Definition at line 130 of file dl_matrix_clip_tracker.h.

{ return mapRect(*rect, rect); }

mapRect() [4/4]

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

inline

Definition at line 135 of file dl_matrix_clip_tracker.h.

{ return mapRect(*rect, rect); }

matrix()

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

inline

Definition at line 59 of file dl_matrix_clip_tracker.h.

{ return matrix_; }

matrix_3x3()

SkMatrix flutter::DisplayListMatrixClipState::matrix_3x3 ( ) const

inline

Definition at line 61 of file dl_matrix_clip_tracker.h.

{ return ToSkMatrix(matrix_); }

matrix_4x4()

SkM44 flutter::DisplayListMatrixClipState::matrix_4x4 ( ) const

inline

Definition at line 60 of file dl_matrix_clip_tracker.h.

{ return SkM44::ColMajor(matrix_.m); }

oval_covers_cull() [1/2]

bool flutter::DisplayListMatrixClipState::oval_covers_cull

(

const DlRect &

content_bounds

)

const

Definition at line 260 of file dl_matrix_clip_tracker.cc.

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

oval_covers_cull() [2/2]

bool flutter::DisplayListMatrixClipState::oval_covers_cull ( const SkRect &  content_bounds ) const

inline

Definition at line 71 of file dl_matrix_clip_tracker.h.

                                                            {
    return oval_covers_cull(ToDlRect(content_bounds));
  }

rect_covers_cull() [1/2]

bool flutter::DisplayListMatrixClipState::rect_covers_cull

(

const DlRect &

content

)

const

Definition at line 235 of file dl_matrix_clip_tracker.cc.

                                                                             {
  if (content.IsEmpty()) {
    return false;
  }
  if (cull_rect_.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 content.TransformAndClipBounds(matrix_).Contains(cull_rect_);
  }
  DlPoint corners[4];
  if (!getLocalCullCorners(corners)) {
    return false;
  }
  for (auto corner : corners) {
    if (!content.ContainsInclusive(corner)) {
      return false;
    }
  }
  return true;
}

rect_covers_cull() [2/2]

bool flutter::DisplayListMatrixClipState::rect_covers_cull ( const SkRect &  content ) const

inline

Definition at line 67 of file dl_matrix_clip_tracker.h.

                                                     {
    return rect_covers_cull(ToDlRect(content));
  }

resetDeviceCullRect() [1/2]

void flutter::DisplayListMatrixClipState::resetDeviceCullRect

(

const DlRect &

cull_rect

)

Definition at line 153 of file dl_matrix_clip_tracker.cc.

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

resetDeviceCullRect() [2/2]

void flutter::DisplayListMatrixClipState::resetDeviceCullRect ( const SkRect &  cull_rect )

inline

Definition at line 47 of file dl_matrix_clip_tracker.h.

                                                    {
    resetDeviceCullRect(ToDlRect(cull_rect));
  }

resetLocalCullRect() [1/2]

void flutter::DisplayListMatrixClipState::resetLocalCullRect

(

const DlRect &

cull_rect

)

Definition at line 161 of file dl_matrix_clip_tracker.cc.

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

resetLocalCullRect() [2/2]

void flutter::DisplayListMatrixClipState::resetLocalCullRect ( const SkRect &  cull_rect )

inline

Definition at line 51 of file dl_matrix_clip_tracker.h.

                                                   {
    resetLocalCullRect(ToDlRect(cull_rect));
  }

rotate()

void flutter::DisplayListMatrixClipState::rotate ( SkScalar  degrees )

inline

Definition at line 91 of file dl_matrix_clip_tracker.h.

                                {
    matrix_ = matrix_ * DlMatrix::MakeRotationZ(DlDegrees(degrees));
  }

rrect_covers_cull()

bool flutter::DisplayListMatrixClipState::rrect_covers_cull

(

const SkRRect &

content

)

const

Definition at line 284 of file dl_matrix_clip_tracker.cc.

                                  {
  if (content.isEmpty()) {
    return false;
  }
  if (cull_rect_.IsEmpty()) {
    return true;
  }
  if (content.isRect()) {
    return rect_covers_cull(content.getBounds());
  }
  if (content.isOval()) {
    return oval_covers_cull(content.getBounds());
  }
  if (!content.isSimple()) {
    return false;
  }
  DlPoint corners[4];
  if (!getLocalCullCorners(corners)) {
    return false;
  }
  auto outer = content.getBounds();
  DlScalar x_center = outer.centerX();
  DlScalar y_center = outer.centerY();
  auto radii = content.getSimpleRadii();
  DlScalar inner_x = outer.width() * 0.5f - radii.fX;
  DlScalar inner_y = outer.height() * 0.5f - radii.fY;
  DlScalar scale_x = 1.0 / radii.fX;
  DlScalar scale_y = 1.0 / radii.fY;
  for (auto corner : corners) {
    if (!outer.contains(corner.x, corner.y)) {
      return false;
    }
    DlScalar x_rel = std::abs(corner.x - x_center) - inner_x;
    DlScalar y_rel = std::abs(corner.y - y_center) - inner_y;
    if (x_rel > 0.0f && y_rel > 0.0f) {
      x_rel *= scale_x;
      y_rel *= scale_y;
      if (x_rel * x_rel + y_rel * y_rel >= 1.0f) {
        return false;
      }
    }
  }
  return true;
}

scale()

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

inline

Definition at line 85 of file dl_matrix_clip_tracker.h.

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

setIdentity()

void flutter::DisplayListMatrixClipState::setIdentity ( )

inline

Definition at line 124 of file dl_matrix_clip_tracker.h.

{ matrix_ = DlMatrix(); }

setTransform() [1/3]

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

inline

Definition at line 121 of file dl_matrix_clip_tracker.h.

{ matrix_ = matrix; }

setTransform() [2/3]

void flutter::DisplayListMatrixClipState::setTransform ( const SkM44 &  m44 )

inline

Definition at line 123 of file dl_matrix_clip_tracker.h.

{ matrix_ = ToDlMatrix(m44); }

setTransform() [3/3]

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

inline

Definition at line 122 of file dl_matrix_clip_tracker.h.

{ matrix_ = ToDlMatrix(matrix); }

skew()

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

inline

Definition at line 88 of file dl_matrix_clip_tracker.h.

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

transform() [1/3]

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

inline

Definition at line 94 of file dl_matrix_clip_tracker.h.

{ matrix_ = matrix_ * matrix; }

transform() [2/3]

void flutter::DisplayListMatrixClipState::transform ( const SkM44 &  m44 )

inline

Definition at line 95 of file dl_matrix_clip_tracker.h.

{ transform(ToDlMatrix(m44)); }

transform() [3/3]

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

inline

Definition at line 96 of file dl_matrix_clip_tracker.h.

{ transform(ToDlMatrix(matrix)); }

transform2DAffine()

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

inline

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

transformFullPerspective()

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

inline

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

translate()

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

inline

Definition at line 82 of file dl_matrix_clip_tracker.h.

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

using_4x4_matrix()

bool flutter::DisplayListMatrixClipState::using_4x4_matrix ( ) const

inline

Definition at line 55 of file dl_matrix_clip_tracker.h.

{ return !matrix_.IsAffine(); }

---

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