impeller::BlitPass Class Reference

Blit passes encode blit into the underlying command buffer. More...

#include <blit_pass.h>

Inheritance diagram for impeller::BlitPass:

Public Member Functions
virtual	~BlitPass ()
virtual bool	IsValid () const =0
void	SetLabel (std::string label)
bool	AddCopy (std::shared_ptr< Texture > source, std::shared_ptr< Texture > destination, std::optional< IRect > source_region=std::nullopt, IPoint destination_origin={}, std::string label="")
	Record a command to copy the contents of one texture to another texture. The blit area is limited by the intersection of the texture coverage with respect the source region and destination origin. No work is encoded into the command buffer at this time.
bool	AddCopy (std::shared_ptr< Texture > source, std::shared_ptr< DeviceBuffer > destination, std::optional< IRect > source_region=std::nullopt, size_t destination_offset=0, std::string label="")
	Record a command to copy the contents of the buffer to the texture. No work is encoded into the command buffer at this time.
bool	AddCopy (BufferView source, std::shared_ptr< Texture > destination, IPoint destination_origin={}, std::string label="")
	Record a command to copy the contents of the buffer to the texture. No work is encoded into the command buffer at this time.
bool	GenerateMipmap (std::shared_ptr< Texture > texture, std::string label="")
	Record a command to generate all mip levels for a texture. No work is encoded into the command buffer at this time.
virtual bool	EncodeCommands (const std::shared_ptr< Allocator > &transients_allocator) const =0
	Encode the recorded commands to the underlying command buffer.

Protected Member Functions
	BlitPass ()
virtual void	OnSetLabel (std::string label)=0
virtual bool	OnCopyTextureToTextureCommand (std::shared_ptr< Texture > source, std::shared_ptr< Texture > destination, IRect source_region, IPoint destination_origin, std::string label)=0
virtual bool	OnCopyTextureToBufferCommand (std::shared_ptr< Texture > source, std::shared_ptr< DeviceBuffer > destination, IRect source_region, size_t destination_offset, std::string label)=0
virtual bool	OnCopyBufferToTextureCommand (BufferView source, std::shared_ptr< Texture > destination, IPoint destination_origin, std::string label)=0
virtual bool	OnGenerateMipmapCommand (std::shared_ptr< Texture > texture, std::string label)=0

Detailed Description

Blit passes encode blit into the underlying command buffer.

        Blit passes can be obtained from the command buffer in which
        the pass is meant to encode commands into.

See also

CommandBuffer

Definition at line 26 of file blit_pass.h.

Constructor & Destructor Documentation

~BlitPass()

impeller::BlitPass::~BlitPass ( )

virtualdefault

BlitPass()

impeller::BlitPass::BlitPass ( )

explicitprotected

Definition at line 15 of file blit_pass.cc.

{}

Member Function Documentation

AddCopy() [1/3]

bool impeller::BlitPass::AddCopy	(	BufferView	source,
		std::shared_ptr< Texture >	destination,
		IPoint	destination_origin = {},
		std::string	label = ""
	)

Record a command to copy the contents of the buffer to the texture. No work is encoded into the command buffer at this time.

Parameters

[in]	source	The buffer view to read for copying.
[in]	destination	The texture to overwrite using the source contents.
[in]	destination_offset	The offset to start writing to in the destination buffer.
[in]	label	The optional debug label to give the command.

Returns

If the command was valid for subsequent commitment.

Definition at line 123 of file blit_pass.cc.

                                        {
  if (!destination) {
    VALIDATION_LOG << "Attempted to add a texture blit with no destination.";
    return false;
  }
 
  auto bytes_per_pixel =
      BytesPerPixelForPixelFormat(destination->GetTextureDescriptor().format);
  auto bytes_per_image =
      destination->GetTextureDescriptor().size.Area() * bytes_per_pixel;
 
  if (source.range.length != bytes_per_image) {
    VALIDATION_LOG
        << "Attempted to add a texture blit with out of bounds access.";
    return false;
  }
 
  return OnCopyBufferToTextureCommand(std::move(source), std::move(destination),
                                      destination_origin, std::move(label));
}

AddCopy() [2/3]

bool impeller::BlitPass::AddCopy	(	std::shared_ptr< Texture >	source,
		std::shared_ptr< DeviceBuffer >	destination,
		std::optional< IRect >	source_region = std::nullopt,
		size_t	destination_offset = 0,
		std::string	label = ""
	)

Record a command to copy the contents of the buffer to the texture. No work is encoded into the command buffer at this time.

Parameters

[in]	source	The texture to read for copying.
[in]	destination	The buffer to overwrite using the source contents.
[in]	source_region	The optional region of the source texture to use for copying. If not specified, the full size of the source texture is used.
[in]	destination_origin	The origin to start writing to in the destination texture.
[in]	label	The optional debug label to give the command.

Returns

If the command was valid for subsequent commitment.

Definition at line 83 of file blit_pass.cc.

                                        {
  if (!source) {
    VALIDATION_LOG << "Attempted to add a texture blit with no source.";
    return false;
  }
  if (!destination) {
    VALIDATION_LOG << "Attempted to add a texture blit with no destination.";
    return false;
  }
 
  if (!source_region.has_value()) {
    source_region = IRect::MakeSize(source->GetSize());
  }
 
  auto bytes_per_pixel =
      BytesPerPixelForPixelFormat(source->GetTextureDescriptor().format);
  auto bytes_per_image = source_region->Area() * bytes_per_pixel;
  if (destination_offset + bytes_per_image >
      destination->GetDeviceBufferDescriptor().size) {
    VALIDATION_LOG
        << "Attempted to add a texture blit with out of bounds access.";
    return false;
  }
 
  // Clip the source image.
  source_region =
      source_region->Intersection(IRect::MakeSize(source->GetSize()));
  if (!source_region.has_value()) {
    return true;  // Nothing to blit.
  }
 
  return OnCopyTextureToBufferCommand(std::move(source), std::move(destination),
                                      source_region.value(), destination_offset,
                                      std::move(label));
}

AddCopy() [3/3]

bool impeller::BlitPass::AddCopy	(	std::shared_ptr< Texture >	source,
		std::shared_ptr< Texture >	destination,
		std::optional< IRect >	source_region = std::nullopt,
		IPoint	destination_origin = {},
		std::string	label = ""
	)

Record a command to copy the contents of one texture to another texture. The blit area is limited by the intersection of the texture coverage with respect the source region and destination origin. No work is encoded into the command buffer at this time.

Parameters

[in]	source	The texture to read for copying.
[in]	destination	The texture to overwrite using the source contents.
[in]	source_region	The optional region of the source texture to use for copying. If not specified, the full size of the source texture is used.
[in]	destination_origin	The origin to start writing to in the destination texture.
[in]	label	The optional debug label to give the command.

Returns

If the command was valid for subsequent commitment.

Definition at line 26 of file blit_pass.cc.

                                        {
  if (!source) {
    VALIDATION_LOG << "Attempted to add a texture blit with no source.";
    return false;
  }
  if (!destination) {
    VALIDATION_LOG << "Attempted to add a texture blit with no destination.";
    return false;
  }
 
  if (source->GetTextureDescriptor().sample_count !=
      destination->GetTextureDescriptor().sample_count) {
    VALIDATION_LOG << SPrintF(
        "The source sample count (%d) must match the destination sample count "
        "(%d) for blits.",
        static_cast<int>(source->GetTextureDescriptor().sample_count),
        static_cast<int>(destination->GetTextureDescriptor().sample_count));
    return false;
  }
  if (source->GetTextureDescriptor().format !=
      destination->GetTextureDescriptor().format) {
    VALIDATION_LOG << SPrintF(
        "The source pixel format (%s) must match the destination pixel format "
        "(%s) "
        "for blits.",
        PixelFormatToString(source->GetTextureDescriptor().format),
        PixelFormatToString(destination->GetTextureDescriptor().format));
    return false;
  }
 
  if (!source_region.has_value()) {
    source_region = IRect::MakeSize(source->GetSize());
  }
 
  // Clip the source image.
  source_region =
      source_region->Intersection(IRect::MakeSize(source->GetSize()));
  if (!source_region.has_value()) {
    return true;  // Nothing to blit.
  }
 
  // Clip the destination image.
  source_region = source_region->Intersection(
      IRect::MakeOriginSize(-destination_origin, destination->GetSize()));
  if (!source_region.has_value()) {
    return true;  // Nothing to blit.
  }
 
  return OnCopyTextureToTextureCommand(
      std::move(source), std::move(destination), source_region.value(),
      destination_origin, std::move(label));
}

EncodeCommands()

virtual bool impeller::BlitPass::EncodeCommands ( const std::shared_ptr< Allocator > &  transients_allocator ) const

pure virtual

Encode the recorded commands to the underlying command buffer.

Parameters

transients_allocator

The transients allocator.

Returns

If the commands were encoded to the underlying command buffer.

Implemented in impeller::BlitPassGLES, impeller::BlitPassMTL, and impeller::BlitPassVK.

GenerateMipmap()

bool impeller::BlitPass::GenerateMipmap	(	std::shared_ptr< Texture >	texture,
		std::string	label = ""
	)

Record a command to generate all mip levels for a texture. No work is encoded into the command buffer at this time.

Parameters

[in]	texture	The texture to generate mipmaps for.
[in]	label	The optional debug label to give the command.

Returns

If the command was valid for subsequent commitment.

Definition at line 147 of file blit_pass.cc.

                                               {
  if (!texture) {
    VALIDATION_LOG << "Attempted to add an invalid mipmap generation command "
                      "with no texture.";
    return false;
  }
 
  return OnGenerateMipmapCommand(std::move(texture), std::move(label));
}

IsValid()

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

pure virtual

Implemented in impeller::BlitPassGLES, impeller::BlitPassMTL, and impeller::BlitPassVK.

OnCopyBufferToTextureCommand()

virtual bool impeller::BlitPass::OnCopyBufferToTextureCommand ( BufferView  source, std::shared_ptr< Texture >  destination, IPoint  destination_origin, std::string  label  )

protectedpure virtual

Implemented in impeller::BlitPassGLES, impeller::BlitPassMTL, and impeller::BlitPassVK.

OnCopyTextureToBufferCommand()

virtual bool impeller::BlitPass::OnCopyTextureToBufferCommand ( std::shared_ptr< Texture >  source, std::shared_ptr< DeviceBuffer >  destination, IRect  source_region, size_t  destination_offset, std::string  label  )

protectedpure virtual

Implemented in impeller::BlitPassGLES, impeller::BlitPassMTL, and impeller::BlitPassVK.

OnCopyTextureToTextureCommand()

virtual bool impeller::BlitPass::OnCopyTextureToTextureCommand ( std::shared_ptr< Texture >  source, std::shared_ptr< Texture >  destination, IRect  source_region, IPoint  destination_origin, std::string  label  )

protectedpure virtual

Implemented in impeller::BlitPassGLES, impeller::BlitPassMTL, and impeller::BlitPassVK.

OnGenerateMipmapCommand()

virtual bool impeller::BlitPass::OnGenerateMipmapCommand ( std::shared_ptr< Texture >  texture, std::string  label  )

protectedpure virtual

Implemented in impeller::BlitPassGLES, impeller::BlitPassMTL, and impeller::BlitPassVK.

OnSetLabel()

virtual void impeller::BlitPass::OnSetLabel ( std::string  label )

protectedpure virtual

Implemented in impeller::BlitPassGLES, impeller::BlitPassMTL, and impeller::BlitPassVK.

SetLabel()

void impeller::BlitPass::SetLabel

(

std::string

label

)

Definition at line 19 of file blit_pass.cc.

                                       {
  if (label.empty()) {
    return;
  }
  OnSetLabel(std::move(label));
}

---

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

• impeller/renderer/blit_pass.h
• impeller/renderer/blit_pass.cc