flutter::ImageExternalTextureGL Class Reference

#include <image_external_texture_gl.h>

Inheritance diagram for flutter::ImageExternalTextureGL:

Classes
struct	GlEntry

Public Member Functions
	ImageExternalTextureGL (int64_t id, const fml::jni::ScopedJavaGlobalRef< jobject > &image_textury_entry, const std::shared_ptr< PlatformViewAndroidJNI > &jni_facade)
Public Member Functions inherited from flutter::ImageExternalTexture
	ImageExternalTexture (int64_t id, const fml::jni::ScopedJavaGlobalRef< jobject > &image_texture_entry, const std::shared_ptr< PlatformViewAndroidJNI > &jni_facade)
virtual	~ImageExternalTexture ()=default
void	Paint (PaintContext &context, const SkRect &bounds, bool freeze, const DlImageSampling sampling) override
void	MarkNewFrameAvailable () override
void	OnTextureUnregistered () override
void	OnGrContextCreated () override
void	OnGrContextDestroyed () override
Public Member Functions inherited from flutter::Texture
	Texture (int64_t id)
virtual	~Texture ()
virtual void	Paint (PaintContext &context, const SkRect &bounds, bool freeze, const DlImageSampling sampling)=0
virtual void	MarkNewFrameAvailable ()=0
virtual void	OnTextureUnregistered ()=0
int64_t	Id ()
Public Member Functions inherited from flutter::ContextListener
	ContextListener ()
	~ContextListener ()
virtual void	OnGrContextCreated ()=0
virtual void	OnGrContextDestroyed ()=0

Protected Member Functions
void	Attach (PaintContext &context) override
void	Detach () override
void	ProcessFrame (PaintContext &context, const SkRect &bounds) override
void	UpdateImage (JavaLocalRef &hardware_buffer, const SkRect &bounds, PaintContext &context)
virtual sk_sp< flutter::DlImage >	CreateDlImage (PaintContext &context, const SkRect &bounds, std::optional< HardwareBufferKey > id, impeller::UniqueEGLImageKHR &&egl_image)=0
impeller::UniqueEGLImageKHR	CreateEGLImage (AHardwareBuffer *buffer)
	FML_DISALLOW_COPY_AND_ASSIGN (ImageExternalTextureGL)
Protected Member Functions inherited from flutter::ImageExternalTexture
virtual void	Attach (PaintContext &context)=0
virtual void	Detach ()=0
virtual void	ProcessFrame (PaintContext &context, const SkRect &bounds)=0
JavaLocalRef	AcquireLatestImage ()
void	CloseImage (const fml::jni::JavaRef< jobject > &image)
JavaLocalRef	HardwareBufferFor (const fml::jni::JavaRef< jobject > &image)
void	CloseHardwareBuffer (const fml::jni::JavaRef< jobject > &hardware_buffer)
AHardwareBuffer *	AHardwareBufferFor (const fml::jni::JavaRef< jobject > &hardware_buffer)
	FML_DISALLOW_COPY_AND_ASSIGN (ImageExternalTexture)

Protected Attributes
std::unordered_map< HardwareBufferKey, GlEntry >	gl_entries_
Protected Attributes inherited from flutter::ImageExternalTexture
fml::jni::ScopedJavaGlobalRef< jobject >	image_texture_entry_
std::shared_ptr< PlatformViewAndroidJNI >	jni_facade_
AttachmentState	state_ = AttachmentState::kUninitialized
sk_sp< flutter::DlImage >	dl_image_
ImageLRU	image_lru_ = ImageLRU()

Additional Inherited Members
Protected Types inherited from flutter::ImageExternalTexture
enum class	AttachmentState { kUninitialized , kAttached , kDetached }

Detailed Description

Definition at line 23 of file image_external_texture_gl.h.

Constructor & Destructor Documentation

ImageExternalTextureGL()

flutter::ImageExternalTextureGL::ImageExternalTextureGL	(	int64_t	id,
		const fml::jni::ScopedJavaGlobalRef< jobject > &	image_textury_entry,
		const std::shared_ptr< PlatformViewAndroidJNI > &	jni_facade
	)

Definition at line 24 of file image_external_texture_gl.cc.

    : ImageExternalTexture(id, image_texture_entry, jni_facade) {}

Member Function Documentation

Attach()

void flutter::ImageExternalTextureGL::Attach ( PaintContext &  context )

overrideprotectedvirtual

Implements flutter::ImageExternalTexture.

Definition at line 30 of file image_external_texture_gl.cc.

                                                         {
  if (state_ == AttachmentState::kUninitialized) {
    // TODO(johnmccurtchan): We currently display the first frame after an
    // attach-detach cycle as blank. There seems to be an issue on some
    // devices where ImageReaders/Images from before the detach aren't
    // valid after the attach. According to Android folks this doesn't
    // match the spec. Revisit this in the future.
    // See https://github.com/flutter/flutter/issues/142978 and
    // https://github.com/flutter/flutter/issues/139039.
    state_ = AttachmentState::kAttached;
  }
}

CreateDlImage()

virtual sk_sp< flutter::DlImage > flutter::ImageExternalTextureGL::CreateDlImage ( PaintContext &  context, const SkRect &  bounds, std::optional< HardwareBufferKey >  id, impeller::UniqueEGLImageKHR &&  egl_image  )

protectedpure virtual

CreateEGLImage()

impeller::UniqueEGLImageKHR flutter::ImageExternalTextureGL::CreateEGLImage ( AHardwareBuffer *  buffer )

protected

Definition at line 83 of file image_external_texture_gl.cc.

                                      {
  if (hardware_buffer == nullptr) {
    return impeller::UniqueEGLImageKHR();
  }
 
  EGLDisplay display = eglGetCurrentDisplay();
  FML_CHECK(display != EGL_NO_DISPLAY);
 
  EGLClientBuffer client_buffer =
      impeller::android::GetProcTable().eglGetNativeClientBufferANDROID(
          hardware_buffer);
  FML_DCHECK(client_buffer != nullptr);
  if (client_buffer == nullptr) {
    FML_LOG(ERROR) << "eglGetNativeClientBufferAndroid returned null.";
    return impeller::UniqueEGLImageKHR();
  }
 
  impeller::EGLImageKHRWithDisplay maybe_image =
      impeller::EGLImageKHRWithDisplay{
          eglCreateImageKHR(display, EGL_NO_CONTEXT, EGL_NATIVE_BUFFER_ANDROID,
                            client_buffer, 0),
          display};
 
  return impeller::UniqueEGLImageKHR(maybe_image);
}

Detach()

void flutter::ImageExternalTextureGL::Detach ( )

overrideprotectedvirtual

Implements flutter::ImageExternalTexture.

Definition at line 78 of file image_external_texture_gl.cc.

                                    {
  image_lru_.Clear();
  gl_entries_.clear();
}

FML_DISALLOW_COPY_AND_ASSIGN()

flutter::ImageExternalTextureGL::FML_DISALLOW_COPY_AND_ASSIGN ( ImageExternalTextureGL  )

protected

ProcessFrame()

void flutter::ImageExternalTextureGL::ProcessFrame ( PaintContext &  context, const SkRect &  bounds  )

overrideprotectedvirtual

Implements flutter::ImageExternalTexture.

Definition at line 67 of file image_external_texture_gl.cc.

                                                                {
  JavaLocalRef image = AcquireLatestImage();
  if (image.is_null()) {
    return;
  }
  JavaLocalRef hardware_buffer = HardwareBufferFor(image);
  UpdateImage(hardware_buffer, bounds, context);
  CloseHardwareBuffer(hardware_buffer);
}

UpdateImage()

void flutter::ImageExternalTextureGL::UpdateImage ( JavaLocalRef &  hardware_buffer, const SkRect &  bounds, PaintContext &  context  )

protected

Definition at line 43 of file image_external_texture_gl.cc.

                                                                {
  AHardwareBuffer* latest_hardware_buffer = AHardwareBufferFor(hardware_buffer);
  std::optional<HardwareBufferKey> key =
      impeller::android::HardwareBuffer::GetSystemUniqueID(
          latest_hardware_buffer);
  auto existing_image = image_lru_.FindImage(key);
  if (existing_image != nullptr) {
    dl_image_ = existing_image;
    return;
  }
 
  auto egl_image = CreateEGLImage(latest_hardware_buffer);
  if (!egl_image.is_valid()) {
    return;
  }
 
  dl_image_ = CreateDlImage(context, bounds, key, std::move(egl_image));
  if (key.has_value()) {
    gl_entries_.erase(image_lru_.AddImage(dl_image_, key.value()));
  }
}

Member Data Documentation

gl_entries_

std::unordered_map<HardwareBufferKey, GlEntry> flutter::ImageExternalTextureGL::gl_entries_

protected

Definition at line 54 of file image_external_texture_gl.h.

---

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

• shell/platform/android/image_external_texture_gl.h
• shell/platform/android/image_external_texture_gl.cc