gdkfont.c 9.12 KB
Newer Older
Elliot Lee's avatar
Elliot Lee committed
1 2 3 4
/* GDK - The GIMP Drawing Kit
 * Copyright (C) 1995-1997 Peter Mattis, Spencer Kimball and Josh MacDonald
 *
 * This library is free software; you can redistribute it and/or
5
 * modify it under the terms of the GNU Lesser General Public
Elliot Lee's avatar
Elliot Lee committed
6 7 8 9 10 11
 * License as published by the Free Software Foundation; either
 * version 2 of the License, or (at your option) any later version.
 *
 * This library is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
12
 * Lesser General Public License for more details.
Elliot Lee's avatar
Elliot Lee committed
13
 *
14
 * You should have received a copy of the GNU Lesser General Public
15 16 17
 * License along with this library; if not, write to the
 * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
 * Boston, MA 02111-1307, USA.
Elliot Lee's avatar
Elliot Lee committed
18
 */
19 20

/*
21
 * Modified by the GTK+ Team and others 1997-2000.  See the AUTHORS
22 23 24 25 26
 * file for a list of people on the GTK+ Team.  See the ChangeLog
 * files for a list of changes.  These files are distributed with
 * GTK+ at ftp://ftp.gtk.org/pub/gtk/. 
 */

Manish Singh's avatar
Manish Singh committed
27 28
#undef GDK_DISABLE_DEPRECATED

29
#include "gdkdisplay.h"
Owen Taylor's avatar
Started  
Owen Taylor committed
30
#include "gdkfont.h"
31
#include "gdkinternals.h"
Elliot Lee's avatar
Elliot Lee committed
32

33 34 35 36 37 38 39 40
GType
gdk_font_get_type (void)
{
  static GType our_type = 0;
  
  if (our_type == 0)
    our_type = g_boxed_type_register_static ("GdkFont",
					     (GBoxedCopyFunc)gdk_font_ref,
Alexander Larsson's avatar
Alexander Larsson committed
41
					     (GBoxedFreeFunc)gdk_font_unref);
42 43 44
  return our_type;
}

45 46 47 48 49 50 51 52
/**
 * gdk_font_ref:
 * @font: a #GdkFont
 * 
 * Increases the reference count of a font by one.
 * 
 * Return value: @font
 **/
53 54
GdkFont*
gdk_font_ref (GdkFont *font)
Elliot Lee's avatar
Elliot Lee committed
55 56 57
{
  GdkFontPrivate *private;

58
  g_return_val_if_fail (font != NULL, NULL);
Elliot Lee's avatar
Elliot Lee committed
59 60

  private = (GdkFontPrivate*) font;
61 62
  private->ref_count += 1;
  return font;
Elliot Lee's avatar
Elliot Lee committed
63 64
}

65 66 67 68 69 70 71
/**
 * gdk_font_unref:
 * @font: a #GdkFont
 * 
 * Decreases the reference count of a font by one.
 * If the result is zero, destroys the font.
 **/
Elliot Lee's avatar
Elliot Lee committed
72
void
73
gdk_font_unref (GdkFont *font)
Elliot Lee's avatar
Elliot Lee committed
74 75
{
  GdkFontPrivate *private;
76
  private = (GdkFontPrivate*) font;
Elliot Lee's avatar
Elliot Lee committed
77 78

  g_return_if_fail (font != NULL);
79
  g_return_if_fail (private->ref_count > 0);
Elliot Lee's avatar
Elliot Lee committed
80 81 82

  private->ref_count -= 1;
  if (private->ref_count == 0)
83
    _gdk_font_destroy (font);
Elliot Lee's avatar
Elliot Lee committed
84 85
}

86 87 88 89 90 91 92 93 94 95 96 97
/**
 * gdk_string_width:
 * @font:  a #GdkFont
 * @string: the nul-terminated string to measure
 * 
 * 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)
 * 
 * Return value: the width of the string in pixels.
 **/
Elliot Lee's avatar
Elliot Lee committed
98 99 100 101 102 103 104
gint
gdk_string_width (GdkFont     *font,
		  const gchar *string)
{
  g_return_val_if_fail (font != NULL, -1);
  g_return_val_if_fail (string != NULL, -1);

105
  return gdk_text_width (font, string, _gdk_font_strlen (font, string));
Elliot Lee's avatar
Elliot Lee committed
106 107
}

108 109 110 111 112 113 114 115 116
/**
 * gdk_char_width:
 * @font: a #GdkFont
 * @character: the character to measure.
 * 
 * Determines the width of a given character.
 * 
 * Return value: the width of the character in pixels.
 **/
Elliot Lee's avatar
Elliot Lee committed
117 118 119 120 121 122
gint
gdk_char_width (GdkFont *font,
		gchar    character)
{
  g_return_val_if_fail (font != NULL, -1);

123
  return gdk_text_width (font, &character, 1);
Elliot Lee's avatar
Elliot Lee committed
124 125
}

126 127 128 129 130 131 132 133 134 135
/**
 * gdk_char_width_wc:
 * @font: a #GdkFont
 * @character: the character to measure.
 * 
 * Determines the width of a given wide character. (Encoded
 * in the wide-character encoding of the current locale).
 * 
 * Return value: the width of the character in pixels.
 **/
136 137 138 139 140 141
gint
gdk_char_width_wc (GdkFont *font,
		   GdkWChar character)
{
  g_return_val_if_fail (font != NULL, -1);

142
  return gdk_text_width_wc (font, &character, 1);
143 144
}

145 146 147 148 149 150 151 152 153 154 155 156 157
/**
 * gdk_string_measure:
 * @font: a #GdkFont
 * @string: the nul-terminated string to measure.
 * 
 * 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().
 * 
 * Return value: the right bearing of the string in pixels.
 **/
Elliot Lee's avatar
Elliot Lee committed
158 159 160 161 162 163 164
gint
gdk_string_measure (GdkFont     *font,
                    const gchar *string)
{
  g_return_val_if_fail (font != NULL, -1);
  g_return_val_if_fail (string != NULL, -1);

165
  return gdk_text_measure (font, string, _gdk_font_strlen (font, string));
Owen Taylor's avatar
Owen Taylor committed
166 167
}

168 169 170 171 172 173 174 175 176 177
/**
 * gdk_string_extents:
 * @font: a #GdkFont.
 * @string: the nul-terminated string to measure.
 * @lbearing: the left bearing of the string.
 * @rbearing: the right bearing of the string.
 * @width: the width of the string.
 * @ascent: the ascent of the string.
 * @descent: the descent of the string.
 * 
178
 * Gets the metrics of a nul-terminated string.
179
 **/
180 181 182 183 184 185 186 187 188 189 190 191
void
gdk_string_extents (GdkFont     *font,
		    const gchar *string,
		    gint        *lbearing,
		    gint        *rbearing,
		    gint        *width,
		    gint        *ascent,
		    gint        *descent)
{
  g_return_if_fail (font != NULL);
  g_return_if_fail (string != NULL);

192
  gdk_text_extents (font, string, _gdk_font_strlen (font, string),
193 194 195 196
		    lbearing, rbearing, width, ascent, descent);
}


197 198 199 200 201 202 203 204 205 206 207 208 209 210
/**
 * gdk_text_measure:
 * @font: a #GdkFont
 * @text: the text to measure.
 * @text_length: the length of the text in bytes.
 * 
 * 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().
 * 
 * Return value: the right bearing of the string in pixels.
 **/
Elliot Lee's avatar
Elliot Lee committed
211 212 213 214 215
gint
gdk_text_measure (GdkFont     *font,
                  const gchar *text,
                  gint         text_length)
{
216
  gint rbearing;
Elliot Lee's avatar
Elliot Lee committed
217 218 219 220

  g_return_val_if_fail (font != NULL, -1);
  g_return_val_if_fail (text != NULL, -1);

221 222
  gdk_text_extents (font, text, text_length, NULL, &rbearing, NULL, NULL, NULL);
  return rbearing;
Elliot Lee's avatar
Elliot Lee committed
223
}
224 225 226 227 228 229 230 231 232 233 234 235 236

/**
 * gdk_char_measure:
 * @font: a #GdkFont
 * @character: the character to measure.
 * 
 * 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. 
 * 
 * Return value: the right bearing of the character in pixels.
 **/
Elliot Lee's avatar
Elliot Lee committed
237 238 239 240 241 242 243 244
gint
gdk_char_measure (GdkFont *font,
                  gchar    character)
{
  g_return_val_if_fail (font != NULL, -1);

  return gdk_text_measure (font, &character, 1);
}
245

246 247 248 249 250 251 252 253 254 255 256 257
/**
 * gdk_string_height:
 * @font: a #GdkFont
 * @string: the nul-terminated string to measure.
 * 
 * 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().
 * 
 * Return value: the height of the string in pixels.
 **/
258 259 260 261 262 263 264
gint
gdk_string_height (GdkFont     *font,
		   const gchar *string)
{
  g_return_val_if_fail (font != NULL, -1);
  g_return_val_if_fail (string != NULL, -1);

265
  return gdk_text_height (font, string, _gdk_font_strlen (font, string));
266 267
}

268 269 270 271 272 273 274 275 276 277 278 279 280
/**
 * gdk_text_height:
 * @font: a #GdkFont
 * @text: the text to measure.
 * @text_length: the length of the text in bytes.
 * 
 * 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().
 * 
 * Return value: the height of the string in pixels.
 **/
281 282 283 284 285
gint
gdk_text_height (GdkFont     *font,
		 const gchar *text,
		 gint         text_length)
{
286
  gint ascent, descent;
287 288 289 290

  g_return_val_if_fail (font != NULL, -1);
  g_return_val_if_fail (text != NULL, -1);

291 292
  gdk_text_extents (font, text, text_length, NULL, NULL, NULL, &ascent, &descent);
  return ascent + descent;
293 294
}

295 296 297 298 299 300 301 302 303 304 305 306
/**
 * gdk_char_height:
 * @font: a #GdkFont
 * @character: the character to measure.
 * 
 * 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().
 * 
 * Return value: the height of the character in pixels. 
 **/
307 308 309 310 311 312 313 314
gint
gdk_char_height (GdkFont *font,
		 gchar    character)
{
  g_return_val_if_fail (font != NULL, -1);

  return gdk_text_height (font, &character, 1);
}
315 316 317 318 319 320 321 322 323 324 325 326 327 328 329 330 331

/**
 * gdk_font_from_description:
 * @font_desc: a #PangoFontDescription.
 * 
 * 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.
 * 
 * Return value: the newly loaded font, or %NULL if the font
 * cannot be loaded.
 **/
GdkFont*
gdk_font_from_description (PangoFontDescription *font_desc)
{
Owen Taylor's avatar
Owen Taylor committed
332
  return gdk_font_from_description_for_display (gdk_display_get_default (),font_desc);
333 334
}

335 336 337 338 339 340 341 342 343 344 345
/**
 * gdk_font_load:
 * @font_name: a XLFD describing the font to load.
 * 
 * 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.
 * 
 * Return value: a #GdkFont, or %NULL if the font could not be loaded.
 **/
346 347 348
GdkFont*
gdk_font_load (const gchar *font_name)
{  
Owen Taylor's avatar
Owen Taylor committed
349
   return gdk_font_load_for_display (gdk_display_get_default(), font_name);
350
}
351 352