flutter::EmbedderRenderTarget Class Reference

Describes a surface whose backing store is managed by the embedder. The type of surface depends on the client rendering API used. The embedder is notified of the collection of this render target via a callback. More...

#include <embedder_render_target.h>

Inheritance diagram for flutter::EmbedderRenderTarget:

Public Member Functions
virtual	~EmbedderRenderTarget ()
	Destroys this instance of the render target and invokes the callback for the embedder to release its resource associated with the particular backing store.
virtual sk_sp< SkSurface >	GetSkiaSurface () const =0
	A render surface the rasterizer can use to draw into the backing store of this render target.
virtual impeller::RenderTarget *	GetImpellerRenderTarget () const =0
	An impeller render target the rasterizer can use to draw into the backing store.
virtual std::shared_ptr< impeller::AiksContext >	GetAiksContext () const =0
	Returns the AiksContext that should be used for rendering, if this render target is backed by Impeller.
virtual SkISize	GetRenderTargetSize () const =0
	Returns the size of the render target.
const FlutterBackingStore *	GetBackingStore () const
	The embedder backing store descriptor. This is the descriptor that was given to the engine by the embedder. This descriptor may contain context the embedder can use to associate it resources with the compositor layers when they are given back to it in present callback. The engine does not use this in any way.

Protected Member Functions
	EmbedderRenderTarget (FlutterBackingStore backing_store, fml::closure on_release)
	Creates a render target whose backing store is managed by the embedder. The way this render target is exposed to the engine is via an SkSurface and a callback that is invoked by this object in its destructor.

Detailed Description

Describes a surface whose backing store is managed by the embedder. The type of surface depends on the client rendering API used. The embedder is notified of the collection of this render target via a callback.

Definition at line 28 of file embedder_render_target.h.

Constructor & Destructor Documentation

~EmbedderRenderTarget()

flutter::EmbedderRenderTarget::~EmbedderRenderTarget ( )

virtual

Destroys this instance of the render target and invokes the callback for the embedder to release its resource associated with the particular backing store.

Definition at line 20 of file embedder_render_target.cc.

                                            {
  if (on_release_) {
    on_release_();
  }
}

EmbedderRenderTarget()

flutter::EmbedderRenderTarget::EmbedderRenderTarget ( FlutterBackingStore  backing_store, fml::closure  on_release  )

protected

Creates a render target whose backing store is managed by the embedder. The way this render target is exposed to the engine is via an SkSurface and a callback that is invoked by this object in its destructor.

Parameters

[in]	backing_store	The backing store describing this render target.
[in]	on_release	The callback to invoke (eventually forwarded to the embedder) when the backing store is no longer required by the engine.

Definition at line 12 of file embedder_render_target.cc.

    : backing_store_(backing_store), on_release_(std::move(on_release)) {
  // TODO(38468): The optimization to elide backing store updates between frames
  // has not been implemented yet.
  backing_store_.did_update = true;
}

Member Function Documentation

GetAiksContext()

virtual std::shared_ptr< impeller::AiksContext > flutter::EmbedderRenderTarget::GetAiksContext ( ) const

pure virtual

Returns the AiksContext that should be used for rendering, if this render target is backed by Impeller.

Returns

The Impeller Aiks context.

Implemented in flutter::EmbedderRenderTargetImpeller, and flutter::EmbedderRenderTargetSkia.

GetBackingStore()

const FlutterBackingStore * flutter::EmbedderRenderTarget::GetBackingStore

(

)

const

The embedder backing store descriptor. This is the descriptor that was given to the engine by the embedder. This descriptor may contain context the embedder can use to associate it resources with the compositor layers when they are given back to it in present callback. The engine does not use this in any way.

Returns

The backing store.

Definition at line 26 of file embedder_render_target.cc.

                                                                       {
  return &backing_store_;
}

GetImpellerRenderTarget()

virtual impeller::RenderTarget * flutter::EmbedderRenderTarget::GetImpellerRenderTarget ( ) const

pure virtual

An impeller render target the rasterizer can use to draw into the backing store.

Returns

The Impeller render target.

Implemented in flutter::EmbedderRenderTargetImpeller, and flutter::EmbedderRenderTargetSkia.

GetRenderTargetSize()

virtual SkISize flutter::EmbedderRenderTarget::GetRenderTargetSize ( ) const

pure virtual

Returns the size of the render target.

Returns

The size of the render target.

Implemented in flutter::EmbedderRenderTargetImpeller, and flutter::EmbedderRenderTargetSkia.

GetSkiaSurface()

virtual sk_sp< SkSurface > flutter::EmbedderRenderTarget::GetSkiaSurface ( ) const

pure virtual

A render surface the rasterizer can use to draw into the backing store of this render target.

Returns

The render surface.

Implemented in flutter::EmbedderRenderTargetImpeller, and flutter::EmbedderRenderTargetSkia.

---

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

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