Flutter iOS Embedder
ios_external_view_embedder.mm
Go to the documentation of this file.
1 // Copyright 2013 The Flutter 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.
4 
6 #include "fml/task_runner.h"
7 
8 #include "flutter/common/constants.h"
9 
11 
12 namespace flutter {
13 
15  const std::shared_ptr<PlatformViewsController>& platform_views_controller,
16  const std::shared_ptr<IOSContext>& context)
17  : platform_views_controller_(platform_views_controller), ios_context_(context) {
18  FML_CHECK(ios_context_);
19 }
20 
22 
23 // |ExternalViewEmbedder|
24 DlCanvas* IOSExternalViewEmbedder::GetRootCanvas() {
25  // On iOS, the root surface is created from the on-screen render target. Only the surfaces for the
26  // various overlays are controlled by this class.
27  return nullptr;
28 }
29 
30 // |ExternalViewEmbedder|
31 void IOSExternalViewEmbedder::CancelFrame() {
32  TRACE_EVENT0("flutter", "IOSExternalViewEmbedder::CancelFrame");
33  FML_CHECK(platform_views_controller_);
34  platform_views_controller_->CancelFrame();
35 }
36 
37 // |ExternalViewEmbedder|
38 void IOSExternalViewEmbedder::BeginFrame(
39  GrDirectContext* context,
40  const fml::RefPtr<fml::RasterThreadMerger>& raster_thread_merger) {}
41 
42 // |ExternalViewEmbedder|
43 void IOSExternalViewEmbedder::PrepareFlutterView(SkISize frame_size, double device_pixel_ratio) {
44  FML_CHECK(platform_views_controller_);
45  platform_views_controller_->BeginFrame(frame_size);
46 }
47 
48 // |ExternalViewEmbedder|
49 void IOSExternalViewEmbedder::PrerollCompositeEmbeddedView(
50  int64_t view_id,
51  std::unique_ptr<EmbeddedViewParams> params) {
52  TRACE_EVENT0("flutter", "IOSExternalViewEmbedder::PrerollCompositeEmbeddedView");
53  FML_CHECK(platform_views_controller_);
54  platform_views_controller_->PrerollCompositeEmbeddedView(view_id, std::move(params));
55 }
56 
57 // |ExternalViewEmbedder|
58 PostPrerollResult IOSExternalViewEmbedder::PostPrerollAction(
59  const fml::RefPtr<fml::RasterThreadMerger>& raster_thread_merger) {
60  TRACE_EVENT0("flutter", "IOSExternalViewEmbedder::PostPrerollAction");
61  FML_CHECK(platform_views_controller_);
62  PostPrerollResult result = platform_views_controller_->PostPrerollAction(
63  raster_thread_merger, ios_context_->GetBackend() != IOSRenderingBackend::kSkia);
64  return result;
65 }
66 
67 // |ExternalViewEmbedder|
68 DlCanvas* IOSExternalViewEmbedder::CompositeEmbeddedView(int64_t view_id) {
69  TRACE_EVENT0("flutter", "IOSExternalViewEmbedder::CompositeEmbeddedView");
70  FML_CHECK(platform_views_controller_);
71  return platform_views_controller_->CompositeEmbeddedView(view_id);
72 }
73 
74 // |ExternalViewEmbedder|
75 void IOSExternalViewEmbedder::SubmitFlutterView(
76  int64_t flutter_view_id,
77  GrDirectContext* context,
78  const std::shared_ptr<impeller::AiksContext>& aiks_context,
79  std::unique_ptr<SurfaceFrame> frame) {
80  TRACE_EVENT0("flutter", "IOSExternalViewEmbedder::SubmitFlutterView");
81 
82  // TODO(dkwingsmt): This class only supports rendering into the implicit view.
83  // Properly support multi-view in the future.
84  FML_DCHECK(flutter_view_id == kFlutterImplicitViewId);
85  FML_CHECK(platform_views_controller_);
86  platform_views_controller_->SubmitFrame(context, ios_context_, std::move(frame));
87  TRACE_EVENT0("flutter", "IOSExternalViewEmbedder::DidSubmitFrame");
88 }
89 
90 // |ExternalViewEmbedder|
91 void IOSExternalViewEmbedder::EndFrame(
92  bool should_resubmit_frame,
93  const fml::RefPtr<fml::RasterThreadMerger>& raster_thread_merger) {
94  TRACE_EVENT0("flutter", "IOSExternalViewEmbedder::EndFrame");
95  platform_views_controller_->EndFrame(should_resubmit_frame, raster_thread_merger,
96  ios_context_->GetBackend() != IOSRenderingBackend::kSkia);
97 }
98 
99 // |ExternalViewEmbedder|
100 bool IOSExternalViewEmbedder::SupportsDynamicThreadMerging() {
101 // TODO(jonahwilliams): remove this once Software backend is removed for iOS Sim.
102 #if FML_OS_IOS_SIMULATOR
103  return true;
104 #else
105  return ios_context_->GetBackend() == IOSRenderingBackend::kSkia;
106 #endif // FML_OS_IOS_SIMULATOR
107 }
108 
109 // |ExternalViewEmbedder|
110 void IOSExternalViewEmbedder::PushFilterToVisitedPlatformViews(
111  const std::shared_ptr<const DlImageFilter>& filter,
112  const SkRect& filter_rect) {
113  platform_views_controller_->PushFilterToVisitedPlatformViews(filter, filter_rect);
114 }
115 
116 // |ExternalViewEmbedder|
117 void IOSExternalViewEmbedder::PushVisitedPlatformView(int64_t view_id) {
118  platform_views_controller_->PushVisitedPlatformView(view_id);
119 }
120 
121 } // namespace flutter
flutter::IOSRenderingBackend::kSkia
@ kSkia
ios_external_view_embedder.h
flutter::IOSExternalViewEmbedder::~IOSExternalViewEmbedder
virtual ~IOSExternalViewEmbedder() override
flutter
Definition: accessibility_bridge.h:28
flutter::IOSExternalViewEmbedder::IOSExternalViewEmbedder
IOSExternalViewEmbedder(const std::shared_ptr< PlatformViewsController > &platform_views_controller, const std::shared_ptr< IOSContext > &context)
Definition: ios_external_view_embedder.mm:14
FLUTTER_ASSERT_ARC
Definition: FlutterChannelKeyResponder.mm:13