/* LICENSE BEGIN This file is part of the SixtyFPS Project -- https://sixtyfps.io Copyright (c) 2021 Olivier Goffart Copyright (c) 2021 Simon Hausmann SPDX-License-Identifier: GPL-3.0-only This file is also available under commercial licensing terms. Please contact info@sixtyfps.io for more information. LICENSE END */ //! Datastructures used to represent layouts in the compiler use crate::diagnostics::BuildDiagnostics; use crate::expression_tree::{Expression, NamedReference, Path}; use crate::langtype::{PropertyLookupResult, Type}; use crate::object_tree::ElementRc; use std::rc::Rc; #[derive(Clone, Debug, Copy, Eq, PartialEq)] pub enum Orientation { Horizontal, Vertical, } #[derive(Clone, Debug, derive_more::From)] pub enum Layout { GridLayout(GridLayout), PathLayout(PathLayout), BoxLayout(BoxLayout), } impl Layout { pub fn rect(&self) -> &LayoutRect { match self { Layout::GridLayout(g) => &g.geometry.rect, Layout::BoxLayout(g) => &g.geometry.rect, Layout::PathLayout(p) => &p.rect, } } pub fn rect_mut(&mut self) -> &mut LayoutRect { match self { Layout::GridLayout(g) => &mut g.geometry.rect, Layout::BoxLayout(g) => &mut g.geometry.rect, Layout::PathLayout(p) => &mut p.rect, } } pub fn geometry(&self) -> Option<&LayoutGeometry> { match self { Layout::GridLayout(l) => Some(&l.geometry), Layout::BoxLayout(l) => Some(&l.geometry), Layout::PathLayout(_) => None, } } } impl Layout { /// Call the visitor for each NamedReference stored in the layout pub fn visit_named_references(&mut self, visitor: &mut impl FnMut(&mut NamedReference)) { match self { Layout::GridLayout(grid) => grid.visit_named_references(visitor), Layout::BoxLayout(l) => l.visit_named_references(visitor), Layout::PathLayout(path) => path.visit_named_references(visitor), } } } /// An Item in the layout tree #[derive(Debug, Default, Clone)] pub struct LayoutItem { pub element: ElementRc, pub constraints: LayoutConstraints, } impl LayoutItem { pub fn rect(&self) -> LayoutRect { let p = |unresolved_name: &str| { let PropertyLookupResult { resolved_name, property_type } = self.element.borrow().lookup_property(unresolved_name); if property_type == Type::LogicalLength { Some(NamedReference::new(&self.element, resolved_name.as_ref())) } else { None } }; LayoutRect { x_reference: p("x"), y_reference: p("y"), width_reference: if !self.constraints.fixed_width { p("width") } else { None }, height_reference: if !self.constraints.fixed_height { p("height") } else { None }, } } } #[derive(Debug, Clone, Default)] pub struct LayoutRect { pub width_reference: Option, pub height_reference: Option, pub x_reference: Option, pub y_reference: Option, } impl LayoutRect { pub fn install_on_element(element: &ElementRc) -> Self { let install_prop = |name: &str| Some(NamedReference::new(element, name)); Self { x_reference: install_prop("x"), y_reference: install_prop("y"), width_reference: install_prop("width"), height_reference: install_prop("height"), } } fn visit_named_references(&mut self, mut visitor: &mut impl FnMut(&mut NamedReference)) { self.width_reference.as_mut().map(&mut visitor); self.height_reference.as_mut().map(&mut visitor); self.x_reference.as_mut().map(&mut visitor); self.y_reference.as_mut().map(&mut visitor); } pub fn size_reference(&self, orientation: Orientation) -> Option<&NamedReference> { match orientation { Orientation::Horizontal => self.width_reference.as_ref(), Orientation::Vertical => self.height_reference.as_ref(), } } } #[derive(Debug, Default, Clone)] pub struct LayoutConstraints { pub min_width: Option, pub max_width: Option, pub min_height: Option, pub max_height: Option, pub preferred_width: Option, pub preferred_height: Option, pub horizontal_stretch: Option, pub vertical_stretch: Option, pub fixed_width: bool, pub fixed_height: bool, } impl LayoutConstraints { pub fn new(element: &ElementRc, diag: &mut BuildDiagnostics) -> Self { let mut constraints = Self { min_width: binding_reference(element, "min_width"), max_width: binding_reference(element, "max_width"), min_height: binding_reference(element, "min_height"), max_height: binding_reference(element, "max_height"), preferred_width: binding_reference(element, "preferred_width"), preferred_height: binding_reference(element, "preferred_height"), horizontal_stretch: binding_reference(element, "horizontal_stretch"), vertical_stretch: binding_reference(element, "vertical_stretch"), fixed_width: false, fixed_height: false, }; let mut apply_size_constraint = |prop, binding, op: &mut Option| { if let Some(other_prop) = op { diag.push_error( format!("Cannot specify both '{}' and '{}'", prop, other_prop.name()), binding, ) } *op = Some(NamedReference::new(element, prop)) }; let e = element.borrow(); if let Some(s) = e.bindings.get("height") { constraints.fixed_height = true; apply_size_constraint("height", s, &mut constraints.min_height); apply_size_constraint("height", s, &mut constraints.max_height); } if let Some(s) = e.bindings.get("width") { if s.expression.ty() == Type::Percent { apply_size_constraint("width", s, &mut constraints.min_width); } else { constraints.fixed_width = true; apply_size_constraint("width", s, &mut constraints.min_width); apply_size_constraint("width", s, &mut constraints.max_width); } } constraints } pub fn has_explicit_restrictions(&self) -> bool { self.min_width.is_some() || self.max_width.is_some() || self.min_height.is_some() || self.max_width.is_some() || self.max_height.is_some() || self.preferred_height.is_some() || self.preferred_width.is_some() || self.horizontal_stretch.is_some() || self.vertical_stretch.is_some() } // Iterate over the constraint with a reference to a property, and the corresponding member in the sixtyfps_corelib::layout::LayoutInfo struct pub fn for_each_restrictions<'a>( &'a self, orientation: Orientation, ) -> impl Iterator { let (min, max, preferred, stretch) = match orientation { Orientation::Horizontal => { (&self.min_width, &self.max_width, &self.preferred_width, &self.horizontal_stretch) } Orientation::Vertical => { (&self.min_height, &self.max_height, &self.preferred_height, &self.vertical_stretch) } }; std::iter::empty() .chain(min.as_ref().map(|x| { if Expression::PropertyReference(x.clone()).ty() != Type::Percent { (x, "min") } else { (x, "min_percent") } })) .chain(max.as_ref().map(|x| { if Expression::PropertyReference(x.clone()).ty() != Type::Percent { (x, "max") } else { (x, "max_percent") } })) .chain(preferred.as_ref().map(|x| (x, "preferred"))) .chain(stretch.as_ref().map(|x| (x, "stretch"))) } pub fn visit_named_references(&mut self, visitor: &mut impl FnMut(&mut NamedReference)) { if let Some(e) = self.max_width.as_mut() { visitor(&mut *e); } if let Some(e) = self.min_width.as_mut() { visitor(&mut *e); } if let Some(e) = self.max_height.as_mut() { visitor(&mut *e); } if let Some(e) = self.min_height.as_mut() { visitor(&mut *e); } if let Some(e) = self.preferred_width.as_mut() { visitor(&mut *e); } if let Some(e) = self.preferred_height.as_mut() { visitor(&mut *e); } if let Some(e) = self.horizontal_stretch.as_mut() { visitor(&mut *e); } if let Some(e) = self.vertical_stretch.as_mut() { visitor(&mut *e); } } } /// An element in a GridLayout #[derive(Debug, Clone)] pub struct GridLayoutElement { pub col: u16, pub row: u16, pub colspan: u16, pub rowspan: u16, pub item: LayoutItem, } impl GridLayoutElement { pub fn col_or_row_and_span(&self, orientation: Orientation) -> (u16, u16) { match orientation { Orientation::Horizontal => (self.col, self.colspan), Orientation::Vertical => (self.row, self.rowspan), } } } #[derive(Debug, Clone)] pub struct Padding { pub left: Option, pub right: Option, pub top: Option, pub bottom: Option, } impl Padding { fn visit_named_references(&mut self, visitor: &mut impl FnMut(&mut NamedReference)) { self.left.as_mut().map(|e| visitor(&mut *e)); self.right.as_mut().map(|e| visitor(&mut *e)); self.top.as_mut().map(|e| visitor(&mut *e)); self.bottom.as_mut().map(|e| visitor(&mut *e)); } // Return reference to the begin and end padding for a given orientation pub fn begin_end(&self, o: Orientation) -> (Option<&NamedReference>, Option<&NamedReference>) { match o { Orientation::Horizontal => (self.left.as_ref(), self.right.as_ref()), Orientation::Vertical => (self.top.as_ref(), self.bottom.as_ref()), } } } #[derive(Debug, Clone)] pub struct LayoutGeometry { pub rect: LayoutRect, pub spacing: Option, pub alignment: Option, pub padding: Padding, } impl LayoutGeometry { pub fn visit_named_references(&mut self, visitor: &mut impl FnMut(&mut NamedReference)) { self.rect.visit_named_references(visitor); self.spacing.as_mut().map(|e| visitor(&mut *e)); self.alignment.as_mut().map(|e| visitor(&mut *e)); self.padding.visit_named_references(visitor); } } /// Return a named reference to a property if a binding is set on that property fn binding_reference(element: &ElementRc, name: &str) -> Option { element.borrow().bindings.contains_key(name).then(|| NamedReference::new(element, name)) } fn init_fake_property( grid_layout_element: &ElementRc, name: &str, lazy_default: impl Fn() -> Option, ) { if grid_layout_element.borrow().property_declarations.contains_key(name) && !grid_layout_element.borrow().bindings.contains_key(name) { if let Some(e) = lazy_default() { if e.name() == name && Rc::ptr_eq(&e.element(), grid_layout_element) { // Don't reference self return; } grid_layout_element .borrow_mut() .bindings .insert(name.to_owned(), Expression::PropertyReference(e).into()); } } } impl LayoutGeometry { pub fn new(layout_element: &ElementRc) -> Self { let spacing = binding_reference(layout_element, "spacing"); let alignment = binding_reference(layout_element, "alignment"); let padding = || binding_reference(layout_element, "padding"); init_fake_property(layout_element, "padding_left", padding); init_fake_property(layout_element, "padding_right", padding); init_fake_property(layout_element, "padding_top", padding); init_fake_property(layout_element, "padding_bottom", padding); let padding = Padding { left: binding_reference(layout_element, "padding_left").or_else(padding), right: binding_reference(layout_element, "padding_right").or_else(padding), top: binding_reference(layout_element, "padding_top").or_else(padding), bottom: binding_reference(layout_element, "padding_bottom").or_else(padding), }; let rect = LayoutRect::install_on_element(layout_element); Self { rect, spacing, padding, alignment } } } /// Internal representation of a grid layout #[derive(Debug, Clone)] pub struct GridLayout { /// All the elements will be layout within that element. pub elems: Vec, pub geometry: LayoutGeometry, } impl GridLayout { fn visit_named_references(&mut self, visitor: &mut impl FnMut(&mut NamedReference)) { for cell in &mut self.elems { cell.item.constraints.visit_named_references(visitor); } self.geometry.visit_named_references(visitor); } } /// Internal representation of a BoxLayout #[derive(Debug, Clone)] pub struct BoxLayout { /// Whether, this is a HorizontalLayout, otherwise a VerticalLayout pub orientation: Orientation, pub elems: Vec, pub geometry: LayoutGeometry, } impl BoxLayout { fn visit_named_references(&mut self, visitor: &mut impl FnMut(&mut NamedReference)) { for cell in &mut self.elems { cell.constraints.visit_named_references(visitor); } self.geometry.visit_named_references(visitor); } } /// Internal representation of a path layout #[derive(Debug, Clone)] pub struct PathLayout { pub path: Path, pub elements: Vec, pub rect: LayoutRect, pub offset_reference: Option, } impl PathLayout { fn visit_named_references(&mut self, visitor: &mut impl FnMut(&mut NamedReference)) { self.rect.visit_named_references(visitor); self.offset_reference.as_mut().map(visitor); } } /// The [`Type`] for a runtime LayoutInfo structure pub fn layout_info_type() -> Type { Type::Struct { fields: ["min", "max", "preferred"] .iter() .map(|s| (s.to_string(), Type::LogicalLength)) .chain( ["min_percent", "max_percent", "stretch"] .iter() .map(|s| (s.to_string(), Type::Float32)), ) .collect(), name: Some("LayoutInfo".into()), node: None, } }