Struct fonts::FontTemplateDescriptor

pub struct FontTemplateDescriptor {
    pub weight: (FontWeight, FontWeight),
    pub stretch: (T, T),
    pub style: (T, T),
    pub unicode_range: Option<Vec<RangeInclusive<u32>>>,
}

Describes how to select a font from a given family. This is very basic at the moment and needs to be expanded or refactored when we support more of the font styling parameters.

NB: If you change this, you will need to update style::properties::compute_font_hash().

Fields

weight: (FontWeight, FontWeight)

stretch: (T, T)

style: (T, T)

unicode_range: Option<Vec<RangeInclusive<u32>>>

Implementations

impl FontTemplateDescriptor

pub fn new(weight: FontWeight, stretch: FontStretch, style: FontStyle) -> Self

pub fn is_variation_font(&self) -> bool

fn distance_from(&self, target: &FontDescriptor) -> f32

Returns a score indicating how far apart visually the two font descriptors are. This is used for implmenting the CSS Font Matching algorithm: https://drafts.csswg.org/css-fonts/#font-matching-algorithm.

The smaller the score, the better the fonts match. 0 indicates an exact match. This must be commutative (distance(A, B) == distance(B, A)).

fn matches(&self, descriptor_to_match: &FontDescriptor) -> bool

pub(crate) fn override_values_with_css_font_template_descriptors( &mut self, css_font_template_descriptors: &CSSFontFaceDescriptors, )

Trait Implementations

impl Clone for FontTemplateDescriptor

fn clone(&self) -> FontTemplateDescriptor

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for FontTemplateDescriptor

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

Formats the value using the given formatter.

impl Default for FontTemplateDescriptor

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for FontTemplateDescriptor

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Hash for FontTemplateDescriptor

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 MallocSizeOf for FontTemplateDescriptor

fn size_of(&self, ops: &mut MallocSizeOfOps) -> usize

Measure the heap usage of all descendant heap-allocated structures, but not the space taken up by the value itself.

impl PartialEq for FontTemplateDescriptor

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

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for FontTemplateDescriptor

FontTemplateDescriptor contains floats, which are not Eq because of NaN. However, we know they will never be NaN, so we can manually implement Eq.

impl StructuralPartialEq for FontTemplateDescriptor