Monitor the intersection of video and viewport.

third_party/WebKit/Source/core/dom/ElementVisibilityObserver.h

 // Copyright 2016 The Chromium Authors. All rights reserved.
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
 #ifndef ElementVisibilityObserver_h
 #define ElementVisibilityObserver_h
 
 #include "core/CoreExport.h"
 #include "core/dom/IntersectionObserver.h"
 #include "platform/heap/Heap.h"
 #include "platform/heap/Member.h"
+#include "public/platform/WebRect.h"
 
 namespace blink {
 
 class Element;
 
+// Base class for ElementVisibilityObserver and
+// ElementViewportIntersectionObserver.
+class CORE_EXPORT VisibilityObserverBase
+    : public GarbageCollectedFinalized<VisibilityObserverBase> {
+  WTF_MAKE_NONCOPYABLE(VisibilityObserverBase);
+
+ public:
+  VisibilityObserverBase(Element*, const Vector<float>&);
+  virtual ~VisibilityObserverBase();
+
+  virtual void onVisibilityChanged(
+      const HeapVector<Member<IntersectionObserverEntry>>& entries) = 0;
+  void start();
+  void stop();
+
+  DECLARE_VIRTUAL_TRACE();
+
+ protected:
+  Member<Element> m_element;
+  Vector<float> m_thresholds;
+  Member<IntersectionObserver> m_intersectionObserver;
+};
+
 // ElementVisibilityObserver is a helper class to be used to track the
 // visibility of an Element in the viewport. Creating an
 // ElementVisibilityObserver is a no-op with regards to CPU cycle. The observing
 // has be started by calling |start()| and can be stopped with |stop()|.
 // When creating an instance, the caller will have to pass a callback taking
 // a boolean as an argument. The boolean will be the new visibility state.
 // The ElementVisibilityObserver is implemented on top of IntersectionObserver.
 // It is a layer meant to simplify the usage for C++ Blink code checking for the
 // visibility of an element.
 class CORE_EXPORT ElementVisibilityObserver final
-    : public GarbageCollectedFinalized<ElementVisibilityObserver> {
+    : public VisibilityObserverBase {
   WTF_MAKE_NONCOPYABLE(ElementVisibilityObserver);
 
  public:
   using VisibilityCallback = Function<void(bool), WTF::SameThreadAffinity>;
 
   ElementVisibilityObserver(Element*, std::unique_ptr<VisibilityCallback>);
-  virtual ~ElementVisibilityObserver();
-
-  void start();
-  void stop();
+  ~ElementVisibilityObserver() final;
 
   void deliverObservationsForTesting();
 
-  DECLARE_VIRTUAL_TRACE();
-
  private:
   class ElementVisibilityCallback;
 
   void onVisibilityChanged(
-      const HeapVector<Member<IntersectionObserverEntry>>&);
+      const HeapVector<Member<IntersectionObserverEntry>>&) final;
+  std::unique_ptr<VisibilityCallback> m_callback;
+};
 
-  Member<Element> m_element;
-  Member<IntersectionObserver> m_intersectionObserver;
-  std::unique_ptr<VisibilityCallback> m_callback;
+// ElementViewportIntersectionObserver monitors the intersection between
+// observed element and viewport.
+// Creating an ElementViewportIntersectionObserver is a no-op with regards to
+// CPU cycle. The observing has be started by calling |start()| and can be
+// stopped with |stop()|. When creating an instance, the caller will have to
+// pass a callback taking the rootRect and the intersectRect as arguments.
+class ElementViewportIntersectionObserver final
+    : public VisibilityObserverBase {
+  WTF_MAKE_NONCOPYABLE(ElementViewportIntersectionObserver);
+
+ public:
+  using RatioChangeCallback =
+      Function<void(const WebRect&, const WebRect&), WTF::SameThreadAffinity>;
+
+  ElementViewportIntersectionObserver(Element*,
+                                      std::unique_ptr<RatioChangeCallback>);
+  ~ElementViewportIntersectionObserver() final;
+
+ private:
+  void onVisibilityChanged(
+      const HeapVector<Member<IntersectionObserverEntry>>&) final;
+  std::unique_ptr<RatioChangeCallback> m_callback;
 };
 
 }  // namespace blink
 
 #endif  // ElementVisibilityObserver_h