Struct GlyphDrawingOptions 

pub struct GlyphDrawingOptions { /* private fields */ }

Options that influence how a single glyph is drawn, independent of variable-font axis configuration: which CPAL palette to use for color glyphs, and which bitmap strike size to prefer for bitmap-based glyphs.

All properties are optional. None means “use the font’s default” (palette 0 for color glyphs; no bitmap strike preference). Concerns specific to variable fonts (axis coordinates, named instances) live on FontVariationSettings.

A record with init-only properties: a value is built from GlyphDrawingOptions::new with GlyphDrawingOptions::with_palette_index and GlyphDrawingOptions::with_pixel_size, which validate as the property initialisers do.

Implementations

impl GlyphDrawingOptions

pub const DEFAULT: GlyphDrawingOptions

The instance representing “use the font’s defaults”.

pub const fn new() -> GlyphDrawingOptions

Creates options that use the font’s defaults.

pub fn palette_index(&self) -> Option<i32>

Gets the optional CPAL palette index used to resolve colors for COLR v0 / COLR v1 glyphs.

When None, the font’s default palette (palette 0) is used.

pub fn with_palette_index(self, value: Option<i32>) -> GlyphDrawingOptions

Returns a copy of the options with the given palette index.

Panics

When the value is negative (ArgumentOutOfRangeException).

pub fn pixel_size(&self) -> Option<i32>

Gets the optional pixel size used to select a bitmap strike from sbix, CBDT or EBDT tables.

When None, no bitmap strike is selected and the font’s outline (or color-layer) representation is used instead.

pub fn with_pixel_size(self, value: Option<i32>) -> GlyphDrawingOptions

Returns a copy of the options with the given pixel size.

Panics

When the value is less than 1 (ArgumentOutOfRangeException).

Trait Implementations

impl Clone for GlyphDrawingOptions

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for GlyphDrawingOptions

impl Debug for GlyphDrawingOptions

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

Formats the value using the given formatter.

impl Default for GlyphDrawingOptions

fn default() -> Self

Returns the “default value” for a type.

impl Eq for GlyphDrawingOptions

impl Hash for GlyphDrawingOptions

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 GlyphDrawingOptions

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for GlyphDrawingOptions