impeller::TextureGLES Class Reference

#include <texture_gles.h>

Inheritance diagram for impeller::TextureGLES:

Public Types
enum	Type {   Type::kTexture,   Type::kRenderBuffer,   Type::kRenderBufferMultisampled }
enum	IsWrapped { IsWrapped::kWrapped }
enum	AttachmentPoint {   AttachmentPoint::kColor0,   AttachmentPoint::kDepth,   AttachmentPoint::kStencil }

Public Member Functions
	TextureGLES (ReactorGLES::Ref reactor, TextureDescriptor desc)
	TextureGLES (ReactorGLES::Ref reactor, TextureDescriptor desc, IsWrapped wrapped)
	~TextureGLES () override
std::optional< GLuint >	GetGLHandle () const
bool	Bind () const
bool	GenerateMipmap ()
bool	SetAsFramebufferAttachment (GLenum target, GLuint fbo, AttachmentPoint point) const
Type	GetType () const
bool	IsWrapped () const
Public Member Functions inherited from impeller::Texture
virtual	~Texture ()
bool	SetContents (const uint8_t *contents, size_t length, size_t slice=0, bool is_opaque=false)
bool	SetContents (std::shared_ptr< const fml::Mapping > mapping, size_t slice=0, bool is_opaque=false)
bool	IsOpaque () const
size_t	GetMipCount () const
const TextureDescriptor &	GetTextureDescriptor () const
void	SetCoordinateSystem (TextureCoordinateSystem coordinate_system)
TextureCoordinateSystem	GetCoordinateSystem () const
bool	NeedsMipmapGeneration () const

Friends
class	AllocatorMTL

Additional Inherited Members
Static Public Member Functions inherited from impeller::BackendCast< TextureGLES, Texture >
static TextureGLES &	Cast (Texture &base)
static const TextureGLES &	Cast (const Texture &base)
static TextureGLES *	Cast (Texture *base)
static const TextureGLES *	Cast (const Texture *base)
Protected Member Functions inherited from impeller::Texture
	Texture (TextureDescriptor desc)
Protected Attributes inherited from impeller::Texture
bool	mipmap_generated_ = false

Detailed Description

Definition at line 15 of file texture_gles.h.

Member Enumeration Documentation

AttachmentPoint

enum impeller::TextureGLES::AttachmentPoint

strong

Enumerator
kColor0
kDepth
kStencil

Definition at line 43 of file texture_gles.h.

                             {
    kColor0,
    kDepth,
    kStencil,
  };

IsWrapped

enum impeller::TextureGLES::IsWrapped

strong

Enumerator
kWrapped

Definition at line 24 of file texture_gles.h.

                       {
    kWrapped,
  };

Type

enum impeller::TextureGLES::Type

strong

Enumerator
kTexture
kRenderBuffer
kRenderBufferMultisampled

Definition at line 18 of file texture_gles.h.

                  {
    kTexture,
    kRenderBuffer,
    kRenderBufferMultisampled,
  };

Constructor & Destructor Documentation

TextureGLES() [1/2]

impeller::TextureGLES::TextureGLES	(	ReactorGLES::Ref	reactor,
		TextureDescriptor	desc
	)

Definition at line 42 of file texture_gles.cc.

    : TextureGLES(std::move(reactor), desc, false) {}

TextureGLES() [2/2]

impeller::TextureGLES::TextureGLES	(	ReactorGLES::Ref	reactor,
		TextureDescriptor	desc,
		IsWrapped	wrapped
	)

Definition at line 45 of file texture_gles.cc.

    : TextureGLES(std::move(reactor), desc, true) {}

~TextureGLES()

impeller::TextureGLES::~TextureGLES ( )

override

Definition at line 76 of file texture_gles.cc.

                          {
  reactor_->CollectHandle(handle_);
}

Member Function Documentation

Bind()

bool impeller::TextureGLES::Bind

(

)

const

Definition at line 434 of file texture_gles.cc.

                             {
  auto handle = GetGLHandle();
  if (!handle.has_value()) {
    return false;
  }
  const auto& gl = reactor_->GetProcTable();
  switch (type_) {
    case Type::kTexture: {
      const auto target = ToTextureTarget(GetTextureDescriptor().type);
      if (!target.has_value()) {
        VALIDATION_LOG << "Could not bind texture of this type.";
        return false;
      }
      gl.BindTexture(target.value(), handle.value());
    } break;
    case Type::kRenderBuffer:
    // MSAA textures are treated as render buffers.
    case Type::kRenderBufferMultisampled:
      gl.BindRenderbuffer(GL_RENDERBUFFER, handle.value());
      break;
  }
  InitializeContentsIfNecessary();
  return true;
}

References GetGLHandle(), impeller::Texture::GetTextureDescriptor(), kRenderBuffer, kRenderBufferMultisampled, kTexture, impeller::ToTextureTarget(), and VALIDATION_LOG.

Referenced by GenerateMipmap().

GenerateMipmap()

bool impeller::TextureGLES::GenerateMipmap

(

)

Definition at line 459 of file texture_gles.cc.

                                 {
  if (!IsValid()) {
    return false;
  }
 
  auto type = GetTextureDescriptor().type;
  switch (type) {
    case TextureType::kTexture2D:
      break;
    case TextureType::kTexture2DMultisample:
      VALIDATION_LOG << "Generating mipmaps for multisample textures is not "
                        "supported in the GLES backend.";
      return false;
    case TextureType::kTextureCube:
      break;
    case TextureType::kTextureExternalOES:
      break;
  }
 
  if (!Bind()) {
    return false;
  }
 
  auto handle = GetGLHandle();
  if (!handle.has_value()) {
    return false;
  }
 
  const auto& gl = reactor_->GetProcTable();
  gl.GenerateMipmap(ToTextureType(type));
  mipmap_generated_ = true;
  return true;
}

References Bind(), GetGLHandle(), impeller::Texture::GetTextureDescriptor(), impeller::kTexture2D, impeller::kTexture2DMultisample, impeller::kTextureCube, impeller::kTextureExternalOES, impeller::Texture::mipmap_generated_, impeller::ToTextureType(), impeller::TextureDescriptor::type, and VALIDATION_LOG.

GetGLHandle()

std::optional< GLuint > impeller::TextureGLES::GetGLHandle

(

)

const

Definition at line 427 of file texture_gles.cc.

                                                   {
  if (!IsValid()) {
    return std::nullopt;
  }
  return reactor_->GetGLHandle(handle_);
}

Referenced by Bind(), impeller::ConfigureFBO(), GenerateMipmap(), and SetAsFramebufferAttachment().

GetType()

TextureGLES::Type impeller::TextureGLES::GetType

(

)

const

Definition at line 493 of file texture_gles.cc.

                                           {
  return type_;
}

IsWrapped()

bool impeller::TextureGLES::IsWrapped ( ) const

inline

Definition at line 54 of file texture_gles.h.

{ return is_wrapped_; }

SetAsFramebufferAttachment()

bool impeller::TextureGLES::SetAsFramebufferAttachment	(	GLenum	target,
		GLuint	fbo,
		AttachmentPoint	point
	)		const

Definition at line 508 of file texture_gles.cc.

                                                                          {
  if (!IsValid()) {
    return false;
  }
  InitializeContentsIfNecessary();
  auto handle = GetGLHandle();
  if (!handle.has_value()) {
    return false;
  }
  const auto& gl = reactor_->GetProcTable();
  switch (type_) {
    case Type::kTexture:
      gl.FramebufferTexture2D(target,                    // target
                              ToAttachmentPoint(point),  // attachment
                              GL_TEXTURE_2D,             // textarget
                              handle.value(),            // texture
                              0                          // level
      );
      break;
    case Type::kRenderBuffer:
      gl.FramebufferRenderbuffer(target,                    // target
                                 ToAttachmentPoint(point),  // attachment
                                 GL_RENDERBUFFER,  // render-buffer target
                                 handle.value()    // render-buffer
      );
      break;
    case Type::kRenderBufferMultisampled:
      // Assume that when MSAA is enabled, we're using 4x MSAA.
      FML_DCHECK(GetTextureDescriptor().sample_count == SampleCount::kCount4);
      gl.FramebufferTexture2DMultisampleEXT(
          target,                    // target
          ToAttachmentPoint(point),  // attachment
          GL_TEXTURE_2D,             // textarget
          handle.value(),            // texture
          0,                         // level
          4                          // samples
      );
      break;
  }
  return true;
}

References GetGLHandle(), impeller::Texture::GetTextureDescriptor(), impeller::kCount4, kRenderBuffer, kRenderBufferMultisampled, kTexture, and impeller::ToAttachmentPoint().

Referenced by impeller::ConfigureFBO().

Friends And Related Function Documentation

AllocatorMTL

friend class AllocatorMTL

friend

Definition at line 57 of file texture_gles.h.

---

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

• impeller/renderer/backend/gles/texture_gles.h
• impeller/renderer/backend/gles/texture_gles.cc