Merge lp:~kdub/mir/sort-out-surface-observers into lp:mir

[Kevin DuBois]

Sort out the observers structure by introducing a StreamObserver. The BufferStreamObserver can notify of frame posting and resize of a buffer stream. The surface observer no longer notifies of a new frame (as it doesn't know what the streams are doing), but it can notify that the stacking of the streams has changed.

Sort out the observers structure by introducing a StreamObserver. The BufferStreamObserver can notify of frame posting and resize of a buffer stream. The surface observer no longer notifies of a new frame (as it doesn't know what the streams are doing), but it can notify that the stacking of the streams has changed.

In the review of ~kdub/mir/surface-has-a-bufferstream, Alexandros pointed in this comment (https://code.launchpad.net/~kdub/mir/surface-has-a-bufferstream/+merge/257559/comments/642904)
that the SurfaceObservers keeping track of the streams was a bit strange, and this MP corrects this.

I also considered having
ms::SurfaceObserver : public ms::BufferStreamObserver
but it seems to me that these are two different operations, so they are separate in this MP.

[PS Jenkins bot (ps-jenkins)]

PASSED: Continuous integration, rev:2642
http://jenkins.qa.ubuntu.com/job/mir-ci/4068/
Executed test runs:
    SUCCESS: http://jenkins.qa.ubuntu.com/job/mir-android-vivid-i386-build/2800
    SUCCESS: http://jenkins.qa.ubuntu.com/job/mir-clang-wily-amd64-build/313
    SUCCESS: http://jenkins.qa.ubuntu.com/job/mir-mediumtests-vivid-touch/2748
    SUCCESS: http://jenkins.qa.ubuntu.com/job/mir-wily-amd64-ci/224
        deb: http://jenkins.qa.ubuntu.com/job/mir-wily-amd64-ci/224/artifact/work/output/*zip*/output.zip
    SUCCESS: http://jenkins.qa.ubuntu.com/job/mir-mediumtests-builder-vivid-armhf/2748
        deb: http://jenkins.qa.ubuntu.com/job/mir-mediumtests-builder-vivid-armhf/2748/artifact/work/output/*zip*/output.zip
    SUCCESS: http://jenkins.qa.ubuntu.com/job/mir-mediumtests-runner-mako/5585
    SUCCESS: http://s-jenkins.ubuntu-ci:8080/job/touch-flash-device/21098

Click here to trigger a rebuild:
http://s-jenkins.ubuntu-ci:8080/job/mir-ci/4068/rebuild

review: Approve (continuous-integration)

[Alan Griffiths (alan-griffiths)]

*Needs Discussion*

397 +void ms::BasicSurface::add_observer(std::shared_ptr<StreamObserver> const& observer)

I'm not convinced that the Surface (and not the SurfaceObserver) is responsible for adding StreamObservers.

My instinct would be for LegacySurfaceChangeNotification::stream_added() to register a stream observer.

review: Needs Information

[Robert Carr (robertcarr)]

I'm not totally sure this is an improvement. It seems to solve the problem of having to use the implement complete surface observer interface when only a stream observer is needed but this is pretty easy to manager with null observers and isn't so much a safety issue as a wart (as far as I see it)...I think this branch comes with a few warts:

+class SurfaceReadyObserver : public scene::NullStreamObserver,

We've fixed one name mismatch but introduced another as far as I can see...the other wart I notice being the increased complexity in BasicSurface.

It's possible Alan's suggestion about making the Surface Observer responsible for adding the StreamObserver would resolve some of my concerns, this way you would have SurfaceReadyObserver be a SurfaceObserver right?

Anyway though...it seems a reasonable and runtime correct step and I assume you find it useful if you've proposed it so I'll approve!

review: Approve

[Kevin DuBois (kdub)]

Will see if I can root out the requirement on Surface tomorrow.

[Daniel van Vugt (vanvugt)]

I think our Surface-related classes are quite overcomplicated for the limited functionality they have. So from a high level I feel there's no justifiable reason to grow the code, we should be shrinking it.

But I won't block progress in wishing we were doing better...

review: Abstain

[Kevin DuBois (kdub)]

The rework should not complicate the Surface class anymore. This is somewhat on the backburner, will re-propose at a later time.

Unmerged revisions

2642. By Kevin DuBois on 2015-06-10

remove a dup symbol from the table

2641. By Kevin DuBois on 2015-06-10

merge in mir

2640. By Kevin DuBois on 2015-06-09

round of cleanups

2639. By Kevin DuBois on 2015-06-09

shift around files

2638. By Kevin DuBois on 2015-06-09

sort out observers with resetting the streams

2637. By Kevin DuBois on 2015-06-09

merge in mir

2636. By Kevin DuBois on 2015-06-08

tests to pass

2635. By Kevin DuBois on 2015-06-08

merge in mir

2634. By Kevin DuBois on 2015-06-08

transition most things to having a separate stream and surface notification path

=== modified file 'include/server/mir/frontend/buffer_stream.h'
--- include/server/mir/frontend/buffer_stream.h	2015-06-02 13:41:40 +0000
+++ include/server/mir/frontend/buffer_stream.h	2015-06-10 12:39:17 +0000
@@ -32,7 +32,7 @@
 }
 namespace scene
 {
-class SurfaceObserver;
+class StreamObserver;
 }
 
 namespace frontend
@@ -45,8 +45,8 @@
     
     virtual void swap_buffers(graphics::Buffer* old_buffer, std::function<void(graphics::Buffer* new_buffer)> complete) = 0;
 
-    virtual void add_observer(std::shared_ptr<scene::SurfaceObserver> const& observer) = 0;
-    virtual void remove_observer(std::weak_ptr<scene::SurfaceObserver> const& observer) = 0;
+    virtual void add_observer(std::shared_ptr<scene::StreamObserver> const& observer) = 0;
+    virtual void remove_observer(std::weak_ptr<scene::StreamObserver> const& observer) = 0;
     
     virtual void with_most_recent_buffer_do(
         std::function<void(graphics::Buffer&)> const& exec) = 0;

=== added file 'include/server/mir/scene/null_stream_observer.h'
--- include/server/mir/scene/null_stream_observer.h	1970-01-01 00:00:00 +0000
+++ include/server/mir/scene/null_stream_observer.h	2015-06-10 12:39:17 +0000
@@ -0,0 +1,36 @@
+/*
+ * Copyright © 2015 Canonical Ltd.
+ *
+ * This program is free software: you can redistribute it and/or modify it
+ * under the terms of the GNU General Public License version 3,
+ * as published by the Free Software Foundation.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ *
+ * Authored by: Kevin DuBois <[e-mail]>
+ */
+
+#ifndef MIR_SCENE_NULL_STREAM_OBSERVER_H_
+#define MIR_SCENE_NULL_STREAM_OBSERVER_H_
+
+#include "mir/scene/stream_observer.h"
+
+namespace mir
+{
+namespace scene
+{
+class NullStreamObserver : public StreamObserver
+{
+    void frame_posted(int frames_available) override;
+    void resized_to(geometry::Size const& size) override;
+};
+}
+}
+
+#endif // MIR_SCENE_NULL_STREAM_OBSERVER_H_

=== modified file 'include/server/mir/scene/null_surface_observer.h'
--- include/server/mir/scene/null_surface_observer.h	2015-04-09 08:57:24 +0000
+++ include/server/mir/scene/null_surface_observer.h	2015-06-10 12:39:17 +0000
@@ -35,7 +35,6 @@
     void resized_to(geometry::Size const& size) override;
     void moved_to(geometry::Point const& top_left) override;
     void hidden_set_to(bool hide) override;
-    void frame_posted(int frames_available) override;
     void alpha_set_to(float alpha) override;
     void orientation_set_to(MirOrientation orientation) override;
     void transformation_set_to(glm::mat4 const& t) override;
@@ -44,6 +43,7 @@
     void client_surface_close_requested() override;
     void keymap_changed(xkb_rule_names const& names) override;
     void renamed(char const* name) override;
+    void streams_repositioned() override;
 
 protected:
     NullSurfaceObserver(NullSurfaceObserver const&) = delete;

=== added file 'include/server/mir/scene/stream_observer.h'
--- include/server/mir/scene/stream_observer.h	1970-01-01 00:00:00 +0000
+++ include/server/mir/scene/stream_observer.h	2015-06-10 12:39:17 +0000
@@ -0,0 +1,45 @@
+/*
+ * Copyright © 2015 Canonical Ltd.
+ *
+ * This program is free software: you can redistribute it and/or modify it
+ * under the terms of the GNU General Public License version 3,
+ * as published by the Free Software Foundation.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ *
+ * Authored by: Kevin DuBois <[e-mail]>
+ */
+
+#ifndef MIR_SCENE_STREAM_OBSERVER_H_
+#define MIR_SCENE_STREAM_OBSERVER_H_
+
+namespace mir
+{
+namespace geometry
+{
+struct Size;
+}
+namespace scene
+{
+class StreamObserver
+{
+public:
+    virtual void resized_to(geometry::Size const& size) = 0;
+    virtual void frame_posted(int frames_available) = 0;
+
+protected:
+    StreamObserver() = default;
+    virtual ~StreamObserver() = default;
+    StreamObserver(StreamObserver const&) = delete;
+    StreamObserver& operator=(StreamObserver const&) = delete;
+};
+}
+}
+
+#endif // MIR_SCENE_SURFACE_OBSERVER_H_

=== modified file 'include/server/mir/scene/surface.h'
--- include/server/mir/scene/surface.h	2015-06-02 13:41:40 +0000
+++ include/server/mir/scene/surface.h	2015-06-10 12:39:17 +0000
@@ -93,6 +93,8 @@
     virtual void set_cursor_image(std::shared_ptr<graphics::CursorImage> const& image) override = 0;
     virtual std::shared_ptr<graphics::CursorImage> cursor_image() const override = 0;
 
+    virtual void add_observer(std::shared_ptr<StreamObserver> const& observer) = 0;
+    virtual void remove_observer(std::weak_ptr<StreamObserver> const& observer) = 0;
     virtual void add_observer(std::shared_ptr<SurfaceObserver> const& observer) = 0;
     virtual void remove_observer(std::weak_ptr<SurfaceObserver> const& observer) = 0;
 

=== modified file 'include/server/mir/scene/surface_observer.h'
--- include/server/mir/scene/surface_observer.h	2015-04-09 08:57:24 +0000
+++ include/server/mir/scene/surface_observer.h	2015-06-10 12:39:17 +0000
@@ -47,7 +47,6 @@
     virtual void resized_to(geometry::Size const& size) = 0;
     virtual void moved_to(geometry::Point const& top_left) = 0;
     virtual void hidden_set_to(bool hide) = 0;
-    virtual void frame_posted(int frames_available) = 0;
     virtual void alpha_set_to(float alpha) = 0;
     virtual void orientation_set_to(MirOrientation orientation) = 0;
     virtual void transformation_set_to(glm::mat4 const& t) = 0;
@@ -56,6 +55,7 @@
     virtual void client_surface_close_requested() = 0;
     virtual void keymap_changed(xkb_rule_names const& names) = 0;
     virtual void renamed(char const* name) = 0;
+    virtual void streams_repositioned() = 0;
 
 protected:
     SurfaceObserver() = default;

=== modified file 'include/server/mir/shell/surface_ready_observer.h'
--- include/server/mir/shell/surface_ready_observer.h	2015-05-18 19:58:07 +0000
+++ include/server/mir/shell/surface_ready_observer.h	2015-06-10 12:39:17 +0000
@@ -19,7 +19,7 @@
 #ifndef MIR_SHELL_SURFACE_READY_OBSERVER_H_
 #define MIR_SHELL_SURFACE_READY_OBSERVER_H_
 
-#include "mir/scene/null_surface_observer.h"
+#include "mir/scene/null_stream_observer.h"
 
 #include <functional>
 #include <memory>
@@ -30,7 +30,7 @@
 
 namespace shell
 {
-class SurfaceReadyObserver : public scene::NullSurfaceObserver,
+class SurfaceReadyObserver : public scene::NullStreamObserver,
     public std::enable_shared_from_this<SurfaceReadyObserver>
 {
 public:
@@ -47,6 +47,7 @@
 
 private:
     void frame_posted(int) override;
+    void resized_to(geometry::Size const&) override;
 
     ActivateFunction const activate;
     std::weak_ptr<scene::Session> const session;

=== added file 'src/include/server/mir/scene/stream_observers.h'
--- src/include/server/mir/scene/stream_observers.h	1970-01-01 00:00:00 +0000
+++ src/include/server/mir/scene/stream_observers.h	2015-06-10 12:39:17 +0000
@@ -0,0 +1,43 @@
+/*
+ * Copyright © 2015 Canonical Ltd.
+ *
+ * This program is free software: you can redistribute it and/or modify it
+ * under the terms of the GNU General Public License version 3,
+ * as published by the Free Software Foundation.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ *
+ * Authored by: Kevin DuBois <[e-mail]>
+ */
+
+#ifndef MIR_SCENE_STREAM_OBSERVERS_H_
+#define MIR_SCENE_STREAM_OBSERVERS_H_
+
+#include "mir/basic_observers.h"
+#include "mir/scene/stream_observer.h"
+
+namespace mir
+{
+namespace scene
+{
+
+class StreamObservers : public StreamObserver, BasicObservers<StreamObserver>
+{
+public:
+    using BasicObservers<StreamObserver>::add;
+    using BasicObservers<StreamObserver>::remove;
+    using BasicObservers<StreamObserver>::for_each;
+    void frame_posted(int frames_available) override;
+    void resized_to(geometry::Size const& size) override;
+};
+
+}
+}
+
+#endif /* MIR_SCENE_STREAM_OBSERVERS_H_ */

=== modified file 'src/include/server/mir/scene/surface_observers.h'
--- src/include/server/mir/scene/surface_observers.h	2015-05-19 21:34:34 +0000
+++ src/include/server/mir/scene/surface_observers.h	2015-06-10 12:39:17 +0000
@@ -37,7 +37,6 @@
     void resized_to(geometry::Size const& size) override;
     void moved_to(geometry::Point const& top_left) override;
     void hidden_set_to(bool hide) override;
-    void frame_posted(int frames_available) override;
     void alpha_set_to(float alpha) override;
     void orientation_set_to(MirOrientation orientation) override;
     void transformation_set_to(glm::mat4 const& t) override;
@@ -46,6 +45,7 @@
     void client_surface_close_requested() override;
     void keymap_changed(xkb_rule_names const& names) override;
     void renamed(char const*) override;
+    void streams_repositioned() override;
 };
 
 }

=== modified file 'src/server/compositor/buffer_stream_surfaces.cpp'
--- src/server/compositor/buffer_stream_surfaces.cpp	2015-05-19 21:34:34 +0000
+++ src/server/compositor/buffer_stream_surfaces.cpp	2015-06-10 12:39:17 +0000
@@ -125,12 +125,12 @@
     return buffer_bundle->properties().format;
 }
 
-void mc::BufferStreamSurfaces::add_observer(std::shared_ptr<scene::SurfaceObserver> const& observer)
+void mc::BufferStreamSurfaces::add_observer(std::shared_ptr<scene::StreamObserver> const& observer)
 {
     observers.add(observer);
 }
 
-void mc::BufferStreamSurfaces::remove_observer(std::weak_ptr<scene::SurfaceObserver> const& observer)
+void mc::BufferStreamSurfaces::remove_observer(std::weak_ptr<scene::StreamObserver> const& observer)
 {
     if (auto o = observer.lock())
         observers.remove(o);

=== modified file 'src/server/compositor/buffer_stream_surfaces.h'
--- src/server/compositor/buffer_stream_surfaces.h	2015-05-19 21:34:34 +0000
+++ src/server/compositor/buffer_stream_surfaces.h	2015-06-10 12:39:17 +0000
@@ -21,7 +21,7 @@
 #define MIR_COMPOSITOR_BUFFER_STREAM_SCENE_H_
 
 #include "mir/compositor/buffer_stream.h"
-#include "mir/scene/surface_observers.h"
+#include "mir/scene/stream_observers.h"
 
 #include <mutex>
 
@@ -45,8 +45,8 @@
         graphics::Buffer* old_buffer, std::function<void(graphics::Buffer* new_buffer)> complete) override;
     void with_most_recent_buffer_do(std::function<void(graphics::Buffer&)> const& exec) override;
     MirPixelFormat pixel_format() const override;
-    void add_observer(std::shared_ptr<scene::SurfaceObserver> const& observer) override;
-    void remove_observer(std::weak_ptr<scene::SurfaceObserver> const& observer) override;
+    void add_observer(std::shared_ptr<scene::StreamObserver> const& observer) override;
+    void remove_observer(std::weak_ptr<scene::StreamObserver> const& observer) override;
 
     //from mc::BufferStream
     void acquire_client_buffer(std::function<void(graphics::Buffer* buffer)> complete);
@@ -70,7 +70,7 @@
 private:
     std::mutex mutable mutex;
     std::shared_ptr<BufferBundle> const buffer_bundle;
-    scene::SurfaceObservers observers;
+    scene::StreamObservers observers;
     bool first_frame_posted;
 };
 

=== modified file 'src/server/input/cursor_controller.cpp'
--- src/server/input/cursor_controller.cpp	2015-05-12 06:58:52 +0000
+++ src/server/input/cursor_controller.cpp	2015-06-10 12:39:17 +0000
@@ -62,10 +62,6 @@
     {
         cursor_controller->update_cursor_image();
     }
-    void frame_posted(int) override
-    {
-        // Frame posting wont trigger a cursor update
-    }
     void alpha_set_to(float) override
     {
         cursor_controller->update_cursor_image();

=== modified file 'src/server/scene/CMakeLists.txt'
--- src/server/scene/CMakeLists.txt	2015-05-19 17:17:57 +0000
+++ src/server/scene/CMakeLists.txt	2015-06-10 12:39:17 +0000
@@ -20,6 +20,7 @@
   threaded_snapshot_strategy.cpp
   legacy_scene_change_notification.cpp
   legacy_surface_change_notification.cpp
+  legacy_stream_change_notification.cpp
   prompt_session_container.cpp
   prompt_session_impl.cpp
   prompt_session_manager_impl.cpp

=== modified file 'src/server/scene/basic_surface.cpp'
--- src/server/scene/basic_surface.cpp	2015-06-04 11:32:52 +0000
+++ src/server/scene/basic_surface.cpp	2015-06-10 12:39:17 +0000
@@ -29,7 +29,7 @@
 #include "mir/geometry/displacement.h"
 
 #include "mir/scene/scene_report.h"
-#include "mir/scene/null_surface_observer.h"
+#include "mir/scene/null_stream_observer.h"
 
 #include <boost/throw_exception.hpp>
 
@@ -70,12 +70,23 @@
         { observer->hidden_set_to(hide); });
 }
 
-void ms::SurfaceObservers::frame_posted(int frames_available)
+void ms::StreamObservers::frame_posted(int frames_available)
 {
-    for_each([&](std::shared_ptr<SurfaceObserver> const& observer)
+    for_each([&](std::shared_ptr<StreamObserver> const& observer)
         { observer->frame_posted(frames_available); });
 }
 
+void ms::StreamObservers::resized_to(geom::Size const& size)
+{
+    for_each([&](std::shared_ptr<StreamObserver> const& observer)
+        { observer->resized_to(size); });
+}
+
+void ms::SurfaceObservers::streams_repositioned()
+{
+    for_each([&](std::shared_ptr<SurfaceObserver> const& observer)
+        { observer->streams_repositioned(); });
+}
 void ms::SurfaceObservers::alpha_set_to(float alpha)
 {
     for_each([&](std::shared_ptr<SurfaceObserver> const& observer)
@@ -557,7 +568,7 @@
 
 namespace
 {
-struct FramePostObserver : public ms::NullSurfaceObserver
+struct FramePostObserver : public ms::NullStreamObserver
 {
     FramePostObserver(std::function<void()> const& exec)
         : exec(exec)
@@ -729,11 +740,28 @@
     return new_visibility;
 }
 
+void ms::BasicSurface::add_observer(std::shared_ptr<StreamObserver> const& observer)
+{
+    stream_observers.add(observer);
+    std::lock_guard<std::mutex> lg(guard);
+    for (auto& info : layers) 
+        info.stream->add_observer(observer);
+}
+
+void ms::BasicSurface::remove_observer(std::weak_ptr<StreamObserver> const& observer)
+{
+    auto o = observer.lock();
+    if (!o)
+        BOOST_THROW_EXCEPTION(std::runtime_error("Invalid observer (previously destroyed)"));
+    std::lock_guard<std::mutex> lg(guard);
+    for (auto& info : layers) 
+        info.stream->remove_observer(observer);
+    stream_observers.remove(o);
+}
+
 void ms::BasicSurface::add_observer(std::shared_ptr<SurfaceObserver> const& observer)
 {
     observers.add(observer);
-    for (auto& info : layers) 
-        info.stream->add_observer(observer);
 }
 
 void ms::BasicSurface::remove_observer(std::weak_ptr<SurfaceObserver> const& observer)
@@ -742,8 +770,6 @@
     if (!o)
         BOOST_THROW_EXCEPTION(std::runtime_error("Invalid observer (previously destroyed)"));
     observers.remove(o);
-    for (auto& info : layers) 
-        info.stream->remove_observer(observer);
 }
 
 std::shared_ptr<ms::Surface> ms::BasicSurface::parent() const
@@ -844,15 +870,28 @@
 
 void ms::BasicSurface::set_streams(std::list<scene::StreamInfo> const& s)
 {
-    std::unique_lock<std::mutex> lk(guard);
-
-    if (s.end() == std::find_if(s.begin(), s.end(),
-        [this] (ms::StreamInfo const& info) { return info.stream == surface_buffer_stream; }))
     {
-        BOOST_THROW_EXCEPTION(std::logic_error("cannot remove the created-with buffer stream yet"));
+        std::unique_lock<std::mutex> lk(guard);
+
+        if (s.end() == std::find_if(s.begin(), s.end(),
+            [this] (ms::StreamInfo const& info) { return info.stream == surface_buffer_stream; }))
+        {
+            BOOST_THROW_EXCEPTION(std::logic_error("cannot remove the created-with buffer stream yet"));
+        }
+
+        stream_observers.for_each([this](std::shared_ptr<StreamObserver> const& observer) {
+            for(auto& layer : layers)
+                layer.stream->remove_observer(observer);
+        });
+
+        layers = s;
+
+        stream_observers.for_each([this](std::shared_ptr<StreamObserver> const& observer) {
+            for(auto& layer : layers)
+                layer.stream->add_observer(observer);
+        });
     }
-
-    layers = s;
+    observers.streams_repositioned();
 }
 
 mg::RenderableList ms::BasicSurface::generate_renderables(mc::CompositorID id) const

=== modified file 'src/server/scene/basic_surface.h'
--- src/server/scene/basic_surface.h	2015-06-04 11:32:52 +0000
+++ src/server/scene/basic_surface.h	2015-06-10 12:39:17 +0000
@@ -22,6 +22,7 @@
 #include "mir/scene/surface.h"
 #include "mir/basic_observers.h"
 #include "mir/scene/surface_observers.h"
+#include "mir/scene/stream_observers.h"
 
 #include "mir/geometry/rectangle.h"
 
@@ -139,6 +140,8 @@
 
     void add_observer(std::shared_ptr<SurfaceObserver> const& observer) override;
     void remove_observer(std::weak_ptr<SurfaceObserver> const& observer) override;
+    void add_observer(std::shared_ptr<StreamObserver> const& observer) override;
+    void remove_observer(std::weak_ptr<StreamObserver> const& observer) override;
 
     int dpi() const;
 
@@ -157,6 +160,8 @@
     MirOrientationMode set_preferred_orientation(MirOrientationMode mode);
 
     SurfaceObservers observers;
+    StreamObservers stream_observers;
+
     std::mutex mutable guard;
     std::string surface_name;
     geometry::Rectangle surface_rect;

=== modified file 'src/server/scene/legacy_scene_change_notification.cpp'
--- src/server/scene/legacy_scene_change_notification.cpp	2015-06-01 16:19:11 +0000
+++ src/server/scene/legacy_scene_change_notification.cpp	2015-06-10 12:39:17 +0000
@@ -19,6 +19,7 @@
 #include "legacy_surface_change_notification.h"
 
 #include "mir/scene/legacy_scene_change_notification.h"
+#include "legacy_stream_change_notification.h"
 #include "mir/scene/surface.h"
 
 #include <boost/throw_exception.hpp>
@@ -48,9 +49,9 @@
             was_visible = surface->visible();
         };
 
-    auto observer = std::make_shared<ms::LegacySurfaceChangeNotification>(
-        notifier, buffer_notify_change);
+    auto observer = std::make_shared<ms::LegacySurfaceChangeNotification>(notifier);
     surface->add_observer(observer);
+    surface->add_observer(std::make_shared<ms::LegacyStreamChangeNotification>(buffer_notify_change));
     
     {
         std::unique_lock<decltype(surface_observers_guard)> lg(surface_observers_guard);

=== added file 'src/server/scene/legacy_stream_change_notification.cpp'
--- src/server/scene/legacy_stream_change_notification.cpp	1970-01-01 00:00:00 +0000
+++ src/server/scene/legacy_stream_change_notification.cpp	2015-06-10 12:39:17 +0000
@@ -0,0 +1,37 @@
+/*
+ * Copyright © 2015 Canonical Ltd.
+ *
+ * This program is free software: you can redistribute it and/or modify it
+ * under the terms of the GNU General Public License version 3,
+ * as published by the Free Software Foundation.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program. If not, see <http://www.gnu.org/licenses/>.
+ *
+ * Authored by: Kevin DuBois <[e-mail]>
+ */
+
+#include "legacy_stream_change_notification.h"
+
+namespace ms = mir::scene;
+namespace geom = mir::geometry;
+
+ms::LegacyStreamChangeNotification::LegacyStreamChangeNotification(
+    std::function<void(int)> const& notify_buffer_change) :
+    notify_buffer_change(notify_buffer_change)
+{
+}
+
+void ms::LegacyStreamChangeNotification::frame_posted(int frames_available)
+{
+    notify_buffer_change(frames_available);
+}
+
+void ms::LegacyStreamChangeNotification::resized_to(geom::Size const&)
+{
+}

=== added file 'src/server/scene/legacy_stream_change_notification.h'
--- src/server/scene/legacy_stream_change_notification.h	1970-01-01 00:00:00 +0000
+++ src/server/scene/legacy_stream_change_notification.h	2015-06-10 12:39:17 +0000
@@ -0,0 +1,45 @@
+/*
+ * Copyright © 2015 Canonical Ltd.
+ *
+ * This program is free software: you can redistribute it and/or modify it
+ * under the terms of the GNU General Public License version 3,
+ * as published by the Free Software Foundation.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program. If not, see <http://www.gnu.org/licenses/>.
+ *
+ * Authored by: Kevin DuBois <[e-mail]>
+ */
+
+#ifndef MIR_SCENE_LEGACY_STREAM_CHANGE_NOTIFICATION_H_
+#define MIR_SCENE_LEGACY_STREAM_CHANGE_NOTIFICATION_H_
+
+#include "mir/scene/stream_observer.h"
+
+#include <functional>
+
+namespace ms = mir::scene;
+namespace geom = mir::geometry;
+
+namespace mir
+{
+namespace scene
+{
+class LegacyStreamChangeNotification : public ms::StreamObserver
+{
+public:
+    LegacyStreamChangeNotification(std::function<void(int)> const& stream_change);
+    void frame_posted(int frames_available) override;
+    void resized_to(geometry::Size const& size) override;
+private:
+    std::function<void(int)> const notify_buffer_change;
+};
+}
+}
+
+#endif // MIR_SCENE_LEGACY_STREAM_CHANGE_NOTIFICATION_H_

=== modified file 'src/server/scene/legacy_surface_change_notification.cpp'
--- src/server/scene/legacy_surface_change_notification.cpp	2015-04-09 08:57:24 +0000
+++ src/server/scene/legacy_surface_change_notification.cpp	2015-06-10 12:39:17 +0000
@@ -24,10 +24,8 @@
 namespace geom = mir::geometry;
 
 ms::LegacySurfaceChangeNotification::LegacySurfaceChangeNotification(
-    std::function<void()> const& notify_scene_change,
-    std::function<void(int)> const& notify_buffer_change) :
-    notify_scene_change(notify_scene_change),
-    notify_buffer_change(notify_buffer_change)
+    std::function<void()> const& notify_scene_change) :
+    notify_scene_change(notify_scene_change)
 {
 }
 
@@ -46,9 +44,9 @@
     notify_scene_change();
 }
 
-void ms::LegacySurfaceChangeNotification::frame_posted(int frames_available)
+void ms::LegacySurfaceChangeNotification::streams_repositioned()
 {
-    notify_buffer_change(frames_available);
+    notify_scene_change();
 }
 
 void ms::LegacySurfaceChangeNotification::alpha_set_to(float /*alpha*/)

=== modified file 'src/server/scene/legacy_surface_change_notification.h'
--- src/server/scene/legacy_surface_change_notification.h	2015-04-09 08:57:24 +0000
+++ src/server/scene/legacy_surface_change_notification.h	2015-06-10 12:39:17 +0000
@@ -33,14 +33,11 @@
 class LegacySurfaceChangeNotification : public ms::SurfaceObserver
 {
 public:
-    LegacySurfaceChangeNotification(
-        std::function<void()> const& notify_scene_change,
-        std::function<void(int)> const& notify_buffer_change);
+    LegacySurfaceChangeNotification(std::function<void()> const& notify_scene_change);
 
     void resized_to(geometry::Size const& /*size*/) override;
     void moved_to(geometry::Point const& /*top_left*/) override;
     void hidden_set_to(bool /*hide*/) override;
-    void frame_posted(int frames_available) override;
     void alpha_set_to(float /*alpha*/) override;
     void orientation_set_to(MirOrientation orientation) override;
     void transformation_set_to(glm::mat4 const& /*t*/) override;
@@ -50,10 +47,10 @@
     void client_surface_close_requested() override;
     void keymap_changed(xkb_rule_names const& names) override;
     void renamed(char const*) override;
+    void streams_repositioned() override;
 
 private:
     std::function<void()> const notify_scene_change;
-    std::function<void(int)> const notify_buffer_change;
 };
 }
 }

=== modified file 'src/server/scene/null_surface_observer.cpp'
--- src/server/scene/null_surface_observer.cpp	2015-04-09 08:57:24 +0000
+++ src/server/scene/null_surface_observer.cpp	2015-06-10 12:39:17 +0000
@@ -17,6 +17,7 @@
  */
 
 #include "mir/scene/null_surface_observer.h"
+#include "mir/scene/null_stream_observer.h"
 
 namespace ms = mir::scene;
 namespace mg = mir::graphics;
@@ -25,7 +26,6 @@
 void ms::NullSurfaceObserver::resized_to(geometry::Size const& /*size*/) {}
 void ms::NullSurfaceObserver::moved_to(geometry::Point const& /*top_left*/) {}
 void ms::NullSurfaceObserver::hidden_set_to(bool /*hide*/) {}
-void ms::NullSurfaceObserver::frame_posted(int /*frames_available*/) {}
 void ms::NullSurfaceObserver::alpha_set_to(float /*alpha*/) {}
 void ms::NullSurfaceObserver::orientation_set_to(MirOrientation /*orientation*/) {}
 void ms::NullSurfaceObserver::transformation_set_to(glm::mat4 const& /*t*/) {}
@@ -34,3 +34,7 @@
 void ms::NullSurfaceObserver::client_surface_close_requested() {}
 void ms::NullSurfaceObserver::keymap_changed(xkb_rule_names const& /* names */) {}
 void ms::NullSurfaceObserver::renamed(char const*) {}
+void ms::NullSurfaceObserver::streams_repositioned() {}
+
+void ms::NullStreamObserver::frame_posted(int /*frames_available*/) {}
+void ms::NullStreamObserver::resized_to(geometry::Size const& /*size*/) {}

=== added file 'src/server/scene/stream_change_notification.h'
--- src/server/scene/stream_change_notification.h	1970-01-01 00:00:00 +0000
+++ src/server/scene/stream_change_notification.h	2015-06-10 12:39:17 +0000
@@ -0,0 +1,45 @@
+/*
+ * Copyright © 2015 Canonical Ltd.
+ *
+ * This program is free software: you can redistribute it and/or modify it
+ * under the terms of the GNU General Public License version 3,
+ * as published by the Free Software Foundation.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program. If not, see <http://www.gnu.org/licenses/>.
+ *
+ * Authored by: Kevin DuBois <[e-mail]>
+ */
+
+#ifndef MIR_SCENE_STREAM_CHANGE_NOTIFICATION_H_
+#define MIR_SCENE_STREAM_CHANGE_NOTIFICATION_H_
+
+#include "mir/scene/surface_observer.h"
+
+#include <functional>
+
+namespace ms = mir::scene;
+namespace geom = mir::geometry;
+
+namespace mir
+{
+namespace scene
+{
+class LegacySurfaceChangeNotification : public ms::SurfaceObserver
+{
+public:
+    LegacySurfaceChangeNotification(std::function<void(int)> const& notify_buffer_change);
+    void resized_to(geometry::Size const& /*size*/) override;
+    void frame_posted(int frames_available) override;
+private:
+    std::function<void()> const notify_scene_change;
+};
+}
+}
+
+#endif // MIR_SCENE_STREAM_CHANGE_NOTIFICATION_H_

=== modified file 'src/server/shell/surface_ready_observer.cpp'
--- src/server/shell/surface_ready_observer.cpp	2015-05-18 19:58:07 +0000
+++ src/server/shell/surface_ready_observer.cpp	2015-06-10 12:39:17 +0000
@@ -43,3 +43,7 @@
         s->remove_observer(shared_from_this());
     }
 }
+
+void msh::SurfaceReadyObserver::resized_to(mir::geometry::Size const&)
+{
+}

=== modified file 'src/server/symbols.map'
--- src/server/symbols.map	2015-06-09 07:20:56 +0000
+++ src/server/symbols.map	2015-06-10 12:39:17 +0000
@@ -71,11 +71,12 @@
     mir::scene::NullSessionListener::?NullSessionListener*;
     mir::scene::NullSessionListener::NullSessionListener*;
     mir::scene::NullSessionListener::operator*;
+    mir::scene::NullStreamObserver::frame_posted*;
+    mir::scene::NullStreamObserver::resized_to*;
     mir::scene::NullSurfaceObserver::alpha_set_to*;
     mir::scene::NullSurfaceObserver::attrib_changed*;
     mir::scene::NullSurfaceObserver::client_surface_close_requested*;
     mir::scene::NullSurfaceObserver::cursor_image_set_to*;
-    mir::scene::NullSurfaceObserver::frame_posted*;
     mir::scene::NullSurfaceObserver::hidden_set_to*;
     mir::scene::NullSurfaceObserver::keymap_changed*;
     mir::scene::NullSurfaceObserver::moved_to*;
@@ -87,6 +88,7 @@
     mir::scene::NullSurfaceObserver::resized_to*;
     mir::scene::NullSurfaceObserver::transformation_set_to*;
     mir::scene::NullSurfaceObserver::renamed*;
+    mir::scene::NullSurfaceObserver::streams_repositioned*;
     mir::scene::Observer::?Observer*;
     mir::scene::Observer::Observer*;
     mir::scene::Observer::operator*;
@@ -280,11 +282,12 @@
     non-virtual?thunk?to?mir::LockableCallback::?LockableCallback*;
     non-virtual?thunk?to?mir::scene::CoordinateTranslator::?CoordinateTranslator*;
     non-virtual?thunk?to?mir::scene::NullSessionListener::?NullSessionListener*;
+    non-virtual?thunk?to?mir::scene::NullStreamObserver::frame_posted*;
+    non-virtual?thunk?to?mir::scene::NullStreamObserver::resized_to*;
     non-virtual?thunk?to?mir::scene::NullSurfaceObserver::alpha_set_to*;
     non-virtual?thunk?to?mir::scene::NullSurfaceObserver::attrib_changed*;
     non-virtual?thunk?to?mir::scene::NullSurfaceObserver::client_surface_close_requested*;
     non-virtual?thunk?to?mir::scene::NullSurfaceObserver::cursor_image_set_to*;
-    non-virtual?thunk?to?mir::scene::NullSurfaceObserver::frame_posted*;
     non-virtual?thunk?to?mir::scene::NullSurfaceObserver::hidden_set_to*;
     non-virtual?thunk?to?mir::scene::NullSurfaceObserver::keymap_changed*;
     non-virtual?thunk?to?mir::scene::NullSurfaceObserver::moved_to*;
@@ -292,6 +295,7 @@
     non-virtual?thunk?to?mir::scene::NullSurfaceObserver::orientation_set_to*;
     non-virtual?thunk?to?mir::scene::NullSurfaceObserver::reception_mode_set_to*;
     non-virtual?thunk?to?mir::scene::NullSurfaceObserver::resized_to*;
+    non-virtual?thunk?to?mir::scene::NullSurfaceObserver::streams_repositioned*;
     non-virtual?thunk?to?mir::scene::NullSurfaceObserver::transformation_set_to*;
     non-virtual?thunk?to?mir::scene::Observer::?Observer*;
     non-virtual?thunk?to?mir::scene::PlacementStrategy::?PlacementStrategy*;
@@ -375,6 +379,7 @@
     typeinfo?for?mir::MainLoop;
     typeinfo?for?mir::scene::CoordinateTranslator;
     typeinfo?for?mir::scene::NullSessionListener;
+    typeinfo?for?mir::scene::NullStreamObserver;
     typeinfo?for?mir::scene::NullSurfaceObserver;
     typeinfo?for?mir::scene::Observer;
     typeinfo?for?mir::scene::PlacementStrategy;
@@ -432,6 +437,7 @@
     vtable?for?mir::MainLoop;
     vtable?for?mir::scene::CoordinateTranslator;
     vtable?for?mir::scene::NullSessionListener;
+    vtable?for?mir::scene::NullStreamObserver;
     vtable?for?mir::scene::NullSurfaceObserver;
     vtable?for?mir::scene::Observer;
     vtable?for?mir::scene::PlacementStrategy;

=== modified file 'tests/include/mir_test_doubles/mock_buffer_stream.h'
--- tests/include/mir_test_doubles/mock_buffer_stream.h	2015-05-29 13:48:13 +0000
+++ tests/include/mir_test_doubles/mock_buffer_stream.h	2015-06-10 12:39:17 +0000
@@ -58,8 +58,8 @@
     MOCK_METHOD1(release_client_buffer, void(graphics::Buffer*));
     MOCK_METHOD1(lock_compositor_buffer,
                  std::shared_ptr<graphics::Buffer>(void const*));
-    MOCK_METHOD1(add_observer, void(std::shared_ptr<scene::SurfaceObserver> const&));
-    MOCK_METHOD1(remove_observer, void(std::weak_ptr<scene::SurfaceObserver> const&));
+    MOCK_METHOD1(add_observer, void(std::shared_ptr<scene::StreamObserver> const&));
+    MOCK_METHOD1(remove_observer, void(std::weak_ptr<scene::StreamObserver> const&));
 
     MOCK_METHOD0(get_stream_pixel_format, MirPixelFormat());
     MOCK_METHOD0(stream_size, geometry::Size());

=== modified file 'tests/include/mir_test_doubles/mock_surface.h'
--- tests/include/mir_test_doubles/mock_surface.h	2015-05-19 21:34:34 +0000
+++ tests/include/mir_test_doubles/mock_surface.h	2015-06-10 12:39:17 +0000
@@ -68,6 +68,8 @@
     MOCK_METHOD2(configure, int(MirSurfaceAttrib, int));
     MOCK_METHOD1(add_observer, void(std::shared_ptr<scene::SurfaceObserver> const&));
     MOCK_METHOD1(remove_observer, void(std::weak_ptr<scene::SurfaceObserver> const&));
+    MOCK_METHOD1(add_observer, void(std::shared_ptr<scene::StreamObserver> const&));
+    MOCK_METHOD1(remove_observer, void(std::weak_ptr<scene::StreamObserver> const&));
     MOCK_CONST_METHOD0(primary_buffer_stream, std::shared_ptr<frontend::BufferStream>());
 };
 

=== modified file 'tests/include/mir_test_doubles/stub_buffer_stream.h'
--- tests/include/mir_test_doubles/stub_buffer_stream.h	2015-05-19 21:34:34 +0000
+++ tests/include/mir_test_doubles/stub_buffer_stream.h	2015-06-10 12:39:17 +0000
@@ -76,8 +76,8 @@
         fn(*stub_compositor_buffer);
     }
     MirPixelFormat pixel_format() const { return mir_pixel_format_abgr_8888; }
-    void add_observer(std::shared_ptr<scene::SurfaceObserver> const&) {}
-    void remove_observer(std::weak_ptr<scene::SurfaceObserver> const&) {}
+    void add_observer(std::shared_ptr<scene::StreamObserver> const&) {}
+    void remove_observer(std::weak_ptr<scene::StreamObserver> const&) {}
     bool has_submitted_buffer() const { return true; }
 
     StubBuffer stub_client_buffer;

=== modified file 'tests/include/mir_test_doubles/stub_scene_surface.h'
--- tests/include/mir_test_doubles/stub_scene_surface.h	2015-05-29 13:48:13 +0000
+++ tests/include/mir_test_doubles/stub_scene_surface.h	2015-06-10 12:39:17 +0000
@@ -80,6 +80,8 @@
     void set_alpha(float) override {}
     void set_orientation(MirOrientation) {}
 
+    void add_observer(std::shared_ptr<scene::StreamObserver> const&) override {}
+    void remove_observer(std::weak_ptr<scene::StreamObserver> const&) override {}
     void add_observer(std::shared_ptr<scene::SurfaceObserver> const&) override {}
     void remove_observer(std::weak_ptr<scene::SurfaceObserver> const&) override {}
 

=== modified file 'tests/unit-tests/compositor/test_buffer_stream.cpp'
--- tests/unit-tests/compositor/test_buffer_stream.cpp	2015-05-19 21:34:34 +0000
+++ tests/unit-tests/compositor/test_buffer_stream.cpp	2015-06-10 12:39:17 +0000
@@ -17,7 +17,7 @@
  */
 
 #include "src/server/compositor/buffer_stream_surfaces.h"
-#include "src/server/scene/legacy_surface_change_notification.h"
+#include "src/server/scene/legacy_stream_change_notification.h"
 
 #include "mir_test_doubles/stub_buffer.h"
 #include "mir_test_doubles/mock_buffer_bundle.h"
@@ -222,8 +222,7 @@
     };
     NiceMock<MockCallback> mock_cb;
     EXPECT_CALL(mock_cb, call()).Times(3);
-    auto observer = std::make_shared<mir::scene::LegacySurfaceChangeNotification>(
-        []{ FAIL() << "buffer stream shouldnt notify of scene changes.";},
+    auto observer = std::make_shared<mir::scene::LegacyStreamChangeNotification>(
         std::bind(&MockCallback::call, &mock_cb));
 
     mc::BufferStreamSurfaces buffer_stream(mock_bundle);

=== modified file 'tests/unit-tests/scene/test_basic_surface.cpp'
--- tests/unit-tests/scene/test_basic_surface.cpp	2015-06-04 11:24:07 +0000
+++ tests/unit-tests/scene/test_basic_surface.cpp	2015-06-10 12:39:17 +0000
@@ -93,7 +93,7 @@
     std::shared_ptr<ms::SceneReport> const report = mr::null_scene_report();
     void const* compositor_id{nullptr};
     std::shared_ptr<ms::LegacySurfaceChangeNotification> observer =
-        std::make_shared<ms::LegacySurfaceChangeNotification>(mock_change_cb, [this](int){mock_change_cb();});
+        std::make_shared<ms::LegacySurfaceChangeNotification>(mock_change_cb);
     std::shared_ptr<mi::InputSender> const stub_input_sender = std::make_shared<mtd::StubInputSender>();
     testing::NiceMock<mtd::MockInputSender> mock_sender;
 

=== modified file 'tests/unit-tests/scene/test_legacy_scene_change_notification.cpp'
--- tests/unit-tests/scene/test_legacy_scene_change_notification.cpp	2015-06-01 16:19:11 +0000
+++ tests/unit-tests/scene/test_legacy_scene_change_notification.cpp	2015-06-10 12:39:17 +0000
@@ -66,7 +66,8 @@
 
 TEST_F(LegacySceneChangeNotificationTest, registers_observer_with_surfaces)
 {
-    EXPECT_CALL(surface, add_observer(testing::_))
+    using namespace testing;
+    EXPECT_CALL(surface, add_observer(Matcher<std::shared_ptr<ms::SurfaceObserver> const&>(_)))
         .Times(1);
 
     ms::LegacySceneChangeNotification observer(scene_change_callback, buffer_change_callback);
@@ -75,7 +76,8 @@
 
 TEST_F(LegacySceneChangeNotificationTest, registers_observer_with_existing_surfaces)
 {
-    EXPECT_CALL(surface, add_observer(testing::_))
+    using namespace testing;
+    EXPECT_CALL(surface, add_observer(Matcher<std::shared_ptr<ms::SurfaceObserver> const&>(_)))
         .Times(1);
 
     ms::LegacySceneChangeNotification observer(scene_change_callback, buffer_change_callback);
@@ -85,8 +87,8 @@
 TEST_F(LegacySceneChangeNotificationTest, observes_surface_changes)
 {
     using namespace ::testing;
-    std::shared_ptr<ms::SurfaceObserver> surface_observer;
-    EXPECT_CALL(surface, add_observer(_)).Times(1)
+    std::shared_ptr<ms::StreamObserver> surface_observer;
+    EXPECT_CALL(surface, add_observer(Matcher<std::shared_ptr<ms::StreamObserver> const&>(_)))
         .WillOnce(SaveArg<0>(&surface_observer));
    
     int buffer_num{3}; 
@@ -104,7 +106,7 @@
 
     std::shared_ptr<ms::SurfaceObserver> surface_observer;
 
-    EXPECT_CALL(surface, add_observer(_)).Times(1)
+    EXPECT_CALL(surface, add_observer(Matcher<std::shared_ptr<ms::SurfaceObserver> const&>(_)))
         .WillOnce(SaveArg<0>(&surface_observer));
     EXPECT_CALL(scene_callback, invoke()).Times(1);
 
@@ -118,9 +120,9 @@
 {
     using namespace ::testing;
     
-    EXPECT_CALL(surface, add_observer(_))
+    EXPECT_CALL(surface, add_observer(Matcher<std::shared_ptr<ms::SurfaceObserver> const&>(_)))
         .Times(1);
-    EXPECT_CALL(surface, remove_observer(_))
+    EXPECT_CALL(surface, remove_observer(Matcher<std::weak_ptr<ms::SurfaceObserver> const&>(_)))
         .Times(1);
     {
         ms::LegacySceneChangeNotification observer(scene_change_callback, buffer_change_callback);
@@ -131,9 +133,9 @@
 TEST_F(LegacySceneChangeNotificationTest, ending_observation_unregisters_observers)
 {
     using namespace ::testing;
-    EXPECT_CALL(surface, add_observer(_))
+    EXPECT_CALL(surface, add_observer(Matcher<std::shared_ptr<ms::SurfaceObserver> const&>(_)))
         .Times(1);
-    EXPECT_CALL(surface, remove_observer(_))
+    EXPECT_CALL(surface, remove_observer(Matcher<std::weak_ptr<ms::SurfaceObserver> const&>(_)))
         .Times(1);
 
     ms::LegacySceneChangeNotification observer(scene_change_callback, buffer_change_callback);