impeller::TextureGLES Class Reference

#include <texture_gles.h>

Inheritance diagram for impeller::TextureGLES:

Public Types
enum	Type {   Type::kTexture,   Type::kTextureMultisampled,   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, 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 44 of file texture_gles.h.

                             {
    kColor0,
    kDepth,
    kStencil,
  };

IsWrapped

enum impeller::TextureGLES::IsWrapped

strong

Enumerator
kWrapped

Definition at line 25 of file texture_gles.h.

                       {
    kWrapped,
  };

Type

enum impeller::TextureGLES::Type

strong

Enumerator
kTexture
kTextureMultisampled
kRenderBuffer
kRenderBufferMultisampled

Definition at line 18 of file texture_gles.h.

                  {
    kTexture,
    kTextureMultisampled,
    kRenderBuffer,
    kRenderBufferMultisampled,
  };

Constructor & Destructor Documentation

TextureGLES() [1/2]

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

Definition at line 46 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 49 of file texture_gles.cc.

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

~TextureGLES()

impeller::TextureGLES::~TextureGLES ( )

override

Definition at line 81 of file texture_gles.cc.

                          {
  reactor_->CollectHandle(handle_);
}

Member Function Documentation

Bind()

bool impeller::TextureGLES::Bind

(

)

const

Definition at line 397 of file texture_gles.cc.

                             {
  auto handle = GetGLHandle();
  if (!handle.has_value()) {
    return false;
  }
  const auto& gl = reactor_->GetProcTable();
  switch (type_) {
    case Type::kTexture:
    case Type::kTextureMultisampled: {
      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:
    case Type::kRenderBufferMultisampled:
      gl.BindRenderbuffer(GL_RENDERBUFFER, handle.value());
      break;
  }
  InitializeContentsIfNecessary();
  return true;
}

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

Referenced by GenerateMipmap().

GenerateMipmap()

bool impeller::TextureGLES::GenerateMipmap

(

)

Definition at line 422 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 390 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 456 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,
		AttachmentPoint	point
	)		const

Definition at line 471 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::kTextureMultisampled:
      gl.FramebufferTexture2DMultisampleEXT(
          target,                    // target
          ToAttachmentPoint(point),  // attachment
          GL_TEXTURE_2D,             // textarget
          handle.value(),            // texture
          0,                         // level
          4                          // samples
      );
      break;
    case Type::kRenderBuffer:
    case Type::kRenderBufferMultisampled:
      gl.FramebufferRenderbuffer(target,                    // target
                                 ToAttachmentPoint(point),  // attachment
                                 GL_RENDERBUFFER,  // render-buffer target
                                 handle.value()    // render-buffer
      );
      break;
  }
 
  return true;
}

References GetGLHandle(), kRenderBuffer, kRenderBufferMultisampled, kTexture, kTextureMultisampled, 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