1 // Copyright 2017 The Chromium Authors. All rights reserved.
2 // Use of this source code is governed by a BSD-style license that can be
3 // found in the LICENSE file.
5 #include "cc/mojo_embedder/async_layer_tree_frame_sink.h"
10 #include "base/metrics/histogram.h"
11 #include "base/metrics/histogram_base.h"
12 #include "base/metrics/histogram_functions.h"
13 #include "base/metrics/histogram_macros.h"
14 #include "base/trace_event/trace_event.h"
15 #include "cc/base/histograms.h"
16 #include "cc/trees/layer_tree_frame_sink_client.h"
17 #include "components/viz/common/features.h"
18 #include "components/viz/common/frame_sinks/begin_frame_args.h"
19 #include "components/viz/common/hit_test/hit_test_region_list.h"
20 #include "components/viz/common/quads/compositor_frame.h"
24 base::HistogramBase* GetHistogramNamed(const char* histogram_name_format,
25 const char* client_name) {
29 return base::LinearHistogram::FactoryMicrosecondsTimeGet(
30 base::StringPrintf(histogram_name_format, client_name),
31 base::TimeDelta::FromMicroseconds(1),
32 base::TimeDelta::FromMilliseconds(200), 50,
33 base::HistogramBase::kUmaTargetedHistogramFlag);
38 namespace mojo_embedder {
40 AsyncLayerTreeFrameSink::PipelineReporting::PipelineReporting(
41 const viz::BeginFrameArgs args,
43 base::HistogramBase* submit_begin_frame_histogram)
44 : trace_id_(args.trace_id),
46 submit_begin_frame_histogram_(submit_begin_frame_histogram) {}
48 AsyncLayerTreeFrameSink::PipelineReporting::~PipelineReporting() = default;
50 void AsyncLayerTreeFrameSink::PipelineReporting::Report() {
51 TRACE_EVENT_WITH_FLOW1("viz,benchmark", "Graphics.Pipeline",
52 TRACE_ID_GLOBAL(trace_id_),
53 TRACE_EVENT_FLAG_FLOW_IN | TRACE_EVENT_FLAG_FLOW_OUT,
54 "step", "SubmitCompositorFrame");
55 auto report_time = base::TimeTicks::Now() - frame_time_;
57 if (submit_begin_frame_histogram_)
58 submit_begin_frame_histogram_->AddTimeMicrosecondsGranularity(report_time);
61 AsyncLayerTreeFrameSink::InitParams::InitParams() = default;
62 AsyncLayerTreeFrameSink::InitParams::~InitParams() = default;
64 AsyncLayerTreeFrameSink::UnboundMessagePipes::UnboundMessagePipes() = default;
65 AsyncLayerTreeFrameSink::UnboundMessagePipes::~UnboundMessagePipes() = default;
67 bool AsyncLayerTreeFrameSink::UnboundMessagePipes::HasUnbound() const {
68 return client_receiver.is_valid() &&
69 (compositor_frame_sink_remote.is_valid() ^
70 compositor_frame_sink_associated_remote.is_valid());
73 AsyncLayerTreeFrameSink::UnboundMessagePipes::UnboundMessagePipes(
74 UnboundMessagePipes&& other) = default;
76 AsyncLayerTreeFrameSink::AsyncLayerTreeFrameSink(
77 scoped_refptr<viz::ContextProvider> context_provider,
78 scoped_refptr<viz::RasterContextProvider> worker_context_provider,
80 : LayerTreeFrameSink(std::move(context_provider),
81 std::move(worker_context_provider),
82 std::move(params->compositor_task_runner),
83 params->gpu_memory_buffer_manager),
84 synthetic_begin_frame_source_(
85 std::move(params->synthetic_begin_frame_source)),
86 pipes_(std::move(params->pipes)),
87 wants_animate_only_begin_frames_(params->wants_animate_only_begin_frames),
88 receive_begin_frame_histogram_(
89 GetHistogramNamed("GraphicsPipeline.%s.ReceivedBeginFrame",
90 params->client_name)),
91 submit_begin_frame_histogram_(GetHistogramNamed(
92 "GraphicsPipeline.%s.SubmitCompositorFrameAfterBeginFrame",
93 params->client_name)) {
94 DETACH_FROM_THREAD(thread_checker_);
97 AsyncLayerTreeFrameSink::~AsyncLayerTreeFrameSink() {}
99 bool AsyncLayerTreeFrameSink::BindToClient(LayerTreeFrameSinkClient* client) {
100 DCHECK_CALLED_ON_VALID_THREAD(thread_checker_);
102 if (!LayerTreeFrameSink::BindToClient(client))
105 DCHECK(pipes_.HasUnbound());
106 if (pipes_.compositor_frame_sink_remote.is_valid()) {
107 compositor_frame_sink_.Bind(std::move(pipes_.compositor_frame_sink_remote));
108 compositor_frame_sink_.set_disconnect_with_reason_handler(
109 base::BindOnce(&AsyncLayerTreeFrameSink::OnMojoConnectionError,
110 weak_factory_.GetWeakPtr()));
111 compositor_frame_sink_ptr_ = compositor_frame_sink_.get();
112 } else if (pipes_.compositor_frame_sink_associated_remote.is_valid()) {
113 compositor_frame_sink_associated_.Bind(
114 std::move(pipes_.compositor_frame_sink_associated_remote));
115 compositor_frame_sink_associated_.set_disconnect_with_reason_handler(
116 base::BindOnce(&AsyncLayerTreeFrameSink::OnMojoConnectionError,
117 weak_factory_.GetWeakPtr()));
118 compositor_frame_sink_ptr_ = compositor_frame_sink_associated_.get();
120 client_receiver_.Bind(std::move(pipes_.client_receiver),
121 compositor_task_runner_);
123 if (synthetic_begin_frame_source_) {
124 client->SetBeginFrameSource(synthetic_begin_frame_source_.get());
126 begin_frame_source_ = std::make_unique<viz::ExternalBeginFrameSource>(this);
127 begin_frame_source_->OnSetBeginFrameSourcePaused(begin_frames_paused_);
128 client->SetBeginFrameSource(begin_frame_source_.get());
131 if (wants_animate_only_begin_frames_)
132 compositor_frame_sink_->SetWantsAnimateOnlyBeginFrames();
134 compositor_frame_sink_ptr_->InitializeCompositorFrameSinkType(
135 viz::mojom::CompositorFrameSinkType::kLayerTree);
140 void AsyncLayerTreeFrameSink::DetachFromClient() {
141 DCHECK_CALLED_ON_VALID_THREAD(thread_checker_);
142 client_->SetBeginFrameSource(nullptr);
143 begin_frame_source_.reset();
144 synthetic_begin_frame_source_.reset();
145 client_receiver_.reset();
146 compositor_frame_sink_.reset();
147 compositor_frame_sink_associated_.reset();
148 compositor_frame_sink_ptr_ = nullptr;
149 LayerTreeFrameSink::DetachFromClient();
152 void AsyncLayerTreeFrameSink::SetLocalSurfaceId(
153 const viz::LocalSurfaceId& local_surface_id) {
154 DCHECK_CALLED_ON_VALID_THREAD(thread_checker_);
155 DCHECK(local_surface_id.is_valid());
156 local_surface_id_ = local_surface_id;
159 void AsyncLayerTreeFrameSink::SubmitCompositorFrame(
160 viz::CompositorFrame frame,
161 bool hit_test_data_changed,
162 bool show_hit_test_borders) {
163 DCHECK_CALLED_ON_VALID_THREAD(thread_checker_);
164 DCHECK(compositor_frame_sink_ptr_);
165 DCHECK(frame.metadata.begin_frame_ack.has_damage);
166 DCHECK(frame.metadata.begin_frame_ack.frame_id.IsSequenceValid());
168 // It's possible to request an immediate composite from cc which will bypass
169 // BeginFrame. In that case, we cannot collect full graphics pipeline data.
170 auto it = pipeline_reporting_frame_times_.find(
171 frame.metadata.begin_frame_ack.trace_id);
172 if (it != pipeline_reporting_frame_times_.end()) {
174 pipeline_reporting_frame_times_.erase(it);
178 local_surface_id_ = viz::LocalSurfaceId(viz::kInitialParentSequenceNumber,
179 viz::kInitialChildSequenceNumber,
180 base::UnguessableToken::Create());
182 if (local_surface_id_ == last_submitted_local_surface_id_) {
183 DCHECK_EQ(last_submitted_device_scale_factor_, frame.device_scale_factor());
184 DCHECK_EQ(last_submitted_size_in_pixels_.height(),
185 frame.size_in_pixels().height());
186 DCHECK_EQ(last_submitted_size_in_pixels_.width(),
187 frame.size_in_pixels().width());
190 base::Optional<viz::HitTestRegionList> hit_test_region_list =
191 client_->BuildHitTestData();
193 if (show_hit_test_borders && hit_test_region_list)
194 hit_test_region_list->flags |= viz::HitTestRegionFlags::kHitTestDebug;
196 // If |hit_test_data_changed| was set or local_surface_id has been updated,
197 // we always send hit-test data; otherwise we check for equality with the
198 // last submitted hit-test data for possible optimization.
199 if (!hit_test_region_list) {
200 last_hit_test_data_ = viz::HitTestRegionList();
201 } else if (!hit_test_data_changed &&
202 local_surface_id_ == last_submitted_local_surface_id_) {
203 if (viz::HitTestRegionList::IsEqual(*hit_test_region_list,
204 last_hit_test_data_)) {
205 DCHECK(!viz::HitTestRegionList::IsEqual(*hit_test_region_list,
206 viz::HitTestRegionList()));
207 hit_test_region_list = base::nullopt;
209 last_hit_test_data_ = *hit_test_region_list;
212 UMA_HISTOGRAM_BOOLEAN("Event.VizHitTest.HitTestDataIsEqualAccuracy",
213 !hit_test_region_list);
215 last_hit_test_data_ = *hit_test_region_list;
218 if (last_submitted_local_surface_id_ != local_surface_id_) {
219 last_submitted_local_surface_id_ = local_surface_id_;
220 last_submitted_device_scale_factor_ = frame.device_scale_factor();
221 last_submitted_size_in_pixels_ = frame.size_in_pixels();
223 // These traces are split into two due to the incoming flow using
224 // TRACE_ID_LOCAL, and the outgoing flow using TRACE_ID_GLOBAL. This is
225 // needed to ensure the incoming flow is not messed up. The outgoing flow is
226 // going to a different process.
227 TRACE_EVENT_WITH_FLOW2(
228 TRACE_DISABLED_BY_DEFAULT("viz.surface_id_flow"),
229 "LocalSurfaceId.Submission.Flow",
230 TRACE_ID_LOCAL(local_surface_id_.submission_trace_id()),
231 TRACE_EVENT_FLAG_FLOW_IN, "step", "SubmitCompositorFrame", "surface_id",
232 local_surface_id_.ToString());
233 TRACE_EVENT_WITH_FLOW2(
234 TRACE_DISABLED_BY_DEFAULT("viz.surface_id_flow"),
235 "LocalSurfaceId.Submission.Flow",
236 TRACE_ID_GLOBAL(local_surface_id_.submission_trace_id()),
237 TRACE_EVENT_FLAG_FLOW_OUT, "step", "SubmitCompositorFrame",
238 "surface_id", local_surface_id_.ToString());
241 // The trace_id is negated in order to keep the Graphics.Pipeline and
242 // Event.Pipeline flows separated.
243 const int64_t trace_id = ~frame.metadata.begin_frame_ack.trace_id;
244 TRACE_EVENT_WITH_FLOW1(TRACE_DISABLED_BY_DEFAULT("viz.hit_testing_flow"),
245 "Event.Pipeline", TRACE_ID_GLOBAL(trace_id),
246 TRACE_EVENT_FLAG_FLOW_OUT, "step",
247 "SubmitHitTestData");
249 compositor_frame_sink_ptr_->SubmitCompositorFrame(
250 local_surface_id_, std::move(frame), std::move(hit_test_region_list), 0);
253 void AsyncLayerTreeFrameSink::DidNotProduceFrame(
254 const viz::BeginFrameAck& ack) {
255 DCHECK(compositor_frame_sink_ptr_);
256 DCHECK(!ack.has_damage);
257 DCHECK(ack.frame_id.IsSequenceValid());
259 // TODO(yiyix): Remove duplicated calls of DidNotProduceFrame from the same
260 // BeginFrames. https://crbug.com/881949
261 auto it = pipeline_reporting_frame_times_.find(ack.trace_id);
262 if (it != pipeline_reporting_frame_times_.end()) {
263 TRACE_EVENT_WITH_FLOW1("viz,benchmark", "Graphics.Pipeline",
264 TRACE_ID_GLOBAL(ack.trace_id),
265 TRACE_EVENT_FLAG_FLOW_IN | TRACE_EVENT_FLAG_FLOW_OUT,
266 "step", "DidNotProduceFrame");
267 compositor_frame_sink_ptr_->DidNotProduceFrame(ack);
268 pipeline_reporting_frame_times_.erase(it);
272 void AsyncLayerTreeFrameSink::DidAllocateSharedBitmap(
273 base::ReadOnlySharedMemoryRegion region,
274 const viz::SharedBitmapId& id) {
275 DCHECK(compositor_frame_sink_ptr_);
276 compositor_frame_sink_ptr_->DidAllocateSharedBitmap(std::move(region), id);
279 void AsyncLayerTreeFrameSink::DidDeleteSharedBitmap(
280 const viz::SharedBitmapId& id) {
281 DCHECK(compositor_frame_sink_ptr_);
282 compositor_frame_sink_ptr_->DidDeleteSharedBitmap(id);
285 void AsyncLayerTreeFrameSink::DidReceiveCompositorFrameAck(
286 const std::vector<viz::ReturnedResource>& resources) {
287 DCHECK_CALLED_ON_VALID_THREAD(thread_checker_);
288 client_->ReclaimResources(resources);
289 client_->DidReceiveCompositorFrameAck();
292 void AsyncLayerTreeFrameSink::OnBeginFrame(
293 const viz::BeginFrameArgs& args,
294 const viz::FrameTimingDetailsMap& timing_details) {
295 for (const auto& pair : timing_details) {
296 client_->DidPresentCompositorFrame(pair.first, pair.second);
299 DCHECK_LE(pipeline_reporting_frame_times_.size(), 25u);
300 if (args.trace_id != -1) {
301 base::TimeTicks current_time = base::TimeTicks::Now();
302 PipelineReporting report(args, current_time, submit_begin_frame_histogram_);
303 pipeline_reporting_frame_times_.emplace(args.trace_id, report);
304 // Missed BeginFrames use the frame time of the last received BeginFrame
305 // which is bogus from a reporting perspective if nothing has been updating
306 // on screen for a while.
307 if (args.type != viz::BeginFrameArgs::MISSED) {
308 base::TimeDelta frame_difference = current_time - args.frame_time;
310 if (receive_begin_frame_histogram_) {
311 receive_begin_frame_histogram_->AddTimeMicrosecondsGranularity(
316 if (!needs_begin_frames_) {
317 TRACE_EVENT_WITH_FLOW1("viz,benchmark", "Graphics.Pipeline",
318 TRACE_ID_GLOBAL(args.trace_id),
319 TRACE_EVENT_FLAG_FLOW_IN | TRACE_EVENT_FLAG_FLOW_OUT,
320 "step", "ReceiveBeginFrameDiscard");
321 // We had a race with SetNeedsBeginFrame(false) and still need to let the
322 // sink know that we didn't use this BeginFrame. OnBeginFrame() can also be
323 // called to deliver presentation feedback.
324 DidNotProduceFrame(viz::BeginFrameAck(args, false));
327 TRACE_EVENT_WITH_FLOW1("viz,benchmark", "Graphics.Pipeline",
328 TRACE_ID_GLOBAL(args.trace_id),
329 TRACE_EVENT_FLAG_FLOW_IN | TRACE_EVENT_FLAG_FLOW_OUT,
330 "step", "ReceiveBeginFrame");
332 if (begin_frame_source_)
333 begin_frame_source_->OnBeginFrame(args);
336 void AsyncLayerTreeFrameSink::OnBeginFramePausedChanged(bool paused) {
337 begin_frames_paused_ = paused;
338 if (begin_frame_source_)
339 begin_frame_source_->OnSetBeginFrameSourcePaused(paused);
342 void AsyncLayerTreeFrameSink::ReclaimResources(
343 const std::vector<viz::ReturnedResource>& resources) {
344 DCHECK_CALLED_ON_VALID_THREAD(thread_checker_);
345 client_->ReclaimResources(resources);
348 void AsyncLayerTreeFrameSink::OnNeedsBeginFrames(bool needs_begin_frames) {
349 DCHECK(compositor_frame_sink_ptr_);
350 if (needs_begin_frames_ != needs_begin_frames) {
351 if (needs_begin_frames_) {
352 TRACE_EVENT_ASYNC_END0("cc,benchmark", "NeedsBeginFrames", this);
354 TRACE_EVENT_ASYNC_BEGIN0("cc,benchmark", "NeedsBeginFrames", this);
357 needs_begin_frames_ = needs_begin_frames;
358 compositor_frame_sink_ptr_->SetNeedsBeginFrame(needs_begin_frames);
361 void AsyncLayerTreeFrameSink::OnMojoConnectionError(
362 uint32_t custom_reason,
363 const std::string& description) {
365 DLOG(FATAL) << description;
367 client_->DidLoseLayerTreeFrameSink();
370 } // namespace mojo_embedder