flutter::AndroidContextGLSkia Class Reference

#include <android_context_gl_skia.h>

Inheritance diagram for flutter::AndroidContextGLSkia:

Public Member Functions
	AndroidContextGLSkia (fml::RefPtr< AndroidEnvironmentGL > environment, const TaskRunners &taskRunners, uint8_t msaa_samples)
	~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 ()
AndroidRenderingAPI	RenderingApi () 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.
std::shared_ptr< impeller::Context >	GetImpellerContext () const
	Accessor for the Impeller context associated with AndroidSurfaces and the raster thread.

Additional Inherited Members
Protected Member Functions inherited from flutter::AndroidContext
void	SetImpellerContext (const std::shared_ptr< impeller::Context > &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,
		uint8_t	msaa_samples
	)

Definition at line 67 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(), msaa_samples);
  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;
}

~AndroidContextGLSkia()

flutter::AndroidContextGLSkia::~AndroidContextGLSkia

(

)

Definition at line 111 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();
  }
}

Member Function Documentation

ClearCurrent()

bool flutter::AndroidContextGLSkia::ClearCurrent

(

)

const

Returns

Whether the current context was successfully clear.

Definition at line 193 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;
}

Config()

EGLConfig flutter::AndroidContextGLSkia::Config ( ) const

inline

The EGLConfig for this context.

Definition at line 102 of file android_context_gl_skia.h.

{ return config_; }

CreateNewContext()

EGLContext flutter::AndroidContextGLSkia::CreateNewContext

(

)

const

Create a new EGLContext using the same EGLConfig.

Returns

The EGLContext.

Definition at line 214 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 163 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_);
}

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 146 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_);
  }
}

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 175 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_);
}

Environment()

fml::RefPtr< AndroidEnvironmentGL > flutter::AndroidContextGLSkia::Environment

(

)

const

Returns

The Android environment that contains a reference to the display.

Definition at line 185 of file android_context_gl_skia.cc.

                                                                        {
  return environment_;
}

GetEGLContext()

EGLContext flutter::AndroidContextGLSkia::GetEGLContext

(

)

const

Returns the EGLContext.

Returns

EGLContext.

Definition at line 206 of file android_context_gl_skia.cc.

                                                     {
  return context_;
}

GetEGLDisplay()

EGLDisplay flutter::AndroidContextGLSkia::GetEGLDisplay

(

)

const

Returns the EGLDisplay.

Returns

EGLDisplay.

Definition at line 210 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 189 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