Struct JustificationControl 

pub struct JustificationControl {
    pub mode: JustifyMode,
    pub word_space: GlueSpec,
    pub sentence_space: GlueSpec,
    pub char_space: GlueSpec,
    pub penalties: SpacePenalty,
    pub french_spacing: bool,
    pub max_consecutive_hyphens: u8,
    pub emergency_stretch_factor: u32,
}

Unified justification configuration.

Combines alignment mode, glue specs per space category, and penalty modifiers into a single configuration object that can be passed to the line-break optimizer.

Fields

mode: JustifyMode

Text alignment mode.

word_space: GlueSpec

Glue spec for inter-word spaces.

sentence_space: GlueSpec

Glue spec for inter-sentence spaces.

char_space: GlueSpec

Glue spec for inter-character adjustments (tracking).

penalties: SpacePenalty

Penalty modifiers for adjustment quality.

french_spacing: bool

Whether to use French spacing (same space after sentences as words).

max_consecutive_hyphens: u8

Maximum consecutive hyphens before incurring extra penalty.

emergency_stretch_factor: u32

Emergency stretch multiplier (1/256ths): applied when no feasible break exists. 256 = 1x (no extra), 512 = 2x emergency stretch.

Implementations

impl JustificationControl

pub const TERMINAL: Self

Terminal default: left-aligned, rigid spaces.

pub const READABLE: Self

Readable: fully justified with moderate elasticity.

pub const TYPOGRAPHIC: Self

Typographic: full justification with fine-grained controls.

pub const fn glue_for(&self, category: SpaceCategory) -> GlueSpec

Look up the glue spec for a given space category.

pub fn total_natural(&self, spaces: &[SpaceCategory]) -> u32

Compute total natural width for a sequence of space categories.

pub fn total_stretch(&self, spaces: &[SpaceCategory]) -> u32

Compute total stretchability for a sequence of space categories.

pub fn total_shrink(&self, spaces: &[SpaceCategory]) -> u32

Compute total shrinkability for a sequence of space categories.

pub fn adjustment_ratio( &self, slack_subcell: i32, total_stretch: u32, total_shrink: u32, ) -> Option<i32>

Compute the adjustment ratio for a line.

slack_subcell = desired_width - content_width - natural_space_width (positive means line is too short, needs stretching).

Returns ratio in 1/256ths, or None if adjustment is impossible (shrink required exceeds total shrinkability).

pub fn badness(ratio_fixed: i32) -> u64

Compute badness for a given adjustment ratio.

Uses the standard TeX cubic formula: |r/256|³ × 10000. Returns u64::MAX for infeasible adjustments.

pub fn line_demerits( &self, ratio_fixed: i32, spaces: &[SpaceCategory], break_penalty: i64, ) -> u64

Compute total demerits for a line, combining badness and penalties.

ratio_fixed: adjustment ratio in 1/256ths. spaces: the space categories on this line. break_penalty: penalty from the break point itself.

pub fn validate(&self) -> Vec<&'static str>

Validate that the configuration is internally consistent.

Returns a list of warnings (empty = valid).

Trait Implementations

impl Clone for JustificationControl

fn clone(&self) -> JustificationControl

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for JustificationControl

impl Debug for JustificationControl

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

Formats the value using the given formatter.

impl Default for JustificationControl

fn default() -> Self

Returns the “default value” for a type.

impl Display for JustificationControl

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

Formats the value using the given formatter.

impl Eq for JustificationControl

impl Hash for JustificationControl

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 JustificationControl

fn eq(&self, other: &JustificationControl) -> 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 StructuralPartialEq for JustificationControl