Struct ScreenParams 

pub struct ScreenParams {
    pub kind: ScreenType,
    pub size: i32,
    pub dot_radius: i32,
}

Parameters for constructing a halftone screen.

Valid values

• kind: any ScreenType variant.
• size: must be a power of two and ≥ 2 (e.g. 2, 4, 8, 16 …). The screen matrix is size × size cells. Values that are not powers of two, or values less than 2, produce an undefined screen pattern. Call validate after construction to enforce these constraints.
• dot_radius: meaningful only for ScreenType::StochasticClustered; must be ≥ 1. Ignored for other screen types but must still be positive.

Default

{ Dispersed, size: 2, dot_radius: 2 }.

Fields

kind: ScreenType

The halftone algorithm to use.

size: i32

Screen matrix dimension in cells.

Must be a power of two and ≥ 2. Typical values: 2, 4, 8, 16, 32, 64.

dot_radius: i32

Dot radius for ScreenType::StochasticClustered screens.

Must be ≥ 1. Ignored (but still validated) for other screen types.

Implementations

impl ScreenParams

pub const fn validate(&self) -> Result<(), Cow<'static, str>>

Validates that the parameter values are within their documented ranges.

Constraints checked

• size must be ≥ 2.
• size must be a power of two.
• dot_radius must be ≥ 1.

Errors

Returns Err with a human-readable Cow<'static, str> message describing the first constraint violated. All current error messages are static string literals (Cow::Borrowed), so no allocation occurs. Future callers that need dynamic messages (e.g. including the offending field value) can return Cow::Owned(format!(...)) without a breaking API change.

Examples

assert!(ScreenParams::default().validate().is_ok());

let bad = ScreenParams { size: 3, ..ScreenParams::default() };
assert!(bad.validate().is_err());

Trait Implementations

impl Clone for ScreenParams

fn clone(&self) -> ScreenParams

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ScreenParams

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

Formats the value using the given formatter.

impl Default for ScreenParams

fn default() -> Self

Returns the default screen parameters: { Dispersed, size: 2, dot_radius: 2 }.

impl Copy for ScreenParams