Struct GridScale 

pub struct GridScale(/* private fields */);

The fraction of the render target every internal grid is drawn at — the post chain’s grid and the attractor’s trail field (ADR-0245).

A validated value: only new and parse make one, and both refuse anything outside MIN..=MAX, NaN included. That is what makes the Eq below honest — a GridScale is never NaN, so it equals itself.

A capacity, not a look value, in the sense the module docs use: it sets how many texels a field holds, and a grid is a resolution rather than a shape (ADR-0037), so the picture’s geometry does not move with it. What does move is sharpness, which is the trade.

Implementations

impl GridScale

pub const MIN: f32 = 0.25

The smallest fraction accepted. Below a quarter a 1080p field is under 480x270 and the grid floor (grid::MIN_AXIS) starts deciding the size instead of the scale.

pub const MAX: f32 = 1.0

The largest: the target’s own resolution. A grid is never drawn above it.

pub const FULL: Self

The whole target — every row of the table but Rich on an integrated adapter, and what a headless renderer resolves unless it is told otherwise.

pub fn new(value: f32) -> Option<Self>

value as a scale, or None when it is outside MIN..=MAX or not a number.

pub fn parse(text: &str) -> Result<Self, String>

Parse a scale from its written form — the flag’s value, the environment variable’s, or a settings value. The error names the accepted range, because a caller surfaces it as a usage error verbatim.

pub fn get(self) -> f32

The fraction itself.

pub fn texels(self, px: u32) -> u32

px target pixels, as the texels a grid at this scale asks for before it is quantized: round(px * scale^2), saturating.

Exactly px at FULL, because 1.0 * 1.0 is exact and every u32 is exact in f64 — so a count derived from this at scale 1.0 is the count derived from the target, byte for byte.

Trait Implementations

impl Clone for GridScale

fn clone(&self) -> GridScale

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for GridScale

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

Formats the value using the given formatter.

impl Default for GridScale

fn default() -> Self

Returns the “default value” for a type.

impl Display for GridScale

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

Two decimals — 1.00, 0.75 — the form the overlay and a log line print.

impl PartialEq for GridScale

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

fn partial_cmp(&self, other: &GridScale) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

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

Tests less than (for self and other) and is used by the < operator.

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

Tests less than or equal to (for self and other) and is used by the <= operator.

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

Tests greater than (for self and other) and is used by the > operator.

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

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl Copy for GridScale

impl Eq for GridScale

impl StructuralPartialEq for GridScale