Struct NameId

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

Identifier for an informational string (or name).

A set of predefined identifiers exist for accessing names and other various metadata about the font and those are provided as associated constants on this type.

IDs 26 to 255, inclusive, are reserved for future standard names. IDs 256 to 32767, inclusive, are reserved for font-specific names such as those referenced by a font’s layout features.

For more detail, see https://learn.microsoft.com/en-us/typography/opentype/spec/name#name-ids

Implementations

impl NameId

pub const COPYRIGHT_NOTICE: NameId = _

Copyright notice.

pub const FAMILY_NAME: NameId = _

Font family name.

The font family name is used in combination with font subfamily name (ID 2), and should be shared among at most four fonts that differ only in weight or style (as described below).

pub const SUBFAMILY_NAME: NameId = _

Font subfamily name.

The font subfamily name is used in combination with font family name (ID 1), and distinguishes the fonts in a group with the same font family name. This should be used for style and weight variants only (as described below).

pub const UNIQUE_ID: NameId = _

Unique font identifier.

pub const FULL_NAME: NameId = _

Full font name that reflects all family and relevant subfamily descriptors.

The full font name is generally a combination of IDs 1 and 2, or of IDs 16 and 17, or a similar human-readable variant.

pub const VERSION_STRING: NameId = _

Version string.

Should begin with the syntax “Version number.number” (upper case, lower case, or mixed, with a space between “Version” and the number).

pub const POSTSCRIPT_NAME: NameId = _

PostScript name for the font.

ID 6 specifies a string which is used to invoke a PostScript language font that corresponds to this OpenType font. When translated to ASCII, the name string must be no longer than 63 characters and restricted to the printable ASCII subset, codes 33 to 126, except for the 10 characters ‘[’, ‘]’, ‘(’, ‘)’, ‘{’, ‘}’, ‘<’, ‘>’, ‘/’, ‘%’.

pub const TRADEMARK: NameId = _

Trademark; this is used to save any trademark notice/information for this font.

Such information should be based on legal advice. This is distinctly separate from the copyright.

pub const MANUFACTURER: NameId = _

Manufacturer name.

pub const DESIGNER: NameId = _

Name of the designer of the typeface.

pub const DESCRIPTION: NameId = _

Description of the typeface.

Can contain revision information, usage recommendations, history, features, etc.

pub const VENDOR_URL: NameId = _

URL of font vendor (with protocol, e.g., http://, ftp://).

If a unique serial number is embedded in the URL, it can be used to register the font.

pub const DESIGNER_URL: NameId = _

URL of typeface designer (with protocol, e.g., http://, ftp://).

pub const LICENSE_DESCRIPTION: NameId = _

License description.

A description of how the font may be legally used, or different example scenarios for licensed use. This field should be written in plain language, not legalese.

pub const LICENSE_URL: NameId = _

URL where additional licensing information can be found.

pub const TYPOGRAPHIC_FAMILY_NAME: NameId = _

Typographic family name.

The typographic family grouping doesn’t impose any constraints on the number of faces within it, in contrast with the 4-style family grouping (ID 1), which is present both for historical reasons and to express style linking groups.

pub const TYPOGRAPHIC_SUBFAMILY_NAME: NameId = _

Typographic subfamily name.

This allows font designers to specify a subfamily name within the typographic family grouping. This string must be unique within a particular typographic family.

pub const COMPATIBLE_FULL_NAME: NameId = _

Compatible full (Macintosh only).

On the Macintosh, the menu name is constructed using the FOND resource. This usually matches the full name. If you want the name of the font to appear differently than the Full Name, you can insert the compatible full name in ID 18.

pub const SAMPLE_TEXT: NameId = _

Sample text.

This can be the font name, or any other text that the designer thinks is the best sample to display the font in.

pub const POSTSCRIPT_CID_NAME: NameId = _

PostScript CID findfont name.

Its presence in a font means that the ID 6 holds a PostScript font name that is meant to be used with the “composefont” invocation in order to invoke the font in a PostScript interpreter.

pub const WWS_FAMILY_NAME: NameId = _

WWS family name.

Used to provide a WWS-conformant family name in case the entries for IDs 16 and 17 do not conform to the WWS model.

pub const WWS_SUBFAMILY_NAME: NameId = _

WWS subfamily name.

Used in conjunction with ID 21, this ID provides a WWS-conformant subfamily name (reflecting only weight, width and slope attributes) in case the entries for IDs 16 and 17 do not conform to the WWS model.

pub const LIGHT_BACKGROUND_PALETTE: NameId = _

Light background palette.

This ID, if used in the CPAL table’s Palette Labels Array, specifies that the corresponding color palette in the CPAL table is appropriate to use with the font when displaying it on a light background such as white.

pub const DARK_BACKGROUND_PALETTE: NameId = _

Dark background palette.

This ID, if used in the CPAL table’s Palette Labels Array, specifies that the corresponding color palette in the CPAL table is appropriate to use with the font when displaying it on a dark background such as black.

pub const VARIATIONS_POSTSCRIPT_NAME_PREFIX: NameId = _

Variations PostScript name prefix.

If present in a variable font, it may be used as the family prefix in the PostScript Name Generation for Variation Fonts algorithm.

pub const LAST_RESERVED_NAME_ID: NameId = _

The last value that is explicitly reserved for standard names.

Values after this are available to be used for font-specific names.

See https://learn.microsoft.com/en-us/typography/opentype/spec/name#name-ids

pub const LAST_ALLOWED_NAME_ID: NameId = _

The last value that is available for font-specific names.

See https://learn.microsoft.com/en-us/typography/opentype/spec/name#name-ids

impl NameId

pub const fn new(raw: u16) -> NameId

Create a new identifier from a raw u16 value.

pub fn predefined() -> impl Iterator<Item = NameId> + Clone

Returns an iterator over the set of predefined identifiers according to the specification.

pub const fn to_u16(self) -> u16

Return the identifier as a u16.

pub const fn is_reserved(self) -> bool

Returns true if self is in the range 0..=255 (reserved for standard names.)

pub const fn checked_add(self, rhs: u16) -> Option<NameId>

Returns a new NameId by adding rhs to the current value.

Returns None if the result would be greater than Self::LAST_ALLOWED_NAME_ID.

pub const fn to_be_bytes(self) -> [u8; 2]

Return the memory representation of this identifier as a byte array in big-endian (network) byte order.

Trait Implementations

impl Clone for NameId

fn clone(&self) -> NameId

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for NameId

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

Formats the value using the given formatter.

impl Default for NameId

fn default() -> NameId

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for NameId

fn deserialize<__D>( __deserializer: __D, ) -> Result<NameId, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for NameId

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

Formats the value using the given formatter.

impl Domain for NameId

Available on crate feature std only.

fn to_u32(&self) -> u32

Converts this value of T to a value in u32.

fn from_u32(member: InDomain) -> NameId

Converts a mapped u32 value back to T.

fn is_continuous() -> bool

Returns true if all u32 values between the mapped u32 min and mapped u32 max value of T are used.

fn ordered_values() -> impl DoubleEndedIterator<Item = u32>

Returns an iterator which iterates over all values in the domain of T

fn ordered_values_range( range: RangeInclusive<NameId>, ) -> impl DoubleEndedIterator<Item = u32>

Return an iterator which iterates over all values of T in the given range.

fn count() -> u64

Returns the number of members in the domain.

impl From<u16> for NameId

fn from(value: u16) -> NameId

Converts to this type from the input type.

impl Hash for NameId

fn hash<__H>(&self, state: &mut __H)

where __H: Hasher,

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 Ord for NameId

fn cmp(&self, other: &NameId) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

impl PartialEq for NameId

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

fn partial_cmp(&self, other: &NameId) -> 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 Scalar for NameId

type Raw = [u8; 2]

The raw byte representation of this type.

fn to_raw(self) -> [u8; 2]

Encode this type as raw big-endian bytes

fn from_raw(raw: [u8; 2]) -> NameId

Create an instance of this type from raw big-endian bytes

fn read(slice: &[u8]) -> Option<Self>

Attempt to read a scalar from a slice.

impl Serialize for NameId

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Zeroable for NameId

fn zeroed() -> Self

Calls zeroed.

impl AnyBitPattern for NameId

impl Copy for NameId

impl Eq for NameId

impl StructuralPartialEq for NameId