flutter::SurfacePool Class Reference

#include <surface_pool.h>

Public Member Functions
	SurfacePool (bool use_new_surface_methods)
	~SurfacePool ()
std::shared_ptr< OverlayLayer >	GetLayer (GrDirectContext *gr_context, const AndroidContext &android_context, const std::shared_ptr< PlatformViewAndroidJNI > &jni_facade, const std::shared_ptr< AndroidSurfaceFactory > &surface_factory)
std::vector< std::shared_ptr< OverlayLayer > >	GetUnusedLayers ()
void	RecycleLayers ()
void	DestroyLayers (const std::shared_ptr< PlatformViewAndroidJNI > &jni_facade)
void	SetFrameSize (DlISize frame_size)
bool	HasLayers ()
void	ResetLayers ()
void	TrimLayers ()

Detailed Description

Definition at line 46 of file surface_pool.h.

Constructor & Destructor Documentation

SurfacePool()

flutter::SurfacePool::SurfacePool ( bool  use_new_surface_methods )

explicit

Definition at line 20 of file surface_pool.cc.

    : use_new_surface_methods_(use_new_surface_methods) {}

~SurfacePool()

flutter::SurfacePool::~SurfacePool ( )

default

Member Function Documentation

DestroyLayers()

void flutter::SurfacePool::DestroyLayers

(

const std::shared_ptr< PlatformViewAndroidJNI > &

jni_facade

)

Definition at line 92 of file surface_pool.cc.

                                                             {
  std::lock_guard lock(mutex_);
  DestroyLayersLocked(jni_facade);
}

GetLayer()

std::shared_ptr< OverlayLayer > flutter::SurfacePool::GetLayer	(	GrDirectContext *	gr_context,
		const AndroidContext &	android_context,
		const std::shared_ptr< PlatformViewAndroidJNI > &	jni_facade,
		const std::shared_ptr< AndroidSurfaceFactory > &	surface_factory
	)

Definition at line 25 of file surface_pool.cc.

                                                                 {
  std::lock_guard lock(mutex_);
  // Destroy current layers in the pool if the frame size has changed.
  if (requested_frame_size_ != current_frame_size_) {
    DestroyLayersLocked(jni_facade);
  }
  intptr_t gr_context_key = reinterpret_cast<intptr_t>(gr_context);
  // Allocate a new surface if there isn't one available.
  if (available_layer_index_ >= layers_.size()) {
    std::unique_ptr<AndroidSurface> android_surface =
        surface_factory->CreateSurface();
 
    FML_CHECK(android_surface && android_surface->IsValid())
        << "Could not create an OpenGL, Vulkan or Software surface to set up "
           "rendering.";
 
    std::unique_ptr<PlatformViewAndroidJNI::OverlayMetadata> java_metadata =
        use_new_surface_methods_
            ? jni_facade->createOverlaySurface2()
            : jni_facade->FlutterViewCreateOverlaySurface();
 
    FML_CHECK(java_metadata->window);
    android_surface->SetNativeWindow(java_metadata->window, jni_facade);
    android_surface->SetupImpellerSurface();
 
    std::unique_ptr<Surface> surface =
        android_surface->CreateGPUSurface(gr_context);
 
    std::shared_ptr<OverlayLayer> layer =
        std::make_shared<OverlayLayer>(java_metadata->id,           //
                                       std::move(android_surface),  //
                                       std::move(surface)           //
        );
    layer->gr_context_key = gr_context_key;
    layers_.push_back(layer);
  }
 
  std::shared_ptr<OverlayLayer> layer = layers_[available_layer_index_];
  // Since the surfaces are recycled, it's possible that the GrContext is
  // different.
  if (gr_context_key != layer->gr_context_key) {
    layer->gr_context_key = gr_context_key;
    // The overlay already exists, but the GrContext was changed so we need to
    // recreate the rendering surface with the new GrContext.
    std::unique_ptr<Surface> surface =
        layer->android_surface->CreateGPUSurface(gr_context);
    layer->surface = std::move(surface);
  }
  available_layer_index_++;
  current_frame_size_ = requested_frame_size_;
  return layer;
}

References FML_CHECK, and surface.

GetUnusedLayers()

std::vector< std::shared_ptr< OverlayLayer > > flutter::SurfacePool::GetUnusedLayers

(

)

Definition at line 112 of file surface_pool.cc.

                                                                    {
  std::lock_guard lock(mutex_);
  std::vector<std::shared_ptr<OverlayLayer>> results;
  for (size_t i = available_layer_index_; i < layers_.size(); i++) {
    results.push_back(layers_[i]);
  }
  return results;
}

References i.

HasLayers()

bool flutter::SurfacePool::HasLayers

(

)

Definition at line 87 of file surface_pool.cc.

                            {
  std::lock_guard lock(mutex_);
  return !layers_.empty();
}

RecycleLayers()

void flutter::SurfacePool::RecycleLayers

(

)

Definition at line 82 of file surface_pool.cc.

                                {
  std::lock_guard lock(mutex_);
  available_layer_index_ = 0;
}

ResetLayers()

void flutter::SurfacePool::ResetLayers

(

)

Definition at line 126 of file surface_pool.cc.

                              {
  available_layer_index_ = 0;
}

SetFrameSize()

void flutter::SurfacePool::SetFrameSize

(

DlISize

frame_size

)

Definition at line 121 of file surface_pool.cc.

                                                 {
  std::lock_guard lock(mutex_);
  requested_frame_size_ = frame_size;
}

TrimLayers()

void flutter::SurfacePool::TrimLayers

(

)

Definition at line 130 of file surface_pool.cc.

                             {
  std::lock_guard lock(mutex_);
  layers_.erase(layers_.begin() + available_layer_index_, layers_.end());
  available_layer_index_ = 0;
}

---

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

• shell/platform/android/external_view_embedder/surface_pool.h
• shell/platform/android/external_view_embedder/surface_pool.cc