flutter_runner::FlatlandConnection Class Reference

#include <flatland_connection.h>

Public Member Functions
	FlatlandConnection (std::string debug_label, fuchsia::ui::composition::FlatlandHandle flatland, fml::closure error_callback, on_frame_presented_event on_frame_presented_callback)
	~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 34 of file flatland_connection.h.

Constructor & Destructor Documentation

FlatlandConnection()

flutter_runner::FlatlandConnection::FlatlandConnection	(	std::string	debug_label,
		fuchsia::ui::composition::FlatlandHandle	flatland,
		fml::closure	error_callback,
		on_frame_presented_event	on_frame_presented_callback
	)

Definition at line 24 of file flatland_connection.cc.

    : flatland_(flatland.Bind()),
      error_callback_(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);
}

~FlatlandConnection()

flutter_runner::FlatlandConnection::~FlatlandConnection ( )

default

Member Function Documentation

AwaitVsync()

void flutter_runner::FlatlandConnection::AwaitVsync

(

FireCallbackCallback

callback

)

Definition at line 88 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_ = callback;
    return;
  }
 
  // Regular case.
  RunVsyncCallback(now, callback);
}

AwaitVsyncForSecondaryCallback()

void flutter_runner::FlatlandConnection::AwaitVsyncForSecondaryCallback

(

FireCallbackCallback

callback

)

Definition at line 110 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);
}

EnqueueAcquireFence()

void flutter_runner::FlatlandConnection::EnqueueAcquireFence

(

zx::event

fence

)

Definition at line 264 of file flatland_connection.cc.

                                                          {
  acquire_fences_.push_back(std::move(fence));
}

EnqueueReleaseFence()

void flutter_runner::FlatlandConnection::EnqueueReleaseFence

(

zx::event

fence

)

Definition at line 269 of file flatland_connection.cc.

                                                          {
  current_present_release_fences_.push_back(std::move(fence));
}

flatland()

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

inline

Definition at line 51 of file flatland_connection.h.

{ return flatland_.get(); }

NextContentId()

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

inline

Definition at line 57 of file flatland_connection.h.

                                                {
    return {++next_content_id_};
  }

NextTransformId()

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

inline

Definition at line 53 of file flatland_connection.h.

                                                    {
    return {++next_transform_id_};
  }

Present()

void flutter_runner::FlatlandConnection::Present

(

)

Definition at line 49 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

first_feedback_received_

bool flutter_runner::FlatlandConnection::first_feedback_received_ = false

Definition at line 102 of file flatland_connection.h.

last_presentation_time_

fml::TimePoint flutter_runner::FlatlandConnection::last_presentation_time_

Definition at line 99 of file flatland_connection.h.

mutex_

std::mutex flutter_runner::FlatlandConnection::mutex_

Definition at line 95 of file flatland_connection.h.

next_presentation_times_

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

Definition at line 96 of file flatland_connection.h.

pending_fire_callback_

FireCallbackCallback flutter_runner::FlatlandConnection::pending_fire_callback_

Definition at line 100 of file flatland_connection.h.

present_credits_

uint32_t flutter_runner::FlatlandConnection::present_credits_ = 1

Definition at line 101 of file flatland_connection.h.

vsync_interval_

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

Definition at line 97 of file flatland_connection.h.

vsync_offset_

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

Definition at line 98 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