summaryrefslogtreecommitdiffstats
path: root/dom/svg/SVGGeometryElement.h
diff options
context:
space:
mode:
Diffstat (limited to '')
-rw-r--r--dom/svg/SVGGeometryElement.h271
1 files changed, 271 insertions, 0 deletions
diff --git a/dom/svg/SVGGeometryElement.h b/dom/svg/SVGGeometryElement.h
new file mode 100644
index 0000000000..12576730ee
--- /dev/null
+++ b/dom/svg/SVGGeometryElement.h
@@ -0,0 +1,271 @@
+/* -*- Mode: C++; tab-width: 8; indent-tabs-mode: nil; c-basic-offset: 2 -*- */
+/* vim: set ts=8 sts=2 et sw=2 tw=80: */
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at http://mozilla.org/MPL/2.0/. */
+
+#ifndef DOM_SVG_SVGGEOMETRYELEMENT_H_
+#define DOM_SVG_SVGGEOMETRYELEMENT_H_
+
+#include "mozilla/dom/SVGGraphicsElement.h"
+#include "mozilla/gfx/2D.h"
+#include "mozilla/dom/SVGAnimatedNumber.h"
+
+namespace mozilla {
+
+struct SVGMark {
+ enum Type {
+ eStart,
+ eMid,
+ eEnd,
+
+ eTypeCount
+ };
+
+ float x, y, angle;
+ Type type;
+ SVGMark(float aX, float aY, float aAngle, Type aType)
+ : x(aX), y(aY), angle(aAngle), type(aType) {}
+};
+
+namespace dom {
+
+class DOMSVGAnimatedNumber;
+class DOMSVGPoint;
+
+using SVGGeometryElementBase = mozilla::dom::SVGGraphicsElement;
+
+class SVGGeometryElement : public SVGGeometryElementBase {
+ protected:
+ using CapStyle = mozilla::gfx::CapStyle;
+ using DrawTarget = mozilla::gfx::DrawTarget;
+ using FillRule = mozilla::gfx::FillRule;
+ using Float = mozilla::gfx::Float;
+ using Matrix = mozilla::gfx::Matrix;
+ using Path = mozilla::gfx::Path;
+ using Point = mozilla::gfx::Point;
+ using PathBuilder = mozilla::gfx::PathBuilder;
+ using Rect = mozilla::gfx::Rect;
+ using StrokeOptions = mozilla::gfx::StrokeOptions;
+
+ public:
+ explicit SVGGeometryElement(
+ already_AddRefed<mozilla::dom::NodeInfo>&& aNodeInfo);
+
+ NS_IMPL_FROMNODE_HELPER(SVGGeometryElement, IsSVGGeometryElement())
+
+ void AfterSetAttr(int32_t aNamespaceID, nsAtom* aName,
+ const nsAttrValue* aValue, const nsAttrValue* aOldValue,
+ nsIPrincipal* aSubjectPrincipal, bool aNotify) override;
+ bool IsSVGGeometryElement() const override { return true; }
+
+ /**
+ * Causes this element to discard any Path object that GetOrBuildPath may
+ * have cached.
+ */
+ void ClearAnyCachedPath() final { mCachedPath = nullptr; }
+
+ virtual bool AttributeDefinesGeometry(const nsAtom* aName);
+
+ /**
+ * Returns true if this element's geometry depends on the width or height of
+ * its coordinate context (typically the viewport established by its nearest
+ * <svg> ancestor). In other words, returns true if one of the attributes for
+ * which AttributeDefinesGeometry returns true has a percentage value.
+ *
+ * This could be moved up to a more general class so it can be used for
+ * non-leaf elements, but that would require care and for now there's no need.
+ */
+ bool GeometryDependsOnCoordCtx();
+
+ virtual bool IsMarkable();
+ virtual void GetMarkPoints(nsTArray<SVGMark>* aMarks);
+
+ /**
+ * A method that can be faster than using a Moz2D Path and calling GetBounds/
+ * GetStrokedBounds on it. It also helps us avoid rounding error for simple
+ * shapes and simple transforms where the Moz2D Path backends can fail to
+ * produce the clean integer bounds that content authors expect in some cases.
+ *
+ * If |aToNonScalingStrokeSpace| is non-null then |aBounds|, which is computed
+ * in bounds space, has the property that it's the smallest (axis-aligned)
+ * rectangular bound containing the image of this shape as stroked in
+ * non-scaling-stroke space. (When all transforms involved are rectilinear
+ * the bounds of the image of |aBounds| in non-scaling-stroke space will be
+ * tight, but if there are non-rectilinear transforms involved then that may
+ * be impossible and this method will return false).
+ *
+ * If |aToNonScalingStrokeSpace| is non-null then |*aToNonScalingStrokeSpace|
+ * must be non-singular.
+ */
+ virtual bool GetGeometryBounds(
+ Rect* aBounds, const StrokeOptions& aStrokeOptions,
+ const Matrix& aToBoundsSpace,
+ const Matrix* aToNonScalingStrokeSpace = nullptr) {
+ return false;
+ }
+
+ /**
+ * For use with GetAsSimplePath.
+ */
+ class SimplePath {
+ public:
+ SimplePath()
+ : mX(0.0), mY(0.0), mWidthOrX2(0.0), mHeightOrY2(0.0), mType(NONE) {}
+ bool IsPath() const { return mType != NONE; }
+ void SetRect(Float x, Float y, Float width, Float height) {
+ mX = x;
+ mY = y;
+ mWidthOrX2 = width;
+ mHeightOrY2 = height;
+ mType = RECT;
+ }
+ Rect AsRect() const {
+ MOZ_ASSERT(mType == RECT);
+ return Rect(mX, mY, mWidthOrX2, mHeightOrY2);
+ }
+ bool IsRect() const { return mType == RECT; }
+ void SetLine(Float x1, Float y1, Float x2, Float y2) {
+ mX = x1;
+ mY = y1;
+ mWidthOrX2 = x2;
+ mHeightOrY2 = y2;
+ mType = LINE;
+ }
+ Point Point1() const {
+ MOZ_ASSERT(mType == LINE);
+ return Point(mX, mY);
+ }
+ Point Point2() const {
+ MOZ_ASSERT(mType == LINE);
+ return Point(mWidthOrX2, mHeightOrY2);
+ }
+ bool IsLine() const { return mType == LINE; }
+ void Reset() { mType = NONE; }
+
+ private:
+ enum Type { NONE, RECT, LINE };
+ Float mX, mY, mWidthOrX2, mHeightOrY2;
+ Type mType;
+ };
+
+ /**
+ * For some platforms there is significant overhead to creating and painting
+ * a Moz2D Path object. For Rects and lines it is better to get the path data
+ * using this method and then use the optimized DrawTarget methods for
+ * filling/stroking rects and lines.
+ */
+ virtual void GetAsSimplePath(SimplePath* aSimplePath) {
+ aSimplePath->Reset();
+ }
+
+ /**
+ * Returns a Path that can be used to paint, hit-test or calculate bounds for
+ * this element. May return nullptr if there is no [valid] path. The path
+ * that is created may be cached and returned on subsequent calls.
+ */
+ virtual already_AddRefed<Path> GetOrBuildPath(const DrawTarget* aDrawTarget,
+ FillRule fillRule);
+
+ /**
+ * The same as GetOrBuildPath, but bypasses the cache (neither returns any
+ * previously cached Path, nor caches the Path that in does return).
+ * this element. May return nullptr if there is no [valid] path.
+ */
+ virtual already_AddRefed<Path> BuildPath(PathBuilder* aBuilder) = 0;
+
+ /**
+ * Get the distances from the origin of the path segments.
+ * For non-path elements that's just 0 and the total length of the shape.
+ */
+ virtual bool GetDistancesFromOriginToEndsOfVisibleSegments(
+ FallibleTArray<double>* aOutput) {
+ aOutput->Clear();
+ double distances[] = {0.0, GetTotalLength()};
+ return aOutput->AppendElements(Span<double>(distances), fallible);
+ }
+
+ /**
+ * Returns a Path that can be used to measure the length of this elements
+ * path, or to find the position at a given distance along it.
+ *
+ * This is currently equivalent to calling GetOrBuildPath, but it may not be
+ * in the future. The reason for this function to be separate from
+ * GetOrBuildPath is because SVGPathData::BuildPath inserts small lines into
+ * the path if zero length subpaths are encountered, in order to implement
+ * the SVG specifications requirements that zero length subpaths should
+ * render circles/squares if stroke-linecap is round/square, respectively.
+ * In principle these inserted lines could interfere with path measurement,
+ * so we keep callers that are looking to do measurement separate in case we
+ * run into problems with the inserted lines negatively affecting measuring
+ * for content.
+ */
+ virtual already_AddRefed<Path> GetOrBuildPathForMeasuring();
+
+ /**
+ * If this shape element is a closed loop, this returns true. If it is an
+ * unclosed interval, this returns false. This function is used for motion
+ * path especially.
+ *
+ * 1. SVG Paths are closed loops only if the final command in the path list is
+ * a closepath command ("z" or "Z"), otherwise they are unclosed intervals.
+ * 2. SVG circles, ellipses, polygons and rects are closed loops.
+ * 3. SVG lines and polylines are unclosed intervals.
+ *
+ * https://drafts.fxtf.org/motion/#path-distance
+ */
+ virtual bool IsClosedLoop() const { return false; }
+
+ /**
+ * Return |true| if some geometry properties (|x|, |y|, etc) are changed
+ * because of CSS change.
+ */
+ bool IsGeometryChangedViaCSS(ComputedStyle const& aNewStyle,
+ ComputedStyle const& aOldStyle) const;
+
+ /**
+ * Returns the current computed value of the CSS property 'fill-rule' for
+ * this element.
+ */
+ FillRule GetFillRule();
+
+ enum PathLengthScaleForType { eForTextPath, eForStroking };
+
+ /**
+ * Gets the ratio of the actual element's length to the content author's
+ * estimated length (as provided by the element's 'pathLength' attribute).
+ * This is used to scale stroke dashing, and to scale offsets along a
+ * textPath.
+ */
+ float GetPathLengthScale(PathLengthScaleForType aFor);
+
+ // WebIDL
+ already_AddRefed<DOMSVGAnimatedNumber> PathLength();
+ MOZ_CAN_RUN_SCRIPT bool IsPointInFill(const DOMPointInit& aPoint);
+ MOZ_CAN_RUN_SCRIPT bool IsPointInStroke(const DOMPointInit& aPoint);
+ MOZ_CAN_RUN_SCRIPT float GetTotalLengthForBinding();
+ MOZ_CAN_RUN_SCRIPT already_AddRefed<DOMSVGPoint> GetPointAtLength(
+ float distance, ErrorResult& rv);
+
+ protected:
+ // SVGElement method
+ NumberAttributesInfo GetNumberInfo() override;
+
+ // d is a presentation attribute, so we would like to make sure style is
+ // up-to-date. This function flushes the style if the path attribute is d.
+ MOZ_CAN_RUN_SCRIPT void FlushStyleIfNeeded();
+
+ SVGAnimatedNumber mPathLength;
+ static NumberInfo sNumberInfo;
+ mutable RefPtr<Path> mCachedPath;
+
+ private:
+ already_AddRefed<Path> GetOrBuildPathForHitTest();
+
+ float GetTotalLength();
+};
+
+} // namespace dom
+} // namespace mozilla
+
+#endif // DOM_SVG_SVGGEOMETRYELEMENT_H_