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. More...

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. More...

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. More...

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. More...

virtual bool	EncodeCommands (const std::shared_ptr< Allocator > &transients_allocator) const =0
	Encode the recorded commands to the underlying command buffer. More...

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.

15 {}

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));
 }

References impeller::BytesPerPixelForPixelFormat(), impeller::Range::length, OnCopyBufferToTextureCommand(), impeller::BufferView::range, and VALIDATION_LOG.

◆ 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));
 }

References impeller::BytesPerPixelForPixelFormat(), impeller::TRect< int64_t >::MakeSize(), OnCopyTextureToBufferCommand(), and VALIDATION_LOG.

◆ 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));
 }

References impeller::TRect< int64_t >::MakeOriginSize(), impeller::TRect< int64_t >::MakeSize(), OnCopyTextureToTextureCommand(), impeller::PixelFormatToString(), impeller::SPrintF(), and VALIDATION_LOG.

◆ 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.

◆ 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));
 }

References OnGenerateMipmapCommand(), and VALIDATION_LOG.

◆ IsValid()

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

pure virtual

◆ OnCopyBufferToTextureCommand()

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

protectedpure virtual

Referenced by AddCopy().

◆ 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

Referenced by AddCopy().

◆ 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

Referenced by AddCopy().

◆ OnGenerateMipmapCommand()

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

protectedpure virtual

Referenced by GenerateMipmap().

◆ OnSetLabel()

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

protectedpure virtual

Referenced by SetLabel().

◆ 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));
 }

References OnSetLabel().

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

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

Public Member Functions

Protected Member Functions

Detailed Description

Constructor & Destructor Documentation

◆ ~BlitPass()

◆ BlitPass()

Member Function Documentation

◆ AddCopy() [1/3]

◆ AddCopy() [2/3]

◆ AddCopy() [3/3]

◆ EncodeCommands()

◆ GenerateMipmap()

◆ IsValid()

◆ OnCopyBufferToTextureCommand()

◆ OnCopyTextureToBufferCommand()

◆ OnCopyTextureToTextureCommand()

◆ OnGenerateMipmapCommand()

◆ OnSetLabel()

◆ SetLabel()