Struct LayoutPolicy 

pub struct LayoutPolicy {
    pub tier: LayoutTier,
    pub allow_degradation: bool,
    pub justify_override: Option<JustifyMode>,
    pub vertical_override: Option<VerticalPolicy>,
    pub line_height_subpx: u32,
}

User-facing layout policy configuration.

Combines a desired tier with optional overrides. Call [resolve] with a RuntimeCapability to get a fully-resolved configuration.

Fields

tier: LayoutTier

Desired quality tier.

allow_degradation: bool

If true, allow automatic degradation when capabilities are insufficient. If false, resolution fails with an error.

justify_override: Option<JustifyMode>

Override the justify mode (ignoring the tier’s default).

vertical_override: Option<VerticalPolicy>

Override the vertical policy (ignoring the tier’s default).

line_height_subpx: u32

Line height in sub-pixel units (1/256 px) for vertical metrics. 0 = use default (16px = 4096 subpx).

Implementations

impl LayoutPolicy

pub const EMERGENCY: Self

Emergency preset: bare-minimum survival mode.

pub const FAST: Self

Quick preset: terminal-optimized.

pub const BALANCED: Self

Balanced preset: good for general use.

pub const QUALITY: Self

Quality preset: best output.

pub const fn effective_line_height(&self) -> u32

The effective line height (using default if unset).

pub fn resolve( &self, caps: &RuntimeCapability, ) -> Result<ResolvedPolicy, PolicyError>

Resolve this policy against runtime capabilities.

Returns a fully-resolved configuration, potentially degraded to a lower tier if capabilities are insufficient.

Errors

Returns PolicyError::CapabilityInsufficient if allow_degradation is false and the requested tier cannot be supported.

Trait Implementations

impl Clone for LayoutPolicy

fn clone(&self) -> LayoutPolicy

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for LayoutPolicy

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for LayoutPolicy

fn default() -> Self

Returns the “default value” for a type.

impl Display for LayoutPolicy

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Hash for LayoutPolicy

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for LayoutPolicy

fn eq(&self, other: &LayoutPolicy) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Copy for LayoutPolicy

impl Eq for LayoutPolicy

impl StructuralPartialEq for LayoutPolicy