GpuCompositorFrameSink implements cc::mojom::DisplayPrivate

cc/ipc/display_compositor.mojom

 // 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.
 
 module cc.mojom;
 
 import "cc/ipc/frame_sink_id.mojom";
 import "cc/ipc/mojo_compositor_frame_sink.mojom";
 import "cc/ipc/surface_id.mojom";
 import "cc/ipc/surface_sequence.mojom";
 import "gpu/ipc/common/surface_handle.mojom";
+import "mojo/common/time.mojom";
 import "ui/gfx/geometry/mojo/geometry.mojom";
+import "ui/gfx/mojo/color_space.mojom";
+
+// See ui/compositor/compositor.h: ContextFactoryPrivate.
+// The DisplayPrivate is used by privileged clients to talk to cc::Display.
+// DisplayPrivate would eventually replace or be used by ContextFactoryPrivate.
+interface DisplayPrivate {
+  SetDisplayVisible(bool visible);
+  ResizeDisplay(gfx.mojom.Size size_in_pixel);
+  SetDisplayColorSpace(gfx.mojom.ColorSpace color_space);
+  SetOutputIsSecure(bool secure);
+};
 
 // The DisplayCompositor interface is a privileged interface that allows
 // the display compositor host (browser or window server) to create
 // CompositorFrameSinks. Clients acquire a CompositorFrameSink connection
 // through the display compositor host. Clients request a
 // MojoCompositorFrameSink interface, and implement a
 // MojoCompositorFrameSinkClient interface. The display compositor host
 // holds one or more root CompositorFrameSinks that are tied to a valid
 // |surface_handle|. All other CompositorFrameSinks are offscreen. FrameSinkIds
 // are fixed for a given client and are determined ahead of time. Thus, a client
 // will typically simply request a CompositorFrameSink from the display
 // compositor host which will forward the request to the display compositor.
 interface DisplayCompositor {
+  // Create a CompositorFrameSink for a privileged client (e.g. WindowServer).
+  // This is only used by privileged clients. The client can call methods that
+  // talks to the cc::Display (e.g. ResizeDisplay(), SetDisplayVisible(), etc)
   CreateDisplayCompositorFrameSink(
       cc.mojom.FrameSinkId frame_sink_id,
       gpu.mojom.SurfaceHandle widget,
       cc.mojom.MojoCompositorFrameSink& compositor_frame_sink,
       cc.mojom.MojoCompositorFrameSinkPrivate& compositor_frame_sink_private,
-      cc.mojom.MojoCompositorFrameSinkClient compositor_frame_sink_client);
+      cc.mojom.MojoCompositorFrameSinkClient compositor_frame_sink_client,
+      DisplayPrivate& display_private);
 
+  // CreateOffscreenCompositorFrameSink is used by non-privileged clients.

[Fady Samuel, 2016/12/21 18:09:09]

nit: unprivileged

[Alex Z., 2016/12/21 18:36:14]

Done.

+  // An off screen CompositorFrameSink only submits frames to a buffer instead
+  // of a display.
   CreateOffscreenCompositorFrameSink(
       cc.mojom.FrameSinkId frame_sink_id,
       cc.mojom.MojoCompositorFrameSink& compositor_frame_sink,
       cc.mojom.MojoCompositorFrameSinkPrivate& compositor_frame_sink_private,
       cc.mojom.MojoCompositorFrameSinkClient compositor_frame_sink_client);
 };
 
 // The DisplayCompositorClient interface is implemented by the Display
 // Compositor Host, a stable, and privileged peer service to the display
 // compositor. The display compositor host is either the browser process in
 // Chrome or the window server process.
 interface DisplayCompositorClient {
   // Called by the display compostor when it is created. Provides the top level
   // root surface id that should reference display roots. This will always be
   // the first message sent.
   OnDisplayCompositorCreated(cc.mojom.SurfaceId root_surface_id);
 
   // Called by the display compositor immediately upon receiving a
   // CompositorFrame with a new SurfaceId for the first time.
   OnSurfaceCreated(cc.mojom.SurfaceId surface_id,
                    gfx.mojom.Size frame_size,
                    float device_scale_factor);
 };