#include <android_context_gl_skia.h>

Inheritance diagram for flutter::AndroidContextGLSkia:

Public Member Functions
	AndroidContextGLSkia (fml::RefPtr< AndroidEnvironmentGL > environment, const TaskRunners &taskRunners)

	~AndroidContextGLSkia ()

std::unique_ptr< AndroidEGLSurface >	CreateOnscreenSurface (const fml::RefPtr< AndroidNativeWindow > &window) const
	Allocates an new EGL window surface that is used for on-screen pixels.

std::unique_ptr< AndroidEGLSurface >	CreateOffscreenSurface () const
	Allocates an 1x1 pbuffer surface that is used for making the offscreen current for texture uploads.

std::unique_ptr< AndroidEGLSurface >	CreatePbufferSurface () const
	Allocates an 1x1 pbuffer surface that is used for making the onscreen context current for snapshotting.

fml::RefPtr< AndroidEnvironmentGL >	Environment () const

bool	IsValid () const override

bool	ClearCurrent () const

EGLContext	GetEGLContext () const
	Returns the EGLContext.

EGLDisplay	GetEGLDisplay () const
	Returns the EGLDisplay.

EGLContext	CreateNewContext () const
	Create a new EGLContext using the same EGLConfig.

EGLConfig	Config () const
	The EGLConfig for this context.

Public Member Functions inherited from flutter::AndroidContext
	AndroidContext (AndroidRenderingAPI rendering_api)

virtual	~AndroidContext ()

virtual AndroidRenderingAPI	RenderingApi () const

virtual bool	IsDynamicSelection () const

void	SetMainSkiaContext (const sk_sp< GrDirectContext > &main_context)
	Setter for the Skia context to be used by subsequent AndroidSurfaces.

sk_sp< GrDirectContext >	GetMainSkiaContext () const
	Accessor for the Skia context associated with AndroidSurfaces and the raster thread.

virtual std::shared_ptr< impeller::Context >	GetImpellerContext () const
	Accessor for the Impeller context associated with AndroidSurfaces and the raster thread.

virtual void	SetupImpellerContext ()
	Perform deferred setup for the impeller Context.

Additional Inherited Members
Protected Member Functions inherited from flutter::AndroidContext
void	SetImpellerContext (const std::shared_ptr< impeller::Context > &impeller_context)

Detailed Description

The Android context is used by AndroidSurfaceGL to create and manage EGL surfaces.

This context binds EGLContext to the current rendering thread and to the draw and read EGLSurfaces.

Definition at line 28 of file android_context_gl_skia.h.

Constructor & Destructor Documentation

◆ AndroidContextGLSkia()

flutter::AndroidContextGLSkia::AndroidContextGLSkia	(	fml::RefPtr< AndroidEnvironmentGL >	environment,
		const TaskRunners &	taskRunners
	)

Definition at line 63 of file android_context_gl_skia.cc.

    : AndroidContext(AndroidRenderingAPI::kSkiaOpenGLES),
      environment_(std::move(environment)),
      task_runners_(task_runners) {
  if (!environment_->IsValid()) {
    FML_LOG(ERROR) << "Could not create an Android GL environment.";
    return;
  }
 
  bool success = false;
 
  // Choose a valid configuration.
  std::tie(success, config_) = ChooseEGLConfiguration(environment_->Display());
  if (!success) {
    FML_LOG(ERROR) << "Could not choose an EGL configuration.";
    LogLastEGLError();
    return;
  }
 
  // Create a context for the configuration.
  std::tie(success, context_) =
      CreateContext(environment_->Display(), config_, EGL_NO_CONTEXT);
  if (!success) {
    FML_LOG(ERROR) << "Could not create an EGL context";
    LogLastEGLError();
    return;
  }
 
  std::tie(success, resource_context_) =
      CreateContext(environment_->Display(), config_, context_);
  if (!success) {
    FML_LOG(ERROR) << "Could not create an EGL resource context";
    LogLastEGLError();
    return;
  }
 
  // All done!
  valid_ = true;
}

References flutter::ChooseEGLConfiguration(), flutter::CreateContext(), FML_LOG, and flutter::LogLastEGLError().

◆ ~AndroidContextGLSkia()

flutter::AndroidContextGLSkia::~AndroidContextGLSkia ( )

Definition at line 105 of file android_context_gl_skia.cc.

                                            {
  FML_DCHECK(task_runners_.GetPlatformTaskRunner()->RunsTasksOnCurrentThread());
  sk_sp<GrDirectContext> main_context = GetMainSkiaContext();
  SetMainSkiaContext(nullptr);
  fml::AutoResetWaitableEvent latch;
  // This context needs to be deallocated from the raster thread in order to
  // keep a coherent usage of egl from a single thread.
  fml::TaskRunner::RunNowOrPostTask(task_runners_.GetRasterTaskRunner(), [&] {
    if (main_context) {
      std::unique_ptr<AndroidEGLSurface> pbuffer_surface =
          CreatePbufferSurface();
      auto status = pbuffer_surface->MakeCurrent();
      if (status != AndroidEGLSurfaceMakeCurrentStatus::kFailure) {
        main_context->releaseResourcesAndAbandonContext();
        main_context.reset();
        ClearCurrent();
      }
    }
    latch.Signal();
  });
  latch.Wait();
 
  if (!TeardownContext(environment_->Display(), context_)) {
    FML_LOG(ERROR)
        << "Could not tear down the EGL context. Possible resource leak.";
    LogLastEGLError();
  }
 
  if (!TeardownContext(environment_->Display(), resource_context_)) {
    FML_LOG(ERROR) << "Could not tear down the EGL resource context. Possible "
                      "resource leak.";
    LogLastEGLError();
  }
}

References FML_DCHECK, flutter::AndroidContext::GetMainSkiaContext(), flutter::TaskRunners::GetPlatformTaskRunner(), flutter::TaskRunners::GetRasterTaskRunner(), fml::TaskRunner::RunNowOrPostTask(), fml::TaskRunner::RunsTasksOnCurrentThread(), flutter::AndroidContext::SetMainSkiaContext(), and fml::AutoResetWaitableEvent::Signal().

Member Function Documentation

◆ ClearCurrent()

bool flutter::AndroidContextGLSkia::ClearCurrent ( ) const

Returns: Whether the current context was successfully clear.

Definition at line 187 of file android_context_gl_skia.cc.

                                              {
  if (eglGetCurrentContext() != context_) {
    return true;
  }
  if (eglMakeCurrent(environment_->Display(), EGL_NO_SURFACE, EGL_NO_SURFACE,
                     EGL_NO_CONTEXT) != EGL_TRUE) {
    FML_LOG(ERROR) << "Could not clear the current context";
    LogLastEGLError();
    return false;
  }
  return true;
}

References FML_LOG, and flutter::LogLastEGLError().

◆ Config()

EGLConfig flutter::AndroidContextGLSkia::Config ( ) const

inline

The EGLConfig for this context.

Definition at line 101 of file android_context_gl_skia.h.

101{ return config_; }

◆ CreateNewContext()

EGLContext flutter::AndroidContextGLSkia::CreateNewContext ( ) const

Create a new EGLContext using the same EGLConfig.

Returns: The EGLContext.

Definition at line 208 of file android_context_gl_skia.cc.

                                                        {
  bool success;
  EGLContext context;
  std::tie(success, context) =
      CreateContext(environment_->Display(), config_, EGL_NO_CONTEXT);
  return success ? context : EGL_NO_CONTEXT;
}

◆ CreateOffscreenSurface()

std::unique_ptr< AndroidEGLSurface > flutter::AndroidContextGLSkia::CreateOffscreenSurface ( ) const

Allocates an 1x1 pbuffer surface that is used for making the offscreen current for texture uploads.

Returns: The pbuffer surface.

Definition at line 157 of file android_context_gl_skia.cc.

                                                   {
  // We only ever create pbuffer surfaces for background resource loading
  // contexts. We never bind the pbuffer to anything.
  EGLDisplay display = environment_->Display();
 
  const EGLint attribs[] = {EGL_WIDTH, 1, EGL_HEIGHT, 1, EGL_NONE};
 
  EGLSurface surface = eglCreatePbufferSurface(display, config_, attribs);
  return std::make_unique<AndroidEGLSurface>(surface, display,
                                             resource_context_);
}

References surface.

◆ CreateOnscreenSurface()

std::unique_ptr< AndroidEGLSurface > flutter::AndroidContextGLSkia::CreateOnscreenSurface ( const fml::RefPtr< AndroidNativeWindow > & window ) const

Allocates an new EGL window surface that is used for on-screen pixels.

Returns: The window surface.

Definition at line 140 of file android_context_gl_skia.cc.

                                                        {
  if (window->IsFakeWindow()) {
    return CreatePbufferSurface();
  } else {
    EGLDisplay display = environment_->Display();
 
    const EGLint attribs[] = {EGL_NONE};
 
    EGLSurface surface = eglCreateWindowSurface(
        display, config_,
        reinterpret_cast<EGLNativeWindowType>(window->handle()), attribs);
    return std::make_unique<AndroidEGLSurface>(surface, display, context_);
  }
}

References surface, and window.

◆ CreatePbufferSurface()

std::unique_ptr< AndroidEGLSurface > flutter::AndroidContextGLSkia::CreatePbufferSurface ( ) const

Allocates an 1x1 pbuffer surface that is used for making the onscreen context current for snapshotting.

Returns: The pbuffer surface.

Definition at line 169 of file android_context_gl_skia.cc.

          {
  EGLDisplay display = environment_->Display();
 
  const EGLint attribs[] = {EGL_WIDTH, 1, EGL_HEIGHT, 1, EGL_NONE};
 
  EGLSurface surface = eglCreatePbufferSurface(display, config_, attribs);
  return std::make_unique<AndroidEGLSurface>(surface, display, context_);
}

References surface.

◆ Environment()

fml::RefPtr< AndroidEnvironmentGL > flutter::AndroidContextGLSkia::Environment ( ) const

Returns: The Android environment that contains a reference to the display.

Definition at line 179 of file android_context_gl_skia.cc.

                                                                        {
  return environment_;
}

◆ GetEGLContext()

EGLContext flutter::AndroidContextGLSkia::GetEGLContext ( ) const

Returns the EGLContext.

Returns: EGLContext.

Definition at line 200 of file android_context_gl_skia.cc.

                                                     {
  return context_;
}

◆ GetEGLDisplay()

EGLDisplay flutter::AndroidContextGLSkia::GetEGLDisplay ( ) const

Returns the EGLDisplay.

Returns: EGLDisplay.

Definition at line 204 of file android_context_gl_skia.cc.

                                                     {
  return environment_->Display();
}

◆ IsValid()

bool flutter::AndroidContextGLSkia::IsValid ( ) const

overridevirtual

Returns: Whether the current context is valid. That is, if the EGL contexts were successfully created.

Reimplemented from flutter::AndroidContext.

Definition at line 183 of file android_context_gl_skia.cc.

                                         {
  return valid_;
}

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

shell/platform/android/android_context_gl_skia.h
shell/platform/android/android_context_gl_skia.cc

Public Member Functions

Additional Inherited Members