mirror of
https://github.com/flutter/flutter.git
synced 2026-02-20 02:29:02 +08:00
67fdd7eded
Embedders can now notify shell during startup about the various displays and their corresponding settings. Adds a notion of Display update type which can later include chages to displays during runtime such as addition / removal / reconfiguration of displays. We also remove the responsibility of providing the refresh rate from `vsync_waiter` to `DisplayManager`. Rewires existing platform implementations of the said API to use `Shell::OnDisplayUpdate` to notify the display manager of the startup configuration. DisplayManager is also thread-safe to account for rasterizer and UI thread accesses.
60 lines
1.9 KiB
C++
60 lines
1.9 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_DISPLAY_MANAGER_H_
|
|
#define FLUTTER_SHELL_COMMON_DISPLAY_MANAGER_H_
|
|
|
|
#include <mutex>
|
|
#include <vector>
|
|
|
|
#include "flutter/shell/common/display.h"
|
|
|
|
namespace flutter {
|
|
|
|
/// The update type parameter that is passed to
|
|
/// `DisplayManager::HandleDisplayUpdates`.
|
|
enum class DisplayUpdateType {
|
|
/// `flutter::Display`s that were active during start-up. A display is
|
|
/// considered active if:
|
|
/// 1. The frame buffer hardware is connected.
|
|
/// 2. The display is drawable, e.g. it isn't being mirrored from another
|
|
/// connected display or sleeping.
|
|
kStartup
|
|
};
|
|
|
|
/// Manages lifecycle of the connected displays. This class is thread-safe.
|
|
class DisplayManager {
|
|
public:
|
|
DisplayManager();
|
|
|
|
~DisplayManager();
|
|
|
|
/// Returns the display refresh rate of the main display. In cases where there
|
|
/// is only one display connected, it will return that. We do not yet support
|
|
/// cases where there are multiple displays.
|
|
///
|
|
/// When there are no registered displays, it returns
|
|
/// `kUnknownDisplayRefreshRate`.
|
|
double GetMainDisplayRefreshRate() const;
|
|
|
|
/// Handles the display updates.
|
|
void HandleDisplayUpdates(DisplayUpdateType update_type,
|
|
std::vector<Display> displays);
|
|
|
|
private:
|
|
/// Guards `displays_` vector.
|
|
mutable std::mutex displays_mutex_;
|
|
std::vector<Display> displays_;
|
|
|
|
/// Checks that the provided display configuration is valid. Currently this
|
|
/// ensures that all the displays have an id in the case there are multiple
|
|
/// displays. In case where there is a single display, it is valid for the
|
|
/// display to not have an id.
|
|
void CheckDisplayConfiguration(std::vector<Display> displays) const;
|
|
};
|
|
|
|
} // namespace flutter
|
|
|
|
#endif // FLUTTER_SHELL_COMMON_DISPLAY_MANAGER_H_
|