mirror of
https://github.com/flutter/flutter.git
synced 2026-02-20 02:29:02 +08:00
927fd200ed
This reverts commit 87171e73397f7edfd4c145fbaebdd7208954debf. Internal performance test shows that this PR negatively affects startup time. I'll reland this PR in parts. b/307872797 [C++, Objective-C, Java style guides]: https://github.com/flutter/engine/blob/main/CONTRIBUTING.md#style
130 lines
4.5 KiB
C++
130 lines
4.5 KiB
C++
// Copyright 2013 The Flutter Authors. All rights reserved.
|
|
// Use of this source code is governed by a BSD-style license that can be
|
|
// found in the LICENSE file.
|
|
|
|
#ifndef FLUTTER_SHELL_COMMON_ANIMATOR_H_
|
|
#define FLUTTER_SHELL_COMMON_ANIMATOR_H_
|
|
|
|
#include <deque>
|
|
|
|
#include "flutter/common/task_runners.h"
|
|
#include "flutter/flow/frame_timings.h"
|
|
#include "flutter/fml/memory/ref_ptr.h"
|
|
#include "flutter/fml/memory/weak_ptr.h"
|
|
#include "flutter/fml/synchronization/semaphore.h"
|
|
#include "flutter/fml/time/time_point.h"
|
|
#include "flutter/shell/common/pipeline.h"
|
|
#include "flutter/shell/common/rasterizer.h"
|
|
#include "flutter/shell/common/vsync_waiter.h"
|
|
|
|
namespace flutter {
|
|
|
|
namespace testing {
|
|
class ShellTest;
|
|
}
|
|
|
|
/// Executor of animations.
|
|
///
|
|
/// In conjunction with the |VsyncWaiter| it allows callers (typically Dart
|
|
/// code) to schedule work that ends up generating a |LayerTree|.
|
|
class Animator final {
|
|
public:
|
|
class Delegate {
|
|
public:
|
|
virtual void OnAnimatorBeginFrame(fml::TimePoint frame_target_time,
|
|
uint64_t frame_number) = 0;
|
|
|
|
virtual void OnAnimatorNotifyIdle(fml::TimeDelta deadline) = 0;
|
|
|
|
virtual void OnAnimatorUpdateLatestFrameTargetTime(
|
|
fml::TimePoint frame_target_time) = 0;
|
|
|
|
virtual void OnAnimatorDraw(std::shared_ptr<FramePipeline> pipeline) = 0;
|
|
|
|
virtual void OnAnimatorDrawLastLayerTrees(
|
|
std::unique_ptr<FrameTimingsRecorder> frame_timings_recorder) = 0;
|
|
};
|
|
|
|
Animator(Delegate& delegate,
|
|
const TaskRunners& task_runners,
|
|
std::unique_ptr<VsyncWaiter> waiter);
|
|
|
|
~Animator();
|
|
|
|
void RequestFrame(bool regenerate_layer_trees = true);
|
|
|
|
//--------------------------------------------------------------------------
|
|
/// @brief Tells the Animator that this frame needs to render another view.
|
|
///
|
|
/// This method must be called during a vsync callback, or
|
|
/// technically, between Animator::BeginFrame and Animator::EndFrame
|
|
/// (both private methods). Otherwise, an assertion will be
|
|
/// triggered.
|
|
///
|
|
void Render(std::unique_ptr<flutter::LayerTree> layer_tree,
|
|
float device_pixel_ratio);
|
|
|
|
const std::weak_ptr<VsyncWaiter> GetVsyncWaiter() const;
|
|
|
|
//--------------------------------------------------------------------------
|
|
/// @brief Schedule a secondary callback to be executed right after the
|
|
/// main `VsyncWaiter::AsyncWaitForVsync` callback (which is added
|
|
/// by `Animator::RequestFrame`).
|
|
///
|
|
/// Like the callback in `AsyncWaitForVsync`, this callback is
|
|
/// only scheduled to be called once, and it's supposed to be
|
|
/// called in the UI thread. If there is no AsyncWaitForVsync
|
|
/// callback (`Animator::RequestFrame` is not called), this
|
|
/// secondary callback will still be executed at vsync.
|
|
///
|
|
/// This callback is used to provide the vsync signal needed by
|
|
/// `SmoothPointerDataDispatcher`, and for our own flow events.
|
|
///
|
|
/// @see `PointerDataDispatcher::ScheduleSecondaryVsyncCallback`.
|
|
void ScheduleSecondaryVsyncCallback(uintptr_t id,
|
|
const fml::closure& callback);
|
|
|
|
// Enqueue |trace_flow_id| into |trace_flow_ids_|. The flow event will be
|
|
// ended at either the next frame, or the next vsync interval with no active
|
|
// rendering.
|
|
void EnqueueTraceFlowId(uint64_t trace_flow_id);
|
|
|
|
private:
|
|
void BeginFrame(std::unique_ptr<FrameTimingsRecorder> frame_timings_recorder);
|
|
|
|
bool CanReuseLastLayerTrees();
|
|
|
|
void DrawLastLayerTrees(
|
|
std::unique_ptr<FrameTimingsRecorder> frame_timings_recorder);
|
|
|
|
void AwaitVSync();
|
|
|
|
// Clear |trace_flow_ids_| if |frame_scheduled_| is false.
|
|
void ScheduleMaybeClearTraceFlowIds();
|
|
|
|
Delegate& delegate_;
|
|
TaskRunners task_runners_;
|
|
std::shared_ptr<VsyncWaiter> waiter_;
|
|
|
|
std::unique_ptr<FrameTimingsRecorder> frame_timings_recorder_;
|
|
uint64_t frame_request_number_ = 1;
|
|
fml::TimeDelta dart_frame_deadline_;
|
|
std::shared_ptr<FramePipeline> layer_tree_pipeline_;
|
|
fml::Semaphore pending_frame_semaphore_;
|
|
FramePipeline::ProducerContinuation producer_continuation_;
|
|
bool regenerate_layer_trees_ = false;
|
|
bool frame_scheduled_ = false;
|
|
std::deque<uint64_t> trace_flow_ids_;
|
|
bool has_rendered_ = false;
|
|
|
|
fml::WeakPtrFactory<Animator> weak_factory_;
|
|
|
|
friend class testing::ShellTest;
|
|
|
|
FML_DISALLOW_COPY_AND_ASSIGN(Animator);
|
|
};
|
|
|
|
} // namespace flutter
|
|
|
|
#endif // FLUTTER_SHELL_COMMON_ANIMATOR_H_
|