flutter_runner::FlatlandConnection Class Reference

#include <flatland_connection.h>

Public Member Functions
	FlatlandConnection (const std::string &debug_label, fuchsia::ui::composition::FlatlandHandle flatland, fml::closure error_callback, on_frame_presented_event on_frame_presented_callback, async_dispatcher_t *dispatcher=async_get_default_dispatcher())
	~FlatlandConnection ()
void	Present ()
void	AwaitVsync (FireCallbackCallback callback)
void	AwaitVsyncForSecondaryCallback (FireCallbackCallback callback)
fuchsia::ui::composition::Flatland *	flatland ()
fuchsia::ui::composition::TransformId	NextTransformId ()
fuchsia::ui::composition::ContentId	NextContentId ()
void	EnqueueAcquireFence (zx::event fence)
void	EnqueueReleaseFence (zx::event fence)

Detailed Description

Definition at line 51 of file flatland_connection.h.

Constructor & Destructor Documentation

FlatlandConnection()

flutter_runner::FlatlandConnection::FlatlandConnection	(	const std::string &	debug_label,
		fuchsia::ui::composition::FlatlandHandle	flatland,
		fml::closure	error_callback,
		on_frame_presented_event	on_frame_presented_callback,
		async_dispatcher_t *	dispatcher = async_get_default_dispatcher()
	)

Definition at line 30 of file flatland_connection.cc.

    : dispatcher_(dispatcher),
      flatland_(flatland.Bind()),
      error_callback_(std::move(error_callback)),
      on_frame_presented_callback_(std::move(on_frame_presented_callback)) {
  flatland_.set_error_handler([callback = error_callback_](zx_status_t status) {
    FML_LOG(ERROR) << "Flatland disconnected: " << zx_status_get_string(status);
    callback();
  });
  debug_label_ = debug_label;
  flatland_->SetDebugName(debug_label);
  flatland_.events().OnError =
      fit::bind_member(this, &FlatlandConnection::OnError);
  flatland_.events().OnFramePresented =
      fit::bind_member(this, &FlatlandConnection::OnFramePresented);
  flatland_.events().OnNextFrameBegin =
      fit::bind_member(this, &FlatlandConnection::OnNextFrameBegin);
}

References callback, and FML_LOG.

~FlatlandConnection()

flutter_runner::FlatlandConnection::~FlatlandConnection ( )

default

Member Function Documentation

AwaitVsync()

void flutter_runner::FlatlandConnection::AwaitVsync

(

FireCallbackCallback

callback

)

Definition at line 170 of file flatland_connection.cc.

                                                                 {
  TRACE_DURATION("flutter", "FlatlandConnection::AwaitVsync");
 
  std::scoped_lock<std::mutex> lock(threadsafe_state_.mutex_);
  threadsafe_state_.pending_fire_callback_ = nullptr;
  const auto now = fml::TimePoint::Now();
 
  // Initial case.
  if (MaybeRunInitialVsyncCallback(now, callback)) {
    return;
  }
 
  // Throttle case.
  if (threadsafe_state_.present_credits_ == 0) {
    threadsafe_state_.pending_fire_callback_ = std::move(callback);
    return;
  }
 
  // Regular case.
  RunVsyncCallback(now, callback);
}

References callback, and fml::TimePoint::Now().

AwaitVsyncForSecondaryCallback()

void flutter_runner::FlatlandConnection::AwaitVsyncForSecondaryCallback

(

FireCallbackCallback

callback

)

Definition at line 193 of file flatland_connection.cc.

                                   {
  TRACE_DURATION("flutter",
                 "FlatlandConnection::AwaitVsyncForSecondaryCallback");
 
  std::scoped_lock<std::mutex> lock(threadsafe_state_.mutex_);
  const auto now = fml::TimePoint::Now();
 
  // Initial case.
  if (MaybeRunInitialVsyncCallback(now, callback)) {
    return;
  }
 
  // Regular case.
  RunVsyncCallback(now, callback);
}

References callback, and fml::TimePoint::Now().

EnqueueAcquireFence()

void flutter_runner::FlatlandConnection::EnqueueAcquireFence

(

zx::event

fence

)

Definition at line 408 of file flatland_connection.cc.

                                                          {
  Enqueue(std::move(fence), &acquire_fences_, &acquire_overflow_);
}

References flutter_runner::Enqueue().

EnqueueReleaseFence()

void flutter_runner::FlatlandConnection::EnqueueReleaseFence

(

zx::event

fence

)

Definition at line 413 of file flatland_connection.cc.

                                                          {
  Enqueue(std::move(fence), &current_present_release_fences_,
          &current_release_overflow_);
}

References flutter_runner::Enqueue().

flatland()

fuchsia::ui::composition::Flatland * flutter_runner::FlatlandConnection::flatland ( )

inline

Definition at line 70 of file flatland_connection.h.

{ return flatland_.get(); }

NextContentId()

fuchsia::ui::composition::ContentId flutter_runner::FlatlandConnection::NextContentId ( )

inline

Definition at line 76 of file flatland_connection.h.

                                                {
    return {++next_content_id_};
  }

NextTransformId()

fuchsia::ui::composition::TransformId flutter_runner::FlatlandConnection::NextTransformId ( )

inline

Definition at line 72 of file flatland_connection.h.

                                                    {
    return {++next_transform_id_};
  }

Present()

void flutter_runner::FlatlandConnection::Present

(

)

Definition at line 57 of file flatland_connection.cc.

                                 {
  TRACE_DURATION("flutter", "FlatlandConnection::Present");
  std::scoped_lock<std::mutex> lock(threadsafe_state_.mutex_);
  if (threadsafe_state_.present_credits_ > 0) {
    DoPresent();
  } else {
    present_waiting_for_credit_ = true;
  }
}

Member Data Documentation

initial_vsync_callback_ran_

bool flutter_runner::FlatlandConnection::initial_vsync_callback_ran_ = false

Definition at line 140 of file flatland_connection.h.

last_presentation_time_

fml::TimePoint flutter_runner::FlatlandConnection::last_presentation_time_

Definition at line 137 of file flatland_connection.h.

mutex_

std::mutex flutter_runner::FlatlandConnection::mutex_

Definition at line 133 of file flatland_connection.h.

next_presentation_times_

std::queue<fml::TimePoint> flutter_runner::FlatlandConnection::next_presentation_times_

Definition at line 134 of file flatland_connection.h.

pending_fire_callback_

FireCallbackCallback flutter_runner::FlatlandConnection::pending_fire_callback_

Definition at line 138 of file flatland_connection.h.

present_credits_

uint32_t flutter_runner::FlatlandConnection::present_credits_ = 1

Definition at line 139 of file flatland_connection.h.

vsync_interval_

fml::TimeDelta flutter_runner::FlatlandConnection::vsync_interval_ = kInitialFlatlandVsyncOffset

Definition at line 135 of file flatland_connection.h.

vsync_offset_

fml::TimeDelta flutter_runner::FlatlandConnection::vsync_offset_ = kInitialFlatlandVsyncOffset

Definition at line 136 of file flatland_connection.h.

---

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

• shell/platform/fuchsia/flutter/flatland_connection.h
• shell/platform/fuchsia/flutter/flatland_connection.cc