flutter::EmbedderSurfaceSoftware Class Reference

#include <embedder_surface_software.h>

Inheritance diagram for flutter::EmbedderSurfaceSoftware:

Classes
struct	SoftwareDispatchTable

Public Member Functions
	EmbedderSurfaceSoftware (SoftwareDispatchTable software_dispatch_table, std::shared_ptr< EmbedderExternalViewEmbedder > external_view_embedder)
	~EmbedderSurfaceSoftware () override
Public Member Functions inherited from flutter::EmbedderSurface
	EmbedderSurface ()
virtual	~EmbedderSurface ()
virtual std::shared_ptr< impeller::Context >	CreateImpellerContext () const
Public Member Functions inherited from flutter::GPUSurfaceSoftwareDelegate
	~GPUSurfaceSoftwareDelegate ()

Private Member Functions
bool	IsValid () const override
std::unique_ptr< Surface >	CreateGPUSurface () override
sk_sp< GrDirectContext >	CreateResourceContext () const override
sk_sp< SkSurface >	AcquireBackingStore (const SkISize &size) override
	Called when the GPU surface needs a new buffer to render a new frame into.
bool	PresentBackingStore (sk_sp< SkSurface > backing_store) override
	Called by the platform when a frame has been rendered into the backing store and the platform must display it on-screen.

Detailed Description

Definition at line 17 of file embedder_surface_software.h.

Constructor & Destructor Documentation

EmbedderSurfaceSoftware()

flutter::EmbedderSurfaceSoftware::EmbedderSurfaceSoftware	(	SoftwareDispatchTable	software_dispatch_table,
		std::shared_ptr< EmbedderExternalViewEmbedder >	external_view_embedder
	)

Definition at line 18 of file embedder_surface_software.cc.

    : software_dispatch_table_(std::move(software_dispatch_table)),
      external_view_embedder_(std::move(external_view_embedder)) {
  if (!software_dispatch_table_.software_present_backing_store) {
    return;
  }
  valid_ = true;
}

~EmbedderSurfaceSoftware()

flutter::EmbedderSurfaceSoftware::~EmbedderSurfaceSoftware ( )

overridedefault

Member Function Documentation

AcquireBackingStore()

sk_sp< SkSurface > flutter::EmbedderSurfaceSoftware::AcquireBackingStore ( const SkISize &  size )

overrideprivatevirtual

Called when the GPU surface needs a new buffer to render a new frame into.

Parameters

[in]

size

The size of the frame.

Returns

A raster surface returned by the platform.

Implements flutter::GPUSurfaceSoftwareDelegate.

Definition at line 57 of file embedder_surface_software.cc.

                         {
  TRACE_EVENT0("flutter", "EmbedderSurfaceSoftware::AcquireBackingStore");
  if (!IsValid()) {
    FML_LOG(ERROR)
        << "Could not acquire backing store for the software surface.";
    return nullptr;
  }
 
  if (sk_surface_ != nullptr &&
      SkISize::Make(sk_surface_->width(), sk_surface_->height()) == size) {
    // The old and new surface sizes are the same. Nothing to do here.
    return sk_surface_;
  }
 
  SkImageInfo info = SkImageInfo::MakeN32(
      size.fWidth, size.fHeight, kPremul_SkAlphaType, SkColorSpace::MakeSRGB());
  sk_surface_ = SkSurfaces::Raster(info, nullptr);
 
  if (sk_surface_ == nullptr) {
    FML_LOG(ERROR) << "Could not create backing store for software rendering.";
    return nullptr;
  }
 
  return sk_surface_;
}

CreateGPUSurface()

std::unique_ptr< Surface > flutter::EmbedderSurfaceSoftware::CreateGPUSurface ( )

overrideprivatevirtual

Implements flutter::EmbedderSurface.

Definition at line 37 of file embedder_surface_software.cc.

                                                                 {
  if (!IsValid()) {
    return nullptr;
  }
  const bool render_to_surface = !external_view_embedder_;
  auto surface = std::make_unique<GPUSurfaceSoftware>(this, render_to_surface);
 
  if (!surface->IsValid()) {
    return nullptr;
  }
 
  return surface;
}

CreateResourceContext()

sk_sp< GrDirectContext > flutter::EmbedderSurfaceSoftware::CreateResourceContext ( ) const

overrideprivatevirtual

Reimplemented from flutter::EmbedderSurface.

Definition at line 52 of file embedder_surface_software.cc.

                                                                            {
  return nullptr;
}

IsValid()

bool flutter::EmbedderSurfaceSoftware::IsValid ( ) const

overrideprivatevirtual

Implements flutter::EmbedderSurface.

Definition at line 32 of file embedder_surface_software.cc.

                                            {
  return valid_;
}

PresentBackingStore()

bool flutter::EmbedderSurfaceSoftware::PresentBackingStore ( sk_sp< SkSurface >  backing_store )

overrideprivatevirtual

Called by the platform when a frame has been rendered into the backing store and the platform must display it on-screen.

Parameters

[in]

backing_store

The software backing store to present.

Returns

Returns if the platform could present the backing store onto the screen.

Implements flutter::GPUSurfaceSoftwareDelegate.

Definition at line 85 of file embedder_surface_software.cc.

                                    {
  if (!IsValid()) {
    FML_LOG(ERROR) << "Tried to present an invalid software surface.";
    return false;
  }
 
  SkPixmap pixmap;
  if (!backing_store->peekPixels(&pixmap)) {
    FML_LOG(ERROR) << "Could not peek the pixels of the backing store.";
    return false;
  }
 
  // Some basic sanity checking.
  uint64_t expected_pixmap_data_size = pixmap.width() * pixmap.height() * 4;
 
  const size_t pixmap_size = pixmap.computeByteSize();
 
  if (expected_pixmap_data_size != pixmap_size) {
    FML_LOG(ERROR) << "Software backing store had unexpected size.";
    return false;
  }
 
  return software_dispatch_table_.software_present_backing_store(
      pixmap.addr(),      //
      pixmap.rowBytes(),  //
      pixmap.height()     //
  );
}

---

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

• shell/platform/embedder/embedder_surface_software.h
• shell/platform/embedder/embedder_surface_software.cc