impeller::Texture Class Reference

#include <texture.h>

Inheritance diagram for impeller::Texture:

Public Member Functions
virtual	~Texture ()
virtual void	SetLabel (std::string_view label)=0
	Label this resource for inspection in GPU debugging tools.
virtual void	SetLabel (std::string_view label, std::string_view trailing)=0
	Label this resource for inspection in GPU debugging tools, with label and trailing will be concatenated together.
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)
virtual bool	IsValid () const =0
virtual ISize	GetSize () const =0
bool	IsOpaque () const
size_t	GetMipCount () const
const TextureDescriptor &	GetTextureDescriptor () const
bool	NeedsMipmapGeneration () const

Protected Member Functions
	Texture (TextureDescriptor desc)
virtual bool	OnSetContents (const uint8_t *contents, size_t length, size_t slice)=0
virtual bool	OnSetContents (std::shared_ptr< const fml::Mapping > mapping, size_t slice)=0

Protected Attributes
bool	mipmap_generated_ = false

Detailed Description

Definition at line 17 of file texture.h.

Constructor & Destructor Documentation

~Texture()

impeller::Texture::~Texture ( )

virtualdefault

Texture()

impeller::Texture::Texture ( TextureDescriptor  desc )

explicitprotected

Definition at line 11 of file texture.cc.

: desc_(desc) {}

Member Function Documentation

GetMipCount()

size_t impeller::Texture::GetMipCount

(

)

const

Definition at line 51 of file texture.cc.

                                  {
  return GetTextureDescriptor().mip_count;
}

References GetTextureDescriptor(), and impeller::TextureDescriptor::mip_count.

GetSize()

virtual ISize impeller::Texture::GetSize ( ) const

pure virtual

Implemented in impeller::TestImpellerTexture, and impeller::TextureVK.

GetTextureDescriptor()

const TextureDescriptor & impeller::Texture::GetTextureDescriptor

(

)

const

Definition at line 55 of file texture.cc.

                                                             {
  return desc_;
}

Referenced by impeller::TextureGLES::Bind(), impeller::BlitCopyBufferToTextureCommandGLES::Encode(), impeller::TextureGLES::GenerateMipmap(), GetMipCount(), impeller::TestImpellerTexture::GetSize(), impeller::TextureVK::GetSize(), impeller::TextureGLES::SetAsFramebufferAttachment(), impeller::TextureMTL::TextureMTL(), and impeller::TextureMTL::~TextureMTL().

IsOpaque()

bool impeller::Texture::IsOpaque

(

)

const

Definition at line 47 of file texture.cc.

                             {
  return is_opaque_;
}

IsValid()

virtual bool impeller::Texture::IsValid ( ) const

pure virtual

Implemented in impeller::TextureGLES, impeller::TextureMTL, and impeller::TestImpellerTexture.

NeedsMipmapGeneration()

bool impeller::Texture::NeedsMipmapGeneration

(

)

const

Returns true if mipmaps have never been generated. The contents of the mipmap may be out of date if the root texture has been modified and the mipmaps hasn't been regenerated.

Definition at line 71 of file texture.cc.

                                          {
  return !mipmap_generated_ && desc_.mip_count > 1;
}

References impeller::TextureDescriptor::mip_count, and mipmap_generated_.

OnSetContents() [1/2]

virtual bool impeller::Texture::OnSetContents ( const uint8_t *  contents, size_t  length, size_t  slice  )

protectedpure virtual

Implemented in impeller::TestImpellerTexture.

Referenced by SetContents(), and SetContents().

OnSetContents() [2/2]

virtual bool impeller::Texture::OnSetContents ( std::shared_ptr< const fml::Mapping >  mapping, size_t  slice  )

protectedpure virtual

Implemented in impeller::TestImpellerTexture.

SetContents() [1/2]

bool impeller::Texture::SetContents	(	const uint8_t *	contents,
		size_t	length,
		size_t	slice = 0,
		bool	is_opaque = false
	)

Definition at line 15 of file texture.cc.

                                          {
  if (!IsSliceValid(slice)) {
    VALIDATION_LOG << "Invalid slice for texture.";
    return false;
  }
  if (!OnSetContents(contents, length, slice)) {
    return false;
  }
  is_opaque_ = is_opaque;
  return true;
}

References length, OnSetContents(), and VALIDATION_LOG.

SetContents() [2/2]

bool impeller::Texture::SetContents	(	std::shared_ptr< const fml::Mapping >	mapping,
		size_t	slice = 0,
		bool	is_opaque = false
	)

Definition at line 30 of file texture.cc.

                                          {
  if (!IsSliceValid(slice)) {
    VALIDATION_LOG << "Invalid slice for texture.";
    return false;
  }
  if (!mapping) {
    return false;
  }
  if (!OnSetContents(std::move(mapping), slice)) {
    return false;
  }
  is_opaque_ = is_opaque;
  return true;
}

References OnSetContents(), and VALIDATION_LOG.

SetLabel() [1/2]

virtual void impeller::Texture::SetLabel ( std::string_view  label )

pure virtual

Label this resource for inspection in GPU debugging tools.

This functionality may be disabled in release builds.

Implemented in impeller::TestImpellerTexture.

SetLabel() [2/2]

virtual void impeller::Texture::SetLabel ( std::string_view  label, std::string_view  trailing  )

pure virtual

Label this resource for inspection in GPU debugging tools, with label and trailing will be concatenated together.

This functionality may be disabled in release builds.

Implemented in impeller::TestImpellerTexture.

Member Data Documentation

mipmap_generated_

bool impeller::Texture::mipmap_generated_ = false

protected

Definition at line 69 of file texture.h.

Referenced by impeller::TextureGLES::GenerateMipmap(), impeller::TextureMTL::GenerateMipmap(), NeedsMipmapGeneration(), and impeller::TextureVK::SetMipMapGenerated().

---

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

• impeller/core/texture.h
• impeller/core/texture.cc