Flutter Impeller
impeller::CircleGeometry Class Referencefinal

#include <circle_geometry.h>

Inheritance diagram for impeller::CircleGeometry:
impeller::Geometry

Public Member Functions

 CircleGeometry (const Point &center, Scalar radius)
 
 CircleGeometry (const Point &center, Scalar radius, Scalar stroke_width)
 
 ~CircleGeometry () override
 
bool CoversArea (const Matrix &transform, const Rect &rect) const override
 Determines if this geometry, transformed by the given transform, will completely cover all surface area of the given rect. More...
 
bool IsAxisAlignedRect () const override
 
Scalar ComputeAlphaCoverage (const Matrix &transform) const override
 
Scalar GetRadius () const
 
Scalar GetStrokeWidth () const
 
Point GetCenter () const
 
std::optional< RectGetCoverage (const Matrix &transform) const override
 
GeometryResult GetPositionBuffer (const ContentContext &renderer, const Entity &entity, RenderPass &pass) const override
 
void SetAntialiasPadding (Scalar extra_pixels)
 
- Public Member Functions inherited from impeller::Geometry
virtual ~Geometry ()
 
virtual GeometryResult::Mode GetResultMode () const
 
virtual bool CanApplyMaskFilter () const
 

Additional Inherited Members

- Static Public Member Functions inherited from impeller::Geometry
static std::unique_ptr< GeometryMakeFillPath (const flutter::DlPath &path, std::optional< Rect > inner_rect=std::nullopt)
 
static std::unique_ptr< GeometryMakeStrokePath (const flutter::DlPath &path, const StrokeParameters &stroke={})
 
static std::unique_ptr< GeometryMakeCover ()
 
static std::unique_ptr< GeometryMakeRect (const Rect &rect)
 
static std::unique_ptr< GeometryMakeOval (const Rect &rect)
 
static std::unique_ptr< GeometryMakeLine (const Point &p0, const Point &p1, const StrokeParameters &stroke)
 
static std::unique_ptr< GeometryMakeCircle (const Point &center, Scalar radius)
 
static std::unique_ptr< GeometryMakeStrokedCircle (const Point &center, Scalar radius, Scalar stroke_width)
 
static std::unique_ptr< GeometryMakeFilledArc (const Rect &oval_bounds, Degrees start, Degrees sweep, bool include_center)
 
static std::unique_ptr< GeometryMakeStrokedArc (const Rect &oval_bounds, Degrees start, Degrees sweep, const StrokeParameters &stroke)
 
static std::unique_ptr< GeometryMakeRoundRect (const Rect &rect, const Size &radii)
 
static std::unique_ptr< GeometryMakeRoundSuperellipse (const Rect &rect, Scalar corner_radius)
 
static Scalar ComputeStrokeAlphaCoverage (const Matrix &entity, Scalar stroke_width)
 Compute an alpha value to simulate lower coverage of fractional pixel strokes. More...
 
static GeometryResult ComputePositionGeometry (const ContentContext &renderer, const Tessellator::VertexGenerator &generator, const Entity &entity, RenderPass &pass)
 

Detailed Description

Definition at line 14 of file circle_geometry.h.

Constructor & Destructor Documentation

◆ CircleGeometry() [1/2]

impeller::CircleGeometry::CircleGeometry ( const Point center,
Scalar  radius 
)
explicit

Definition at line 16 of file circle_geometry.cc.

17  : center_(center),
18  radius_(radius),
19  stroke_width_(-1.0f),
20  padding_pixels_(0.0f) {
21  FML_DCHECK(radius >= 0);
22 }

◆ CircleGeometry() [2/2]

impeller::CircleGeometry::CircleGeometry ( const Point center,
Scalar  radius,
Scalar  stroke_width 
)
explicit

Definition at line 26 of file circle_geometry.cc.

29  : center_(center),
30  radius_(radius),
31  stroke_width_(std::max(stroke_width, 0.0f)),
32  padding_pixels_(0.0) {
33  FML_DCHECK(radius >= 0);
34  FML_DCHECK(stroke_width >= 0);
35 }

◆ ~CircleGeometry()

impeller::CircleGeometry::~CircleGeometry ( )
overridedefault

Member Function Documentation

◆ ComputeAlphaCoverage()

Scalar impeller::CircleGeometry::ComputeAlphaCoverage ( const Matrix transform) const
overridevirtual

Reimplemented from impeller::Geometry.

Definition at line 38 of file circle_geometry.cc.

38  {
39  if (stroke_width_ < 0) {
40  return 1;
41  }
42  return Geometry::ComputeStrokeAlphaCoverage(transform, stroke_width_);
43 }
static Scalar ComputeStrokeAlphaCoverage(const Matrix &entity, Scalar stroke_width)
Compute an alpha value to simulate lower coverage of fractional pixel strokes.
Definition: geometry.cc:149

References impeller::Geometry::ComputeStrokeAlphaCoverage(), and transform.

◆ CoversArea()

bool impeller::CircleGeometry::CoversArea ( const Matrix transform,
const Rect rect 
) const
overridevirtual

Determines if this geometry, transformed by the given transform, will completely cover all surface area of the given rect.

This is a conservative estimate useful for certain optimizations.

Returns
true if the transformed geometry is guaranteed to cover the given rect. May return false in many undetected cases where the transformed geometry does in fact cover the rect.

Reimplemented from impeller::Geometry.

Definition at line 96 of file circle_geometry.cc.

97  {
98  return false;
99 }

◆ GetCenter()

Point impeller::CircleGeometry::GetCenter ( ) const

Definition at line 45 of file circle_geometry.cc.

45  {
46  return center_;
47 }

◆ GetCoverage()

std::optional< Rect > impeller::CircleGeometry::GetCoverage ( const Matrix transform) const
overridevirtual

Implements impeller::Geometry.

Definition at line 84 of file circle_geometry.cc.

84  {
85  Scalar max_basis = transform.GetMaxBasisLengthXY();
86  Scalar expansion = max_basis == 0 ? 0.0 : padding_pixels_ / max_basis;
87 
88  Scalar half_width = stroke_width_ < 0 ? 0.0 : stroke_width_ * 0.5f;
89  Scalar outer_radius = radius_ + half_width + expansion;
90  return Rect::MakeLTRB(-outer_radius, -outer_radius, //
91  +outer_radius, +outer_radius)
92  .Shift(center_)
93  .TransformAndClipBounds(transform);
94 }
float Scalar
Definition: scalar.h:19
constexpr TRect< T > Shift(T dx, T dy) const
Returns a new rectangle translated by the given offset.
Definition: rect.h:602
constexpr static TRect MakeLTRB(Type left, Type top, Type right, Type bottom)
Definition: rect.h:129

References impeller::TRect< Scalar >::MakeLTRB(), impeller::TRect< T >::Shift(), and transform.

◆ GetPositionBuffer()

GeometryResult impeller::CircleGeometry::GetPositionBuffer ( const ContentContext renderer,
const Entity entity,
RenderPass pass 
) const
overridevirtual

Implements impeller::Geometry.

Definition at line 61 of file circle_geometry.cc.

63  {
64  auto& transform = entity.GetTransform();
65 
66  Scalar max_basis = transform.GetMaxBasisLengthXY();
67  Scalar expansion = max_basis == 0 ? 0.0 : padding_pixels_ / max_basis;
68 
69  if (stroke_width_ < 0) {
70  auto generator = renderer.GetTessellator().FilledCircle(
71  transform, center_, radius_ + expansion);
72  return ComputePositionGeometry(renderer, generator, entity, pass);
73  }
74 
75  Scalar half_width =
77 
78  auto generator = renderer.GetTessellator().StrokedCircle(
79  transform, center_, radius_, half_width + expansion);
80 
81  return ComputePositionGeometry(renderer, generator, entity, pass);
82 }
static GeometryResult ComputePositionGeometry(const ContentContext &renderer, const Tessellator::VertexGenerator &generator, const Entity &entity, RenderPass &pass)
Definition: geometry.cc:26
static Scalar ComputePixelHalfWidth(const Matrix &transform, Scalar width)

References impeller::LineGeometry::ComputePixelHalfWidth(), impeller::Geometry::ComputePositionGeometry(), impeller::Tessellator::FilledCircle(), impeller::ContentContext::GetTessellator(), impeller::Entity::GetTransform(), impeller::Tessellator::StrokedCircle(), and transform.

◆ GetRadius()

Scalar impeller::CircleGeometry::GetRadius ( ) const

Definition at line 49 of file circle_geometry.cc.

49  {
50  return radius_;
51 }

◆ GetStrokeWidth()

Scalar impeller::CircleGeometry::GetStrokeWidth ( ) const

Definition at line 53 of file circle_geometry.cc.

53  {
54  return stroke_width_;
55 }

◆ IsAxisAlignedRect()

bool impeller::CircleGeometry::IsAxisAlignedRect ( ) const
overridevirtual

Reimplemented from impeller::Geometry.

Definition at line 101 of file circle_geometry.cc.

101  {
102  return false;
103 }

◆ SetAntialiasPadding()

void impeller::CircleGeometry::SetAntialiasPadding ( Scalar  extra_pixels)

Definition at line 57 of file circle_geometry.cc.

57  {
58  padding_pixels_ = extra_padding;
59 }

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