Hook up BeginFrameSource to SurfaceFactoryClient via SurfaceManager

cc/surfaces/surface_manager_unittest.cc

+// 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.
+
+#include <stddef.h>
+
+#include "cc/scheduler/begin_frame_source.h"
+#include "cc/surfaces/surface_factory_client.h"
+#include "cc/surfaces/surface_manager.h"
+#include "testing/gtest/include/gtest/gtest.h"
+
+namespace cc {
+
+class FakeSurfaceFactoryClient : public SurfaceFactoryClient {
+ public:
+  explicit FakeSurfaceFactoryClient(int id_namespace)
+      : source_(nullptr), manager_(nullptr), id_namespace_(id_namespace) {}
+  FakeSurfaceFactoryClient(int id_namespace, SurfaceManager* manager)
+      : source_(nullptr), manager_(nullptr), id_namespace_(id_namespace) {
+    DCHECK(manager);
+    Register(manager);
+  }
+
+  ~FakeSurfaceFactoryClient() override {
+    if (manager_) {
+      Unregister();
+    }
+    EXPECT_EQ(source_, nullptr);
+  }
+
+  BeginFrameSource* source() { return source_; }
+  uint32_t id_namespace() { return id_namespace_; }
+
+  void Register(SurfaceManager* manager) {
+    EXPECT_EQ(manager_, nullptr);
+    manager_ = manager;
+    manager_->RegisterSurfaceFactoryClient(id_namespace_, this);
+  }
+
+  void Unregister() {
+    EXPECT_NE(manager_, nullptr);
+    manager_->UnregisterSurfaceFactoryClient(id_namespace_);
+    manager_ = nullptr;
+  }
+
+  // SurfaceFactoryClient implementation.
+  void ReturnResources(const ReturnedResourceArray& resources) override{};
+  void SetBeginFrameSource(BeginFrameSource* begin_frame_source) override {
+    DCHECK(!source_ || !begin_frame_source);
+    source_ = begin_frame_source;
+  };
+
+ private:
+  BeginFrameSource* source_;
+  SurfaceManager* manager_;
+  uint32_t id_namespace_;
+};
+
+class EmptyBeginFrameSource : public BeginFrameSource {
+ public:
+  void DidFinishFrame(size_t remaining_frames) override{};
+  void AddObserver(BeginFrameObserver* obs) override{};
+  void RemoveObserver(BeginFrameObserver* obs) override{};
+  void SetClientReady() override {}
+  void AsValueInto(base::trace_event::TracedValue* dict) const override{};
+};
+
+class SurfaceManagerTest : public testing::Test {
+ public:
+  // These tests don't care about namespace registration, so just preregister
+  // a set of namespaces that tests can use freely without worrying if they're
+  // valid or not.
+  enum { MAX_NAMESPACE = 10 };
+
+  SurfaceManagerTest() {
+    for (size_t i = 0; i < MAX_NAMESPACE; ++i)
+      manager_.RegisterSurfaceIdNamespace(i);
+  }
+
+  ~SurfaceManagerTest() override {
+    for (size_t i = 0; i < MAX_NAMESPACE; ++i)
+      manager_.InvalidateSurfaceIdNamespace(i);
+  }
+
+ protected:
+  SurfaceManager manager_;
+};
+
+TEST_F(SurfaceManagerTest, SingleClients) {
+  FakeSurfaceFactoryClient client(1);
+  FakeSurfaceFactoryClient other_client(2);
+  EmptyBeginFrameSource source;
+
+  EXPECT_EQ(client.source(), nullptr);
+  EXPECT_EQ(other_client.source(), nullptr);
+  client.Register(&manager_);
+  other_client.Register(&manager_);
+  EXPECT_EQ(client.source(), nullptr);
+  EXPECT_EQ(other_client.source(), nullptr);
+
+  // Test setting unsetting BFS
+  manager_.RegisterBeginFrameSource(&source, client.id_namespace());
+  EXPECT_EQ(client.source(), &source);
+  EXPECT_EQ(other_client.source(), nullptr);
+  manager_.UnregisterBeginFrameSource(&source);
+  EXPECT_EQ(client.source(), nullptr);
+  EXPECT_EQ(other_client.source(), nullptr);
+
+  // Set BFS for other namespace
+  manager_.RegisterBeginFrameSource(&source, other_client.id_namespace());
+  EXPECT_EQ(other_client.source(), &source);
+  EXPECT_EQ(client.source(), nullptr);
+  manager_.UnregisterBeginFrameSource(&source);
+  EXPECT_EQ(client.source(), nullptr);
+  EXPECT_EQ(other_client.source(), nullptr);
+
+  // Re-set BFS for original
+  manager_.RegisterBeginFrameSource(&source, client.id_namespace());
+  EXPECT_EQ(client.source(), &source);
+  manager_.UnregisterBeginFrameSource(&source);
+  EXPECT_EQ(client.source(), nullptr);
+}
+
+TEST_F(SurfaceManagerTest, MultipleDisplays) {
+  EmptyBeginFrameSource root1_source;
+  EmptyBeginFrameSource root2_source;
+
+  // root1 -> A -> B
+  // root2 -> C
+  FakeSurfaceFactoryClient root1(1, &manager_);
+  FakeSurfaceFactoryClient root2(2, &manager_);
+  FakeSurfaceFactoryClient client_a(3, &manager_);
+  FakeSurfaceFactoryClient client_b(4, &manager_);
+  FakeSurfaceFactoryClient client_c(5, &manager_);
+
+  manager_.RegisterBeginFrameSource(&root1_source, root1.id_namespace());
+  manager_.RegisterBeginFrameSource(&root2_source, root2.id_namespace());
+  EXPECT_EQ(root1.source(), &root1_source);
+  EXPECT_EQ(root2.source(), &root2_source);
+
+  // Set up initial hierarchy.
+  manager_.RegisterSurfaceNamespaceHierarchy(root1.id_namespace(),
+                                             client_a.id_namespace());
+  EXPECT_EQ(client_a.source(), root1.source());
+  manager_.RegisterSurfaceNamespaceHierarchy(client_a.id_namespace(),
+                                             client_b.id_namespace());
+  EXPECT_EQ(client_b.source(), root1.source());
+  manager_.RegisterSurfaceNamespaceHierarchy(root2.id_namespace(),
+                                             client_c.id_namespace());
+  EXPECT_EQ(client_c.source(), root2.source());
+
+  // Attach A into root2's subtree, like a window moving across displays.
+  // root1 -> A -> B
+  // root2 -> C -> A -> B
+  manager_.RegisterSurfaceNamespaceHierarchy(client_c.id_namespace(),
+                                             client_a.id_namespace());
+  // With the heuristic of just keeping existing BFS in the face of multiple,
+  // no client sources should change.
+  EXPECT_EQ(client_a.source(), root1.source());
+  EXPECT_EQ(client_b.source(), root1.source());
+  EXPECT_EQ(client_c.source(), root2.source());
+
+  // Detach A from root1.  A and B should now be updated to root2.
+  manager_.UnregisterSurfaceNamespaceHierarchy(root1.id_namespace(),
+                                               client_a.id_namespace());
+  EXPECT_EQ(client_a.source(), root2.source());
+  EXPECT_EQ(client_b.source(), root2.source());
+  EXPECT_EQ(client_c.source(), root2.source());
+
+  // Detach root1 from BFS.  root1 should now have no source.
+  manager_.UnregisterBeginFrameSource(&root1_source);
+  EXPECT_EQ(root1.source(), nullptr);
+  EXPECT_NE(root2.source(), nullptr);
+
+  // Detatch root2 from BFS.
+  manager_.UnregisterBeginFrameSource(&root2_source);
+  EXPECT_EQ(client_a.source(), nullptr);
+  EXPECT_EQ(client_b.source(), nullptr);
+  EXPECT_EQ(client_c.source(), nullptr);
+  EXPECT_EQ(root2.source(), nullptr);
+
+  // Cleanup hierarchy.
+  manager_.UnregisterSurfaceNamespaceHierarchy(root2.id_namespace(),
+                                               client_c.id_namespace());
+  manager_.UnregisterSurfaceNamespaceHierarchy(client_c.id_namespace(),
+                                               client_a.id_namespace());
+  manager_.UnregisterSurfaceNamespaceHierarchy(client_a.id_namespace(),
+                                               client_b.id_namespace());
+}
+
+// In practice, registering and unregistering both parent/child relationships
+// and SurfaceFactoryClients can happen in any ordering with respect to
+// each other.  These following tests verify that all the data structures
+// are properly set up and cleaned up under the four permutations of orderings
+// of this nesting.
+
+class SurfaceManagerOrderingTest : public SurfaceManagerTest {
+ public:
+  SurfaceManagerOrderingTest()
+      : client_a_(1),
+        client_b_(2),
+        client_c_(3),
+        hierarchy_registered_(false),
+        clients_registered_(false),
+        bfs_registered_(false) {
+    AssertCorrectBFSState();
+  }
+
+  ~SurfaceManagerOrderingTest() override {
+    EXPECT_EQ(hierarchy_registered_, false);
+    EXPECT_EQ(clients_registered_, false);
+    EXPECT_EQ(bfs_registered_, false);
+    AssertCorrectBFSState();
+  }
+
+  void RegisterHierarchy() {
+    DCHECK(!hierarchy_registered_);
+    hierarchy_registered_ = true;
+    manager_.RegisterSurfaceNamespaceHierarchy(client_a_.id_namespace(),
+                                               client_b_.id_namespace());
+    manager_.RegisterSurfaceNamespaceHierarchy(client_b_.id_namespace(),
+                                               client_c_.id_namespace());
+    AssertCorrectBFSState();
+  }
+  void UnregisterHierarchy() {
+    DCHECK(hierarchy_registered_);
+    hierarchy_registered_ = false;
+    manager_.UnregisterSurfaceNamespaceHierarchy(client_a_.id_namespace(),
+                                                 client_b_.id_namespace());
+    manager_.UnregisterSurfaceNamespaceHierarchy(client_b_.id_namespace(),
+                                                 client_c_.id_namespace());
+    AssertCorrectBFSState();
+  }
+
+  void RegisterClients() {
+    DCHECK(!clients_registered_);
+    clients_registered_ = true;
+    client_a_.Register(&manager_);
+    client_b_.Register(&manager_);
+    client_c_.Register(&manager_);
+    AssertCorrectBFSState();
+  }
+
+  void UnregisterClients() {
+    DCHECK(clients_registered_);
+    clients_registered_ = false;
+    client_a_.Unregister();
+    client_b_.Unregister();
+    client_c_.Unregister();
+    AssertCorrectBFSState();
+  }
+
+  void RegisterBFS() {
+    DCHECK(!bfs_registered_);
+    bfs_registered_ = true;
+    manager_.RegisterBeginFrameSource(&source_, client_a_.id_namespace());
+    AssertCorrectBFSState();
+  }
+  void UnregisterBFS() {
+    DCHECK(bfs_registered_);
+    bfs_registered_ = false;
+    manager_.UnregisterBeginFrameSource(&source_);
+    AssertCorrectBFSState();
+  }
+
+  void AssertEmptyBFS() {
+    EXPECT_EQ(client_a_.source(), nullptr);
+    EXPECT_EQ(client_b_.source(), nullptr);
+    EXPECT_EQ(client_c_.source(), nullptr);
+  }
+
+  void AssertAllValidBFS() {
+    EXPECT_EQ(client_a_.source(), &source_);
+    EXPECT_EQ(client_b_.source(), &source_);
+    EXPECT_EQ(client_c_.source(), &source_);
+  }
+
+ protected:
+  void AssertCorrectBFSState() {
+    if (!clients_registered_ || !bfs_registered_) {
+      AssertEmptyBFS();
+      return;
+    }
+    if (!hierarchy_registered_) {
+      // A valid but not attached to anything.
+      EXPECT_EQ(client_a_.source(), &source_);
+      EXPECT_EQ(client_b_.source(), nullptr);
+      EXPECT_EQ(client_c_.source(), nullptr);
+      return;
+    }
+
+    AssertAllValidBFS();
+  }
+
+  EmptyBeginFrameSource source_;
+  // A -> B -> C hierarchy, with A always having the BFS.
+  FakeSurfaceFactoryClient client_a_;
+  FakeSurfaceFactoryClient client_b_;
+  FakeSurfaceFactoryClient client_c_;
+
+  bool hierarchy_registered_;
+  bool clients_registered_;
+  bool bfs_registered_;
+};
+
+enum RegisterOrder { REGISTER_HIERARCHY_FIRST, REGISTER_CLIENTS_FIRST };
+enum UnregisterOrder { UNREGISTER_HIERARCHY_FIRST, UNREGISTER_CLIENTS_FIRST };
+enum BFSOrder { BFS_FIRST, BFS_SECOND, BFS_THIRD };
+
+static const RegisterOrder kRegisterOrderList[] = {REGISTER_HIERARCHY_FIRST,
+                                                   REGISTER_CLIENTS_FIRST};
+static const UnregisterOrder kUnregisterOrderList[] = {
+    UNREGISTER_HIERARCHY_FIRST, UNREGISTER_CLIENTS_FIRST};
+static const BFSOrder kBFSOrderList[] = {BFS_FIRST, BFS_SECOND, BFS_THIRD};
+
+class SurfaceManagerOrderingParamTest
+    : public SurfaceManagerOrderingTest,
+      public ::testing::WithParamInterface<
+          std::tr1::tuple<RegisterOrder, UnregisterOrder, BFSOrder>> {};
+
+TEST_P(SurfaceManagerOrderingParamTest, Ordering) {
+  // Test the four permutations of client/hierarchy setting/unsetting and test
+  // each place the BFS can be added and removed.  The BFS and the
+  // client/hierarchy are less related, so BFS is tested independently instead
+  // of every permutation of BFS setting and unsetting.
+  // The register/unregister functions themselves test most of the state.
+  RegisterOrder register_order = std::tr1::get<0>(GetParam());
+  UnregisterOrder unregister_order = std::tr1::get<1>(GetParam());
+  BFSOrder bfs_order = std::tr1::get<2>(GetParam());
+
+  // Attach everything up in the specified order.
+  if (bfs_order == BFS_FIRST)
+    RegisterBFS();
+
+  if (register_order == REGISTER_HIERARCHY_FIRST)
+    RegisterHierarchy();
+  else
+    RegisterClients();
+
+  if (bfs_order == BFS_SECOND)
+    RegisterBFS();
+
+  if (register_order == REGISTER_HIERARCHY_FIRST)
+    RegisterClients();
+  else
+    RegisterHierarchy();
+
+  if (bfs_order == BFS_THIRD)
+    RegisterBFS();
+
+  // Everything hooked up, so should be valid.
+  AssertAllValidBFS();
+
+  // Detach everything in the specified order.
+  if (bfs_order == BFS_THIRD)
+    UnregisterBFS();
+
+  if (unregister_order == UNREGISTER_HIERARCHY_FIRST)
+    UnregisterHierarchy();
+  else
+    UnregisterClients();
+
+  if (bfs_order == BFS_SECOND)
+    UnregisterBFS();
+
+  if (unregister_order == UNREGISTER_HIERARCHY_FIRST)
+    UnregisterClients();
+  else
+    UnregisterHierarchy();
+
+  if (bfs_order == BFS_FIRST)
+    UnregisterBFS();
+}
+
+INSTANTIATE_TEST_CASE_P(
+    SurfaceManagerOrderingParamTestInstantiation,
+    SurfaceManagerOrderingParamTest,
+    ::testing::Combine(::testing::ValuesIn(kRegisterOrderList),
+                       ::testing::ValuesIn(kUnregisterOrderList),
+                       ::testing::ValuesIn(kBFSOrderList)));
+
+}  // namespace cc