FontDescription

---

Object Hierarchy:

Description:

Content:

Static methods:

• public static FontDescription from_string (string str)
  Creates a new font description from a string representation in the form "[FAMILY-LIST] [STYLE-OPTIONS] [SIZE]", where FAMILY-LIST is a comma separated list of families optionally terminated by a comma, STYLE_OPTIONS is a whitespace separated list of words where each WORD describes one of style, variant, weight, stretch, or gravity, and SIZE is a decimal number (size in points) or optionally followed by the unit modifier "px" for absolute size. Any one of the options may be absent. If FAMILY-LIST is absent, then the family_name field of the resulting font description will be initialized to null. If STYLE-OPTIONS is missing, then all style options will be set to the default values. If SIZE is missing, the size in the resulting font description will be set to 0.

Creation methods:

• public FontDescription ()
  Creates a new font description structure with all fields unset.

Methods:

• public bool better_match (FontDescription old_match, FontDescription new_match)
  Determines if the style attributes of new_match are a closer match for desc than those of old_match are, or if old_match is null, determines if new_match is a match at all. Approximate matching is done for weight and style; other style attributes must match exactly. Style attributes are all attributes other than family and size-related attributes. Approximate matching for style considers PANGO_STYLE_OBLIQUE and PANGO_STYLE_ITALIC as matches, but not as good a match as when the styles are equal.
• public FontDescription copy ()
  Make a copy of a FontDescription.
• public bool equal (FontDescription desc2)
  Compares two font descriptions for equality. Two font descriptions are considered equal if the fonts they describe are provably identical. This means that their masks do not have to match, as long as other fields are all the same. (Two font descriptions may result in identical fonts being loaded, but still compare false.)
• public unowned string get_family ()
  Gets the family name field of a font description. See set_family.
• public Gravity get_gravity ()
  Gets the gravity field of a font description. See set_gravity.
• public FontMask get_set_fields ()
  Determines which fields in a font description have been set.
• public int get_size ()
  Gets the size field of a font description. See set_size.
• public bool get_size_is_absolute ()
  Determines whether the size of the font is in points (not absolute) or device units (absolute). See set_size and set_absolute_size.
• public Stretch get_stretch ()
  Gets the stretch field of a font description. See set_stretch.
• public Style get_style ()
  Gets the style field of a FontDescription. See set_style.
• public Variant get_variant ()
  Gets the variant field of a FontDescription. See set_variant.
• public Weight get_weight ()
  Gets the weight field of a font description. See set_weight.
• public uint hash ()
  Computes a hash of a FontDescription structure suitable to be used, for example, as an argument to g_hash_table_new. The hash value is independent of desc- >mask.
• public void merge (FontDescription desc_to_merge, bool replace_existing)
  Merges the fields that are set in desc_to_merge into the fields in desc. If replace_existing is false, only fields in desc that are not already set are affected. If true, then fields that are already set will be replaced as well.
• public void merge_static (FontDescription desc_to_merge, bool replace_existing)
  Like merge, but only a shallow copy is made of the family name and other allocated fields. desc can only be used until desc_to_merge is modified or freed. This is meant to be used when the merged font description is only needed temporarily.
• public void set_absolute_size (double size)
  Sets the size field of a font description, in device units. This is mutually exclusive with set_size which sets the font size in points.
• public void set_family (string family)
  Sets the family name field of a font description. The family name represents a family of related font styles, and will resolve to a particular FontFamily. In some uses of FontDescription, it is also possible to use a comma separated list of family names for this field.
• public void set_family_static (string family)
  Like set_family, except that no copy of family is made. The caller must make sure that the string passed in stays around until desc has been freed or the name is set again. This function can be used if family is a static string such as a C string literal, or if desc is only needed temporarily.
• public void set_gravity (Gravity gravity)
  Sets the gravity field of a font description. The gravity field specifies how the glyphs should be rotated. If gravity is AUTO, this actually unsets the gravity mask on the font description.
• public void set_size (int size)
  Sets the size field of a font description in fractional points. This is mutually exclusive with set_absolute_size.
• public void set_stretch (Stretch stretch)
  Sets the stretch field of a font description. The stretch field specifies how narrow or wide the font should be.
• public void set_style (Style style)
  Sets the style field of a FontDescription. The Style enumeration describes whether the font is slanted and the manner in which it is slanted; it can be either NORMAL, ITALIC, or OBLIQUE. Most fonts will either have a italic style or an oblique style, but not both, and font matching in Pango will match italic specifications with oblique fonts and vice-versa if an exact match is not found.
• public void set_variant (Variant variant)
  Sets the variant field of a font description. The Variant can either be NORMAL or SMALL_CAPS.
• public void set_weight (Weight weight)
  Sets the weight field of a font description. The weight field specifies how bold or light the font should be. In addition to the values of the Weight enumeration, other intermediate numeric values are possible.
• public string to_filename ()
  Creates a filename representation of a font description. The filename is identical to the result from calling to_string, but with underscores instead of characters that are untypical in filenames, and in lower case only.
• public string to_string ()
  Creates a string representation of a font description. See from_string for a description of the format of the string representation. The family list in the string description will only have a terminating comma if the last word of the list is a valid style option.
• public void unset_fields (FontMask to_unset)
  Unsets some of the fields in a FontDescription. The unset fields will get back to their default values.