Decoder#

Added in version 1.6.

class Decoder(**properties: Any)#

Superclasses: Object

PangoFcDecoder is a virtual base class that implementations will inherit from.

It’s the interface that is used to define a custom encoding for a font. These objects are created in your code from a function callback that was originally registered with add_decoder_find_func. Pango requires information about the supported charset for a font as well as the individual character to glyph conversions. Pango gets that information via the get_charset and get_glyph callbacks into your object implementation.

Methods#

class Decoder
do_get_charset(self, fcfont: Font) → CharSet#
Parameters:

fcfont

do_get_glyph(self, fcfont: Font, wc: int) → int#
Parameters:

  • fcfont

  • wc

get_charset(fcfont: Font) → CharSet#

Generates an FcCharSet of supported characters for the fcfont given.

The returned FcCharSet will be a reference to an internal value stored by the PangoFcDecoder and must not be modified or freed.

Added in version 1.6.

Parameters:

fcfont – the PangoFcFont to query.

get_glyph(fcfont: Font, wc: int) → int#

Generates a PangoGlyph for the given Unicode point using the custom decoder.

For complex scripts where there can be multiple glyphs for a single character, the decoder will return whatever glyph is most convenient for it. (Usually whatever glyph is directly in the fonts character map table.)

Added in version 1.6.

Parameters:

  • fcfont – a PangoFcFont to query.

  • wc – the Unicode code point to convert to a single PangoGlyph.

Virtual Methods#

class Decoder
do_get_charset(fcfont: Font) → CharSet#

Generates an FcCharSet of supported characters for the fcfont given.

The returned FcCharSet will be a reference to an internal value stored by the PangoFcDecoder and must not be modified or freed.

Added in version 1.6.

Parameters:

fcfont – the PangoFcFont to query.

do_get_glyph(fcfont: Font, wc: int) → int#

Generates a PangoGlyph for the given Unicode point using the custom decoder.

For complex scripts where there can be multiple glyphs for a single character, the decoder will return whatever glyph is most convenient for it. (Usually whatever glyph is directly in the fonts character map table.)

Added in version 1.6.

Parameters:

  • fcfont – a PangoFcFont to query.

  • wc – the Unicode code point to convert to a single PangoGlyph.

Fields#

class Decoder
parent_instance#