manpagez: man pages & more
html files: pango
Home | html | info | man


PangoEngineShape — Rendering-system dependent script engines

Stability Level

Unstable, unless otherwise indicated


Object Hierarchy

    ╰── PangoEngine
        ╰── PangoEngineShape


The shape engines are rendering-system dependent engines that convert character strings into glyph strings. These engines are used in pango_shape().



#define             PANGO_ENGINE_SHAPE_DEFINE_TYPE(name, prefix, class_init, instance_init)

PANGO_ENGINE_SHAPE_DEFINE_TYPE has been deprecated since version 1.38 and should not be used in newly-written code.

Outputs the necessary code for GObject type registration for a PangoEngineShape class defined in a module. Two static symbols are defined.

 static GType prefix_type;
 static void prefix_register_type (GTypeModule module);

The prefix_register_type() function should be called in your script_engine_init() function for each type that your module implements, and then your script_engine_create() function can create instances of the object as follows:

PangoEngine *engine = g_object_new (<em class="replaceable"><code>prefix</code></em>_type, NULL);



Name of the the type to register (for example:, ArabicEngineFc



Prefix for symbols that will be defined (for example:, arabic_engine_fc



Class initialization function for the new type, or NULL.



Instance initialization function for the new type, or NULL.


Types and Values


typedef struct _PangoEngineShape PangoEngineShape;

PangoEngineShape has been deprecated since version 1.38 and should not be used in newly-written code.

The PangoEngineShape class is implemented by engines that customize the rendering-system dependent part of the Pango pipeline for a particular script or language. A PangoEngineShape implementation is then specific to both a particular rendering system or group of rendering systems and to a particular script. For instance, there is one PangoEngineShape implementation to handle shaping Arabic for Fontconfig-based backends.

struct PangoEngineShapeClass

struct PangoEngineShapeClass {
  void (*script_shape) (PangoEngineShape    *engine,
			PangoFont           *font,
			const char          *item_text,
			unsigned int         item_length,
			const PangoAnalysis *analysis,
			PangoGlyphString    *glyphs,
			const char          *paragraph_text,
			unsigned int         paragraph_length);
  PangoCoverageLevel (*covers)   (PangoEngineShape *engine,
				  PangoFont        *font,
				  PangoLanguage    *language,
				  gunichar          wc);

PangoEngineShapeClass has been deprecated since version 1.38 and should not be used in newly-written code.

Class structure for PangoEngineShape


script_shape ()

Given a font, a piece of text, and a PangoAnalysis structure, converts characters to glyphs and positions the resulting glyphs. The results are stored in the PangoGlyphString that is passed in. (The implementation should resize it appropriately using pango_glyph_string_set_size()). All fields of the log_clusters and glyphs array must be filled in, with the exception that Pango will automatically generate glyphs->glyphs[i].attr.is_cluster_start using the log_clusters array. Each input character must occur in one of the output logical clusters; if no rendering is desired for a character, this may involve inserting glyphs with the PangoGlyph ID PANGO_GLYPH_EMPTY, which is guaranteed never to render. If the shaping fails for any reason, the shaper should return with an empty (zero-size) glyph string. If the shaper has not set the size on the glyph string yet, simply returning signals the failure too.


covers ()

Returns the characters that this engine can cover with a given font for a given language. If not overridden, the default implementation simply returns the coverage information for the font itself unmodified.



#define PANGO_ENGINE_TYPE_SHAPE "PangoEngineShape"

PANGO_ENGINE_TYPE_SHAPE has been deprecated since version 1.38 and should not be used in newly-written code.

A string constant defining the engine type for shaping engines. These engines derive from PangoEngineShape.

© 2000-2024
Individual documents may contain additional copyright information.