carnelian/view/strategies/
base.rs

1// Copyright 2019 The Fuchsia Authors. All rights reserved.
2// Use of this source code is governed by a BSD-style license that can be
3// found in the LICENSE file.
4use crate::app::strategies::framebuffer::{CoordinatorProxyPtr, DisplayId};
5use crate::geometry::{IntSize, Size};
6use crate::view::{UserInputMessage, ViewAssistantPtr, ViewDetails};
7use crate::{ViewAssistantContext, ViewKey};
8use anyhow::Error;
9use async_trait::async_trait;
10
11#[async_trait(?Send)]
12pub(crate) trait ViewStrategy {
13    fn initial_metrics(&self) -> Size {
14        Size::zero()
15    }
16
17    fn initial_physical_size(&self) -> Size {
18        Size::zero()
19    }
20
21    fn initial_logical_size(&self) -> Size {
22        Size::zero()
23    }
24
25    fn create_view_assistant_context(&self, _view_details: &ViewDetails) -> ViewAssistantContext;
26
27    fn setup(&mut self, _view_details: &ViewDetails, _view_assistant: &mut ViewAssistantPtr);
28    async fn render(
29        &mut self,
30        view_details: &ViewDetails,
31        view_assistant: &mut ViewAssistantPtr,
32    ) -> bool;
33    fn present(&mut self, view_details: &ViewDetails);
34    fn present_done(
35        &mut self,
36        _view_details: &ViewDetails,
37        _view_assistant: &mut ViewAssistantPtr,
38        _info: fidl_fuchsia_scenic_scheduling::FramePresentedInfo,
39    ) {
40    }
41
42    fn convert_user_input_message(
43        &mut self,
44        view_details: &ViewDetails,
45        _: UserInputMessage,
46    ) -> Result<Vec<crate::input::Event>, Error>;
47
48    fn inspect_event(&mut self, _view_details: &ViewDetails, _event: &crate::input::Event) {}
49
50    fn handle_focus(
51        &mut self,
52        _view_details: &ViewDetails,
53        _view_assistant: &mut ViewAssistantPtr,
54        _: bool,
55    );
56
57    fn image_freed(&mut self, _image_id: u64, _collection_id: u32) {}
58
59    fn render_requested(&mut self) {}
60
61    fn ownership_changed(&mut self, _owned: bool) {}
62    fn drop_display_resources(&mut self) {}
63
64    fn handle_on_next_frame_begin(
65        &mut self,
66        _info: &fidl_fuchsia_ui_composition::OnNextFrameBeginValues,
67    ) {
68    }
69
70    async fn handle_display_coordinator_listener_request(
71        &mut self,
72        _event: fidl_fuchsia_hardware_display::CoordinatorListenerRequest,
73    ) {
74    }
75
76    fn is_hosted_on_display(&self, _display_id: DisplayId) -> bool {
77        false
78    }
79
80    fn close(&mut self) {}
81}
82
83pub(crate) type ViewStrategyPtr = Box<dyn ViewStrategy>;
84
85#[derive(Debug)]
86pub(crate) struct DisplayDirectParams {
87    pub view_key: Option<ViewKey>,
88    pub coordinator: CoordinatorProxyPtr,
89    pub info: fidl_fuchsia_hardware_display::Info,
90    pub preferred_size: IntSize,
91}
92
93#[derive(Debug)]
94pub(crate) struct FlatlandParams {
95    pub args: fidl_fuchsia_ui_app::CreateView2Args,
96    pub debug_name: Option<String>,
97}
98
99#[derive(Debug)]
100pub(crate) enum ViewStrategyParams {
101    Flatland(FlatlandParams),
102    DisplayDirect(DisplayDirectParams),
103}
104
105impl ViewStrategyParams {
106    pub fn view_key(&self) -> Option<ViewKey> {
107        match self {
108            ViewStrategyParams::DisplayDirect(params) => {
109                params.view_key.or(Some(ViewKey(params.info.id.value)))
110            }
111            _ => None,
112        }
113    }
114
115    pub fn display_id(&self) -> Option<DisplayId> {
116        match self {
117            ViewStrategyParams::DisplayDirect(params) => Some(params.info.id.into()),
118            _ => None,
119        }
120    }
121}
carnelian/view/strategies/base.rs

carnelian/view/strategies/
base.rs
