GdkFont

typedef struct {
  GdkFontType type;
  gint ascent;
  gint descent;
} GdkFont;

The GdkFont structure represents a font or fontset. It contains the following public fields. A new GdkFont structure is returned by gdk_font_load() or gdk_fontset_load(), and is reference counted with gdk_font_ref() and gdk_font_unref()

enum GdkFontType

typedef enum
{
  GDK_FONT_FONT,
  GDK_FONT_FONTSET
} GdkFontType;

Indicates the type of a font. The possible values are currently:

gdk_font_load ()

GdkFont*    gdk_font_load                   (const gchar *font_name);

Loads a font.

The font may be newly loaded or looked up the font in a cache. You should make no assumptions about the initial reference count.

gdk_font_load_for_display ()

GdkFont*    gdk_font_load_for_display       (GdkDisplay *display,
                                             const gchar *font_name);

Loads a font for use on display.

The font may be newly loaded or looked up the font in a cache. You should make no assumptions about the initial reference count.

Since 2.2

gdk_fontset_load ()

GdkFont*    gdk_fontset_load                (const gchar *fontset_name);

Loads a fontset.

The fontset may be newly loaded or looked up in a cache. You should make no assumptions about the initial reference count.

gdk_fontset_load_for_display ()

GdkFont*    gdk_fontset_load_for_display    (GdkDisplay *display,
                                             const gchar *fontset_name);

Loads a fontset for use on display.

The fontset may be newly loaded or looked up in a cache. You should make no assumptions about the initial reference count.

Since 2.2

gdk_font_from_description ()

GdkFont*    gdk_font_from_description       (PangoFontDescription *font_desc);

Load a GdkFont based on a Pango font description. This font will only be an approximation of the Pango font, and internationalization will not be handled correctly. This function should only be used for legacy code that cannot be easily converted to use Pango. Using Pango directly will produce better results.

gdk_font_from_description_for_display ()

GdkFont*    gdk_font_from_description_for_display
                                            (GdkDisplay *display,
                                             PangoFontDescription *font_desc);

Loads a GdkFont based on a Pango font description for use on display. This font will only be an approximation of the Pango font, and internationalization will not be handled correctly. This function should only be used for legacy code that cannot be easily converted to use Pango. Using Pango directly will produce better results.

Since 2.2

gdk_font_get_display ()

GdkDisplay* gdk_font_get_display            (GdkFont *font);

Returns the GdkDisplay for font.

Since 2.2

gdk_font_ref ()

GdkFont*    gdk_font_ref                    (GdkFont *font);

Increases the reference count of a font by one.

gdk_font_unref ()

void        gdk_font_unref                  (GdkFont *font);

Decreases the reference count of a font by one. If the result is zero, destroys the font.

gdk_font_id ()

gint        gdk_font_id                     (const GdkFont *font);

Returns the X Font ID for the given font.

gdk_font_equal ()

gboolean    gdk_font_equal                  (const GdkFont *fonta,
                                             const GdkFont *fontb);

Compares two fonts for equality. Single fonts compare equal if they have the same X font ID. This operation does not currently work correctly for fontsets.

gdk_string_extents ()

void        gdk_string_extents              (GdkFont *font,
                                             const gchar *string,
                                             gint *lbearing,
                                             gint *rbearing,
                                             gint *width,
                                             gint *ascent,
                                             gint *descent);

Gets the metrics of a nul-terminated string.

gdk_text_extents ()

void        gdk_text_extents                (GdkFont *font,
                                             const gchar *text,
                                             gint text_length,
                                             gint *lbearing,
                                             gint *rbearing,
                                             gint *width,
                                             gint *ascent,
                                             gint *descent);

Gets the metrics of a string.

gdk_text_extents_wc ()

void        gdk_text_extents_wc             (GdkFont *font,
                                             const GdkWChar *text,
                                             gint text_length,
                                             gint *lbearing,
                                             gint *rbearing,
                                             gint *width,
                                             gint *ascent,
                                             gint *descent);

Gets the metrics of a string of wide characters.

gdk_string_width ()

gint        gdk_string_width                (GdkFont *font,
                                             const gchar *string);

Determines the width of a nul-terminated string. (The distance from the origin of the string to the point where the next string in a sequence of strings should be drawn)

gdk_text_width ()

gint        gdk_text_width                  (GdkFont *font,
                                             const gchar *text,
                                             gint text_length);

Determines the width of a given string.

gdk_text_width_wc ()

gint        gdk_text_width_wc               (GdkFont *font,
                                             const GdkWChar *text,
                                             gint text_length);

Determines the width of a given wide-character string.

gdk_char_width ()

gint        gdk_char_width                  (GdkFont *font,
                                             gchar character);

Determines the width of a given character.

gdk_char_width_wc ()

gint        gdk_char_width_wc               (GdkFont *font,
                                             GdkWChar character);

Determines the width of a given wide character. (Encoded in the wide-character encoding of the current locale).

gdk_string_measure ()

gint        gdk_string_measure              (GdkFont *font,
                                             const gchar *string);

Determines the distance from the origin to the rightmost portion of a nul-terminated string when drawn. This is not the correct value for determining the origin of the next portion when drawing text in multiple pieces. See gdk_string_width().

gdk_text_measure ()

gint        gdk_text_measure                (GdkFont *font,
                                             const gchar *text,
                                             gint text_length);

Determines the distance from the origin to the rightmost portion of a string when drawn. This is not the correct value for determining the origin of the next portion when drawing text in multiple pieces. See gdk_text_width().

gdk_char_measure ()

gint        gdk_char_measure                (GdkFont *font,
                                             gchar character);

Determines the distance from the origin to the rightmost portion of a character when drawn. This is not the correct value for determining the origin of the next portion when drawing text in multiple pieces.

gdk_string_height ()

gint        gdk_string_height               (GdkFont *font,
                                             const gchar *string);

Determines the total height of a given nul-terminated string. This value is not generally useful, because you cannot determine how this total height will be drawn in relation to the baseline. See gdk_string_extents().

gdk_text_height ()

gint        gdk_text_height                 (GdkFont *font,
                                             const gchar *text,
                                             gint text_length);

Determines the total height of a given string. This value is not generally useful, because you cannot determine how this total height will be drawn in relation to the baseline. See gdk_text_extents().

gdk_char_height ()

gint        gdk_char_height                 (GdkFont *font,
                                             gchar character);

Determines the total height of a given character. This value is not generally useful, because you cannot determine how this total height will be drawn in relation to the baseline. See gdk_text_extents().

GdkWChar

typedef guint32			    GdkWChar;

Specifies a wide character type, used to represent character codes. This is needed since some native languages have character sets which have more than 256 characters (Japanese and Chinese, for example).

Wide character values between 0 and 127 are always identical in meaning to the ASCII character codes. The wide character value 0 is often used to terminate strings of wide characters in a similar way to normal strings using the char type.

An alternative to wide characters is multi-byte characters, which extend normal char strings to cope with larger character sets. As the name suggests, multi-byte characters use a different number of bytes to store different character codes. For example codes 0-127 (i.e. the ASCII codes) often use just one byte of memory, while other codes may use 2, 3 or even 4 bytes. Multi-byte characters have the advantage that they can often be used in an application with little change, since strings are still represented as arrays of char values. However multi-byte strings are much easier to manipulate since the character are all of the same size.

Applications typically use wide characters to represent character codes internally, and multi-byte strings when saving the characters to a file. The gdk_wcstombs() and gdk_mbstowcs() functions can be used to convert from one representation to the other.

See the 'Extended Characters' section of the GNU C Library Reference Manual for more detailed information on wide and multi-byte characters.

gdk_wcstombs ()

gchar*      gdk_wcstombs                    (const GdkWChar *src);

Converts a wide character string to a multi-byte string. (The function name comes from an acronym of 'Wide Character String TO Multi-Byte String').

gdk_mbstowcs ()

gint        gdk_mbstowcs                    (GdkWChar *dest,
                                             const gchar *src,
                                             gint dest_max);

Converts a multi-byte string to a wide character string. (The function name comes from an acronym of 'Multi-Byte String TO Wide Character String').