Methods

Create a new allow-breaks attribute.

If breaks are disabled, the range will be kept in a single run, as far as possible.

Since: 1.44

Create a new background alpha attribute.

Since: 1.38

Create a new background color attribute.

Create a new font fallback attribute.

If fallback is disabled, characters will only be used from the closest matching font on the system. No fallback will be done to other fonts on the system that might contain the characters in the text.

Since: 1.4

Create a new font family attribute.

Create a new foreground alpha attribute.

Since: 1.38

Create a new foreground color attribute.

Create a new gravity hint attribute.

Since: 1.16

Create a new gravity attribute.

Since: 1.16

Create a new insert-hyphens attribute.

Pango will insert hyphens when breaking lines in the middle of a word. This attribute can be used to suppress the hyphen.

Since: 1.44

Create a new letter-spacing attribute.

Since: 1.6

Create a new baseline displacement attribute.

Create a new font size scale attribute. The base font for the affected text will have its size multiplied by scaleFactor.

Create a new attribute that influences how invisible characters are rendered.

Since: 1.44

Create a new font stretch attribute

Create a new strikethrough color attribute. This attribute modifies the color of strikethrough lines. If not set, strikethrough lines will use the foreground color.

Since: 1.8

Create a new strike-through attribute.

Create a new font slant style attribute.

Create a new underline color attribute. This attribute modifies the color of underlines. If not set, underlines will use the foreground color.

Since: 1.8

Create a new underline-style attribute.

Create a new font variant attribute (normal or small caps)

Create a new font weight attribute.

Determines possible line, word, and character breaks for a string of Unicode text with a single analysis. For most purposes you may want to use getLogAttrs.

This is the default break algorithm. It applies Unicode rules without language-specific tailoring, therefore the analyis argument is unused and can be Nothing.

See tailorBreak for language-specific breaks.

Converts extents from Pango units to device units, dividing by the SCALE factor and performing rounding.

The inclusive rectangle is converted by flooring the x/y coordinates and extending width/height, such that the final rectangle completely includes the original rectangle.

The nearest rectangle is converted by rounding the coordinates of the rectangle to the nearest device unit (pixel).

The rule to which argument to use is: if you want the resulting device-space rectangle to completely contain the original rectangle, pass it in as inclusive. If you want two touching-but-not-overlapping rectangles stay touching-but-not-overlapping after rounding to device units, pass them in as nearest.

Since: 1.16

Searches a string the first character that has a strong direction, according to the Unicode bidirectional algorithm.

Since: 1.4

Locates a paragraph boundary in text. A boundary is caused by delimiter characters, such as a newline, carriage return, carriage return-newline pair, or Unicode paragraph separator character. The index of the run of delimiters is returned in paragraphDelimiterIndex. The index of the start of the paragraph (index after all delimiters) is stored in nextParagraphStart.

If no delimiters are found, both paragraphDelimiterIndex and nextParagraphStart are filled with the length of text (an index one off the end).

Computes a LogAttr for each character in text. The logAttrs array must have one LogAttr for each position in text; if text contains N characters, it has N+1 positions, including the last position at the end of the text. text should be an entire paragraph; logical attributes can't be computed without context (for example you need to see spaces on either side of a word to know the word is a word).

If ch has the Unicode mirrored property and there is another Unicode character that typically has a glyph that is the mirror image of ch's glyph, puts that character in the address pointed to by mirroredCh.

Use unicharGetMirrorChar instead; the docs for that function provide full details.

Checks ch to see if it is a character that should not be normally rendered on the screen. This includes all Unicode characters with "ZERO WIDTH" in their name, as well as <firstterm>bidi</firstterm> formatting characters, and a few other ones. This is totally different from unicharIszerowidth and is at best misnamed.

Since: 1.10

Breaks a piece of text into segments with consistent directional level and shaping engine. Each byte of text will be contained in exactly one of the items in the returned list; the generated list of items will be in logical order (the start offsets of the items are ascending).

cachedIter should be an iterator over attrs currently positioned at a range before or containing startIndex; cachedIter will be advanced to the range covering the position just after startIndex + length. (i.e. if itemizing in a loop, just keep passing in the same cachedIter).

Like itemize, but the base direction to use when computing bidirectional levels (see pango_context_set_base_dir ()), is specified explicitly rather than gotten from the Context.

Since: 1.4

This will return the bidirectional embedding levels of the input paragraph as defined by the Unicode Bidirectional Algorithm available at:

http://www.unicode.org/reports/tr9/

If the input base direction is a weak direction, the direction of the characters in the text will determine the final resolved direction.

Since: 1.4

After feeding a pango markup parser some data with markupParseContextParse, use this function to get the list of pango attributes and text out of the markup. This function will not free context, use markupParseContextFree to do so.

Since: 1.31.0

Parses marked-up text (see <link linkend="PangoMarkupFormat">markup format</link>) to create a plain-text string and an attribute list.

If accelMarker is nonzero, the given character will mark the character following it as an accelerator. For example, accelMarker might be an ampersand or underscore. All characters marked as an accelerator will receive a UnderlineLow attribute, and the first character so marked will be returned in accelChar, when calling finish(). Two accelMarker characters following each other produce a single literal accelMarker character.

To feed markup to the parser, use markupParseContextParse on the returned MarkupParseContext. When done with feeding markup to the parser, use markupParserFinish to get the data out of it, and then use markupParseContextFree to free it.

This function is designed for applications that read pango markup from streams. To simply parse a string containing pango markup, the simpler parseMarkup API is recommended instead.

Since: 1.31.0

Parses an enum type and stores the result in value.

If str does not match the nick name of any of the possible values for the enum and is not an integer, False is returned, a warning is issued if warn is True, and a string representing the list of possible values is stored in possibleValues. The list is slash-separated, eg. "none/start/middle/end". If failed and possibleValues is not Nothing, returned string should be freed using free.

Since: 1.16

Parses marked-up text (see <link linkend="PangoMarkupFormat">markup format</link>) to create a plain-text string and an attribute list.

If accelMarker is nonzero, the given character will mark the character following it as an accelerator. For example, accelMarker might be an ampersand or underscore. All characters marked as an accelerator will receive a UnderlineLow attribute, and the first character so marked will be returned in accelChar. Two accelMarker characters following each other produce a single literal accelMarker character.

To parse a stream of pango markup incrementally, use markupParserNew.

If any error happens, none of the output arguments are touched except for error.

Parses a font stretch. The allowed values are "ultra_condensed", "extra_condensed", "condensed", "semi_condensed", "normal", "semi_expanded", "expanded", "extra_expanded" and "ultra_expanded". Case variations are ignored and the '_' characters may be omitted.

Parses a font style. The allowed values are "normal", "italic" and "oblique", case variations being ignored.

Parses a font variant. The allowed values are "normal" and "smallcaps" or "small_caps", case variations being ignored.

Parses a font weight. The allowed values are "heavy", "ultrabold", "bold", "normal", "light", "ultraleight" and integers. Case variations are ignored.

Quantizes the thickness and position of a line, typically an underline or strikethrough, to whole device pixels, that is integer multiples of SCALE. The purpose of this function is to avoid such lines looking blurry.

Care is taken to make sure thickness is at least one pixel when this function returns, but returned position may become zero as a result of rounding.

Since: 1.12

Reads an entire line from a file into a buffer. Lines may be delimited with '\n', '\r', '\n\r', or '\r\n'. The delimiter is not written into the buffer. Text after a '#' character is treated as a comment and skipped. '\' can be used to escape a # character. '\' proceeding a line delimiter combines adjacent lines. A '\' proceeding any other character is ignored and written into the output buffer unmodified.

From a list of items in logical order and the associated directional levels, produce a list in visual order. The original list is unmodified.

Scans an integer. Leading white space is skipped.

Scans a string into a String buffer. The string may either be a sequence of non-white-space characters, or a quoted string with '"'. Instead a quoted string, '\"' represents a literal quote. Leading white space outside of quotes is skipped.

Scans a word into a String buffer. A word consists of [A-Za-z_] followed by zero or more [A-Za-z_0-9] Leading white space is skipped.

Given a segment of text and the corresponding Analysis structure returned from itemize, convert the characters into glyphs. You may also pass in only a substring of the item from itemize.

It is recommended that you use shapeFull instead, since that API allows for shaping interaction happening across text item boundaries.

Given a segment of text and the corresponding Analysis structure returned from itemize, convert the characters into glyphs. You may also pass in only a substring of the item from itemize.

This is similar to shape, except it also can optionally take the full paragraph text as input, which will then be used to perform certain cross-item shaping interactions. If you have access to the broader text of which itemText is part of, provide the broader text as paragraphText. If paragraphText is Nothing, item text is used instead.

Since: 1.32

Given a segment of text and the corresponding Analysis structure returned from itemize, convert the characters into glyphs. You may also pass in only a substring of the item from itemize.

This is similar to shapeFull, except it also takes flags that can influence the shaping process.

Since: 1.44

Skips 0 or more characters of white space.

Splits a SEARCHPATH_SEPARATOR-separated list of files, stripping white space and substituting ~/ with $HOME/.

Apply language-specific tailoring to the breaks in logAttrs, which are assumed to have been produced by defaultBreak.

If offset is not -1, it is used to apply attributes from analysis that are relevant to line breaking.

Since: 1.44

Trims leading and trailing whitespace from a string.

Determines the inherent direction of a character; either DirectionLtr, DirectionRtl, or DirectionNeutral.

This function is useful to categorize characters into left-to-right letters, right-to-left letters, and everything else. If full Unicode bidirectional type of a character is needed, bidiTypeForUnichar can be used instead.

Converts a floating-point number to Pango units: multiplies it by SCALE and rounds to nearest integer.

Since: 1.16

Converts a number in Pango units to floating-point: divides it by SCALE.

Since: 1.16

This is similar to the macro PANGO_VERSION except that it returns the encoded version of Pango available at run-time, as opposed to the version available at compile-time.

A version number can be encoded into an integer using PANGO_VERSION_ENCODE().

Since: 1.16

Checks that the Pango library in use is compatible with the given version. Generally you would pass in the constants PANGO_VERSION_MAJOR, PANGO_VERSION_MINOR, PANGO_VERSION_MICRO as the three arguments to this function; that produces a check that the library in use at run-time is compatible with the version of Pango the application or module was compiled against.

Compatibility is defined by two things: first the version of the running library is newer than the version requiredMajor.required_minor.requiredMicro. Second the running library must be binary compatible with the version requiredMajor.required_minor.requiredMicro (same major version.)

For compile-time version checking use PANGO_VERSION_CHECK().

Since: 1.16

This is similar to the macro PANGO_VERSION_STRING except that it returns the version of Pango available at run-time, as opposed to the version available at compile-time.

Since: 1.16