Struct TypefaceQuery

pub struct TypefaceQuery {
    pub family: Option<FamilyName>,
    pub style: Option<Style2>,
    pub languages: Option<Vec<LocaleId>>,
    pub code_points: Option<Vec<u32>>,
    pub fallback_family: Option<GenericFontFamily>,
    pub postscript_name: Option<String>,
    pub full_name: Option<String>,
    /* private fields */
}

Parameters for looking up a typeface.

Fields

family: Option<FamilyName>

Desired font family name, e.g. “Roboto”. Font family search is case-insensitive.

Note: In cases where the specified family doesn’t exist, or the specified family doesn’t have a glyph for the requested code_point, a face from another family may be returned. This behavior can be disabled using TypefaceRequestFlags.EXACT_FAMILY.

style: Option<Style2>

Style properties of the desired typeface.

languages: Option<Vec<LocaleId>>

Language tags in order of preference. This allows disambiguating code points that map to different glyphs in different languages (e.g. CJK code points).

See fuchsia.intl.LocaleId.

code_points: Option<Vec<u32>>

Optional code points for which glyphs must be present in the returned face.

Callers that specify this field are expected to extract the character set from the result and cache it in order to avoid calling the API more than necessary.

fallback_family: Option<GenericFontFamily>

A generic font family to fall back to if an exact match is unavailable or does not contain the requested code point.

Every font family belongs to a generic family (configured in the font manifest). If a particular font family doesn’t contain a requested code point, the provider can search for the code point in other font families in the same generic family as a fallback.

Specifying fallback_family in a query allows the client to override the generic family that would be used as a fallback.

postscript_name: Option<String>

The exact Postscript name of the typeface to look up. This corresponds to name ID 6 in the TrueType/OpenType name table.

All characters must be in the printable ASCII range (U+0021 to U+007E), and must not be ‘[’, ‘]’, ‘(’, ‘)’, ‘{’, ‘}’, ‘<’, ‘>’, ‘/’, or ‘%’.

If this field is specified, all the other query fields are ignored.

full_name: Option<String>

The exact full name of the typeface to look up. This corresponds to name ID 4 in the TrueType/OpenType name table.

If this field is specified, all the other query fields are ignored.

Trait Implementations

impl Clone for TypefaceQuery

fn clone(&self) -> TypefaceQuery

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for TypefaceQuery

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

Formats the value using the given formatter.

impl<D: ResourceDialect> Decode<TypefaceQuery, D> for TypefaceQuery

fn new_empty() -> Self

Creates a valid instance of Self. The specific value does not matter, since it will be overwritten by decode.

unsafe fn decode( &mut self, decoder: &mut Decoder<'_, D>, offset: usize, depth: Depth, ) -> Result<()>

Decodes an object of type T from the decoder’s buffers into self.

impl Default for TypefaceQuery

fn default() -> TypefaceQuery

Returns the “default value” for a type.

impl<D: ResourceDialect> Encode<TypefaceQuery, D> for &TypefaceQuery

unsafe fn encode( self, encoder: &mut Encoder<'_, D>, offset: usize, depth: Depth, ) -> Result<()>

Encodes the object into the encoder’s buffers. Any handles stored in the object are swapped for Handle::INVALID.

impl PartialEq for TypefaceQuery

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

type Owned = TypefaceQuery

The owned Rust type which this FIDL type decodes into.

fn inline_align(_context: Context) -> usize

Returns the minimum required alignment of the inline portion of the encoded object. It must be a (nonzero) power of two.

fn inline_size(_context: Context) -> usize

Returns the size of the inline portion of the encoded object, including padding for alignment. Must be a multiple of inline_align.

fn encode_is_copy() -> bool

Returns true if the memory layout of Self::Owned matches the FIDL wire format and encoding requires no validation. When true, we can optimize encoding arrays and vectors of Self::Owned to a single memcpy.

fn decode_is_copy() -> bool

Returns true if the memory layout of Self::Owned matches the FIDL wire format and decoding requires no validation. When true, we can optimize decoding arrays and vectors of Self::Owned to a single memcpy.

impl ValueTypeMarker for TypefaceQuery

type Borrowed<'a> = &'a TypefaceQuery

The Rust type to use for encoding. This is a particular Encode<Self> type cheaply obtainable from &Self::Owned. There are three cases:

fn borrow(value: &<Self as TypeMarker>::Owned) -> Self::Borrowed<'_>

Cheaply converts from &Self::Owned to Self::Borrowed.

impl Persistable for TypefaceQuery

impl StructuralPartialEq for TypefaceQuery