summaryrefslogtreecommitdiffstats
path: root/dom/svg/DOMSVGTransformList.h
diff options
context:
space:
mode:
authorDaniel Baumann <daniel.baumann@progress-linux.org>2024-04-07 09:22:09 +0000
committerDaniel Baumann <daniel.baumann@progress-linux.org>2024-04-07 09:22:09 +0000
commit43a97878ce14b72f0981164f87f2e35e14151312 (patch)
tree620249daf56c0258faa40cbdcf9cfba06de2a846 /dom/svg/DOMSVGTransformList.h
parentInitial commit. (diff)
downloadfirefox-upstream.tar.xz
firefox-upstream.zip
Adding upstream version 110.0.1.upstream/110.0.1upstream
Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>
Diffstat (limited to 'dom/svg/DOMSVGTransformList.h')
-rw-r--r--dom/svg/DOMSVGTransformList.h198
1 files changed, 198 insertions, 0 deletions
diff --git a/dom/svg/DOMSVGTransformList.h b/dom/svg/DOMSVGTransformList.h
new file mode 100644
index 0000000000..2bfb975c71
--- /dev/null
+++ b/dom/svg/DOMSVGTransformList.h
@@ -0,0 +1,198 @@
+/* -*- 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_DOMSVGTRANSFORMLIST_H_
+#define DOM_SVG_DOMSVGTRANSFORMLIST_H_
+
+#include "DOMSVGAnimatedTransformList.h"
+#include "mozAutoDocUpdate.h"
+#include "nsCycleCollectionParticipant.h"
+#include "nsDebug.h"
+#include "SVGTransformList.h"
+#include "nsTArray.h"
+#include "mozilla/Attributes.h"
+
+namespace mozilla {
+class ErrorResult;
+
+namespace dom {
+struct DOMMatrix2DInit;
+class DOMSVGTransform;
+class SVGElement;
+class SVGMatrix;
+
+//----------------------------------------------------------------------
+// Helper class: AutoChangeTransformListNotifier
+// Stack-based helper class to pair calls to WillChangeTransformList and
+// DidChangeTransformList. Used by DOMSVGTransform and DOMSVGTransformList.
+template <class T>
+class MOZ_RAII AutoChangeTransformListNotifier {
+ public:
+ explicit AutoChangeTransformListNotifier(T* aValue) : mValue(aValue) {
+ MOZ_ASSERT(mValue, "Expecting non-null value");
+ // If we don't have an owner then changes don't affect anything else.
+ if (mValue->HasOwner()) {
+ mUpdateBatch.emplace(mValue->Element()->GetComposedDoc(), true);
+ mEmptyOrOldValue =
+ mValue->Element()->WillChangeTransformList(mUpdateBatch.ref());
+ }
+ }
+
+ ~AutoChangeTransformListNotifier() {
+ if (mValue->HasOwner()) {
+ mValue->Element()->DidChangeTransformList(mEmptyOrOldValue,
+ mUpdateBatch.ref());
+ if (mValue->IsAnimating()) {
+ mValue->Element()->AnimationNeedsResample();
+ }
+ }
+ }
+
+ private:
+ T* const mValue;
+ Maybe<mozAutoDocUpdate> mUpdateBatch;
+ nsAttrValue mEmptyOrOldValue;
+};
+
+/**
+ * Class DOMSVGTransformList
+ *
+ * This class is used to create the DOM tearoff objects that wrap internal
+ * SVGTransformList objects.
+ *
+ * See the architecture comment in DOMSVGAnimatedTransformList.h.
+ */
+class DOMSVGTransformList final : public nsISupports, public nsWrapperCache {
+ template <class T>
+ friend class AutoChangeTransformListNotifier;
+ friend class dom::DOMSVGTransform;
+
+ ~DOMSVGTransformList() {
+ // Our mAList's weak ref to us must be nulled out when we die. If GC has
+ // unlinked us using the cycle collector code, then that has already
+ // happened, and mAList is null.
+ if (mAList) {
+ (IsAnimValList() ? mAList->mAnimVal : mAList->mBaseVal) = nullptr;
+ }
+ }
+
+ public:
+ NS_DECL_CYCLE_COLLECTING_ISUPPORTS
+ NS_DECL_CYCLE_COLLECTION_SCRIPT_HOLDER_CLASS(DOMSVGTransformList)
+
+ DOMSVGTransformList(dom::DOMSVGAnimatedTransformList* aAList,
+ const SVGTransformList& aInternalList)
+ : mAList(aAList) {
+ // aInternalList must be passed in explicitly because we can't use
+ // InternalList() here. (Because it depends on IsAnimValList, which depends
+ // on this object having been assigned to aAList's mBaseVal or mAnimVal,
+ // which hasn't happened yet.)
+
+ InternalListLengthWillChange(aInternalList.Length()); // Sync mItems
+ }
+
+ JSObject* WrapObject(JSContext* cx,
+ JS::Handle<JSObject*> aGivenProto) override;
+
+ nsISupports* GetParentObject() { return static_cast<nsIContent*>(Element()); }
+
+ /**
+ * This will normally be the same as InternalList().Length(), except if we've
+ * hit OOM in which case our length will be zero.
+ */
+ uint32_t LengthNoFlush() const {
+ MOZ_ASSERT(mItems.IsEmpty() || mItems.Length() == InternalList().Length(),
+ "DOM wrapper's list length is out of sync");
+ return mItems.Length();
+ }
+
+ /// Called to notify us to synchronize our length and detach excess items.
+ void InternalListLengthWillChange(uint32_t aNewLength);
+
+ /*
+ * List classes always have an owner. We need this so that templates that work
+ * on lists and elements can check ownership where elements may be unowned.
+ */
+ bool HasOwner() const { return true; }
+
+ /**
+ * Returns true if our attribute is animating (in which case our animVal is
+ * not simply a mirror of our baseVal).
+ */
+ bool IsAnimating() const { return mAList->IsAnimating(); }
+ /**
+ * Returns true if there is an animated list mirroring the base list.
+ */
+ bool AnimListMirrorsBaseList() const {
+ return mAList->mAnimVal && !mAList->IsAnimating();
+ }
+
+ uint32_t NumberOfItems() const {
+ if (IsAnimValList()) {
+ Element()->FlushAnimations();
+ }
+ return LengthNoFlush();
+ }
+ void Clear(ErrorResult& error);
+ already_AddRefed<dom::DOMSVGTransform> Initialize(
+ dom::DOMSVGTransform& newItem, ErrorResult& error);
+ already_AddRefed<dom::DOMSVGTransform> GetItem(uint32_t index,
+ ErrorResult& error);
+ already_AddRefed<dom::DOMSVGTransform> IndexedGetter(uint32_t index,
+ bool& found,
+ ErrorResult& error);
+ already_AddRefed<dom::DOMSVGTransform> InsertItemBefore(
+ dom::DOMSVGTransform& newItem, uint32_t index, ErrorResult& error);
+ already_AddRefed<dom::DOMSVGTransform> ReplaceItem(
+ dom::DOMSVGTransform& newItem, uint32_t index, ErrorResult& error);
+ already_AddRefed<dom::DOMSVGTransform> RemoveItem(uint32_t index,
+ ErrorResult& error);
+ already_AddRefed<dom::DOMSVGTransform> AppendItem(
+ dom::DOMSVGTransform& newItem, ErrorResult& error) {
+ return InsertItemBefore(newItem, LengthNoFlush(), error);
+ }
+ already_AddRefed<dom::DOMSVGTransform> CreateSVGTransformFromMatrix(
+ const DOMMatrix2DInit& aMatrix, ErrorResult& aRv);
+ already_AddRefed<dom::DOMSVGTransform> Consolidate(ErrorResult& error);
+ uint32_t Length() const { return NumberOfItems(); }
+
+ private:
+ dom::SVGElement* Element() const { return mAList->mElement; }
+
+ /// Used to determine if this list is the baseVal or animVal list.
+ bool IsAnimValList() const {
+ MOZ_ASSERT(this == mAList->mBaseVal || this == mAList->mAnimVal,
+ "Calling IsAnimValList() too early?!");
+ return this == mAList->mAnimVal;
+ }
+
+ /**
+ * Get a reference to this object's corresponding internal SVGTransformList.
+ *
+ * To simplify the code we just have this one method for obtaining both
+ * baseVal and animVal internal lists. This means that animVal lists don't
+ * get const protection, but our setter methods guard against changing
+ * animVal lists.
+ */
+ SVGTransformList& InternalList() const;
+
+ /// Returns the DOMSVGTransform at aIndex, creating it if necessary.
+ already_AddRefed<dom::DOMSVGTransform> GetItemAt(uint32_t aIndex);
+
+ void MaybeInsertNullInAnimValListAt(uint32_t aIndex);
+ void MaybeRemoveItemFromAnimValListAt(uint32_t aIndex);
+
+ // Weak refs to our DOMSVGTransform items. The items are friends and take care
+ // of clearing our pointer to them when they die.
+ FallibleTArray<dom::DOMSVGTransform*> mItems;
+
+ RefPtr<dom::DOMSVGAnimatedTransformList> mAList;
+};
+
+} // namespace dom
+} // namespace mozilla
+
+#endif // DOM_SVG_DOMSVGTRANSFORMLIST_H_