flutter::gpu::Texture Class Reference

#include <texture.h>

Inheritance diagram for flutter::gpu::Texture:

Public Member Functions
	Texture (std::shared_ptr< impeller::Texture > texture)
	~Texture () override
std::shared_ptr< impeller::Texture >	GetTexture ()
bool	Overwrite (Context &gpu_context, const tonic::DartByteData &source_bytes, uint32_t mip_level, uint32_t slice)
Dart_Handle	AsImage () const
Public Member Functions inherited from flutter::RefCountedDartWrappable< Texture >
virtual void	RetainDartWrappableReference () const override
virtual void	ReleaseDartWrappableReference () const override
Public Member Functions inherited from fml::RefCountedThreadSafe< T >
void	Release () const
Public Member Functions inherited from fml::internal::RefCountedThreadSafeBase
void	AddRef () const
bool	HasOneRef () const
void	AssertHasOneRef () const
Public Member Functions inherited from tonic::DartWrappable
	DartWrappable ()
virtual const DartWrapperInfo &	GetDartWrapperInfo () const =0
Dart_Handle	CreateDartWrapper (DartState *dart_state)
void	AssociateWithDartWrapper (Dart_Handle wrappable)
void	ClearDartWrapper ()
Dart_WeakPersistentHandle	dart_wrapper () const

Additional Inherited Members
Public Types inherited from tonic::DartWrappable
enum	DartNativeFields {   kPeerIndex ,   kNumberOfNativeFields }
Protected Member Functions inherited from fml::RefCountedThreadSafe< T >
	RefCountedThreadSafe ()
	~RefCountedThreadSafe ()
Protected Member Functions inherited from fml::internal::RefCountedThreadSafeBase
	RefCountedThreadSafeBase ()
	~RefCountedThreadSafeBase ()
bool	Release () const
void	Adopt ()
Protected Member Functions inherited from tonic::DartWrappable
virtual	~DartWrappable ()
Static Protected Member Functions inherited from tonic::DartWrappable
static Dart_PersistentHandle	GetTypeForWrapper (tonic::DartState *dart_state, const tonic::DartWrapperInfo &wrapper_info)

Detailed Description

Definition at line 17 of file texture.h.

Constructor & Destructor Documentation

Texture()

flutter::gpu::Texture::Texture ( std::shared_ptr< impeller::Texture >  texture )

explicit

Definition at line 33 of file texture.cc.

    : texture_(std::move(texture)) {}

~Texture()

flutter::gpu::Texture::~Texture ( )

overridedefault

Member Function Documentation

AsImage()

Dart_Handle flutter::gpu::Texture::AsImage

(

)

const

Definition at line 143 of file texture.cc.

                                   {
  // DlImageImpeller isn't compiled in builds with Impeller disabled. If
  // Impeller is disabled, it's impossible to get here anyhow, so just ifdef it
  // out.
#if IMPELLER_SUPPORTS_RENDERING
  auto image = flutter::CanvasImage::Create();
  auto dl_image = impeller::DlImageImpeller::Make(texture_);
  image->set_image(dl_image);
  auto wrapped = image->CreateOuterWrapping();
  return wrapped;
#else
  return Dart_Null();
#endif
}

References flutter::CanvasImage::Create(), image, and impeller::DlImageImpeller::Make().

Referenced by InternalFlutterGpu_Texture_AsImage().

GetTexture()

std::shared_ptr< impeller::Texture > flutter::gpu::Texture::GetTexture

(

)

Definition at line 38 of file texture.cc.

                                                   {
  return texture_;
}

Referenced by flutter::gpu::CommandBuffer::CopyBufferToTexture(), flutter::gpu::CommandBuffer::CopyTextureToBuffer(), flutter::gpu::CommandBuffer::CopyTextureToTexture(), and InternalFlutterGpu_RenderPass_SetColorAttachment().

Overwrite()

bool flutter::gpu::Texture::Overwrite	(	Context &	gpu_context,
		const tonic::DartByteData &	source_bytes,
		uint32_t	mip_level,
		uint32_t	slice
	)

Definition at line 86 of file texture.cc.

                                        {
  const uint8_t* data = static_cast<const uint8_t*>(source_bytes.data());
  const size_t length = source_bytes.length_in_bytes();
 
  auto& impeller_context = gpu_context.GetContext();
  auto staging_buffer =
      impeller_context.GetResourceAllocator()->CreateBufferWithCopy(data,
                                                                    length);
  if (!staging_buffer) {
    FML_LOG(ERROR) << "Failed to allocate staging buffer for texture "
                      "overwrite.";
    return false;
  }
 
  // Compute the destination region for the requested mip level. The
  // BlitPass::AddCopy validation requires the region to fit within the base
  // texture size, and the actual GPU copy uses this rectangle as the
  // destination on the chosen mip level. The same `max(1, dim >> level)`
  // formula is used by `Texture.getMipLevelSizeInBytes` on the Dart side; if
  // either is updated, both must be kept in sync.
  const impeller::ISize base_size = texture_->GetSize();
  const impeller::IRect destination_region = impeller::IRect::MakeXYWH(
      0, 0, MipDimensionAtLevel(base_size.width, mip_level),
      MipDimensionAtLevel(base_size.height, mip_level));
 
  // For the GLES backend, command queue submission just flushes the reactor,
  // which needs to happen on the raster thread.
  if (impeller_context.GetBackendType() ==
      impeller::Context::BackendType::kOpenGLES) {
    auto dart_state = flutter::UIDartState::Current();
    auto& task_runners = dart_state->GetTaskRunners();
    auto context_shared = gpu_context.GetContextShared();
    task_runners.GetRasterTaskRunner()->PostTask(fml::MakeCopyable(
        [context_shared, texture = texture_, staging_buffer, length,
         destination_region, mip_level, slice]() mutable {
          if (!EncodeAndSubmitOverwrite(*context_shared, texture,
                                        staging_buffer, length,
                                        destination_region, mip_level, slice)) {
            FML_LOG(ERROR) << "Failed to encode texture overwrite blit on the "
                              "raster thread.";
          }
          context_shared->DisposeThreadLocalCachedResources();
        }));
    return true;
  }
 
  if (!EncodeAndSubmitOverwrite(impeller_context, texture_, staging_buffer,
                                length, destination_region, mip_level, slice)) {
    return false;
  }
  impeller_context.DisposeThreadLocalCachedResources();
  return true;
}

References flutter::UIDartState::Current(), flutter::data, tonic::DartByteData::data(), flutter::gpu::EncodeAndSubmitOverwrite(), FML_LOG, flutter::gpu::Context::GetContext(), flutter::gpu::Context::GetContextShared(), impeller::Context::GetResourceAllocator(), impeller::TSize< T >::height, impeller::Context::kOpenGLES, length, tonic::DartByteData::length_in_bytes(), fml::MakeCopyable(), impeller::TRect< T >::MakeXYWH(), flutter::gpu::MipDimensionAtLevel(), texture, and impeller::TSize< T >::width.

---

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

• lib/gpu/texture.h
• lib/gpu/texture.cc