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	AttachmentType {   AttachmentType::kColor0,   AttachmentType::kDepth,   AttachmentType::kStencil }

Public Member Functions
	TextureGLES (ReactorGLES::Ref reactor, TextureDescriptor desc)
	TextureGLES (ReactorGLES::Ref reactor, TextureDescriptor desc, IsWrapped wrapped)
	TextureGLES (ReactorGLES::Ref reactor, TextureDescriptor desc, HandleGLES external_handle)
	~TextureGLES () override
bool	IsValid () const override
std::optional< GLuint >	GetGLHandle () const
bool	Bind () const
bool	GenerateMipmap ()
bool	SetAsFramebufferAttachment (GLenum target, AttachmentType attachment_type) const
Type	GetType () const
bool	IsWrapped () const
std::optional< GLuint >	GetFBO () const
void	MarkSliceInitialized (size_t slice) const
bool	IsSliceInitialized (size_t slice) 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

Static Public Member Functions
static std::shared_ptr< TextureGLES >	WrapFBO (ReactorGLES::Ref reactor, TextureDescriptor desc, GLuint fbo)
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)

Additional Inherited Members
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 17 of file texture_gles.h.

Member Enumeration Documentation

AttachmentType

enum impeller::TextureGLES::AttachmentType

strong

Enumerator
kColor0
kDepth
kStencil

Definition at line 57 of file texture_gles.h.

                            {
    kColor0,
    kDepth,
    kStencil,
  };

IsWrapped

enum bool impeller::TextureGLES::IsWrapped

strong

Enumerator
kWrapped

Definition at line 27 of file texture_gles.h.

                       {
    kWrapped,
  };

Type

enum impeller::TextureGLES::Type

strong

Enumerator
kTexture
kTextureMultisampled
kRenderBuffer
kRenderBufferMultisampled

Definition at line 20 of file texture_gles.h.

                  {
    kTexture,
    kTextureMultisampled,
    kRenderBuffer,
    kRenderBufferMultisampled,
  };

Constructor & Destructor Documentation

TextureGLES() [1/3]

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

Definition at line 142 of file texture_gles.cc.

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

Referenced by WrapFBO().

TextureGLES() [2/3]

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

Definition at line 146 of file texture_gles.cc.

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

TextureGLES() [3/3]

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

Definition at line 151 of file texture_gles.cc.

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

~TextureGLES()

impeller::TextureGLES::~TextureGLES ( )

override

Definition at line 199 of file texture_gles.cc.

                          {
  reactor_->CollectHandle(handle_);
}

Member Function Documentation

Bind()

bool impeller::TextureGLES::Bind

(

)

const

Definition at line 444 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(), type, and VALIDATION_LOG.

Referenced by GenerateMipmap().

GenerateMipmap()

bool impeller::TextureGLES::GenerateMipmap

(

)

Definition at line 477 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(), IsValid(), impeller::kTexture2D, impeller::kTexture2DMultisample, impeller::kTextureCube, impeller::kTextureExternalOES, impeller::Texture::mipmap_generated_, impeller::ToTextureType(), impeller::TextureDescriptor::type, type, and VALIDATION_LOG.

GetFBO()

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

(

)

const

Definition at line 587 of file texture_gles.cc.

                                              {
  return wrapped_fbo_;
}

GetGLHandle()

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

(

)

const

Definition at line 437 of file texture_gles.cc.

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

References IsValid().

Referenced by Bind(), impeller::ConfigureFBO(), impeller::BlitCopyBufferToTextureCommandGLES::Encode(), GenerateMipmap(), impeller::interop::ImpellerTextureGetOpenGLHandle(), and SetAsFramebufferAttachment().

GetType()

TextureGLES::Type impeller::TextureGLES::GetType

(

)

const

Definition at line 511 of file texture_gles.cc.

                                           {
  return type_;
}

Referenced by impeller::BlitCopyBufferToTextureCommandGLES::Encode().

IsSliceInitialized()

bool impeller::TextureGLES::IsSliceInitialized

(

size_t

slice

)

const

Definition at line 473 of file texture_gles.cc.

                                                       {
  return slices_initialized_[slice];
}

Referenced by impeller::BlitCopyBufferToTextureCommandGLES::Encode().

IsValid()

bool impeller::TextureGLES::IsValid ( ) const

overridevirtual

Implements impeller::Texture.

Definition at line 204 of file texture_gles.cc.

                                {
  return is_valid_;
}

Referenced by GenerateMipmap(), GetGLHandle(), and SetAsFramebufferAttachment().

IsWrapped()

bool impeller::TextureGLES::IsWrapped

(

)

const

MarkSliceInitialized()

void impeller::TextureGLES::MarkSliceInitialized

(

size_t

slice

)

const

Definition at line 469 of file texture_gles.cc.

                                                         {
  slices_initialized_[slice] = true;
}

Referenced by impeller::BlitCopyBufferToTextureCommandGLES::Encode().

SetAsFramebufferAttachment()

bool impeller::TextureGLES::SetAsFramebufferAttachment	(	GLenum	target,
		AttachmentType	attachment_type
	)		const

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

References GetGLHandle(), IsValid(), kRenderBuffer, kRenderBufferMultisampled, kTexture, kTextureMultisampled, and impeller::ToAttachmentType().

Referenced by impeller::ConfigureFBO().

WrapFBO()

std::shared_ptr< TextureGLES > impeller::TextureGLES::WrapFBO ( ReactorGLES::Ref  reactor, TextureDescriptor  desc, GLuint  fbo  )

static

Definition at line 160 of file texture_gles.cc.

                                                              {
  return std::shared_ptr<TextureGLES>(
      new TextureGLES(std::move(reactor), desc, true, fbo, std::nullopt));
}

References TextureGLES().

---

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