1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137
//! enums for main axis and cross axis alignment.
use std::str::FromStr;
#[cfg(feature = "reflect")]
use bevy::prelude::Reflect;
use crate::Oriented;
/// The cross axis alignment. Aka alignment.
///
/// Note that you can use any alignments with any kind of constraint.
///
/// ```text
/// Direction::Vertical
///
/// Start | Center | End |
/// ▕██ ⁞ ▏ | ▕ ██ ▏ | ▕ ⁞ ██▏ |
/// ▕███████ ▏ | ▕ ███████ ▏ | ▕ ███████▏ |
/// ▕ ⁞ ▏ | ▕ ⁞ ▏ | ▕ ⁞ ▏ |
/// ▕███ ⁞ ▏ | ▕ ███ ▏ | ▕ ⁞ ███▏ |
/// ▕█ ⁞ ▏ | ▕ █ ▏ | ▕ ⁞ █▏ |
/// ▕███ ⁞ ▏ | ▕ ███ ▏ | ▕ ⁞ ███▏ |
/// ▕ ⁞ ▏ | ▕ ⁞ ▏ | ▕ ⁞ ▏ |
/// ▕█ ⁞ ▏ | ▕ █ ▏ | ▕ ⁞ █▏ |
/// ```
///
/// ```text
/// Direction::Horizontal
///
/// | Start | Center | End |
/// |▁▁▁▁▁▁▁▁▁▁▁|▁▁▁▁▁▁▁▁▁▁▁|▁▁▁▁▁▁▁▁▁▁▁|
/// |██ ███ █ ██| | |
/// |██ █ █ ██| █ | |
/// | █ ███ ██|██ ███ ██| █ |
/// |⋯█⋯⋯⋯⋯⋯⋯⋯⋯⋯|██⋯█⋯█⋯█⋯██|⋯█⋯⋯⋯⋯⋯⋯⋯⋯⋯|
/// | █ | █ ███ ██| █ ███ ██|
/// | | █ |██ █ █ ██|
/// | | |██ ███ █ ██|
/// |▔▔▔▔▔▔▔▔▔▔▔|▔▔▔▔▔▔▔▔▔▔▔|▔▔▔▔▔▔▔▔▔▔▔|
/// ```
#[derive(Clone, Copy, PartialEq, Eq, Debug, Default)]
#[cfg_attr(feature = "reflect", derive(Reflect))]
pub enum Alignment {
/// The items within the container are all aligned to the top or left.
///
/// If the container's axis is `Direction::Vertical`, a start alignment
/// will align all items to the left.
#[default]
Start,
/// The items within the container are all centered on the container's axis.
Center,
/// The items within the container are all aligned to the bottom or right.
///
/// If the container's axis is `Direction::Vertical`, an end alignment
/// will align all items to the right.
End,
}
/// The main axis alignment. Aka distribution.
///
/// The following suposes an [`Alignment::Start`].
///
/// ```text
/// Direction::Vertical
///
/// Start | FillMain | End |
/// ▕██ ⁞ ▏ | ▕██ ⁞ ▏ | ▕ ⁞ ▏ |
/// ▕███████ ▏ | ▕ ⁞ ▏ | ▕ ⁞ ▏ |
/// ▕███ ⁞ ▏ | ▕███████ ▏ | ▕ ⁞ ▏ |
/// ▕█ ⁞ ▏ | ▕ ⁞ ▏ | ▕██ ⁞ ▏ |
/// ▕ ⁞ ▏ | ▕███ ⁞ ▏ | ▕███████ ▏ |
/// ▕ ⁞ ▏ | ▕ ⁞ ▏ | ▕███ ⁞ ▏ |
/// ▕ ⁞ ▏ | ▕█ ⁞ ▏ | ▕█ ⁞ ▏ |
/// ```
#[derive(Clone, Copy, PartialEq, Eq, Debug, Default)]
#[cfg_attr(feature = "reflect", derive(Reflect))]
#[doc(alias = "justification")]
pub enum Distribution {
/// All item will be clumped together at the left/top.
#[default]
Start,
/// Items are distributed evenly, with no space left on the sides of the container.
FillMain,
/// All item will be clumped together at the right/bottom.
End,
}
/// Manage cross alignment.
#[derive(Clone, Copy, PartialEq, Debug)]
pub(crate) struct CrossAlign {
cross_parent_size: f32,
align: Alignment,
}
impl CrossAlign {
pub const fn new(parent_size: Oriented<f32>, align: Alignment) -> Self {
CrossAlign { cross_parent_size: parent_size.cross, align }
}
pub fn offset(self, cross_child_size: f32) -> f32 {
match self.align {
Alignment::Start => 0.0,
Alignment::Center => (self.cross_parent_size - cross_child_size) / 2.0,
Alignment::End => self.cross_parent_size - cross_child_size,
}
}
}
impl FromStr for Distribution {
type Err = ();
fn from_str(s: &str) -> Result<Self, Self::Err> {
match s {
"dS" => Ok(Self::Start),
"dE" => Ok(Self::End),
"dC" => Ok(Self::FillMain),
_ => Err(()),
}
}
}
impl FromStr for Alignment {
type Err = ();
fn from_str(s: &str) -> Result<Self, Self::Err> {
match s {
"aS" => Ok(Self::Start),
"aE" => Ok(Self::End),
"aC" => Ok(Self::Center),
_ => Err(()),
}
}
}