class: Font

[13:7] extends: object

A PangoFont is used to represent a font in a rendering-system-independent manner.

Members

• handleObj
• lib
• retainedCallbacks
• signalHandlerNames
• signalSetterHandlers

Methods

• Font (Handle = null)

  Creates a new Font by wrapping a native handle or another wrapper.

  • @p Handle is the native handle or another wrapper whose handle to adopt.

• toNativeHandle (Source)

  Normalizes a constructor argument into a raw pointer carrier. Accepts a raw NativeHandle, a raw NativeBuffer returned from fn.call(...), another generated wrapper exposing handle(), or null. Returns null when the argument carries no pointer.

  • @p Source is the raw handle, raw buffer, wrapper, or null.
  • @r A raw pointer carrier or null when no pointer is present.

• getLib ()

  Returns the opened native library for this generated wrapper.

  • @r The opened native library.

• handle ()

  Returns the wrapped NativeHandle.

  • @r The wrapped NativeHandle.

• isNull ()

  Returns true when the wrapped handle is null.

  • @r A bool.

• describe ()

  Returns a small string for debugging generated wrappers.

  • @r A string.

• asObject ()

  Wraps this handle as Object.

  • @r A Object object.

• FnDescribe ()

  Returns a description of the font, with font size set in points. Use [method@Pango.Font.describe_with_absolute_size] if you want the font size in device units.

• describe_with_absolute_size ()

  Returns a description of the font, with absolute font size set in device units. Use [method@Pango.Font.describe] if you want the font size in points.

• get_coverage (object language)

  Computes the coverage map for a given font and language tag.

  • @p language is the language tag.

• get_face ()

  Gets the PangoFontFace to which @font belongs. Note that this function can return NULL in cases where the font outlives its font map.

• get_font_map ()

  Gets the font map for which the font was created. Note that the font maintains a weak reference to the font map, so if all references to font map are dropped, the font map will be finalized even if there are fonts created with the font map that are still alive. In that case this function will return %NULL. It is the responsibility of the user to ensure that the font map is kept alive. In most uses this is not an issue as a PangoContext holds a reference to the font map.

• get_hb_font ()

  Get a hb_font_t object backing this font. Note that the objects returned by this function are cached and immutable. If you need to make changes to the hb_font_t, use hb_font_create_sub_font().

• get_metrics (object language)

  Gets overall metric information for a font. Since the metrics may be substantially different for different scripts, a language tag can be provided to indicate that the metrics should be retrieved that correspond to the script(s) used by that language. If @font is %NULL, this function gracefully sets some sane values in the output variables and returns.

  • @p language is language tag used to determine which script to get the metrics for, or %NULL to indicate to get the metrics for the entire font..

• serialize ()

  Serializes the @font in a way that can be uniquely identified. There are no guarantees about the format of the output across different versions of Pango. The intended use of this function is testing, benchmarking and debugging. The format is not meant as a permanent storage format. To recreate a font from its serialized form, use [func@Pango.Font.deserialize].