Skip to content
GitLab
Projects
Groups
Snippets
/
Help
Help
Support
Community forum
Keyboard shortcuts
?
Submit feedback
Contribute to GitLab
Sign in / Register
Toggle navigation
Menu
Open sidebar
GNOME
pango
Commits
7f04ed92
Commit
7f04ed92
authored
May 19, 2021
by
Matthias Clasen
Browse files
docs: Convert gtk-doc syntax leftovers
Remove leftovers like #Type, reduce indentations to avoid markdown block quotes, etc.
parent
75eee838
Pipeline
#284440
passed with stages
in 8 minutes and 59 seconds
Changes
58
Pipelines
1
Expand all
Hide whitespace changes
Inline
Side-by-side
CODING_STYLE.md
View file @
7f04ed92
...
...
@@ -49,19 +49,19 @@ in the gtk-doc / gnome-doc style. For instance:
/
**
*
pango_layout_get_line:
*
@layout: a
#
PangoLayout
*
@layout: a
`
PangoLayout
`
*
@line: the index of a line, which must be between 0 and
*
pango_layout_get_line_count(layout) - 1, inclusive.
*
`
pango_layout_get_line_count(layout) - 1
`
, inclusive.
*
*
Retrieves a particular line from a
#
PangoLayout (or @layout.)
*
Retrieves a particular line from a
`
PangoLayout
`
(or @layout.)
*
*
Return value: the requested
#
PangoLayoutLine, or %NULL
if the
*
index is out of range. This layout line can
*
be ref'ed and retained, but will become invalid
*
if changes are made to the
#
PangoLayout.
*
Return value: the requested
`
PangoLayoutLine
`
, or %NULL
*
if the
index is out of range. This layout line can
*
be ref'ed and retained, but will become invalid
*
if changes are made to the
`
PangoLayout
`
.
*
*
Since: 1.6
*
*
/
*
/
PangoLayoutLine
*
pango_layout_get_line (PangoLayout
*
layout,
int line)
...
...
pango/break.c
View file @
7f04ed92
...
...
@@ -143,17 +143,18 @@ typedef enum
* pango_default_break:
* @text: text to break. Must be valid UTF-8
* @length: length of text in bytes (may be -1 if @text is nul-terminated)
* @analysis: (nullable): a
#
PangoAnalysis for the @text
* @analysis: (nullable): a
`
PangoAnalysis
` structure
for the @text
* @attrs: logical attributes to fill in
* @attrs_len: size of the array passed as @attrs
*
* This is the default break algorithm.
*
* It applies Unicode rules without language-specific tailoring, therefore
* the @analyis argument is unused and can be %NULL.
* It applies Unicode rules without language-specific
* tailoring, therefore the @analyis argument is unused
* and can be %NULL.
*
* See
p
ango
_
tailor_break
()
for language-specific breaks.
*
*/
* See
[func@P
ango
.
tailor_break
]
for language-specific breaks.
*/
void
pango_default_break
(
const
gchar
*
text
,
gint
length
,
...
...
@@ -1617,19 +1618,20 @@ tailor_break (const char *text,
/**
* pango_break:
* @text: the text to process. Must be valid UTF-8
* @length: length of @text in bytes (may be -1 if @text is nul-terminated)
* @analysis: #PangoAnalysis structure from pango_itemize()
* @attrs: (array length=attrs_len): an array to store character
* information in
* @text: the text to process. Must be valid UTF-8
* @length: length of @text in bytes (may be -1 if @text is nul-terminated)
* @analysis: `PangoAnalysis` structure for @text
* @attrs: (array length=attrs_len): an array to store character information in
* @attrs_len: size of the array passed as @attrs
*
* Determines possible line, word, and character breaks
for a string of
* Unicode text with a single analysis.
* Determines possible line, word, and character breaks
*
for a string of
Unicode text with a single analysis.
*
* For most purposes you may want to use pango_get_log_attrs().
* For most purposes you may want to use
* [func@Pango.get_log_attrs].
*
* Deprecated: 1.44: Use pango_default_break() and pango_tailor_break()
* Deprecated: 1.44: Use [func@Pango.default_break] and
* [func@Pango.tailor_break]
*/
void
pango_break
(
const
gchar
*
text
,
...
...
@@ -1656,15 +1658,18 @@ pango_break (const gchar *text,
*
* Locates a paragraph boundary in @text.
*
* A boundary is caused by delimiter characters, such as a newline, carriage
* return, carriage return-newline pair, or Unicode paragraph separator character.
* The index of the run of delimiters is returned in @paragraph_delimiter_index.
* The index of the start of the paragrap (index after all delimiters) is stored
* A boundary is caused by delimiter characters, such as
* a newline, carriage return, carriage return-newline pair,
* or Unicode paragraph separator character.
*
* The index of the run of delimiters is returned in
* @paragraph_delimiter_index. The index of the start
* of the paragrap (index after all delimiters) is stored
* in @next_paragraph_start.
*
* If no delimiters are found, both @paragraph_delimiter_index
and
* @next_paragraph_start are filled with the length of @text
(an index one
* off the end).
* If no delimiters are found, both @paragraph_delimiter_index
*
and
@next_paragraph_start are filled with the length of @text
*
(an index one
off the end).
*/
void
pango_find_paragraph_boundary
(
const
gchar
*
text
,
...
...
@@ -1750,16 +1755,18 @@ pango_find_paragraph_boundary (const gchar *text,
* pango_tailor_break:
* @text: text to process. Must be valid UTF-8
* @length: length in bytes of @text
* @analysis: `PangoAnalysis`
structure from [func@itemize]
for @text
* @analysis: `PangoAnalysis` for @text
* @offset: Byte offset of @text from the beginning of the
*
paragraph, or -1 to ignore attributes from @analysis
* paragraph, or -1 to ignore attributes from @analysis
* @log_attrs: (array length=log_attrs_len): array with one `PangoLogAttr`
* per character in @text, plus one extra, to be filled in
* @log_attrs_len: length of @log_attrs array
*
* Apply language-specific tailoring to the breaks in @log_attrs.
* Apply language-specific tailoring to the breaks
* in @log_attrs.
*
* The line breaks are assumed to have been produced by [func@default_break].
* The line breaks are assumed to have been produced
* by [func@Pango.default_break].
*
* If @offset is not -1, it is used to apply attributes
* from @analysis that are relevant to line breaking.
...
...
@@ -1825,11 +1832,13 @@ tailor_segment (const char *range_start,
*
* Computes a `PangoLogAttr` for each character in @text.
*
* The @log_attrs array must have one `PangoLogAttr` for each position in @text;
* if @text contains N characters, it has N+1 positions, including the last
* position at the end of the text. @text should be an entire paragraph; logical
* attributes can't be computed without context (for example you need to see
* spaces on either side of a word to know the word is a word).
* The @log_attrs array must have one `PangoLogAttr` for
* each position in @text; if @text contains N characters,
* it has N+1 positions, including the last position at the
* end of the text. @text should be an entire paragraph;
* logical attributes can't be computed without context
* (for example you need to see spaces on either side of
* a word to know the word is a word).
*/
void
pango_get_log_attrs
(
const
char
*
text
,
...
...
pango/ellipsize.c
View file @
7f04ed92
...
...
@@ -243,7 +243,7 @@ line_iter_prev_cluster (EllipsizeState *state,
* - Starts a grapheme - checked here
*
* In the future we'd also like to add a check for cursive connectivity here.
* This should be an addition to
#
PangoGlyphVisAttr
* This should be an addition to
`
PangoGlyphVisAttr
`
*
*/
...
...
@@ -735,11 +735,11 @@ current_width (EllipsizeState *state)
/**
* _pango_layout_line_ellipsize:
* @line: a
#
PangoLayoutLine
* @line: a
`
PangoLayoutLine
`
* @attrs: Attributes being used for itemization/shaping
* @shape_flags: Flags to use when shaping
*
* Given a
#
PangoLayoutLine with the runs still in logical order, ellipsize
* Given a
`
PangoLayoutLine
`
with the runs still in logical order, ellipsize
* it according the layout's policy to fit within the set width of the layout.
*
* Return value: whether the line had to be ellipsized
...
...
pango/fonts.c
View file @
7f04ed92
...
...
@@ -183,7 +183,7 @@ pango_font_description_get_family (const PangoFontDescription *desc)
*
* The [enum@Pango.Style] enumeration describes whether the font is
* slanted and the manner in which it is slanted; it can be either
*
#
PANGO_STYLE_NORMAL,
#
PANGO_STYLE_ITALIC, or
#
PANGO_STYLE_OBLIQUE.
*
%
PANGO_STYLE_NORMAL,
%
PANGO_STYLE_ITALIC, or
%
PANGO_STYLE_OBLIQUE.
*
* Most fonts will either have a italic style or an oblique style,
* but not both, and font matching in Pango will match italic
...
...
@@ -1803,10 +1803,8 @@ pango_font_find_shaper (PangoFont *font,
* pango_font_get_glyph_extents:
* @font: (nullable): a `PangoFont`
* @glyph: the glyph index
* @ink_rect: (out) (optional): rectangle used to store the extents of the glyph
* as drawn or %NULL to indicate that the result is not needed.
* @logical_rect: (out) (optional): rectangle used to store the logical extents of
* the glyph or %NULL to indicate that the result is not needed.
* @ink_rect: (out) (optional): rectangle used to store the extents of the glyph as drawn
* @logical_rect: (out) (optional): rectangle used to store the logical extents of the glyph
*
* Gets the logical and ink extents of a glyph within a font.
*
...
...
@@ -1893,21 +1891,22 @@ pango_font_get_metrics (PangoFont *font,
/**
* pango_font_get_font_map:
* @font: (nullable): a `PangoFont`
, or %NULL
* @font: (nullable): a `PangoFont`
*
* Gets the font map for which the font was created.
*
* Note that the font maintains a *weak* reference to the font map, so if
* all references to font map are dropped, the font map will be finalized
* even if there are fonts created with the font map that are still alive.
* Note that the font maintains a *weak* reference to
* the font map, so if all references to font map are
* dropped, the font map will be finalized even if there
* are fonts created with the font map that are still alive.
* In that case this function will return %NULL.
*
* It is the responsibility of the user to ensure that the
font map is kept
* alive. In most uses this is not an issue
as a #PangoContext holds
* a reference to the font map.
* It is the responsibility of the user to ensure that the
*
font map is kept
alive. In most uses this is not an issue
*
as a `PangoContext` holds
a reference to the font map.
*
* Return value: (transfer none) (nullable): the `PangoFontMap`
for the
* fo
nt, or %NULL if @font is %NULL.
* Return value: (transfer none) (nullable): the `PangoFontMap`
* fo
r the font
*
* Since: 1.10
*/
...
...
@@ -1947,11 +1946,12 @@ pango_font_get_face (PangoFont *font)
*
* Get a `hb_font_t` object backing this font.
*
* Note that the objects returned by this function are cached and immutable.
* If you need to make changes to the `hb_font_t`, use hb_font_create_sub_font().
* Note that the objects returned by this function are cached
* and immutable. If you need to make changes to the `hb_font_t`,
* use hb_font_create_sub_font().
*
* Returns: (transfer none) (nullable): the `hb_font_t` object
backing the
*
font, or %NULL if the font does not have one
* Returns: (transfer none) (nullable): the `hb_font_t` object
*
backing the font
*
* Since: 1.44
*/
...
...
@@ -2369,13 +2369,13 @@ pango_font_family_real_get_face (PangoFontFamily *family,
* pango_font_family_get_face:
* @family: a `PangoFontFamily`
* @name: (nullable): the name of a face. If the name is %NULL,
*
the family's default face (fontconfig calls it "Regular")
*
will be returned.
* the family's default face (fontconfig calls it "Regular")
* will be returned.
*
* Gets the `PangoFontFace` of @family with the given name.
*
* Returns: (transfer none) (nullable): the `PangoFontFace`,
*
or %NULL if no face with the given name exists.
* or %NULL if no face with the given name exists.
*
* Since: 1.46
*/
...
...
@@ -2526,8 +2526,8 @@ pango_font_face_get_face_name (PangoFontFace *face)
* pango_font_face_list_sizes:
* @face: a `PangoFontFace`.
* @sizes: (out) (array length=n_sizes) (nullable) (optional):
*
location to store a pointer to an array of int. This array
*
should be freed with g_free().
* location to store a pointer to an array of int. This array
* should be freed with g_free().
* @n_sizes: location to store the number of elements in @sizes
*
* List the available sizes for a font.
...
...
pango/glyphstring.c
View file @
7f04ed92
...
...
@@ -31,7 +31,7 @@
* Create a new `PangoGlyphString`.
*
* Return value: the newly allocated `PangoGlyphString`, which
*
should be freed with [method@Pango.GlyphString.free].
* should be freed with [method@Pango.GlyphString.free].
*/
PangoGlyphString
*
pango_glyph_string_new
(
void
)
...
...
@@ -48,8 +48,8 @@ pango_glyph_string_new (void)
/**
* pango_glyph_string_set_size:
* @string:
a `PangoGlyphString`.
* @new_len:
the new length of the string
.
* @string: a `PangoGlyphString`.
* @new_len: the new length of the string
*
* Resize a glyph string to the given length.
*/
...
...
@@ -97,13 +97,13 @@ G_DEFINE_BOXED_TYPE (PangoGlyphString, pango_glyph_string,
/**
* pango_glyph_string_copy:
* @string: (nullable): a `PangoGlyphString`
, may be %NULL
* @string: (nullable): a `PangoGlyphString`
*
* Copy a glyph string and associated storage.
*
* Return value: (nullable): the newly allocated `PangoGlyphString`
,
*
which should be freed with [method@Pango.GlyphString.free],
*
or %NULL if @string was %NULL.
* Return value: (nullable): the newly allocated `PangoGlyphString`
* which should be freed with [method@Pango.GlyphString.free],
* or %NULL if @string was %NULL.
*/
PangoGlyphString
*
pango_glyph_string_copy
(
PangoGlyphString
*
string
)
...
...
@@ -144,17 +144,15 @@ pango_glyph_string_free (PangoGlyphString *string)
/**
* pango_glyph_string_extents_range:
* @glyphs:
a `PangoGlyphString`
* @start:
start index
* @end:
end index (the range is the set of bytes with
indices such that start <= index < end)
* @font:
a `PangoFont`
* @glyphs: a `PangoGlyphString`
* @start: start index
* @end: end index (the range is the set of bytes with
*
indices such that start <= index < end)
* @font: a `PangoFont`
* @ink_rect: (out caller-allocates) (optional): rectangle used to
* store the extents of the glyph string range as drawn or
* %NULL to indicate that the result is not needed.
* store the extents of the glyph string range as drawn
* @logical_rect: (out caller-allocates) (optional): rectangle used to
* store the logical extents of the glyph string range or
* %NULL to indicate that the result is not needed.
* store the logical extents of the glyph string range
*
* Computes the extents of a sub-portion of a glyph string.
*
...
...
@@ -262,12 +260,10 @@ pango_glyph_string_extents_range (PangoGlyphString *glyphs,
/**
* pango_glyph_string_extents:
* @glyphs: a `PangoGlyphString`
* @font: a `PangoFont`
* @ink_rect: (out) (optional): rectangle used to store the extents of the glyph string
* as drawn or %NULL to indicate that the result is not needed.
* @logical_rect: (out) (optional): rectangle used to store the logical extents of the
* glyph string or %NULL to indicate that the result is not needed.
* @glyphs: a `PangoGlyphString`
* @font: a `PangoFont`
* @ink_rect: (out) (optional): rectangle used to store the extents of the glyph string as drawn
* @logical_rect: (out) (optional): rectangle used to store the logical extents of the glyph string
*
* Compute the logical and ink extents of a glyph string.
*
...
...
@@ -322,9 +318,8 @@ pango_glyph_string_get_width (PangoGlyphString *glyphs)
* @length: the length of @text, in bytes
* @embedding_level: the embedding level of the string
* @logical_widths: (array): an array whose length is the number of
* characters in text (equal to g_utf8_strlen (text,
* length) unless text has NUL bytes) to be filled in
* with the resulting character widths.
* characters in text (equal to `g_utf8_strlen (text, length)` unless
* text has `NUL` bytes) to be filled in with the resulting character widths.
*
* Given a `PangoGlyphString` and corresponding text, determine the width
* corresponding to each character.
...
...
@@ -363,14 +358,14 @@ pango_glyph_string_get_logical_widths (PangoGlyphString *glyphs,
/**
* pango_glyph_string_index_to_x:
* @glyphs:
the glyphs return from [func@shape]
* @text:
the text for the run
* @length:
the number of bytes (not characters) in @text.
* @analysis:
the analysis information return from [func@itemize]
* @index_:
the byte index within @text
* @trailing:
whether we should compute the result for the beginning (%FALSE)
*
or end (%TRUE) of the character.
* @x_pos:
(out): location to store result
* @glyphs: the glyphs return from [func@shape]
* @text: the text for the run
* @length: the number of bytes (not characters) in @text.
* @analysis: the analysis information return from [func@itemize]
* @index_: the byte index within @text
* @trailing: whether we should compute the result for the beginning (%FALSE)
* or end (%TRUE) of the character.
* @x_pos: (out): location to store result
*
* Converts from character position to x position.
*
...
...
@@ -378,7 +373,6 @@ pango_glyph_string_get_logical_widths (PangoGlyphString *glyphs,
* Character positions are computed by dividing up each cluster
* into equal portions.
*/
void
pango_glyph_string_index_to_x
(
PangoGlyphString
*
glyphs
,
char
*
text
,
...
...
@@ -493,15 +487,14 @@ pango_glyph_string_index_to_x (PangoGlyphString *glyphs,
/**
* pango_glyph_string_x_to_index:
* @glyphs: the glyphs returned from [func@shape]
* @text: the text for the run
* @length: the number of bytes (not characters) in text.
* @analysis: the analysis information return from [func@itemize]
* @x_pos: the x offset (in Pango units)
* @index_: (out): location to store calculated byte index within @text
* @trailing: (out): location to store a boolean indicating
* whether the user clicked on the leading or trailing
* edge of the character.
* @glyphs: the glyphs returned from [func@shape]
* @text: the text for the run
* @length: the number of bytes (not characters) in text.
* @analysis: the analysis information return from [func@itemize]
* @x_pos: the x offset (in Pango units)
* @index_: (out): location to store calculated byte index within @text
* @trailing: (out): location to store a boolean indicating whether the
* user clicked on the leading or trailing edge of the character
*
* Convert from x offset to character position.
*
...
...
pango/modules.c
View file @
7f04ed92
...
...
@@ -45,8 +45,8 @@ pango_find_map (PangoLanguage *language G_GNUC_UNUSED,
/**
* pango_map_get_engine: (skip)
* @map: a
#
PangoMap
* @script: a
#
PangoScript
* @map: a
`
PangoMap
`
* @script: a
`
PangoScript
`
*
* Do not use. Does not do anything.
*
...
...
@@ -63,8 +63,8 @@ pango_map_get_engine (PangoMap *map G_GNUC_UNUSED,
/**
* pango_map_get_engines: (skip)
* @map: a
#
PangoMap
* @script: a
#
PangoScript
* @map: a
`
PangoMap
`
* @script: a
`
PangoScript
`
* @exact_engines: (nullable): location to store list of engines that exactly
* handle this script.
* @fallback_engines: (nullable): location to store list of engines that
...
...
@@ -89,7 +89,7 @@ pango_map_get_engines (PangoMap *map G_GNUC_UNUSED,
/**
* pango_module_register: (skip)
* @module: a
#
PangoIncludedModule
* @module: a
`
PangoIncludedModule
`
*
* Do not use. Does not do anything.
*
...
...
pango/pango-attributes.c
View file @
7f04ed92
This diff is collapsed.
Click to expand it.
pango/pango-attributes.h
View file @
7f04ed92
...
...
@@ -209,28 +209,28 @@ typedef enum
* @PANGO_UNDERLINE_SINGLE: a single underline should be drawn
* @PANGO_UNDERLINE_DOUBLE: a double underline should be drawn
* @PANGO_UNDERLINE_LOW: a single underline should be drawn at a
*
position beneath the ink extents of the text being
*
underlined. This should be used only for underlining
*
single characters, such as for keyboard accelerators.
*
%PANGO_UNDERLINE_SINGLE should be used for extended
*
portions of text.
* position beneath the ink extents of the text being
* underlined. This should be used only for underlining
* single characters, such as for keyboard accelerators.
* %PANGO_UNDERLINE_SINGLE should be used for extended
* portions of text.
* @PANGO_UNDERLINE_ERROR: an underline indicating an error should
*
be drawn below. The exact style of rendering is up to the
*
`PangoRenderer` in use, but typical styles include wavy
*
or dotted lines.
*
This underline is typically used to indicate an error such
*
as a possible mispelling; in some cases a contrasting color
*
may automatically be used. This type of underlining is
*
available since Pango 1.4.
* be drawn below. The exact style of rendering is up to the
* `PangoRenderer` in use, but typical styles include wavy
* or dotted lines.
* This underline is typically used to indicate an error such
* as a possible mispelling; in some cases a contrasting color
* may automatically be used. This type of underlining is
* available since Pango 1.4.
* @PANGO_UNDERLINE_SINGLE_LINE: Like @PANGO_UNDERLINE_SINGLE, but
*
drawn continuously across multiple runs. This type
*
of underlining is available since Pango 1.46.
* drawn continuously across multiple runs. This type
* of underlining is available since Pango 1.46.
* @PANGO_UNDERLINE_DOUBLE_LINE: Like @PANGO_UNDERLINE_DOUBLE, but
*
drawn continuously across multiple runs. This type
*
of underlining is available since Pango 1.46.
* drawn continuously across multiple runs. This type
* of underlining is available since Pango 1.46.
* @PANGO_UNDERLINE_ERROR_LINE: Like @PANGO_UNDERLINE_ERROR, but
*
drawn continuously across multiple runs. This type
*
of underlining is available since Pango 1.46.
* drawn continuously across multiple runs. This type
* of underlining is available since Pango 1.46.
*
* The `PangoUnderline` enumeration is used to specify whether text
* should be underlined, and if so, the type of underlining.
...
...
@@ -251,7 +251,7 @@ typedef enum {
* PangoOverline:
* @PANGO_OVERLINE_NONE: no overline should be drawn
* @PANGO_OVERLINE_SINGLE: Draw a single line above the ink
*
extents of the text being underlined.
* extents of the text being underlined.
*
* The `PangoOverline` enumeration is used to specify whether text
* should be overlined, and if so, the type of line.
...
...
@@ -596,7 +596,7 @@ PangoAttribute *pango_attr_overline_color_new (guint16 red,
* @PANGO_SHOW_SPACES: Render spaces, tabs and newlines visibly
* @PANGO_SHOW_LINE_BREAKS: Render line breaks visibly
* @PANGO_SHOW_IGNORABLES: Render default-ignorable Unicode
*
characters visibly
* characters visibly
*
* These flags affect how Pango treats characters that are normally
* not visible in the output.
...
...
pango/pango-bidi-type.c
View file @
7f04ed92
...
...
@@ -91,9 +91,9 @@ pango_bidi_type_for_unichar (gunichar ch)
/**
* pango_log2vis_get_embedding_levels:
* @text:
the text to itemize.
* @length:
the number of bytes (not characters) to process, or -1
*
if @text is nul-terminated and the length should be calculated.
* @text: the text to itemize.
* @length: the number of bytes (not characters) to process, or -1
* if @text is nul-terminated and the length should be calculated.
* @pbase_dir: input base direction, and output resolved direction.
*
* Return the bidirectional embedding levels of the input paragraph.
...
...
pango/pango-color.c
View file @
7f04ed92
...
...
@@ -34,18 +34,18 @@ G_DEFINE_BOXED_TYPE (PangoColor, pango_color,
/**
* pango_color_copy:
* @src: (nullable): color to copy
, may be %NULL
* @src: (nullable): color to copy
*
* Creates a copy of @src.
*
* The copy should be freed with pango_color_free(). Primarily
* used by language bindings, not that useful otherwise (since
* colors can just be copied by assignment in C).
* The copy should be freed with [method@Pango.Color.free].
* Primarily used by language bindings, not that useful
* otherwise (since colors can just be copied by assignment
* in C).
*
* Return value: (nullable): the newly allocated `PangoColor`, which
* should be freed with [method@Pango.Color.free], or %NULL if
* @src was %NULL.
**/
* Return value: (nullable): the newly allocated `PangoColor`,
* which should be freed with [method@Pango.Color.free]
*/
PangoColor
*
pango_color_copy
(
const
PangoColor
*
src
)
{
...
...
@@ -63,10 +63,10 @@ pango_color_copy (const PangoColor *src)
/**
* pango_color_free:
* @color: (nullable): an allocated
#
PangoColor
, may be %NULL
* @color: (nullable): an allocated
`
PangoColor
`
*
* Frees a color allocated by
pango_color_
copy
()
.
*
*/
* Frees a color allocated by
[ctor@Pango.
copy
]
.
*/
void
pango_color_free
(
PangoColor
*
color
)
{
...
...
@@ -78,18 +78,19 @@ pango_color_free (PangoColor *color)
/**
* pango_color_to_string:
* @color: a
#
PangoColor
* @color: a
`
PangoColor
`
*
* Returns a textual specification of @color.
*
* The string is in the hexadecimal form `#rrrrggggbbbb`,
where
* `r`, `g` and `b` are hex digits representing the
red, green,
* and blue components respectively.
* The string is in the hexadecimal form `#rrrrggggbbbb`,
*
where
`r`, `g` and `b` are hex digits representing the
*
red, green,
and blue components respectively.
*
* Return value: a newly-allocated text string that must be freed with g_free().
* Return value: a newly-allocated text string that must
* be freed with g_free().
*
* Since: 1.16
*
*/
*/
gchar
*
pango_color_to_string
(
const
PangoColor
*
color
)
{
...
...
@@ -211,27 +212,29 @@ hex (const char *spec,
/**
* pango_color_parse_with_alpha:
* @color: (nullable): a `PangoColor` structure in which
to store the
*
result, or %NULL
* @alpha: (out) (optional): return location for alpha
, or %NULL
* @color: (nullable): a `PangoColor` structure in which
*
to store the result
* @alpha: (out) (optional): return location for alpha
* @spec: a string specifying the new color
*
* Fill in the fields of a color from a string specification.
*
* The string can
*
either one of a large set of standard names. (Taken from the CSS C
olor
*
[specification](https://www.w3.org/TR/css-color-4/#named-colors)
,
*
or it can be a hexadecimal value in the form
`#rgb`, `#rrggbb`
,
`#rrrgggbbb`
*
or `#rrrrggggbbbb` where `r`, `g`
and `b` are hex digits of the red, green,
*
and blue components
of the color, respectively. (White in the four
*
forms is
`#fff`, `#ffffff`, `#fffffffff` and `#ffffffffffff`.)
* The string can
either one of a large set of standard names.
*
(Taken from the CSS Color [specification](https://www.w3.org/TR/css-color-4/#named-c
olor
s),
*
or it can be a hexadecimal value in the form `#rgb`
,
* `#
r
rg
gb
b`, `#rr
r
gg
gb
bb`
or
`#rrr
rg
gggbbb
b` where `r`, `g
`
* and `b` are hex digits of the red, green,
and blue components
* of the color, respectively. (White in the four
forms is
* `#fff`, `#ffffff`, `#fffffffff` and `#ffffffffffff`.)
*
* Additionally, parse strings of the form `#rgba`, `#rrggbbaa`,
* `#rrrrggggbbbbaaaa`, if @alpha is not %NULL, and set @alpha to the value
* specified by the hex digits for `a`. If no alpha component is found
* in @spec, @alpha is set to 0xffff (for a solid color).
* `#rrrrggggbbbbaaaa`, if @alpha is not %NULL, and set @alpha
* to the value specified by the hex digits for `a`. If no alpha
* component is found in @spec, @alpha is set to 0xffff (for a
* solid color).
*
* Return value: %TRUE if parsing of the specifier succeeded, otherwise false.
* Return value: %TRUE if parsing of the specifier succeeded,
* otherwise %FALSE
*
* Since: 1.46
*/
...
...
@@ -320,22 +323,23 @@ pango_color_parse_with_alpha (PangoColor *color,
/**
* pango_color_parse:
* @color: (nullable): a `PangoColor` structure in which
to store the
*
result, or %NULL
* @color: (nullable): a `PangoColor` structure in which
*
to store the result
* @spec: a string specifying the new color
*
* Fill in the fields of a color from a string specification.
*