1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
|
// Copyright 2017 The Chromium Authors
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.
#ifndef COMPONENTS_VIZ_SERVICE_SURFACES_SURFACE_CLIENT_H_
#define COMPONENTS_VIZ_SERVICE_SURFACES_SURFACE_CLIENT_H_
#include <memory>
#include <vector>
#include "base/containers/flat_set.h"
#include "base/threading/platform_thread.h"
#include "components/viz/common/performance_hint_utils.h"
#include "components/viz/common/resources/returned_resource.h"
#include "components/viz/service/surfaces/pending_copy_output_request.h"
#include "components/viz/service/viz_service_export.h"
namespace base {
class TimeTicks;
} // namespace base
namespace gfx {
struct PresentationFeedback;
class Rect;
struct SwapTimings;
} // namespace gfx
namespace viz {
struct ReturnedResource;
class CompositorFrame;
class LocalSurfaceId;
class Surface;
struct TransferableResource;
class VIZ_SERVICE_EXPORT SurfaceClient {
public:
SurfaceClient() = default;
SurfaceClient(const SurfaceClient&) = delete;
SurfaceClient& operator=(const SurfaceClient&) = delete;
virtual ~SurfaceClient() = default;
// Called when |surface| has committed a new CompositorFrame that become
// pending or active.
virtual void OnSurfaceCommitted(Surface* surface) = 0;
// Called when |surface| has a new CompositorFrame available for display.
virtual void OnSurfaceActivated(Surface* surface) = 0;
// Called when |surface| has completed destruction.
virtual void OnSurfaceDestroyed(Surface* surface) = 0;
// Called when a |surface| is about to be drawn.
virtual void OnSurfaceWillDraw(Surface* surface) = 0;
// Increments the reference count on resources specified by |resources|.
virtual void RefResources(
const std::vector<TransferableResource>& resources) = 0;
// Decrements the reference count on resources specified by |resources|.
virtual void UnrefResources(std::vector<ReturnedResource> resources) = 0;
// ReturnResources gets called when the display compositor is done using the
// resources so that the client can use them.
virtual void ReturnResources(std::vector<ReturnedResource> resources) = 0;
// Increments the reference count of resources received from a child
// compositor.
virtual void ReceiveFromChild(
const std::vector<TransferableResource>& resources) = 0;
// Takes all the CopyOutputRequests made at the client level that happened for
// a LocalSurfaceId preceeding the given one.
virtual std::vector<PendingCopyOutputRequest> TakeCopyOutputRequests(
const LocalSurfaceId& latest_surface_id) = 0;
// Notifies the client that a frame with |token| has been activated.
virtual void OnFrameTokenChanged(uint32_t frame_token) = 0;
// Sends a compositor frame ack to the client. Usually happens when viz is
// ready to receive another frame without dropping previous one.
virtual void SendCompositorFrameAck() = 0;
// Notifies the client that a frame with |token| has been presented.
virtual void OnSurfacePresented(
uint32_t frame_token,
base::TimeTicks draw_start_timestamp,
const gfx::SwapTimings& swap_timings,
const gfx::PresentationFeedback& feedback) = 0;
// This is called when |surface| or one of its descendents is determined to be
// damaged at aggregation time.
virtual void OnSurfaceAggregatedDamage(
Surface* surface,
const LocalSurfaceId& local_surface_id,
const CompositorFrame& frame,
const gfx::Rect& damage_rect,
base::TimeTicks expected_display_time) = 0;
virtual bool IsVideoCaptureStarted() = 0;
virtual std::vector<Thread> GetThreads() = 0;
};
} // namespace viz
#endif // COMPONENTS_VIZ_SERVICE_SURFACES_SURFACE_CLIENT_H_
|
