mirror of
https://gitlab.gnome.org/GNOME/gtk.git
synced 2024-11-10 10:50:10 +00:00
More doc comments moved inline.
This commit is contained in:
Matthias Clasen
parent
1489222cab
commit
ca00536f34
@ -1,3 +1,10 @@
|
||||
2002-11-01 Matthias Clasen <maclas@gmx.de>
|
||||
|
||||
* gdk/x11/gdkim-x11.c:
|
||||
* gdk/gdkfont.c:
|
||||
* gdk/x11/gdkfont-x11.c:
|
||||
* gdk/gdkdraw.c: Some docs moved inline.
|
||||
|
||||
Thu Oct 31 17:41:12 2002 Owen Taylor <otaylor@redhat.com>
|
||||
|
||||
* gtk/gtktooltips.c (gtk_tooltips_update_screen): Fix
|
||||
|
||||
@ -1,3 +1,10 @@
|
||||
2002-11-01 Matthias Clasen <maclas@gmx.de>
|
||||
|
||||
* gdk/x11/gdkim-x11.c:
|
||||
* gdk/gdkfont.c:
|
||||
* gdk/x11/gdkfont-x11.c:
|
||||
* gdk/gdkdraw.c: Some docs moved inline.
|
||||
|
||||
Thu Oct 31 17:41:12 2002 Owen Taylor <otaylor@redhat.com>
|
||||
|
||||
* gtk/gtktooltips.c (gtk_tooltips_update_screen): Fix
|
||||
|
||||
@ -1,3 +1,10 @@
|
||||
2002-11-01 Matthias Clasen <maclas@gmx.de>
|
||||
|
||||
* gdk/x11/gdkim-x11.c:
|
||||
* gdk/gdkfont.c:
|
||||
* gdk/x11/gdkfont-x11.c:
|
||||
* gdk/gdkdraw.c: Some docs moved inline.
|
||||
|
||||
Thu Oct 31 17:41:12 2002 Owen Taylor <otaylor@redhat.com>
|
||||
|
||||
* gtk/gtktooltips.c (gtk_tooltips_update_screen): Fix
|
||||
|
||||
@ -1,3 +1,10 @@
|
||||
2002-11-01 Matthias Clasen <maclas@gmx.de>
|
||||
|
||||
* gdk/x11/gdkim-x11.c:
|
||||
* gdk/gdkfont.c:
|
||||
* gdk/x11/gdkfont-x11.c:
|
||||
* gdk/gdkdraw.c: Some docs moved inline.
|
||||
|
||||
Thu Oct 31 17:41:12 2002 Owen Taylor <otaylor@redhat.com>
|
||||
|
||||
* gtk/gtktooltips.c (gtk_tooltips_update_screen): Fix
|
||||
|
||||
@ -1,3 +1,10 @@
|
||||
2002-11-01 Matthias Clasen <maclas@gmx.de>
|
||||
|
||||
* gdk/x11/gdkim-x11.c:
|
||||
* gdk/gdkfont.c:
|
||||
* gdk/x11/gdkfont-x11.c:
|
||||
* gdk/gdkdraw.c: Some docs moved inline.
|
||||
|
||||
Thu Oct 31 17:41:12 2002 Owen Taylor <otaylor@redhat.com>
|
||||
|
||||
* gtk/gtktooltips.c (gtk_tooltips_update_screen): Fix
|
||||
|
||||
@ -1,3 +1,10 @@
|
||||
2002-11-01 Matthias Clasen <maclas@gmx.de>
|
||||
|
||||
* gdk/x11/gdkim-x11.c:
|
||||
* gdk/gdkfont.c:
|
||||
* gdk/x11/gdkfont-x11.c:
|
||||
* gdk/gdkdraw.c: Some docs moved inline.
|
||||
|
||||
Thu Oct 31 17:41:12 2002 Owen Taylor <otaylor@redhat.com>
|
||||
|
||||
* gtk/gtktooltips.c (gtk_tooltips_update_screen): Fix
|
||||
|
||||
@ -1,5 +1,8 @@
|
||||
2002-11-01 Matthias Clasen <maclas@gmx.de>
|
||||
|
||||
* gdk/tmpl/fonts.sgml:
|
||||
* gdk/tmpl/drawing.sgml: More docs moved inline.
|
||||
|
||||
* gtk/tmpl/gtkfilesel.sgml: The label is "Folders" now, not
|
||||
"Directories". (#97224, Vitaly Tishkov)
|
||||
|
||||
|
||||
@ -155,53 +155,45 @@ or a #GdkWindow.
|
||||
|
||||
<!-- ##### FUNCTION gdk_draw_point ##### -->
|
||||
<para>
|
||||
Draws a point, using the foreground color and other attributes of the #GdkGC.
|
||||
</para>
|
||||
|
||||
@drawable: a #GdkDrawable (a #GdkWindow or a #GdkPixmap).
|
||||
@gc: a #GdkGC.
|
||||
@x: the x coordinate of the point.
|
||||
@y: the y coordinate of the point.
|
||||
@drawable:
|
||||
@gc:
|
||||
@x:
|
||||
@y:
|
||||
|
||||
|
||||
<!-- ##### FUNCTION gdk_draw_points ##### -->
|
||||
<para>
|
||||
Draws a number of points, using the foreground color and other attributes of
|
||||
the #GdkGC.
|
||||
</para>
|
||||
|
||||
@drawable: a #GdkDrawable (a #GdkWindow or a #GdkPixmap).
|
||||
@gc: a #GdkGC.
|
||||
@points: an array of #GdkPoint structures.
|
||||
@npoints: the number of points to be drawn.
|
||||
@drawable:
|
||||
@gc:
|
||||
@points:
|
||||
@npoints:
|
||||
|
||||
|
||||
<!-- ##### FUNCTION gdk_draw_line ##### -->
|
||||
<para>
|
||||
Draws a line, using the foreground color and other attributes of the #GdkGC.
|
||||
</para>
|
||||
|
||||
@drawable: a #GdkDrawable (a #GdkWindow or a #GdkPixmap).
|
||||
@gc: a #GdkGC.
|
||||
@x1: the x coordinate of the start point.
|
||||
@y1: the y coordinate of the start point.
|
||||
@x2: the x coordinate of the end point.
|
||||
@y2: the y coordinate of the end point.
|
||||
@drawable:
|
||||
@gc:
|
||||
@x1:
|
||||
@y1:
|
||||
@x2:
|
||||
@y2:
|
||||
|
||||
|
||||
<!-- ##### FUNCTION gdk_draw_lines ##### -->
|
||||
<para>
|
||||
Draws a series of lines connecting the given points.
|
||||
The way in which joins between lines are draw is determined by the
|
||||
#GdkCapStyle value in the #GdkGC. This can be set with
|
||||
gdk_gc_set_line_attributes().
|
||||
</para>
|
||||
|
||||
@drawable: a #GdkDrawable (a #GdkWindow or a #GdkPixmap).
|
||||
@gc: a #GdkGC.
|
||||
@points: an array of #GdkPoint structures specifying the endpoints of the
|
||||
@drawable:
|
||||
@gc:
|
||||
@points:
|
||||
lines.
|
||||
@npoints: the size of the @points array.
|
||||
@npoints:
|
||||
|
||||
|
||||
<!-- ##### FUNCTION gdk_draw_pixbuf ##### -->
|
||||
@ -225,14 +217,12 @@ lines.
|
||||
|
||||
<!-- ##### FUNCTION gdk_draw_segments ##### -->
|
||||
<para>
|
||||
Draws a number of unconnected lines.
|
||||
</para>
|
||||
|
||||
@drawable: a #GdkDrawable (a #GdkWindow or a #GdkPixmap).
|
||||
@gc: a #GdkGC.
|
||||
@segs: an array of #GdkSegment structures specifying the start and end points
|
||||
of the lines to be drawn,
|
||||
@nsegs: the number of line segments to draw, i.e. the size of the @segs array.
|
||||
@drawable:
|
||||
@gc:
|
||||
@segs:
|
||||
@nsegs:
|
||||
|
||||
|
||||
<!-- ##### STRUCT GdkSegment ##### -->
|
||||
@ -248,60 +238,45 @@ function.
|
||||
|
||||
<!-- ##### FUNCTION gdk_draw_rectangle ##### -->
|
||||
<para>
|
||||
Draws a rectangular outline or filled rectangle, using the foreground color
|
||||
and other attributes of the #GdkGC.
|
||||
</para>
|
||||
<note>
|
||||
<para>
|
||||
A rectangle drawn filled is 1 pixel smaller in both dimensions than a rectangle
|
||||
outlined. Calling <literal>gdk_draw_rectangle (window, gc, TRUE, 0, 0, 20, 20)</literal> results
|
||||
in a filled rectangle 20 pixels wide and 20 pixels high. Calling
|
||||
<literal>gdk_draw_rectangle (window, gc, FALSE, 0, 0, 20, 20)</literal> results in an outlined
|
||||
rectangle with corners at (0, 0), (0, 20), (20, 20), and (20, 0), which
|
||||
makes it 21 pixels wide and 21 pixels high.
|
||||
</para>
|
||||
</note>
|
||||
|
||||
@drawable: a #GdkDrawable (a #GdkWindow or a #GdkPixmap).
|
||||
@gc: a #GdkGC.
|
||||
@filled: %TRUE if the rectangle should be filled.
|
||||
@x: the x coordinate of the left edge of the rectangle.
|
||||
@y: the y coordinate of the top edge of the rectangle.
|
||||
@width: the width of the rectangle.
|
||||
@height: the height of the rectangle.
|
||||
@drawable:
|
||||
@gc:
|
||||
@filled:
|
||||
@x:
|
||||
@y:
|
||||
@width:
|
||||
@height:
|
||||
|
||||
|
||||
<!-- ##### FUNCTION gdk_draw_arc ##### -->
|
||||
<para>
|
||||
Draws an arc or a filled 'pie slice'. The arc is defined by the bounding
|
||||
rectangle of the entire ellipse, and the start and end angles of the part of
|
||||
the ellipse to be drawn.
|
||||
</para>
|
||||
|
||||
@drawable: a #GdkDrawable (a #GdkWindow or a #GdkPixmap).
|
||||
@gc: a #GdkGC.
|
||||
@filled: %TRUE if the arc should be filled, producing a 'pie slice'.
|
||||
@x: the x coordinate of the left edge of the bounding rectangle.
|
||||
@y: the y coordinate of the top edge of the bounding rectangle.
|
||||
@width: the width of the bounding rectangle.
|
||||
@height: the height of the bounding rectangle.
|
||||
@angle1: the start angle of the arc, relative to the 3 o'clock position,
|
||||
counter-clockwise, in 1/64ths of a degree.
|
||||
@angle2: the end angle of the arc, relative to @angle1, in 1/64ths of a degree.
|
||||
@drawable:
|
||||
@gc:
|
||||
@filled:
|
||||
@x:
|
||||
@y:
|
||||
@width:
|
||||
@height:
|
||||
@angle1:
|
||||
@angle2:
|
||||
|
||||
|
||||
<!-- ##### FUNCTION gdk_draw_polygon ##### -->
|
||||
<para>
|
||||
Draws an outlined or filled polygon.
|
||||
</para>
|
||||
|
||||
@drawable: a #GdkDrawable (a #GdkWindow or a #GdkPixmap).
|
||||
@gc: a #GdkGC.
|
||||
@filled: %TRUE if the polygon should be filled. The polygon is closed
|
||||
automatically, connecting the last point to the first point if necessary.
|
||||
@points: an array of #GdkPoint structures specifying the points making up the
|
||||
polygon.
|
||||
@npoints: the number of points.
|
||||
@drawable:
|
||||
@gc:
|
||||
@filled:
|
||||
@points:
|
||||
@npoints:
|
||||
|
||||
|
||||
<!-- ##### FUNCTION gdk_draw_glyphs ##### -->
|
||||
@ -371,45 +346,40 @@ polygon.
|
||||
|
||||
<!-- ##### FUNCTION gdk_draw_string ##### -->
|
||||
<para>
|
||||
Draws a string of characters in the given font or fontset.
|
||||
</para>
|
||||
|
||||
@drawable: a #GdkDrawable (a #GdkWindow or a #GdkPixmap).
|
||||
@font: a #GdkFont.
|
||||
@gc: a #GdkGC.
|
||||
@x: the x coordinate of the left edge of the text.
|
||||
@y: the y coordinate of the baseline of the text.
|
||||
@string: the string of characters to draw.
|
||||
@drawable:
|
||||
@font:
|
||||
@gc:
|
||||
@x:
|
||||
@y:
|
||||
@string:
|
||||
|
||||
|
||||
<!-- ##### FUNCTION gdk_draw_text ##### -->
|
||||
<para>
|
||||
Draws a number of characters in the given font or fontset.
|
||||
</para>
|
||||
|
||||
@drawable: a #GdkDrawable (a #GdkWindow or a #GdkPixmap).
|
||||
@font: a #GdkFont.
|
||||
@gc: a #GdkGC.
|
||||
@x: the x coordinate of the left edge of the text.
|
||||
@y: the y coordinate of the baseline of the text.
|
||||
@text: the characters to draw.
|
||||
@text_length: the number of characters of @text to draw.
|
||||
@drawable:
|
||||
@font:
|
||||
@gc:
|
||||
@x:
|
||||
@y:
|
||||
@text:
|
||||
@text_length:
|
||||
|
||||
|
||||
<!-- ##### FUNCTION gdk_draw_text_wc ##### -->
|
||||
<para>
|
||||
Draws a number of wide characters using the given font of fontset.
|
||||
If the font is a 1-byte font, the string is converted into 1-byte characters
|
||||
(discarding the high bytes) before output.
|
||||
</para>
|
||||
|
||||
@drawable: a #GdkDrawable (a #GdkWindow or a #GdkPixmap).
|
||||
@font: a #GdkFont.
|
||||
@gc: a #GdkGC.
|
||||
@x: the x coordinate of the left edge of the text.
|
||||
@y: the y coordinate of the baseline of the text.
|
||||
@text: the wide characters to draw.
|
||||
@text_length: the number of characters to draw.
|
||||
@drawable:
|
||||
@font:
|
||||
@gc:
|
||||
@x:
|
||||
@y:
|
||||
@text:
|
||||
@text_length:
|
||||
|
||||
|
||||
<!-- ##### MACRO gdk_draw_pixmap ##### -->
|
||||
@ -417,20 +387,6 @@ If the font is a 1-byte font, the string is converted into 1-byte characters
|
||||
Draws a pixmap, or a part of a pixmap, onto another drawable.
|
||||
</para>
|
||||
|
||||
<!-- # Unused Parameters # -->
|
||||
@drawable: a #GdkDrawable (a #GdkWindow or a #GdkPixmap).
|
||||
@gc: a #GdkGC.
|
||||
@src: the source #GdkPixmap to draw.
|
||||
@xsrc: the left edge of the source rectangle within @src.
|
||||
@ysrc: the top of the source rectangle within @src.
|
||||
@xdest: the x coordinate of the destination within @drawable.
|
||||
@ydest: the y coordinate of the destination within @drawable.
|
||||
@width: the width of the area to be copied, or -1 to make the area extend to
|
||||
the right edge of the source pixmap.
|
||||
@height: the height of the area to be copied, or -1 to make the area extend
|
||||
to the bottom edge of the source pixmap.
|
||||
|
||||
|
||||
<!-- ##### FUNCTION gdk_draw_drawable ##### -->
|
||||
<para>
|
||||
|
||||
@ -449,21 +405,17 @@ to the bottom edge of the source pixmap.
|
||||
|
||||
<!-- ##### FUNCTION gdk_draw_image ##### -->
|
||||
<para>
|
||||
Draws a #GdkImage onto a drawable.
|
||||
The depth of the #GdkImage must match the depth of the #GdkDrawable.
|
||||
</para>
|
||||
|
||||
@drawable: a #GdkDrawable (a #GdkWindow or a #GdkPixmap).
|
||||
@gc: a #GdkGC.
|
||||
@image: the #GdkImage to draw.
|
||||
@xsrc: the left edge of the source rectangle within @image.
|
||||
@ysrc: the top of the source rectangle within @image.
|
||||
@xdest: the x coordinate of the destination within @drawable.
|
||||
@ydest: the y coordinate of the destination within @drawable.
|
||||
@width: the width of the area to be copied, or -1 to make the area extend to
|
||||
the right edge of @image.
|
||||
@height: the height of the area to be copied, or -1 to make the area extend
|
||||
to the bottom edge of @image.
|
||||
@drawable:
|
||||
@gc:
|
||||
@image:
|
||||
@xsrc:
|
||||
@ysrc:
|
||||
@xdest:
|
||||
@ydest:
|
||||
@width:
|
||||
@height:
|
||||
|
||||
|
||||
<!-- ##### FUNCTION gdk_drawable_get_image ##### -->
|
||||
|
||||
@ -287,16 +287,10 @@ are currently:
|
||||
|
||||
<!-- ##### FUNCTION gdk_font_load ##### -->
|
||||
<para>
|
||||
Loads a font.
|
||||
</para>
|
||||
|
||||
<para>
|
||||
The font may be newly loaded or looked up the font in a cache.
|
||||
You should make no assumptions about the initial reference count.
|
||||
</para>
|
||||
|
||||
@font_name: a XLFD describing the font to load.
|
||||
@Returns: a #GdkFont, or %NULL if the font could not be loaded.
|
||||
@font_name:
|
||||
@Returns:
|
||||
|
||||
|
||||
<!-- ##### FUNCTION gdk_font_load_for_display ##### -->
|
||||
@ -311,16 +305,10 @@ You should make no assumptions about the initial reference count.
|
||||
|
||||
<!-- ##### FUNCTION gdk_fontset_load ##### -->
|
||||
<para>
|
||||
Loads a fontset.
|
||||
</para>
|
||||
<para>
|
||||
The fontset may be newly loaded or looked up in a cache.
|
||||
You should make no assumptions about the initial reference count.
|
||||
</para>
|
||||
|
||||
@fontset_name: a comma-separated list of XLFDs describing
|
||||
the component fonts of the fontset to load.
|
||||
@Returns: a #GdkFont, or %NULL if the fontset could not be loaded.
|
||||
@fontset_name:
|
||||
@Returns:
|
||||
|
||||
|
||||
<!-- ##### FUNCTION gdk_fontset_load_for_display ##### -->
|
||||
@ -363,225 +351,178 @@ You should make no assumptions about the initial reference count.
|
||||
|
||||
<!-- ##### FUNCTION gdk_font_ref ##### -->
|
||||
<para>
|
||||
Increases the reference count of a font by one.
|
||||
</para>
|
||||
|
||||
@font: a #GdkFont
|
||||
@Returns: @font
|
||||
@font:
|
||||
@Returns:
|
||||
|
||||
|
||||
<!-- ##### FUNCTION gdk_font_unref ##### -->
|
||||
<para>
|
||||
Decreases the reference count of a font by one.
|
||||
If the result is zero, destroys the font.
|
||||
</para>
|
||||
|
||||
@font: a #GdkFont
|
||||
@font:
|
||||
|
||||
|
||||
<!-- ##### FUNCTION gdk_font_id ##### -->
|
||||
<para>
|
||||
Returns the X Font ID for the given font.
|
||||
</para>
|
||||
|
||||
@font: a #GdkFont.
|
||||
@Returns: the numeric X Font ID
|
||||
@font:
|
||||
@Returns:
|
||||
|
||||
|
||||
<!-- ##### FUNCTION gdk_font_equal ##### -->
|
||||
<para>
|
||||
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.
|
||||
</para>
|
||||
|
||||
@fonta: a #GdkFont.
|
||||
@fontb: another #GdkFont.
|
||||
@Returns: %TRUE if the fonts are equal.
|
||||
@fonta:
|
||||
@fontb:
|
||||
@Returns:
|
||||
|
||||
|
||||
<!-- ##### FUNCTION gdk_string_extents ##### -->
|
||||
<para>
|
||||
Returns the metrics of a nul-terminated string.
|
||||
</para>
|
||||
|
||||
@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.
|
||||
@font:
|
||||
@string:
|
||||
@lbearing:
|
||||
@rbearing:
|
||||
@width:
|
||||
@ascent:
|
||||
@descent:
|
||||
|
||||
|
||||
<!-- ##### FUNCTION gdk_text_extents ##### -->
|
||||
<para>
|
||||
Returns the metrics of a string.
|
||||
</para>
|
||||
|
||||
@font: a #GdkFont
|
||||
@text: the text to measure
|
||||
@text_length: the length of the text in bytes. (If the
|
||||
font is a 16-bit font, this is twice the length
|
||||
of the text in characters.)
|
||||
@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.
|
||||
@font:
|
||||
@text:
|
||||
@text_length:
|
||||
@lbearing:
|
||||
@rbearing:
|
||||
@width:
|
||||
@ascent:
|
||||
@descent:
|
||||
|
||||
|
||||
<!-- ##### FUNCTION gdk_text_extents_wc ##### -->
|
||||
<para>
|
||||
Returns the metrics of a string of wide characters.
|
||||
</para>
|
||||
|
||||
@font: a #GdkFont
|
||||
@text: the text to measure.
|
||||
@text_length: the length of the text in character.
|
||||
@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.
|
||||
@font:
|
||||
@text:
|
||||
@text_length:
|
||||
@lbearing:
|
||||
@rbearing:
|
||||
@width:
|
||||
@ascent:
|
||||
@descent:
|
||||
|
||||
|
||||
<!-- ##### FUNCTION gdk_string_width ##### -->
|
||||
<para>
|
||||
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)
|
||||
</para>
|
||||
|
||||
@font: a #GdkFont
|
||||
@string: the nul-terminated string to measure
|
||||
@Returns: the width of the string in pixels.
|
||||
@font:
|
||||
@string:
|
||||
@Returns:
|
||||
|
||||
|
||||
<!-- ##### FUNCTION gdk_text_width ##### -->
|
||||
<para>
|
||||
Determines the width of a given string.
|
||||
</para>
|
||||
|
||||
@font: a #GdkFont
|
||||
@text: the text to measure.
|
||||
@text_length: the length of the text in bytes.
|
||||
@Returns: the width of the string in pixels.
|
||||
@font:
|
||||
@text:
|
||||
@text_length:
|
||||
@Returns:
|
||||
|
||||
|
||||
<!-- ##### FUNCTION gdk_text_width_wc ##### -->
|
||||
<para>
|
||||
Determines the width of a given wide-character string.
|
||||
</para>
|
||||
|
||||
@font: a #GdkFont
|
||||
@text: the text to measure.
|
||||
@text_length: the length of the text in characters.
|
||||
@Returns: the width of the string in pixels.
|
||||
@font:
|
||||
@text:
|
||||
@text_length:
|
||||
@Returns:
|
||||
|
||||
|
||||
<!-- ##### FUNCTION gdk_char_width ##### -->
|
||||
<para>
|
||||
Determines the width of a given character.
|
||||
</para>
|
||||
|
||||
@font: a #GdkFont
|
||||
@character: the character to measure.
|
||||
@Returns: the width of the character in pixels.
|
||||
@font:
|
||||
@character:
|
||||
@Returns:
|
||||
|
||||
|
||||
<!-- ##### FUNCTION gdk_char_width_wc ##### -->
|
||||
<para>
|
||||
Determines the width of a given wide character. (Encoded
|
||||
in the wide-character encoding of the current locale).
|
||||
</para>
|
||||
|
||||
@font: a #GdkFont
|
||||
@character: the character to measure.
|
||||
@Returns: the width of the character in pixels.
|
||||
@font:
|
||||
@character:
|
||||
@Returns:
|
||||
|
||||
|
||||
<!-- ##### FUNCTION gdk_string_measure ##### -->
|
||||
<para>
|
||||
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().
|
||||
</para>
|
||||
|
||||
@font: a #GdkFont
|
||||
@string: the nul-terminated string to measure.
|
||||
@Returns: the right bearing of the string in pixels.
|
||||
@font:
|
||||
@string:
|
||||
@Returns:
|
||||
|
||||
|
||||
<!-- ##### FUNCTION gdk_text_measure ##### -->
|
||||
<para>
|
||||
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().
|
||||
</para>
|
||||
|
||||
@font: a #GdkFont
|
||||
@text: the text to measure.
|
||||
@text_length: the length of the text in bytes.
|
||||
@Returns: the right bearing of the string in pixels.
|
||||
@font:
|
||||
@text:
|
||||
@text_length:
|
||||
@Returns:
|
||||
|
||||
|
||||
<!-- ##### FUNCTION gdk_char_measure ##### -->
|
||||
<para>
|
||||
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.
|
||||
</para>
|
||||
|
||||
@font: a #GdkFont
|
||||
@character: the character to measure.
|
||||
@Returns: the right bearing of the character in pixels.
|
||||
@font:
|
||||
@character:
|
||||
@Returns:
|
||||
|
||||
|
||||
<!-- ##### FUNCTION gdk_string_height ##### -->
|
||||
<para>
|
||||
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().
|
||||
</para>
|
||||
|
||||
@font: a #GdkFont
|
||||
@string: the nul-terminated string to measure.
|
||||
@Returns: the height of the string in pixels.
|
||||
@font:
|
||||
@string:
|
||||
@Returns:
|
||||
|
||||
|
||||
<!-- ##### FUNCTION gdk_text_height ##### -->
|
||||
<para>
|
||||
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().
|
||||
</para>
|
||||
|
||||
@font: a #GdkFont
|
||||
@text: the text to measure.
|
||||
@text_length: the length of the text in bytes.
|
||||
@Returns: the height of the string in pixels.
|
||||
@font:
|
||||
@text:
|
||||
@text_length:
|
||||
@Returns:
|
||||
|
||||
|
||||
<!-- ##### FUNCTION gdk_char_height ##### -->
|
||||
<para>
|
||||
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().
|
||||
</para>
|
||||
|
||||
@font: a #GdkFont
|
||||
@character: the character to measure.
|
||||
@Returns: the height of the character in pixels.
|
||||
@font:
|
||||
@character:
|
||||
@Returns:
|
||||
|
||||
|
||||
<!-- ##### TYPEDEF GdkWChar ##### -->
|
||||
@ -621,28 +562,19 @@ for more detailed information on wide and multi-byte characters.
|
||||
|
||||
<!-- ##### FUNCTION gdk_wcstombs ##### -->
|
||||
<para>
|
||||
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').
|
||||
</para>
|
||||
|
||||
@src: a wide character string.
|
||||
@Returns: the multi-byte string corresponding to @src, or %NULL if the
|
||||
conversion failed. The returned string should be freed with g_free() when no
|
||||
longer needed.
|
||||
@src:
|
||||
@Returns:
|
||||
|
||||
|
||||
<!-- ##### FUNCTION gdk_mbstowcs ##### -->
|
||||
<para>
|
||||
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').
|
||||
</para>
|
||||
|
||||
@dest: the space to place the converted wide character string into.
|
||||
@src: the multi-byte string to convert, which must be nul-terminated.
|
||||
@dest_max: the maximum number of wide characters to place in @dest.
|
||||
@Returns: the number of wide characters written into @dest, or -1 if the
|
||||
conversion failed.
|
||||
@dest:
|
||||
@src:
|
||||
@dest_max:
|
||||
@Returns:
|
||||
|
||||
|
||||
|
||||
163
gdk/gdkdraw.c
163
gdk/gdkdraw.c
@ -311,6 +311,17 @@ gdk_drawable_unref (GdkDrawable *drawable)
|
||||
|
||||
/* Drawing
|
||||
*/
|
||||
|
||||
/**
|
||||
* gdk_draw_point:
|
||||
* @drawable: a #GdkDrawable (a #GdkWindow or a #GdkPixmap).
|
||||
* @gc: a #GdkGC.
|
||||
* @x: the x coordinate of the point.
|
||||
* @y: the y coordinate of the point.
|
||||
*
|
||||
* Draws a point, using the foreground color and other attributes of
|
||||
* the #GdkGC.
|
||||
**/
|
||||
void
|
||||
gdk_draw_point (GdkDrawable *drawable,
|
||||
GdkGC *gc,
|
||||
@ -328,6 +339,18 @@ gdk_draw_point (GdkDrawable *drawable,
|
||||
GDK_DRAWABLE_GET_CLASS (drawable)->draw_points (drawable, gc, &point, 1);
|
||||
}
|
||||
|
||||
/**
|
||||
* gdk_draw_line:
|
||||
* @drawable: a #GdkDrawable (a #GdkWindow or a #GdkPixmap).
|
||||
* @gc: a #GdkGC.
|
||||
* @x1: the x coordinate of the start point.
|
||||
* @y1: the y coordinate of the start point.
|
||||
* @x2: the x coordinate of the end point.
|
||||
* @y2: the y coordinate of the end point.
|
||||
*
|
||||
* Draws a line, using the foreground color and other attributes of
|
||||
* the #GdkGC.
|
||||
**/
|
||||
void
|
||||
gdk_draw_line (GdkDrawable *drawable,
|
||||
GdkGC *gc,
|
||||
@ -350,6 +373,27 @@ gdk_draw_line (GdkDrawable *drawable,
|
||||
GDK_DRAWABLE_GET_CLASS (drawable)->draw_segments (drawable, gc, &segment, 1);
|
||||
}
|
||||
|
||||
/**
|
||||
* gdk_draw_rectangle:
|
||||
* @drawable: a #GdkDrawable (a #GdkWindow or a #GdkPixmap).
|
||||
* @gc: a #GdkGC.
|
||||
* @filled: %TRUE if the rectangle should be filled.
|
||||
* @x: the x coordinate of the left edge of the rectangle.
|
||||
* @y: the y coordinate of the top edge of the rectangle.
|
||||
* @width: the width of the rectangle.
|
||||
* @height: the height of the rectangle.
|
||||
*
|
||||
* Draws a rectangular outline or filled rectangle, using the foreground color
|
||||
* and other attributes of the #GdkGC.
|
||||
*
|
||||
* A rectangle drawn filled is 1 pixel smaller in both dimensions than a
|
||||
* rectangle outlined. Calling
|
||||
* <literal>gdk_draw_rectangle (window, gc, TRUE, 0, 0, 20, 20)</literal>
|
||||
* results in a filled rectangle 20 pixels wide and 20 pixels high. Calling
|
||||
* <literal>gdk_draw_rectangle (window, gc, FALSE, 0, 0, 20, 20)</literal>
|
||||
* results in an outlined rectangle with corners at (0, 0), (0, 20), (20, 20),
|
||||
* and (20, 0), which makes it 21 pixels wide and 21 pixels high.
|
||||
**/
|
||||
void
|
||||
gdk_draw_rectangle (GdkDrawable *drawable,
|
||||
GdkGC *gc,
|
||||
@ -379,6 +423,24 @@ gdk_draw_rectangle (GdkDrawable *drawable,
|
||||
width, height);
|
||||
}
|
||||
|
||||
/**
|
||||
* gdk_draw_arc:
|
||||
* @drawable: a #GdkDrawable (a #GdkWindow or a #GdkPixmap).
|
||||
* @gc: a #GdkGC.
|
||||
* @filled: %TRUE if the arc should be filled, producing a 'pie slice'.
|
||||
* @x: the x coordinate of the left edge of the bounding rectangle.
|
||||
* @y: the y coordinate of the top edge of the bounding rectangle.
|
||||
* @width: the width of the bounding rectangle.
|
||||
* @height: the height of the bounding rectangle.
|
||||
* @angle1: the start angle of the arc, relative to the 3 o'clock position,
|
||||
* counter-clockwise, in 1/64ths of a degree.
|
||||
* @angle2: the end angle of the arc, relative to @angle1, in 1/64ths
|
||||
* of a degree.
|
||||
*
|
||||
* Draws an arc or a filled 'pie slice'. The arc is defined by the bounding
|
||||
* rectangle of the entire ellipse, and the start and end angles of the part
|
||||
* of the ellipse to be drawn.
|
||||
**/
|
||||
void
|
||||
gdk_draw_arc (GdkDrawable *drawable,
|
||||
GdkGC *gc,
|
||||
@ -410,6 +472,19 @@ gdk_draw_arc (GdkDrawable *drawable,
|
||||
x, y, width, height, angle1, angle2);
|
||||
}
|
||||
|
||||
/**
|
||||
* gdk_draw_polygon:
|
||||
* @drawable: a #GdkDrawable (a #GdkWindow or a #GdkPixmap).
|
||||
* @gc: a #GdkGC.
|
||||
* @filled: %TRUE if the polygon should be filled. The polygon is closed
|
||||
* automatically, connecting the last point to the first point if
|
||||
* necessary.
|
||||
* @points: an array of #GdkPoint structures specifying the points making
|
||||
* up the polygon.
|
||||
* @npoints: the number of points.
|
||||
*
|
||||
* Draws an outlined or filled polygon.
|
||||
**/
|
||||
void
|
||||
gdk_draw_polygon (GdkDrawable *drawable,
|
||||
GdkGC *gc,
|
||||
@ -430,6 +505,17 @@ gdk_draw_polygon (GdkDrawable *drawable,
|
||||
*
|
||||
* Interface changed: add "GdkFont *font" to specify font or fontset explicitely
|
||||
*/
|
||||
/**
|
||||
* gdk_draw_string:
|
||||
* @drawable: a #GdkDrawable (a #GdkWindow or a #GdkPixmap).
|
||||
* @font: a #GdkFont.
|
||||
* @gc: a #GdkGC.
|
||||
* @x: the x coordinate of the left edge of the text.
|
||||
* @y: the y coordinate of the baseline of the text.
|
||||
* @string: the string of characters to draw.
|
||||
*
|
||||
* Draws a string of characters in the given font or fontset.
|
||||
**/
|
||||
void
|
||||
gdk_draw_string (GdkDrawable *drawable,
|
||||
GdkFont *font,
|
||||
@ -447,6 +533,18 @@ gdk_draw_string (GdkDrawable *drawable,
|
||||
*
|
||||
* Interface changed: add "GdkFont *font" to specify font or fontset explicitely
|
||||
*/
|
||||
/**
|
||||
* gdk_draw_text:
|
||||
* @drawable: a #GdkDrawable (a #GdkWindow or a #GdkPixmap).
|
||||
* @font: a #GdkFont.
|
||||
* @gc: a #GdkGC.
|
||||
* @x: the x coordinate of the left edge of the text.
|
||||
* @y: the y coordinate of the baseline of the text.
|
||||
* @text: the characters to draw.
|
||||
* @text_length: the number of characters of @text to draw.
|
||||
*
|
||||
* Draws a number of characters in the given font or fontset.
|
||||
**/
|
||||
void
|
||||
gdk_draw_text (GdkDrawable *drawable,
|
||||
GdkFont *font,
|
||||
@ -464,6 +562,20 @@ gdk_draw_text (GdkDrawable *drawable,
|
||||
GDK_DRAWABLE_GET_CLASS (drawable)->draw_text (drawable, font, gc, x, y, text, text_length);
|
||||
}
|
||||
|
||||
/**
|
||||
* gdk_draw_text_wc:
|
||||
* @drawable: a #GdkDrawable (a #GdkWindow or a #GdkPixmap).
|
||||
* @font: a #GdkFont.
|
||||
* @gc: a #GdkGC.
|
||||
* @x: the x coordinate of the left edge of the text.
|
||||
* @y: the y coordinate of the baseline of the text.
|
||||
* @text: the wide characters to draw.
|
||||
* @text_length: the number of characters to draw.
|
||||
*
|
||||
* Draws a number of wide characters using the given font of fontset.
|
||||
* If the font is a 1-byte font, the string is converted into 1-byte
|
||||
* characters (discarding the high bytes) before output.
|
||||
**/
|
||||
void
|
||||
gdk_draw_text_wc (GdkDrawable *drawable,
|
||||
GdkFont *font,
|
||||
@ -559,6 +671,23 @@ gdk_draw_drawable (GdkDrawable *drawable,
|
||||
g_object_unref (composite);
|
||||
}
|
||||
|
||||
/**
|
||||
* gdk_draw_image:
|
||||
* @drawable: a #GdkDrawable (a #GdkWindow or a #GdkPixmap).
|
||||
* @gc: a #GdkGC.
|
||||
* @image: the #GdkImage to draw.
|
||||
* @xsrc: the left edge of the source rectangle within @image.
|
||||
* @ysrc: the top of the source rectangle within @image.
|
||||
* @xdest: the x coordinate of the destination within @drawable.
|
||||
* @ydest: the y coordinate of the destination within @drawable.
|
||||
* @width: the width of the area to be copied, or -1 to make the area
|
||||
* extend to the right edge of @image.
|
||||
* @height: the height of the area to be copied, or -1 to make the area
|
||||
* extend to the bottom edge of @image.
|
||||
*
|
||||
* Draws a #GdkImage onto a drawable.
|
||||
* The depth of the #GdkImage must match the depth of the #GdkDrawable.
|
||||
**/
|
||||
void
|
||||
gdk_draw_image (GdkDrawable *drawable,
|
||||
GdkGC *gc,
|
||||
@ -634,6 +763,16 @@ gdk_draw_pixbuf (GdkDrawable *drawable,
|
||||
dither, x_dither, y_dither);
|
||||
}
|
||||
|
||||
/**
|
||||
* gdk_draw_points:
|
||||
* @drawable: a #GdkDrawable (a #GdkWindow or a #GdkPixmap).
|
||||
* @gc: a #GdkGC.
|
||||
* @points: an array of #GdkPoint structures.
|
||||
* @npoints: the number of points to be drawn.
|
||||
*
|
||||
* Draws a number of points, using the foreground color and other
|
||||
* attributes of the #GdkGC.
|
||||
**/
|
||||
void
|
||||
gdk_draw_points (GdkDrawable *drawable,
|
||||
GdkGC *gc,
|
||||
@ -651,6 +790,17 @@ gdk_draw_points (GdkDrawable *drawable,
|
||||
GDK_DRAWABLE_GET_CLASS (drawable)->draw_points (drawable, gc, points, npoints);
|
||||
}
|
||||
|
||||
/**
|
||||
* gdk_draw_segments:
|
||||
* @drawable: a #GdkDrawable (a #GdkWindow or a #GdkPixmap).
|
||||
* @gc: a #GdkGC.
|
||||
* @segs: an array of #GdkSegment structures specifying the start and
|
||||
* end points of the lines to be drawn.
|
||||
* @nsegs: the number of line segments to draw, i.e. the size of the
|
||||
* @segs array.
|
||||
*
|
||||
* Draws a number of unconnected lines.
|
||||
**/
|
||||
void
|
||||
gdk_draw_segments (GdkDrawable *drawable,
|
||||
GdkGC *gc,
|
||||
@ -669,13 +819,24 @@ gdk_draw_segments (GdkDrawable *drawable,
|
||||
GDK_DRAWABLE_GET_CLASS (drawable)->draw_segments (drawable, gc, segs, nsegs);
|
||||
}
|
||||
|
||||
/**
|
||||
* gdk_draw_lines:
|
||||
* @drawable: a #GdkDrawable (a #GdkWindow or a #GdkPixmap).
|
||||
* @gc: a #GdkGC.
|
||||
* @points: an array of #GdkPoint structures specifying the endpoints of the
|
||||
* @npoints: the size of the @points array.
|
||||
*
|
||||
* Draws a series of lines connecting the given points.
|
||||
* The way in which joins between lines are draw is determined by the
|
||||
* #GdkCapStyle value in the #GdkGC. This can be set with
|
||||
* gdk_gc_set_line_attributes().
|
||||
**/
|
||||
void
|
||||
gdk_draw_lines (GdkDrawable *drawable,
|
||||
GdkGC *gc,
|
||||
GdkPoint *points,
|
||||
gint npoints)
|
||||
{
|
||||
|
||||
g_return_if_fail (GDK_IS_DRAWABLE (drawable));
|
||||
g_return_if_fail (points != NULL);
|
||||
g_return_if_fail (GDK_IS_GC (gc));
|
||||
|
||||
148
gdk/gdkfont.c
148
gdk/gdkfont.c
@ -40,6 +40,14 @@ gdk_font_get_type (void)
|
||||
return our_type;
|
||||
}
|
||||
|
||||
/**
|
||||
* gdk_font_ref:
|
||||
* @font: a #GdkFont
|
||||
*
|
||||
* Increases the reference count of a font by one.
|
||||
*
|
||||
* Return value: @font
|
||||
**/
|
||||
GdkFont*
|
||||
gdk_font_ref (GdkFont *font)
|
||||
{
|
||||
@ -52,6 +60,13 @@ gdk_font_ref (GdkFont *font)
|
||||
return font;
|
||||
}
|
||||
|
||||
/**
|
||||
* gdk_font_unref:
|
||||
* @font: a #GdkFont
|
||||
*
|
||||
* Decreases the reference count of a font by one.
|
||||
* If the result is zero, destroys the font.
|
||||
**/
|
||||
void
|
||||
gdk_font_unref (GdkFont *font)
|
||||
{
|
||||
@ -66,6 +81,18 @@ gdk_font_unref (GdkFont *font)
|
||||
_gdk_font_destroy (font);
|
||||
}
|
||||
|
||||
/**
|
||||
* 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.
|
||||
**/
|
||||
gint
|
||||
gdk_string_width (GdkFont *font,
|
||||
const gchar *string)
|
||||
@ -76,6 +103,15 @@ gdk_string_width (GdkFont *font,
|
||||
return gdk_text_width (font, string, _gdk_font_strlen (font, string));
|
||||
}
|
||||
|
||||
/**
|
||||
* 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.
|
||||
**/
|
||||
gint
|
||||
gdk_char_width (GdkFont *font,
|
||||
gchar character)
|
||||
@ -85,6 +121,16 @@ gdk_char_width (GdkFont *font,
|
||||
return gdk_text_width (font, &character, 1);
|
||||
}
|
||||
|
||||
/**
|
||||
* 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.
|
||||
**/
|
||||
gint
|
||||
gdk_char_width_wc (GdkFont *font,
|
||||
GdkWChar character)
|
||||
@ -94,6 +140,19 @@ gdk_char_width_wc (GdkFont *font,
|
||||
return gdk_text_width_wc (font, &character, 1);
|
||||
}
|
||||
|
||||
/**
|
||||
* 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.
|
||||
**/
|
||||
gint
|
||||
gdk_string_measure (GdkFont *font,
|
||||
const gchar *string)
|
||||
@ -104,6 +163,18 @@ gdk_string_measure (GdkFont *font,
|
||||
return gdk_text_measure (font, string, _gdk_font_strlen (font, string));
|
||||
}
|
||||
|
||||
/**
|
||||
* 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.
|
||||
*
|
||||
* Returns the metrics of a nul-terminated string.
|
||||
**/
|
||||
void
|
||||
gdk_string_extents (GdkFont *font,
|
||||
const gchar *string,
|
||||
@ -121,6 +192,20 @@ gdk_string_extents (GdkFont *font,
|
||||
}
|
||||
|
||||
|
||||
/**
|
||||
* 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.
|
||||
**/
|
||||
gint
|
||||
gdk_text_measure (GdkFont *font,
|
||||
const gchar *text,
|
||||
@ -134,6 +219,19 @@ gdk_text_measure (GdkFont *font,
|
||||
gdk_text_extents (font, text, text_length, NULL, &rbearing, NULL, NULL, NULL);
|
||||
return rbearing;
|
||||
}
|
||||
|
||||
/**
|
||||
* 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.
|
||||
**/
|
||||
gint
|
||||
gdk_char_measure (GdkFont *font,
|
||||
gchar character)
|
||||
@ -143,6 +241,18 @@ gdk_char_measure (GdkFont *font,
|
||||
return gdk_text_measure (font, &character, 1);
|
||||
}
|
||||
|
||||
/**
|
||||
* 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.
|
||||
**/
|
||||
gint
|
||||
gdk_string_height (GdkFont *font,
|
||||
const gchar *string)
|
||||
@ -153,6 +263,19 @@ gdk_string_height (GdkFont *font,
|
||||
return gdk_text_height (font, string, _gdk_font_strlen (font, string));
|
||||
}
|
||||
|
||||
/**
|
||||
* 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.
|
||||
**/
|
||||
gint
|
||||
gdk_text_height (GdkFont *font,
|
||||
const gchar *text,
|
||||
@ -167,6 +290,18 @@ gdk_text_height (GdkFont *font,
|
||||
return ascent + descent;
|
||||
}
|
||||
|
||||
/**
|
||||
* 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.
|
||||
**/
|
||||
gint
|
||||
gdk_char_height (GdkFont *font,
|
||||
gchar character)
|
||||
@ -195,8 +330,21 @@ gdk_font_from_description (PangoFontDescription *font_desc)
|
||||
return gdk_font_from_description_for_display (gdk_display_get_default (),font_desc);
|
||||
}
|
||||
|
||||
/**
|
||||
* 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.
|
||||
**/
|
||||
GdkFont*
|
||||
gdk_font_load (const gchar *font_name)
|
||||
{
|
||||
return gdk_font_load_for_display (gdk_display_get_default(), font_name);
|
||||
}
|
||||
|
||||
|
||||
|
||||
@ -396,6 +396,18 @@ gdk_fontset_load_for_display (GdkDisplay *display,
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* gdk_fontset_load:
|
||||
* @fontset_name: a comma-separated list of XLFDs describing
|
||||
* the component fonts of the fontset to load.
|
||||
*
|
||||
* 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.
|
||||
*
|
||||
* Return value: a #GdkFont, or %NULL if the fontset could not be loaded.
|
||||
**/
|
||||
GdkFont*
|
||||
gdk_fontset_load (const gchar *fontset_name)
|
||||
{
|
||||
@ -464,6 +476,14 @@ _gdk_font_strlen (GdkFont *font,
|
||||
return length;
|
||||
}
|
||||
|
||||
/**
|
||||
* gdk_font_id:
|
||||
* @font: a #GdkFont.
|
||||
*
|
||||
* Returns the X Font ID for the given font.
|
||||
*
|
||||
* Return value: the numeric X Font ID
|
||||
**/
|
||||
gint
|
||||
gdk_font_id (const GdkFont *font)
|
||||
{
|
||||
@ -483,6 +503,17 @@ gdk_font_id (const GdkFont *font)
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* gdk_font_equal:
|
||||
* @fonta: a #GdkFont.
|
||||
* @fontb: another #GdkFont.
|
||||
*
|
||||
* 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.
|
||||
*
|
||||
* Return value: %TRUE if the fonts are equal.
|
||||
**/
|
||||
gboolean
|
||||
gdk_font_equal (const GdkFont *fonta,
|
||||
const GdkFont *fontb)
|
||||
@ -515,6 +546,16 @@ gdk_font_equal (const GdkFont *fonta,
|
||||
return 0;
|
||||
}
|
||||
|
||||
/**
|
||||
* gdk_text_width:
|
||||
* @font: a #GdkFont
|
||||
* @text: the text to measure.
|
||||
* @text_length: the length of the text in bytes.
|
||||
*
|
||||
* Determines the width of a given string.
|
||||
*
|
||||
* Return value: the width of the string in pixels.
|
||||
**/
|
||||
gint
|
||||
gdk_text_width (GdkFont *font,
|
||||
const gchar *text,
|
||||
@ -553,6 +594,16 @@ gdk_text_width (GdkFont *font,
|
||||
return width;
|
||||
}
|
||||
|
||||
/**
|
||||
* gdk_text_width_wc:
|
||||
* @font: a #GdkFont
|
||||
* @text: the text to measure.
|
||||
* @text_length: the length of the text in characters.
|
||||
*
|
||||
* Determines the width of a given wide-character string.
|
||||
*
|
||||
* Return value: the width of the string in pixels.
|
||||
**/
|
||||
gint
|
||||
gdk_text_width_wc (GdkFont *font,
|
||||
const GdkWChar *text,
|
||||
@ -609,6 +660,21 @@ gdk_text_width_wc (GdkFont *font,
|
||||
return width;
|
||||
}
|
||||
|
||||
/**
|
||||
* gdk_text_extents:
|
||||
* @font: a #GdkFont
|
||||
* @text: the text to measure
|
||||
* @text_length: the length of the text in bytes. (If the
|
||||
* font is a 16-bit font, this is twice the length
|
||||
* of the text in characters.)
|
||||
* @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.
|
||||
*
|
||||
* Returns the metrics of a string.
|
||||
**/
|
||||
void
|
||||
gdk_text_extents (GdkFont *font,
|
||||
const gchar *text,
|
||||
@ -678,6 +744,19 @@ gdk_text_extents (GdkFont *font,
|
||||
|
||||
}
|
||||
|
||||
/**
|
||||
* gdk_text_extents_wc:
|
||||
* @font: a #GdkFont
|
||||
* @text: the text to measure.
|
||||
* @text_length: the length of the text in character.
|
||||
* @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.
|
||||
*
|
||||
* Returns the metrics of a string of wide characters.
|
||||
**/
|
||||
void
|
||||
gdk_text_extents_wc (GdkFont *font,
|
||||
const GdkWChar *text,
|
||||
|
||||
@ -122,14 +122,18 @@ find_a_display ()
|
||||
return display;
|
||||
}
|
||||
|
||||
/*
|
||||
* gdk_wcstombs
|
||||
*
|
||||
* Returns a multi-byte string converted from the specified array
|
||||
* of wide characters. The string is newly allocated. The array of
|
||||
* wide characters must be null-terminated. If the conversion is
|
||||
* failed, it returns NULL.
|
||||
*/
|
||||
/**
|
||||
* gdk_wcstombs:
|
||||
* @src: a wide character string.
|
||||
*
|
||||
* 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').
|
||||
*
|
||||
* Return value: the multi-byte string corresponding to @src, or %NULL if the
|
||||
* conversion failed. The returned string should be freed with g_free() when no
|
||||
* longer needed.
|
||||
**/
|
||||
gchar *
|
||||
gdk_wcstombs (const GdkWChar *src)
|
||||
{
|
||||
@ -188,14 +192,20 @@ gdk_wcstombs (const GdkWChar *src)
|
||||
|
||||
return mbstr;
|
||||
}
|
||||
/**
|
||||
* gdk_mbstowcs:
|
||||
* @dest: the space to place the converted wide character string into.
|
||||
* @src: the multi-byte string to convert, which must be nul-terminated.
|
||||
* @dest_max: the maximum number of wide characters to place in @dest.
|
||||
*
|
||||
* 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').
|
||||
*
|
||||
* Return value: the number of wide characters written into @dest, or -1 if
|
||||
* the conversion failed.
|
||||
**/
|
||||
|
||||
/*
|
||||
* gdk_mbstowcs
|
||||
*
|
||||
* Converts the specified string into wide characters, and, returns the
|
||||
* number of wide characters written. The string 'src' must be
|
||||
* null-terminated. If the conversion is failed, it returns -1.
|
||||
*/
|
||||
gint
|
||||
gdk_mbstowcs (GdkWChar *dest, const gchar *src, gint dest_max)
|
||||
{
|
||||
|
||||
Loading…
Reference in New Issue
Block a user