Deprecated X font backend

## Deprecated X font backend Deprecated X font backend — Font handling and rendering with the deprecated X font backend |

## Synopsis

    #define     PANGO_RENDER_TYPE_X
    PangoContext* pango_x_get_context           (Display *display);
    void        pango_x_context_set_funcs       (PangoContext *context,
                                                 PangoGetGCFunc get_gc_func,
                                                 PangoFreeGCFunc free_gc_func);
    GC          (*PangoGetGCFunc)               (PangoContext *context,
                                                 PangoColor *color,
                                                 GC base_gc);
    void        (*PangoFreeGCFunc)              (PangoContext *context,
                                                 GC gc);
    void        pango_x_render                  (Display *display,
                                                 Drawable d,
                                                 GC gc,
                                                 PangoFont *font,
                                                 PangoGlyphString *glyphs,
                                                 gint x,
                                                 gint y);
    void        pango_x_render_layout_line      (Display *display,
                                                 Drawable drawable,
                                                 GC gc,
                                                 PangoLayoutLine *line,
                                                 int x,
                                                 int y);
    void        pango_x_render_layout           (Display *display,
                                                 Drawable drawable,
                                                 GC gc,
                                                 PangoLayout *layout,
                                                 int x,
                                                 int y);
    typedef     PangoXSubfont;
    #define     PANGO_X_MAKE_GLYPH              (subfont,index_)
    #define     PANGO_X_GLYPH_SUBFONT           (glyph)
    #define     PANGO_X_GLYPH_INDEX             (glyph)
    PangoFont*  pango_x_load_font               (Display *display,
                                                 const gchar *spec);
    PangoGlyph  pango_x_get_unknown_glyph       (PangoFont *font);
    gboolean    pango_x_has_glyph               (PangoFont *font,
                                                 PangoGlyph glyph);
    int         pango_x_list_subfonts           (PangoFont *font,
                                                 char **charsets,
                                                 int n_charsets,
                                                 PangoXSubfont **subfont_ids,
                                                 int **subfont_charsets);
    PangoFontMap* pango_x_font_map_for_display  (Display *display);
    void        pango_x_shutdown_display        (Display *display);
    PangoXFontCache* pango_x_font_map_get_font_cache
                                                (PangoFontMap *font_map);
    char*       pango_x_font_subfont_xlfd       (PangoFont *font,
                                                 PangoXSubfont subfont_id);
    gboolean    pango_x_find_first_subfont      (PangoFont *font,
                                                 char **charsets,
                                                 int n_charsets,
                                                 PangoXSubfont *rfont);
    PangoGlyph  pango_x_font_get_unknown_glyph  (PangoFont *font,
                                                 gunichar wc);
    gboolean    pango_x_apply_ligatures         (PangoFont *font,
                                                 PangoXSubfont subfont,
                                                 gunichar **glyphs,
                                                 int *n_glyphs,
                                                 int **clusters);
    void        pango_x_fallback_shape          (PangoFont *font,
                                                 PangoGlyphString *glyphs,
                                                 const char *text,
                                                 int n_chars);
                PangoXFontCache;
    PangoXFontCache* pango_x_font_cache_new     (Display *display);
    void        pango_x_font_cache_free         (PangoXFontCache *cache);
    XFontStruct* pango_x_font_cache_load        (PangoXFontCache *cache,
                                                 const char *xlfd);
    void        pango_x_font_cache_unload       (PangoXFontCache *cache,
                                                 XFontStruct *fs);

## Description

The functions and macros in this section are for use with the old X font backend which used server-side bitmap fonts. This font backend is no longer supported, and attempts to use it will produce unpredictable results. Use the Xft or Cairo backend instead.

## Details

### PANGO_RENDER_TYPE_X

    #define PANGO_RENDER_TYPE_X "PangoRenderX"

### Warning

`PANGO_RENDER_TYPE_X` is deprecated and should not be used in newly-written code.

A string constant identifying the X renderer. The associated quark (see `g_quark_from_string()`) is used to identify the renderer in `pango_find_map()`.

### pango_x_get_context ()

    PangoContext* pango_x_get_context           (Display *display);

### Warning

`pango_x_get_context` is deprecated and should not be used in newly-written code.

Retrieves a PangoContext appropriate for rendering with X fonts on the given display.

`display` : | an X display (As returned by `XOpenDisplay()`.)
Returns : | the new PangoContext.

### pango_x_context_set_funcs ()

    void        pango_x_context_set_funcs       (PangoContext *context,
                                                 PangoGetGCFunc get_gc_func,
                                                 PangoFreeGCFunc free_gc_func);

### Warning

`pango_x_context_set_funcs` is deprecated and should not be used in newly-written code.

Sets the functions that will be used to get GC's in various colors when rendering layouts with this context.

`context` : | a PangoContext.
`get_gc_func` : | function called to create a new GC for a given color.
`free_gc_func` : | function called to free a GC created with `get_gc_func`.

### PangoGetGCFunc ()

    GC          (*PangoGetGCFunc)               (PangoContext *context,
                                                 PangoColor *color,
                                                 GC base_gc);

### Warning

`PangoGetGCFunc` is deprecated and should not be used in newly-written code.

Specifies the type of the function used to create a new GC for a given color.

`context` : | a PangoContext.
`color` : | the color to create a new GC for.
`base_gc` : | the GC to base the new GC on.
Returns : | the new GC.

### PangoFreeGCFunc ()

    void        (*PangoFreeGCFunc)              (PangoContext *context,
                                                 GC gc);

### Warning

`PangoFreeGCFunc` is deprecated and should not be used in newly-written code.

Specifies the type of the function used to free a GC created with the corresponding PangoGetGCFunc function.

`context` : | a PangoContext.
`gc` : | the GC to free.

### pango_x_render ()

    void        pango_x_render                  (Display *display,
                                                 Drawable d,
                                                 GC gc,
                                                 PangoFont *font,
                                                 PangoGlyphString *glyphs,
                                                 gint x,
                                                 gint y);

### Warning

`pango_x_render` is deprecated and should not be used in newly-written code.

Renders a PangoGlyphString onto an X drawable.

`display` : | the X display.
`d` : | the drawable on which to draw string.
`gc` : | the graphics context.
`font` : | the font in which to draw the string.
`glyphs` : | the glyph string to draw.
`x` : | the x position of start of string (in pixels).
`y` : | the y position of baseline (in pixels).

### pango_x_render_layout_line ()

    void        pango_x_render_layout_line      (Display *display,
                                                 Drawable drawable,
                                                 GC gc,
                                                 PangoLayoutLine *line,
                                                 int x,
                                                 int y);

### Warning

`pango_x_render_layout_line` is deprecated and should not be used in newly-written code.

Renders a PangoLayoutLine onto an X drawable.

`display` : | the X display.
`drawable` : | the drawable on which to draw.
`gc` : | GC to use for uncolored drawing.
`line` : | a PangoLayoutLine.
`x` : | the x position of start of string (in pixels).
`y` : | the y position of baseline (in pixels).

### pango_x_render_layout ()

    void        pango_x_render_layout           (Display *display,
                                                 Drawable drawable,
                                                 GC gc,
                                                 PangoLayout *layout,
                                                 int x,
                                                 int y);

### Warning

`pango_x_render_layout` is deprecated and should not be used in newly-written code.

Renders a PangoLayout onto an X drawable.

`display` : | the X display.
`drawable` : | the drawable on which to draw.
`gc` : | GC to use for uncolored drawing.
`layout` : | a PangoLayout.
`x` : | the x position of the left of the layout (in pixels).
`y` : | the y position of the top of the layout (in pixels).

### PangoXSubfont

    typedef guint16 PangoXSubfont;

### Warning

`PangoXSubfont` is deprecated and should not be used in newly-written code.

The PangoXSubFont type is an integer ID that identifies one particular X font within the fonts referenced in a PangoFont.

### PANGO_X_MAKE_GLYPH()

    #define PANGO_X_MAKE_GLYPH(subfont,index_) ((subfont)<<16 | (index_))

### Warning

`PANGO_X_MAKE_GLYPH` is deprecated and should not be used in newly-written code.

Make a glyph index from a PangoXSubFont index and a index of a character with the corresponding X font.

`subfont` : | a PangoXSubfont index
`index_` : | the index of a character within an X font.

### PANGO_X_GLYPH_SUBFONT()

    #define PANGO_X_GLYPH_SUBFONT(glyph) ((glyph)>>16)

### Warning

`PANGO_X_GLYPH_SUBFONT` is deprecated and should not be used in newly-written code.

Extract the subfont index from a glyph index.

`glyph` : | a PangoGlyphIndex

### PANGO_X_GLYPH_INDEX()

    #define PANGO_X_GLYPH_INDEX(glyph) ((glyph) & 0xffff)

### Warning

`PANGO_X_GLYPH_INDEX` is deprecated and should not be used in newly-written code.

Extract the character index within the X font from a glyph index.

`glyph` : | a PangoGlyphIndex

### pango_x_load_font ()

    PangoFont*  pango_x_load_font               (Display *display,
                                                 const gchar *spec);

### Warning

`pango_x_load_font` is deprecated and should not be used in newly-written code.

Loads up a logical font based on a "fontset" style text specification. This is not remotely useful (Pango API's generally work in terms of PangoFontDescription) and the result may not work correctly in all circumstances. Use of this function should be avoided.

`display` : | the X display.
`spec` : | a comma-separated list of XLFD's.
Returns : | a new PangoFont.

### pango_x_get_unknown_glyph ()

    PangoGlyph  pango_x_get_unknown_glyph       (PangoFont *font);

### Warning

`pango_x_get_unknown_glyph` is deprecated and should not be used in newly-written code.

Returns the index of a glyph suitable for drawing unknown characters; you should generally use `PANGO_GET_UNKNOWN_GLYPH()` instead, since that may return a glyph that provides a better representation of a particular char. (E.g., by showing hex digits, or a glyph representive of a certain Unicode range.)

`font` : | a PangoFont.
Returns : | a glyph index into `font`.

### pango_x_has_glyph ()

    gboolean    pango_x_has_glyph               (PangoFont *font,
                                                 PangoGlyph glyph);

### Warning

`pango_x_has_glyph` is deprecated and should not be used in newly-written code.

Checks if the given glyph is present in a X font.

`font` : | a PangoFont which must be from the X backend.
`glyph` : | the index of a glyph in the font. (Formed using the PANGO_X_MAKE_GLYPH macro)
Returns : | `TRUE` if the glyph is present.

### pango_x_list_subfonts ()

    int         pango_x_list_subfonts           (PangoFont *font,
                                                 char **charsets,
                                                 int n_charsets,
                                                 PangoXSubfont **subfont_ids,
                                                 int **subfont_charsets);

### Warning

`pango_x_list_subfonts` is deprecated and should not be used in newly-written code.

Lists the subfonts of a given font. The result is ordered first by charset, and then within each charset, by the order of fonts in the font specification.

`font` : | a PangoFont.
`charsets` : | the charsets to list subfonts for.
`n_charsets` : | the number of charsets in `charsets`.
`subfont_ids` : | location to store a pointer to an array of subfont IDs for each found subfont; the result must be freed using `g_free()`.
`subfont_charsets` : | location to store a pointer to an array of subfont IDs for each found subfont; the result must be freed using `g_free()`.
Returns : | length of the arrays stored in `subfont_ids` and `subfont_charsets`.

### pango_x_font_map_for_display ()

    PangoFontMap* pango_x_font_map_for_display  (Display *display);

### Warning

`pango_x_font_map_for_display` is deprecated and should not be used in newly-written code.

Returns a PangoXFontMap for `display`. Font maps are cached and should not be freed. If the font map for a display is no longer needed, it can be released with `pango_x_shutdown_display()`.

`display` : | an X Display.
Returns : | a PangoXFontMap for `display`.

### pango_x_shutdown_display ()

    void        pango_x_shutdown_display        (Display *display);

### Warning

`pango_x_shutdown_display` is deprecated and should not be used in newly-written code.

Free cached resources for the given X display structure.

`display` : | an X Display

### pango_x_font_map_get_font_cache ()

    PangoXFontCache* pango_x_font_map_get_font_cache
                                                (PangoFontMap *font_map);

### Warning

`pango_x_font_map_get_font_cache` is deprecated and should not be used in newly-written code.

Obtains the font cache associated with the given font map.

`font_map` : | a PangoXFontMap.
Returns : | the PangoXFontCache of `font_map`.

### pango_x_font_subfont_xlfd ()

    char*       pango_x_font_subfont_xlfd       (PangoFont *font,
                                                 PangoXSubfont subfont_id);

### Warning

`pango_x_font_subfont_xlfd` is deprecated and should not be used in newly-written code.

Determines the X Logical Font Description for the specified subfont.

`font` : | a PangoFont which must be from the X backend.
`subfont_id` : | the id of a subfont within the font.
Returns : | A newly-allocated string containing the XLFD for the subfont. This string must be freed with `g_free()`.

### pango_x_find_first_subfont ()

    gboolean    pango_x_find_first_subfont      (PangoFont *font,
                                                 char **charsets,
                                                 int n_charsets,
                                                 PangoXSubfont *rfont);

### Warning

`pango_x_find_first_subfont` is deprecated and should not be used in newly-written code.

Looks for subfonts with the `charset` charset, in `font`, and puts the first one in *`rfont`.

`font` : | A PangoFont.
`charsets` : | An array of charsets.
`n_charsets` : | The number of charsets in `charsets`.
`rfont` : | A pointer to a PangoXSubfont.
Returns : | `TRUE` if *`rfont` now contains a font.

### pango_x_font_get_unknown_glyph ()

    PangoGlyph  pango_x_font_get_unknown_glyph  (PangoFont *font,
                                                 gunichar wc);

### Warning

`pango_x_font_get_unknown_glyph` is deprecated and should not be used in newly-written code.

Returns the index of a glyph suitable for drawing `wc` as an unknown character.

Use `PANGO_GET_UNKNOWN_GLYPH()` instead.

`font` : | a PangoFont.
`wc` : | the Unicode character for which a glyph is needed.
Returns : | a glyph index into `font`.

### pango_x_apply_ligatures ()

    gboolean    pango_x_apply_ligatures         (PangoFont *font,
                                                 PangoXSubfont subfont,
                                                 gunichar **glyphs,
                                                 int *n_glyphs,
                                                 int **clusters);

### Warning

`pango_x_apply_ligatures` is deprecated and should not be used in newly-written code.

Previously did subfont-specific ligation. Now a no-op.

`font` : | unused
`subfont` : | unused
`glyphs` : | unused
`n_glyphs` : | unused
`clusters` : | unused
Returns : | `FALSE`, always.

### pango_x_fallback_shape ()

    void        pango_x_fallback_shape          (PangoFont *font,
                                                 PangoGlyphString *glyphs,
                                                 const char *text,
                                                 int n_chars);

### Warning

`pango_x_fallback_shape` is deprecated and should not be used in newly-written code.

This is a simple fallback shaper, that can be used if no subfont that supports a given script is found. For every character in `text`, it puts the unknown glyph.

`font` : | A PangoFont.
`glyphs` : | A pointer to a PangoGlyphString.
`text` : | UTF-8 string.
`n_chars` : | Number of UTF-8 seqs in `text`.

### PangoXFontCache

    typedef struct _PangoXFontCache PangoXFontCache;

### Warning

`PangoXFontCache` is deprecated and should not be used in newly-written code.

A PangoXFontCache caches XFontStructs for a single display by their XLFD name.

### pango_x_font_cache_new ()

    PangoXFontCache* pango_x_font_cache_new     (Display *display);

### Warning

`pango_x_font_cache_new` is deprecated and should not be used in newly-written code.

Creates a font cache for the specified display.

`display` : | an X display.
Returns : | The newly allocated PangoXFontCache, which should be freed with `pango_x_font_cache_free()`.

### pango_x_font_cache_free ()

    void        pango_x_font_cache_free         (PangoXFontCache *cache);

### Warning

`pango_x_font_cache_free` is deprecated and should not be used in newly-written code.

Frees a PangoXFontCache and all associated memory. All fonts loaded through this font cache will be freed along with the cache.

`cache` : | a PangoXFontCache

### pango_x_font_cache_load ()

    XFontStruct* pango_x_font_cache_load        (PangoXFontCache *cache,
                                                 const char *xlfd);

### Warning

`pango_x_font_cache_load` is deprecated and should not be used in newly-written code.

Loads a XFontStruct from a X Logical Font Description. The result may be newly loaded, or it may have been previously stored.

`cache` : | a PangoXFontCache
`xlfd` : | the X Logical Font Description to load.
Returns : | The font structure, or `NULL` if the font could not be loaded. In order to free this structure, you must call `pango_x_font_cache_unload()`.

### pango_x_font_cache_unload ()

    void        pango_x_font_cache_unload       (PangoXFontCache *cache,
                                                 XFontStruct *fs);

### Warning

`pango_x_font_cache_unload` is deprecated and should not be used in newly-written code.

Frees a font structure previously loaded with `pango_x_font_cache_load()`.

`cache` : | a PangoXFontCache
`fs` : | the font structure to unload