Struct OwnedPattern 

pub struct OwnedPattern { /* private fields */ }

A type representing an owned fontconfig’s sys::FcPattern.

Implementations

impl OwnedPattern

pub fn new() -> OwnedPattern

Create a new empty OwnedPattern.

Methods from Deref<Target = Pattern>

pub fn del(&mut self, name: &CStr) -> bool

Delete a property from a pattern

pub fn print(&self)

Print this pattern to stdout with all its values.

pub fn filter(&self, os: Option<&mut ObjectSet>) -> Option<OwnedPattern>

Filter the objects of pattern

Returns a new pattern that only has those objects from self that are in os. If os is None, a duplicate of self is returned.

pub fn format(&self, fmt: &CStr) -> Option<FcStr>

Format a pattern into a string according to a format specifier

See: pattern-format

pub fn default_substitute(&mut self)

Perform default substitutions in a pattern

Supplies default values for underspecified font patterns:

• Patterns without a specified style or weight are set to Medium
• Patterns without a specified style or slant are set to Roman
• Patterns without a specified pixel size are given one computed from any specified point size (default 12), dpi (default 75) and scale (default 1).

pub fn font_match(&mut self, config: &mut FontConfig) -> OwnedPattern

Get the best available match for this pattern, returned as a new pattern.

Finds the font in sets most closely matching pattern and returns the result of Pattern::render_prepare for that font and the provided pattern.
This function should be called only after FontConfig::substitute and Pattern::default_substitute have been called for the pattern.
otherwise the results will not be correct.

pub fn font_list( &self, config: &mut FontConfig, os: Option<&mut ObjectSet>, ) -> FontSet<'_>

List fonts

Selects fonts matching self, creates patterns from those fonts containing only the objects in os and returns the set of unique such patterns.

pub fn font_sort( &mut self, config: &mut FontConfig, trim: bool, ) -> Result<FontSet<'static>, Error>

Get the list of fonts sorted by closeness to self.

If trim is true, elements in the list which don’t include Unicode coverage not provided by earlier elements in the list are elided.
This function should be called only after FontConfig::substitute and Pattern::default_substitute have been called for this pattern;
otherwise the results will not be correct.

pub fn font_sort_with_charset( &mut self, config: &mut FontConfig, trim: bool, ) -> Option<(FontSet<'_>, OwnedCharSet)>

Get the list of fonts sorted by closeness to self.

If trim is true, elements in the list which don’t include Unicode coverage not provided by earlier elements in the list are elided.
The union of Unicode coverage of all of the fonts is returned in CharSet.
This function should be called only after FontConfig::substitute and Pattern::default_substitute have been called for this pattern;
otherwise the results will not be correct.

pub fn render_prepare( &mut self, config: &mut FontConfig, font: &mut Self, ) -> OwnedPattern

Prepare pattern for loading font file.

Creates a new pattern consisting of elements of font not appearing in pat, elements of pat not appearing in font and the best matching value from pat for elements appearing in both.
The result is passed to [FontConfig::substitute_with_pat] with kind crate::MatchKind::Font and then returned.

pub fn charset(&self) -> Option<&CharSet>

Get character map

pub fn name(&self) -> Option<&str>

Get the “fullname” (human-readable name) of this pattern.

pub fn filename(&self) -> Option<&str>

Get the “file” (path on the filesystem) of this font pattern.

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

Get the “index” (The index of the font within the file) of this pattern.

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

Get the “slant” (Italic, oblique or roman) of this pattern.

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

Get the “weight” (Light, medium, demibold, bold or black) of this pattern.

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

Get the “width” (Condensed, normal or expanded) of this pattern.

pub fn fontformat(&self) -> Result<FontFormat, Error>

Get the “fontformat” (“TrueType” “Type 1” “BDF” “PCF” “Type 42” “CID Type 1” “CFF” “PFR” “Windows FNT”) of this pattern.

pub fn hash(&self) -> u32

pub fn lang_set(&self) -> Option<LangSet>

Get the languages set of this pattern.

pub fn matrix(&mut self) -> Option<&Matrix>

Get the matrix from this pattern.

pub fn get<'a, 'pat, V>( &'pat self, name: &'a Property<'pat, V>, index: usize, ) -> Option<V::Returns>

where V: PropertyType<'pat>,

pub fn add<'a, 'pat, V>( &'pat mut self, name: &'a Property<'pat, V>, value: V, ) -> bool

where V: PropertyType<'pat>,

Trait Implementations

impl AsMut<Pattern> for OwnedPattern

fn as_mut(&mut self) -> &mut Pattern

Converts this type into a mutable reference of the (usually inferred) input type.

impl AsRef<Pattern> for OwnedPattern

fn as_ref(&self) -> &Pattern

Converts this type into a shared reference of the (usually inferred) input type.

impl Borrow<Pattern> for OwnedPattern

fn borrow(&self) -> &Pattern

Immutably borrows from an owned value.

impl BorrowMut<Pattern> for OwnedPattern

fn borrow_mut(&mut self) -> &mut Pattern

Mutably borrows from an owned value.

impl Clone for OwnedPattern

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Default for OwnedPattern

fn default() -> Self

Returns the “default value” for a type.

impl Deref for OwnedPattern

type Target = Pattern

The resulting type after dereferencing.

fn deref(&self) -> &Self::Target

Dereferences the value.

impl DerefMut for OwnedPattern

fn deref_mut(&mut self) -> &mut Self::Target

Mutably dereferences the value.

impl Drop for OwnedPattern

fn drop(&mut self)

Executes the destructor for this type.

impl FromStr for OwnedPattern

fn from_str(s: &str) -> Result<Self, Error>

Converts name from the standard text format described above into a pattern.

type Err = Error

The associated error which can be returned from parsing.