| Flutter iOS Embedder |

Public Member Functions | List of all members
flutter::OverlayLayerPool Class Reference

Storage for Overlay layers across frames. More...

`#include <overlay_layer_pool.h>`

## Public Member Functions
| OverlayLayerPool ()=default
| ~OverlayLayerPool ()=default
std::shared_ptr< OverlayLayer > | GetNextLayer ()
| Gets a layer from the pool if available. More...
void | CreateLayer (GrDirectContext *gr_context, const std::shared_ptr< IOSContext > &ios_context, MTLPixelFormat pixel_format)
| Create a new overlay layer. More...
std::vector< std::shared_ptr< OverlayLayer > > | RemoveUnusedLayers ()
| Removes unused layers from the pool. Returns the unused layers. More...
void | RecycleLayers ()
| Marks the layers in the pool as available for reuse. More...
size_t | size () const
| The count of layers currently in the pool. More...

## Detailed Description

Storage for Overlay layers across frames.

Note: this class does not synchronize access to its layers or any layer removal. As it is currently used, layers must be created on the platform thread but other methods of it are called on the raster thread. This is safe as overlay layers are only ever added while the raster thread is latched.

Definition at line 52 of file overlay_layer_pool.h.

## Constructor & Destructor Documentation

## ◆ OverlayLayerPool()

flutter::OverlayLayerPool::OverlayLayerPool | ( |  | ) |
| default

## ◆ ~OverlayLayerPool()

flutter::OverlayLayerPool::~OverlayLayerPool | ( |  | ) |
| default

## Member Function Documentation

## ◆ CreateLayer()

void flutter::OverlayLayerPool::CreateLayer | ( | GrDirectContext * | gr_context,
|  | const std::shared_ptr< IOSContext > & | ios_context,
|  | MTLPixelFormat | pixel_format
| ) |  |

Create a new overlay layer.

This method can only be called on the Platform thread.

Definition at line 55 of file overlay_layer_pool.mm.

57 {
58 FML_DCHECK([[NSThread currentThread] isMainThread]);
59 std::shared_ptr<OverlayLayer> layer;
60 UIView* overlay_view;
61 UIView* overlay_view_wrapper;
62
63 bool impeller_enabled = !!ios_context->GetImpellerContext();
64 if (!gr_context && !impeller_enabled) {
65 overlay_view = [[FlutterOverlayView alloc] init];
66 overlay_view_wrapper = [[FlutterOverlayView alloc] init];
67
68 CALayer* ca_layer = overlay_view.layer;
69 std::unique_ptr<IOSSurface> ios_surface = IOSSurface::Create(ios_context, ca_layer);
70 std::unique_ptr<Surface> surface = ios_surface->CreateGPUSurface();
71
72 layer = std::make_shared<OverlayLayer>(overlay_view, overlay_view_wrapper,
73 std::move(ios_surface), std::move(surface));
74 } else {
75 CGFloat screenScale = [UIScreen mainScreen].scale;
76 overlay_view = [[FlutterOverlayView alloc] initWithContentsScale:screenScale
77 pixelFormat:pixel_format];
78 overlay_view_wrapper = [[FlutterOverlayView alloc] initWithContentsScale:screenScale
79 pixelFormat:pixel_format];
80
81 CALayer* ca_layer = overlay_view.layer;
82 std::unique_ptr<IOSSurface> ios_surface = IOSSurface::Create(ios_context, ca_layer);
83 std::unique_ptr<Surface> surface = ios_surface->CreateGPUSurface(gr_context);
84
85 layer = std::make_shared<OverlayLayer>(overlay_view, overlay_view_wrapper,
86 std::move(ios_surface), std::move(surface));
87 layer->gr_context = gr_context;
88 }
89 // The overlay view wrapper masks the overlay view.
90 // This is required to keep the backing surface size unchanged between frames.
91 //
92 // Otherwise, changing the size of the overlay would require a new surface,
93 // which can be very expensive.
94 //
95 // This is the case of an animation in which the overlay size is changing in every frame.
96 //
97 // +------------------------+
98 // | overlay_view |
99 // | +--------------+ | +--------------+
100 // | | wrapper | | == mask => | overlay_view |
101 // | +--------------+ | +--------------+
102 // +------------------------+
103 layer->overlay_view_wrapper.clipsToBounds = YES;
104 [layer->overlay_view_wrapper addSubview:layer->overlay_view];
105
106 layers_.push_back(layer);
107 }
flutter::IOSSurface::Create
static std::unique_ptr< IOSSurface > Create(std::shared_ptr< IOSContext > context, CALayer *layer)
Definition: ios_surface.mm:19
FlutterOverlayView
Definition: FlutterOverlayView.h:23

References flutter::IOSSurface::Create().

## ◆ GetNextLayer()

std::shared_ptr< OverlayLayer > flutter::OverlayLayerPool::GetNextLayer | ( |  | ) |

Gets a layer from the pool if available.

The layer is marked as used until [RecycleLayers] is called.

Definition at line 45 of file overlay_layer_pool.mm.

45 {
46 std::shared_ptr<OverlayLayer> result;
47 if (available_layer_index_ < layers_.size()) {
48 result = layers_[available_layer_index_];
49 available_layer_index_++;
50 }
51
52 return result;
53 }

## ◆ RecycleLayers()

void flutter::OverlayLayerPool::RecycleLayers | ( |  | ) |

Marks the layers in the pool as available for reuse.

Definition at line 109 of file overlay_layer_pool.mm.

109 {
110 available_layer_index_ = 0;
111 }

## ◆ RemoveUnusedLayers()

std::vector< std::shared_ptr< OverlayLayer > > flutter::OverlayLayerPool::RemoveUnusedLayers | ( |  | ) |

Removes unused layers from the pool. Returns the unused layers.

Definition at line 113 of file overlay_layer_pool.mm.

113 {
114 std::vector<std::shared_ptr<OverlayLayer>> results;
115 for (size_t i = available_layer_index_; i < layers_.size(); i++) {
116 results.push_back(layers_[i]);
117 }
118 // Leave at least one overlay layer, to work around cases where scrolling
119 // platform views under an app bar continually adds and removes an
120 // overlay layer. This logic could be removed if https://github.com/flutter/flutter/issues/150646
121 // is fixed.
122 static constexpr size_t kLeakLayerCount = 1;
123 size_t erase_offset = std::max(available_layer_index_, kLeakLayerCount);
124 if (erase_offset < layers_.size()) {
125 layers_.erase(layers_.begin() + erase_offset, layers_.end());
126 }
127 return results;
128 }

## ◆ size()

size_t flutter::OverlayLayerPool::size | ( |  | ) | const

The count of layers currently in the pool.

Definition at line 130 of file overlay_layer_pool.mm.

130 {
131 return layers_.size();
132 }

The documentation for this class was generated from the following files:

- shell/platform/darwin/ios/framework/Source/overlay_layer_pool.h
- shell/platform/darwin/ios/framework/Source/overlay_layer_pool.mm