flutter::EmbedderSurfaceGLImpeller Class Reference

#include <embedder_surface_gl_impeller.h>

Inheritance diagram for flutter::EmbedderSurfaceGLImpeller:

Public Member Functions
	EmbedderSurfaceGLImpeller (EmbedderSurfaceGL::GLDispatchTable gl_dispatch_table, bool fbo_reset_after_present, std::shared_ptr< EmbedderExternalViewEmbedder > external_view_embedder)
	~EmbedderSurfaceGLImpeller () override
Public Member Functions inherited from flutter::EmbedderSurface
	EmbedderSurface ()
virtual	~EmbedderSurface ()
Public Member Functions inherited from flutter::GPUSurfaceGLDelegate
	~GPUSurfaceGLDelegate ()
virtual void	GLContextSetDamageRegion (const std::optional< SkIRect > &region)
virtual sk_sp< const GrGLInterface >	GetGLInterface () const
virtual bool	AllowsDrawingWhenGpuDisabled () const

Private Member Functions
bool	IsValid () const override
std::unique_ptr< Surface >	CreateGPUSurface () override
std::shared_ptr< impeller::Context >	CreateImpellerContext () const override
std::unique_ptr< GLContextResult >	GLContextMakeCurrent () override
bool	GLContextClearCurrent () override
bool	GLContextPresent (const GLPresentInfo &present_info) override
GLFBOInfo	GLContextFBO (GLFrameInfo frame_info) const override
bool	GLContextFBOResetAfterPresent () const override
SkMatrix	GLContextSurfaceTransformation () const override
GLProcResolver	GetGLProcResolver () const override
SurfaceFrame::FramebufferInfo	GLContextFramebufferInfo () const override
sk_sp< GrDirectContext >	CreateResourceContext () const override

Additional Inherited Members
Public Types inherited from flutter::GPUSurfaceGLDelegate
using	GLProcResolver = std::function< void *(const char *)>
Static Public Member Functions inherited from flutter::GPUSurfaceGLDelegate
static sk_sp< const GrGLInterface >	GetDefaultPlatformGLInterface ()

Detailed Description

Definition at line 22 of file embedder_surface_gl_impeller.h.

Constructor & Destructor Documentation

EmbedderSurfaceGLImpeller()

flutter::EmbedderSurfaceGLImpeller::EmbedderSurfaceGLImpeller	(	EmbedderSurfaceGL::GLDispatchTable	gl_dispatch_table,
		bool	fbo_reset_after_present,
		std::shared_ptr< EmbedderExternalViewEmbedder >	external_view_embedder
	)

Definition at line 48 of file embedder_surface_gl_impeller.cc.

    : gl_dispatch_table_(std::move(gl_dispatch_table)),
      fbo_reset_after_present_(fbo_reset_after_present),
      external_view_embedder_(std::move(external_view_embedder)),
      worker_(std::make_shared<ReactorWorker>()) {
  // Make sure all required members of the dispatch table are checked.
  if (!gl_dispatch_table_.gl_make_current_callback ||
      !gl_dispatch_table_.gl_clear_current_callback ||
      !gl_dispatch_table_.gl_present_callback ||
      !gl_dispatch_table_.gl_fbo_callback ||
      !gl_dispatch_table_.gl_populate_existing_damage ||
      !gl_dispatch_table_.gl_proc_resolver) {
    return;
  }
  // Certain GL backends need to made current before any GL
  // state can be accessed.
  gl_dispatch_table_.gl_make_current_callback();
 
  std::vector<std::shared_ptr<fml::Mapping>> shader_mappings = {
      std::make_shared<fml::NonOwnedMapping>(
          impeller_entity_shaders_gles_data,
          impeller_entity_shaders_gles_length),
      std::make_shared<fml::NonOwnedMapping>(
          impeller_modern_shaders_gles_data,
          impeller_modern_shaders_gles_length),
      std::make_shared<fml::NonOwnedMapping>(
          impeller_framebuffer_blend_shaders_gles_data,
          impeller_framebuffer_blend_shaders_gles_length),
#if IMPELLER_ENABLE_3D
      std::make_shared<fml::NonOwnedMapping>(
          impeller_scene_shaders_gles_data, impeller_scene_shaders_gles_length),
#endif  // IMPELLER_ENABLE_3D
  };
  auto gl = std::make_unique<impeller::ProcTableGLES>(
      gl_dispatch_table_.gl_proc_resolver);
  if (!gl->IsValid()) {
    return;
  }
 
  impeller_context_ = impeller::ContextGLES::Create(
      std::move(gl), shader_mappings, /*enable_gpu_tracing=*/false);
 
  if (!impeller_context_) {
    FML_LOG(ERROR) << "Could not create Impeller context.";
    return;
  }
 
  auto worker_id = impeller_context_->AddReactorWorker(worker_);
  if (!worker_id.has_value()) {
    FML_LOG(ERROR) << "Could not add reactor worker.";
    return;
  }
 
  gl_dispatch_table_.gl_clear_current_callback();
  FML_LOG(IMPORTANT) << "Using the Impeller rendering backend (OpenGL).";
  valid_ = true;
}

~EmbedderSurfaceGLImpeller()

flutter::EmbedderSurfaceGLImpeller::~EmbedderSurfaceGLImpeller ( )

overridedefault

Member Function Documentation

CreateGPUSurface()

std::unique_ptr< Surface > flutter::EmbedderSurfaceGLImpeller::CreateGPUSurface ( )

overrideprivatevirtual

Implements flutter::EmbedderSurface.

Definition at line 180 of file embedder_surface_gl_impeller.cc.

                                                                   {
  // Ensure that the GL context is current before creating the GPU surface.
  // GPUSurfaceGLImpeller initialization will set up shader pipelines, and the
  // current thread needs to be able to execute reactor operations.
  GLContextMakeCurrent();
 
  return std::make_unique<GPUSurfaceGLImpeller>(
      this,                     // GPU surface GL delegate
      impeller_context_,        // Impeller context
      !external_view_embedder_  // render to surface
  );
}

CreateImpellerContext()

std::shared_ptr< impeller::Context > flutter::EmbedderSurfaceGLImpeller::CreateImpellerContext ( ) const

overrideprivatevirtual

Reimplemented from flutter::EmbedderSurface.

Definition at line 195 of file embedder_surface_gl_impeller.cc.

                                                       {
  return impeller_context_;
}

CreateResourceContext()

sk_sp< GrDirectContext > flutter::EmbedderSurfaceGLImpeller::CreateResourceContext ( ) const

overrideprivatevirtual

Reimplemented from flutter::EmbedderSurface.

Definition at line 200 of file embedder_surface_gl_impeller.cc.

          {
  if (gl_dispatch_table_.gl_make_resource_current_callback()) {
    worker_->SetReactionsAllowedOnCurrentThread(true);
  } else {
    FML_DLOG(ERROR) << "Could not make the resource context current.";
    worker_->SetReactionsAllowedOnCurrentThread(false);
  }
  return nullptr;
}

GetGLProcResolver()

EmbedderSurfaceGL::GLProcResolver flutter::EmbedderSurfaceGLImpeller::GetGLProcResolver ( ) const

overrideprivatevirtual

Reimplemented from flutter::GPUSurfaceGLDelegate.

Definition at line 163 of file embedder_surface_gl_impeller.cc.

          {
  return gl_dispatch_table_.gl_proc_resolver;
}

GLContextClearCurrent()

bool flutter::EmbedderSurfaceGLImpeller::GLContextClearCurrent ( )

overrideprivatevirtual

Implements flutter::GPUSurfaceGLDelegate.

Definition at line 125 of file embedder_surface_gl_impeller.cc.

                                                      {
  worker_->SetReactionsAllowedOnCurrentThread(false);
  return gl_dispatch_table_.gl_clear_current_callback();
}

GLContextFBO()

GLFBOInfo flutter::EmbedderSurfaceGLImpeller::GLContextFBO ( GLFrameInfo  frame_info ) const

overrideprivatevirtual

Implements flutter::GPUSurfaceGLDelegate.

Definition at line 138 of file embedder_surface_gl_impeller.cc.

                                  {
  // Get the FBO ID using the gl_fbo_callback and then get exiting damage by
  // passing that ID to the gl_populate_existing_damage.
  return gl_dispatch_table_.gl_populate_existing_damage(
      gl_dispatch_table_.gl_fbo_callback(frame_info));
}

GLContextFBOResetAfterPresent()

bool flutter::EmbedderSurfaceGLImpeller::GLContextFBOResetAfterPresent ( ) const

overrideprivatevirtual

Reimplemented from flutter::GPUSurfaceGLDelegate.

Definition at line 147 of file embedder_surface_gl_impeller.cc.

                                                                    {
  return fbo_reset_after_present_;
}

GLContextFramebufferInfo()

SurfaceFrame::FramebufferInfo flutter::EmbedderSurfaceGLImpeller::GLContextFramebufferInfo ( ) const

overrideprivatevirtual

Reimplemented from flutter::GPUSurfaceGLDelegate.

Definition at line 170 of file embedder_surface_gl_impeller.cc.

                                                          {
  // Enable partial repaint by default on the embedders.
  auto info = SurfaceFrame::FramebufferInfo{};
  info.supports_readback = true;
  info.supports_partial_repaint =
      gl_dispatch_table_.gl_populate_existing_damage != nullptr;
  return info;
}

GLContextMakeCurrent()

std::unique_ptr< GLContextResult > flutter::EmbedderSurfaceGLImpeller::GLContextMakeCurrent ( )

overrideprivatevirtual

Implements flutter::GPUSurfaceGLDelegate.

Definition at line 118 of file embedder_surface_gl_impeller.cc.

                                                {
  worker_->SetReactionsAllowedOnCurrentThread(true);
  return std::make_unique<GLContextDefaultResult>(
      gl_dispatch_table_.gl_make_current_callback());
}

GLContextPresent()

bool flutter::EmbedderSurfaceGLImpeller::GLContextPresent ( const GLPresentInfo &  present_info )

overrideprivatevirtual

Implements flutter::GPUSurfaceGLDelegate.

Definition at line 131 of file embedder_surface_gl_impeller.cc.

                                       {
  // Pass the present information to the embedder present callback.
  return gl_dispatch_table_.gl_present_callback(present_info);
}

GLContextSurfaceTransformation()

SkMatrix flutter::EmbedderSurfaceGLImpeller::GLContextSurfaceTransformation ( ) const

overrideprivatevirtual

Reimplemented from flutter::GPUSurfaceGLDelegate.

Definition at line 152 of file embedder_surface_gl_impeller.cc.

                                                                         {
  auto callback = gl_dispatch_table_.gl_surface_transformation_callback;
  if (!callback) {
    SkMatrix matrix;
    matrix.setIdentity();
    return matrix;
  }
  return callback();
}

IsValid()

bool flutter::EmbedderSurfaceGLImpeller::IsValid ( ) const

overrideprivatevirtual

Implements flutter::EmbedderSurface.

Definition at line 112 of file embedder_surface_gl_impeller.cc.

                                              {
  return valid_;
}

---

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

• shell/platform/embedder/embedder_surface_gl_impeller.h
• shell/platform/embedder/embedder_surface_gl_impeller.cc