flutter::EmbedderExternalView Class Reference

#include <embedder_external_view.h>

Classes
struct	RenderTargetDescriptor
struct	ViewIdentifier

Public Types
using	PlatformViewID = int64_t
using	ViewIdentifierSet = std::unordered_set< ViewIdentifier, ViewIdentifier::Hash, ViewIdentifier::Equal >
using	PendingViews = std::unordered_map< ViewIdentifier, std::unique_ptr< EmbedderExternalView >, ViewIdentifier::Hash, ViewIdentifier::Equal >

Public Member Functions
	EmbedderExternalView (const SkISize &frame_size, const SkMatrix &surface_transformation)
	EmbedderExternalView (const SkISize &frame_size, const SkMatrix &surface_transformation, ViewIdentifier view_identifier, std::unique_ptr< EmbeddedViewParams > params)
	~EmbedderExternalView ()
bool	IsRootView () const
bool	HasPlatformView () const
bool	HasEngineRenderedContents ()
ViewIdentifier	GetViewIdentifier () const
const EmbeddedViewParams *	GetEmbeddedViewParams () const
RenderTargetDescriptor	CreateRenderTargetDescriptor () const
DlCanvas *	GetCanvas ()
SkISize	GetRenderSurfaceSize () const
bool	Render (const EmbedderRenderTarget &render_target, bool clear_surface=true)
const DlRegion &	GetDlRegion () const

Detailed Description

Definition at line 19 of file embedder_external_view.h.

Member Typedef Documentation

PendingViews

using flutter::EmbedderExternalView::PendingViews = std::unordered_map<ViewIdentifier, std::unique_ptr<EmbedderExternalView>, ViewIdentifier::Hash, ViewIdentifier::Equal>

Definition at line 74 of file embedder_external_view.h.

PlatformViewID

using flutter::EmbedderExternalView::PlatformViewID = int64_t

Definition at line 21 of file embedder_external_view.h.

ViewIdentifierSet

using flutter::EmbedderExternalView::ViewIdentifierSet = std::unordered_set<ViewIdentifier, ViewIdentifier::Hash, ViewIdentifier::Equal>

Definition at line 70 of file embedder_external_view.h.

Constructor & Destructor Documentation

EmbedderExternalView() [1/2]

flutter::EmbedderExternalView::EmbedderExternalView	(	const SkISize &	frame_size,
		const SkMatrix &	surface_transformation
	)

Definition at line 25 of file embedder_external_view.cc.

    : EmbedderExternalView(frame_size, surface_transformation, {}, nullptr) {}

EmbedderExternalView() [2/2]

flutter::EmbedderExternalView::EmbedderExternalView	(	const SkISize &	frame_size,
		const SkMatrix &	surface_transformation,
		ViewIdentifier	view_identifier,
		std::unique_ptr< EmbeddedViewParams >	params
	)

Definition at line 30 of file embedder_external_view.cc.

    : render_surface_size_(
          TransformedSurfaceSize(frame_size, surface_transformation)),
      surface_transformation_(surface_transformation),
      view_identifier_(view_identifier),
      embedded_view_params_(std::move(params)),
      slice_(std::make_unique<DisplayListEmbedderViewSlice>(
          SkRect::Make(frame_size))) {}

~EmbedderExternalView()

flutter::EmbedderExternalView::~EmbedderExternalView ( )

default

Member Function Documentation

CreateRenderTargetDescriptor()

EmbedderExternalView::RenderTargetDescriptor flutter::EmbedderExternalView::CreateRenderTargetDescriptor

(

)

const

Definition at line 46 of file embedder_external_view.cc.

                                                         {
  return RenderTargetDescriptor(render_surface_size_);
}

GetCanvas()

DlCanvas * flutter::EmbedderExternalView::GetCanvas

(

)

Definition at line 50 of file embedder_external_view.cc.

                                          {
  return slice_->canvas();
}

GetDlRegion()

const DlRegion & flutter::EmbedderExternalView::GetDlRegion

(

)

const

Definition at line 66 of file embedder_external_view.cc.

                                                        {
  return slice_->getRegion();
}

GetEmbeddedViewParams()

const EmbeddedViewParams * flutter::EmbedderExternalView::GetEmbeddedViewParams

(

)

const

Definition at line 87 of file embedder_external_view.cc.

                                                                            {
  return embedded_view_params_.get();
}

GetRenderSurfaceSize()

SkISize flutter::EmbedderExternalView::GetRenderSurfaceSize

(

)

const

Definition at line 54 of file embedder_external_view.cc.

                                                         {
  return render_surface_size_;
}

GetViewIdentifier()

EmbedderExternalView::ViewIdentifier flutter::EmbedderExternalView::GetViewIdentifier

(

)

const

Definition at line 82 of file embedder_external_view.cc.

          {
  return view_identifier_;
}

HasEngineRenderedContents()

bool flutter::EmbedderExternalView::HasEngineRenderedContents

(

)

Definition at line 70 of file embedder_external_view.cc.

                                                     {
  if (has_engine_rendered_contents_.has_value()) {
    return has_engine_rendered_contents_.value();
  }
  TryEndRecording();
  DlOpSpy dl_op_spy;
  slice_->dispatch(dl_op_spy);
  has_engine_rendered_contents_ = dl_op_spy.did_draw() && !slice_->is_empty();
  // NOLINTNEXTLINE(bugprone-unchecked-optional-access)
  return has_engine_rendered_contents_.value();
}

HasPlatformView()

bool flutter::EmbedderExternalView::HasPlatformView

(

)

const

Definition at line 62 of file embedder_external_view.cc.

                                                 {
  return view_identifier_.platform_view_id.has_value();
}

IsRootView()

bool flutter::EmbedderExternalView::IsRootView

(

)

const

Definition at line 58 of file embedder_external_view.cc.

                                            {
  return !HasPlatformView();
}

Render()

bool flutter::EmbedderExternalView::Render	(	const EmbedderRenderTarget &	render_target,
		bool	clear_surface = true
	)

Definition at line 91 of file embedder_external_view.cc.

                                                      {
  TRACE_EVENT0("flutter", "EmbedderExternalView::Render");
  TryEndRecording();
  FML_DCHECK(HasEngineRenderedContents())
      << "Unnecessarily asked to render into a render target when there was "
         "nothing to render.";
 
#ifdef IMPELLER_SUPPORTS_RENDERING
  auto* impeller_target = render_target.GetImpellerRenderTarget();
  if (impeller_target) {
    auto aiks_context = render_target.GetAiksContext();
 
    auto dl_builder = DisplayListBuilder();
    dl_builder.SetTransform(&surface_transformation_);
    slice_->render_into(&dl_builder);
    auto display_list = dl_builder.Build();
 
#if ENABLE_EXPERIMENTAL_CANVAS
    auto cull_rect =
        impeller::IRect::MakeSize(impeller_target->GetRenderTargetSize());
    SkIRect sk_cull_rect =
        SkIRect::MakeWH(cull_rect.GetWidth(), cull_rect.GetHeight());
 
    impeller::TextFrameDispatcher collector(aiks_context->GetContentContext(),
                                            impeller::Matrix());
    display_list->Dispatch(collector, sk_cull_rect);
 
    impeller::ExperimentalDlDispatcher impeller_dispatcher(
        aiks_context->GetContentContext(), *impeller_target, cull_rect);
    display_list->Dispatch(impeller_dispatcher, sk_cull_rect);
    impeller_dispatcher.FinishRecording();
    aiks_context->GetContentContext().GetTransientsBuffer().Reset();
    aiks_context->GetContentContext().GetLazyGlyphAtlas()->ResetTextFrames();
 
    return true;
#else
    auto dispatcher = impeller::DlDispatcher();
    dispatcher.drawDisplayList(display_list, 1);
    return aiks_context->Render(dispatcher.EndRecordingAsPicture(),
                                *impeller_target, /*reset_host_buffer=*/true);
#endif
  }
#endif  // IMPELLER_SUPPORTS_RENDERING
 
  auto skia_surface = render_target.GetSkiaSurface();
  if (!skia_surface) {
    return false;
  }
 
  FML_DCHECK(render_target.GetRenderTargetSize() == render_surface_size_);
 
  auto canvas = skia_surface->getCanvas();
  if (!canvas) {
    return false;
  }
  DlSkCanvasAdapter dl_canvas(canvas);
  int restore_count = dl_canvas.GetSaveCount();
  dl_canvas.SetTransform(surface_transformation_);
  if (clear_surface) {
    dl_canvas.Clear(DlColor::kTransparent());
  }
  slice_->render_into(&dl_canvas);
  dl_canvas.RestoreToCount(restore_count);
  dl_canvas.Flush();
 
  return true;
}

---

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

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