Type Aliases

A PangoGlyph represents a single glyph in the output form of a string.

The PangoGlyphUnit type is used to store dimensions within Pango.

Dimensions are stored in 1/PANGO_SCALE of a device unit. (A device unit might be a pixel for screen display, or a point on a printer.) PANGO_SCALE is currently 1024, and may change in the future (unlikely though), but you should not depend on its exact value.

The PANGO_PIXELS() macro can be used to convert from glyph units into device units with correct rounding.

A PangoLayoutRun represents a single run within a PangoLayoutLine.

It is simply an alternate name for [structPango.GlyphItem]. See the [structPango.GlyphItem] docs for details on the fields.

Type of a function that can duplicate user data for an attribute.

Type of a function filtering a list of attributes.

Callback used when enumerating fonts in a fontset.

See [methodPango.Fontset.foreach].

PangoAlignment describes how to align the lines of a PangoLayout within the available space.

If the PangoLayout is set to justify using [methodPango.Layout.set_justify], this only affects partial lines.

See [methodPango.Layout.set_auto_dir] for how text direction affects the interpretation of PangoAlignment values.

The PangoAttrType distinguishes between different types of attributes.

Along with the predefined values, it is possible to allocate additional values for custom attributes using [funcAttrType.register]. The predefined values are given below. The type of structure used to store the attribute is listed in parentheses after the description.

An enumeration that affects baseline shifts between runs.

PangoBidiType represents the bidirectional character type of a Unicode character.

The values in this enumeration are specified by the Unicode bidirectional algorithm.

BidiType is deprecated: Use fribidi for this information

PangoCoverageLevel is used to indicate how well a font can represent a particular Unicode character for a particular script.

Since 1.44, only PANGO_COVERAGE_NONE and PANGO_COVERAGE_EXACT will be returned.

PangoDirection represents a direction in the Unicode bidirectional algorithm.

Not every value in this enumeration makes sense for every usage of PangoDirection; for example, the return value of [funcunichar_direction] and [funcfind_base_dir] cannot be PANGO_DIRECTION_WEAK_LTR or PANGO_DIRECTION_WEAK_RTL, since every character is either neutral or has a strong direction; on the other hand PANGO_DIRECTION_NEUTRAL doesn’t make sense to pass to [funcitemize_with_base_dir].

The PANGO_DIRECTION_TTB_LTR, PANGO_DIRECTION_TTB_RTL values come from an earlier interpretation of this enumeration as the writing direction of a block of text and are no longer used. See PangoGravity for how vertical text is handled in Pango.

If you are interested in text direction, you should really use fribidi directly. PangoDirection is only retained because it is used in some public apis.

PangoEllipsizeMode describes what sort of ellipsization should be applied to text.

In the ellipsization process characters are removed from the text in order to make it fit to a given width and replaced with an ellipsis.

An enumeration that affects font sizes for superscript and subscript positioning and for (emulated) Small Caps.

PangoGravity represents the orientation of glyphs in a segment of text.

This is useful when rendering vertical text layouts. In those situations, the layout is rotated using a non-identity [structPango.Matrix], and then glyph orientation is controlled using PangoGravity.

Not every value in this enumeration makes sense for every usage of PangoGravity; for example, PANGO_GRAVITY_AUTO only can be passed to [methodPango.Context.set_base_gravity] and can only be returned by [methodPango.Context.get_base_gravity].

See also: [enumPango.GravityHint]

PangoGravityHint defines how horizontal scripts should behave in a vertical context.

That is, English excerpts in a vertical paragraph for example.

See also [enumPango.Gravity]

Errors that can be returned by [funcPango.Layout.deserialize].

The PangoOverline enumeration is used to specify whether text should be overlined, and if so, the type of line.

PangoRenderPart defines different items to render for such purposes as setting colors.

The PangoScript enumeration identifies different writing systems.

The values correspond to the names as defined in the Unicode standard. See Unicode Standard Annex 24: Script names

Note that this enumeration is deprecated and will not be updated to include values in newer versions of the Unicode standard. Applications should use the [enumGLib.UnicodeScript] enumeration instead, whose values are interchangeable with PangoScript.

An enumeration specifying the width of the font relative to other designs within a family.

An enumeration specifying the various slant styles possible for a font.

PangoTabAlign specifies where the text appears relative to the tab stop position.

An enumeration that affects how Pango treats characters during shaping.

The PangoUnderline enumeration is used to specify whether text should be underlined, and if so, the type of underlining.

An enumeration specifying capitalization variant of the font.

An enumeration specifying the weight (boldness) of a font.

Weight is specified as a numeric value ranging from 100 to 1000. This enumeration simply provides some common, predefined values.

PangoWrapMode describes how to wrap the lines of a PangoLayout to the desired width.

For PANGO_WRAP_WORD, Pango uses break opportunities that are determined by the Unicode line breaking algorithm. For PANGO_WRAP_CHAR, Pango allows breaking at grapheme boundaries that are determined by the Unicode text segmentation algorithm.