flutter::IOSSurfaceSoftware Class Reference

#include <ios_surface_software.h>

Inheritance diagram for flutter::IOSSurfaceSoftware:

Public Member Functions
	IOSSurfaceSoftware (const fml::scoped_nsobject< CALayer > &layer, std::shared_ptr< IOSContext > context)
	~IOSSurfaceSoftware () override
bool	IsValid () const override
void	UpdateStorageSizeIfNecessary () override
std::unique_ptr< Surface >	CreateGPUSurface (GrDirectContext *gr_context=nullptr) override
sk_sp< SkSurface >	AcquireBackingStore (const SkISize &size) override
	Called when the GPU surface needs a new buffer to render a new frame into. More...
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. More...
Public Member Functions inherited from flutter::IOSSurface
std::shared_ptr< IOSContext >	GetContext () const
virtual	~IOSSurface ()
virtual bool	IsValid () const =0
virtual void	UpdateStorageSizeIfNecessary ()=0
virtual std::unique_ptr< Surface >	CreateGPUSurface (GrDirectContext *gr_context=nullptr)=0
Public Member Functions inherited from flutter::GPUSurfaceSoftwareDelegate
	~GPUSurfaceSoftwareDelegate ()
virtual sk_sp< SkSurface >	AcquireBackingStore (const SkISize &size)=0
	Called when the GPU surface needs a new buffer to render a new frame into. More...
virtual bool	PresentBackingStore (sk_sp< SkSurface > backing_store)=0
	Called by the platform when a frame has been rendered into the backing store and the platform must display it on-screen. More...

Additional Inherited Members
Static Public Member Functions inherited from flutter::IOSSurface
static std::unique_ptr< IOSSurface >	Create (std::shared_ptr< IOSContext > context, const fml::scoped_nsobject< CALayer > &layer)
Protected Member Functions inherited from flutter::IOSSurface
	IOSSurface (std::shared_ptr< IOSContext > ios_context)

Detailed Description

Definition at line 21 of file ios_surface_software.h.

Constructor & Destructor Documentation

IOSSurfaceSoftware()

flutter::IOSSurfaceSoftware::IOSSurfaceSoftware	(	const fml::scoped_nsobject< CALayer > &	layer,
		std::shared_ptr< IOSContext >	context
	)

Definition at line 22 of file ios_surface_software.mm.

    : IOSSurface(std::move(context)), layer_(layer) {}

~IOSSurfaceSoftware()

flutter::IOSSurfaceSoftware::~IOSSurfaceSoftware ( )

overridedefault

Member Function Documentation

AcquireBackingStore()

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

overridevirtual

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 53 of file ios_surface_software.mm.

                                                                            {
  TRACE_EVENT0("flutter", "IOSSurfaceSoftware::AcquireBackingStore");
  if (!IsValid()) {
    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);
  return sk_surface_;
}

CreateGPUSurface()

std::unique_ptr< Surface > flutter::IOSSurfaceSoftware::CreateGPUSurface ( GrDirectContext *  gr_context = nullptr )

overridevirtual

Implements flutter::IOSSurface.

Definition at line 39 of file ios_surface_software.mm.

                                                                                       {
  if (!IsValid()) {
    return nullptr;
  }
 
  auto surface = std::make_unique<GPUSurfaceSoftware>(this, true /* render to surface */);
 
  if (!surface->IsValid()) {
    return nullptr;
  }
 
  return surface;
}

IsValid()

bool flutter::IOSSurfaceSoftware::IsValid ( ) const

overridevirtual

Implements flutter::IOSSurface.

Definition at line 28 of file ios_surface_software.mm.

                                       {
  return layer_;
}

PresentBackingStore()

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

overridevirtual

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 71 of file ios_surface_software.mm.

                                                                           {
  TRACE_EVENT0("flutter", "IOSSurfaceSoftware::PresentBackingStore");
  if (!IsValid() || backing_store == nullptr) {
    return false;
  }
 
  SkPixmap pixmap;
  if (!backing_store->peekPixels(&pixmap)) {
    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) {
    return false;
  }
 
  fml::CFRef<CGColorSpaceRef> colorspace(CGColorSpaceCreateDeviceRGB());
 
  // Setup the data provider that gives CG a view into the pixmap.
  fml::CFRef<CGDataProviderRef> pixmap_data_provider(CGDataProviderCreateWithData(
      nullptr,          // info
      pixmap.addr32(),  // data
      pixmap_size,      // size
      nullptr           // release callback
      ));
 
  if (!pixmap_data_provider) {
    return false;
  }
 
  // Create the CGImageRef representation on the pixmap.
  fml::CFRef<CGImageRef> pixmap_image(CGImageCreate(pixmap.width(),     // width
                                                    pixmap.height(),    // height
                                                    8,                  // bits per component
                                                    32,                 // bits per pixel
                                                    pixmap.rowBytes(),  // bytes per row
                                                    colorspace,         // colorspace
                                                    kCGImageAlphaPremultipliedLast,  // bitmap info
                                                    pixmap_data_provider,      // data provider
                                                    nullptr,                   // decode array
                                                    false,                     // should interpolate
                                                    kCGRenderingIntentDefault  // rendering intent
                                                    ));
 
  if (!pixmap_image) {
    return false;
  }
 
  layer_.get().contents = (__bridge id)(static_cast<CGImageRef>(pixmap_image));
 
  return true;
}

UpdateStorageSizeIfNecessary()

void flutter::IOSSurfaceSoftware::UpdateStorageSizeIfNecessary ( )

overridevirtual

Implements flutter::IOSSurface.

Definition at line 32 of file ios_surface_software.mm.

                                                      {
  // Nothing to do here. We don't need an external entity to tell us when our
  // backing store needs to be updated. Instead, we let the frame tell us its
  // size so we can update to match. This method was added to work around
  // Android oddities.
}

---

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

• shell/platform/darwin/ios/ios_surface_software.h
• shell/platform/darwin/ios/ios_surface_software.mm