[docs] regularize whitespace in function params

This commit is contained in:
Nathan Willis 2019-04-17 14:44:25 +01:00 committed by Khaled Hosny
parent 954167143b
commit ec98730ff6
1 changed files with 295 additions and 268 deletions

View File

@ -43,10 +43,12 @@
* @short_description: Font objects
* @include: hb.h
*
* Font objects represent a font face at a certain size and other
* parameters (pixels per EM, points per EM, variation settings.)
* Fonts are created from font faces, and are used as input to
* hb_shape() among other things.
* Functions for working with font objects.
*
* A font object represents a font face at a specific size and with
* certain other parameters (pixels-per-EM, points-per-EM, variation
* settings) specified. Font objects are created from font face
* objects, and are used as input to hb_shape(), among other things.
**/
@ -435,7 +437,8 @@ static hb_bool_t
hb_font_get_glyph_name_nil (hb_font_t *font HB_UNUSED,
void *font_data HB_UNUSED,
hb_codepoint_t glyph HB_UNUSED,
char *name, unsigned int size,
char *name,
unsigned int size,
void *user_data HB_UNUSED)
{
if (size) *name = '\0';
@ -445,7 +448,8 @@ static hb_bool_t
hb_font_get_glyph_name_default (hb_font_t *font,
void *font_data HB_UNUSED,
hb_codepoint_t glyph,
char *name, unsigned int size,
char *name,
unsigned int size,
void *user_data HB_UNUSED)
{
return font->parent->get_glyph_name (glyph, name, size);
@ -465,7 +469,8 @@ hb_font_get_glyph_from_name_nil (hb_font_t *font HB_UNUSED,
static hb_bool_t
hb_font_get_glyph_from_name_default (hb_font_t *font,
void *font_data HB_UNUSED,
const char *name, int len, /* -1 means nul-terminated */
const char *name,
int len, /* -1 means nul-terminated */
hb_codepoint_t *glyph,
void *user_data HB_UNUSED)
{
@ -767,7 +772,8 @@ hb_font_get_v_extents (hb_font_t *font,
**/
hb_bool_t
hb_font_get_glyph (hb_font_t *font,
hb_codepoint_t unicode, hb_codepoint_t variation_selector,
hb_codepoint_t unicode,
hb_codepoint_t variation_selector,
hb_codepoint_t *glyph)
{
if (unlikely (variation_selector))
@ -833,7 +839,8 @@ hb_font_get_nominal_glyphs (hb_font_t *font,
**/
hb_bool_t
hb_font_get_variation_glyph (hb_font_t *font,
hb_codepoint_t unicode, hb_codepoint_t variation_selector,
hb_codepoint_t unicode,
hb_codepoint_t variation_selector,
hb_codepoint_t *glyph)
{
return font->get_variation_glyph (unicode, variation_selector, glyph);
@ -928,7 +935,8 @@ hb_font_get_glyph_v_advances (hb_font_t* font,
hb_bool_t
hb_font_get_glyph_h_origin (hb_font_t *font,
hb_codepoint_t glyph,
hb_position_t *x, hb_position_t *y)
hb_position_t *x,
hb_position_t *y)
{
return font->get_glyph_h_origin (glyph, x, y);
}
@ -949,7 +957,8 @@ hb_font_get_glyph_h_origin (hb_font_t *font,
hb_bool_t
hb_font_get_glyph_v_origin (hb_font_t *font,
hb_codepoint_t glyph,
hb_position_t *x, hb_position_t *y)
hb_position_t *x,
hb_position_t *y)
{
return font->get_glyph_v_origin (glyph, x, y);
}
@ -968,7 +977,8 @@ hb_font_get_glyph_v_origin (hb_font_t *font,
**/
hb_position_t
hb_font_get_glyph_h_kerning (hb_font_t *font,
hb_codepoint_t left_glyph, hb_codepoint_t right_glyph)
hb_codepoint_t left_glyph,
hb_codepoint_t right_glyph)
{
return font->get_glyph_h_kerning (left_glyph, right_glyph);
}
@ -989,7 +999,8 @@ hb_font_get_glyph_h_kerning (hb_font_t *font,
**/
hb_position_t
hb_font_get_glyph_v_kerning (hb_font_t *font,
hb_codepoint_t top_glyph, hb_codepoint_t bottom_glyph)
hb_codepoint_t top_glyph,
hb_codepoint_t bottom_glyph)
{
return font->get_glyph_v_kerning (top_glyph, bottom_glyph);
}
@ -1031,8 +1042,10 @@ hb_font_get_glyph_extents (hb_font_t *font,
**/
hb_bool_t
hb_font_get_glyph_contour_point (hb_font_t *font,
hb_codepoint_t glyph, unsigned int point_index,
hb_position_t *x, hb_position_t *y)
hb_codepoint_t glyph,
unsigned int point_index,
hb_position_t *x,
hb_position_t *y)
{
return font->get_glyph_contour_point (glyph, point_index, x, y);
}
@ -1053,7 +1066,8 @@ hb_font_get_glyph_contour_point (hb_font_t *font,
hb_bool_t
hb_font_get_glyph_name (hb_font_t *font,
hb_codepoint_t glyph,
char *name, unsigned int size)
char *name,
unsigned int size)
{
return font->get_glyph_name (glyph, name, size);
}
@ -1073,7 +1087,8 @@ hb_font_get_glyph_name (hb_font_t *font,
**/
hb_bool_t
hb_font_get_glyph_from_name (hb_font_t *font,
const char *name, int len, /* -1 means nul-terminated */
const char *name,
int len, /* -1 means nul-terminated */
hb_codepoint_t *glyph)
{
return font->get_glyph_from_name (name, len, glyph);
@ -1115,7 +1130,8 @@ void
hb_font_get_glyph_advance_for_direction (hb_font_t *font,
hb_codepoint_t glyph,
hb_direction_t direction,
hb_position_t *x, hb_position_t *y)
hb_position_t *x,
hb_position_t *y)
{
return font->get_glyph_advance_for_direction (glyph, direction, x, y);
}
@ -1156,7 +1172,8 @@ void
hb_font_get_glyph_origin_for_direction (hb_font_t *font,
hb_codepoint_t glyph,
hb_direction_t direction,
hb_position_t *x, hb_position_t *y)
hb_position_t *x,
hb_position_t *y)
{
return font->get_glyph_origin_for_direction (glyph, direction, x, y);
}
@ -1177,7 +1194,8 @@ void
hb_font_add_glyph_origin_for_direction (hb_font_t *font,
hb_codepoint_t glyph,
hb_direction_t direction,
hb_position_t *x, hb_position_t *y)
hb_position_t *x,
hb_position_t *y)
{
return font->add_glyph_origin_for_direction (glyph, direction, x, y);
}
@ -1198,7 +1216,8 @@ void
hb_font_subtract_glyph_origin_for_direction (hb_font_t *font,
hb_codepoint_t glyph,
hb_direction_t direction,
hb_position_t *x, hb_position_t *y)
hb_position_t *x,
hb_position_t *y)
{
return font->subtract_glyph_origin_for_direction (glyph, direction, x, y);
}
@ -1218,9 +1237,11 @@ hb_font_subtract_glyph_origin_for_direction (hb_font_t *font,
**/
void
hb_font_get_glyph_kerning_for_direction (hb_font_t *font,
hb_codepoint_t first_glyph, hb_codepoint_t second_glyph,
hb_codepoint_t first_glyph,
hb_codepoint_t second_glyph,
hb_direction_t direction,
hb_position_t *x, hb_position_t *y)
hb_position_t *x,
hb_position_t *y)
{
return font->get_glyph_kerning_for_direction (first_glyph, second_glyph, direction, x, y);
}
@ -1264,9 +1285,11 @@ hb_font_get_glyph_extents_for_origin (hb_font_t *font,
**/
hb_bool_t
hb_font_get_glyph_contour_point_for_origin (hb_font_t *font,
hb_codepoint_t glyph, unsigned int point_index,
hb_codepoint_t glyph,
unsigned int point_index,
hb_direction_t direction,
hb_position_t *x, hb_position_t *y)
hb_position_t *x,
hb_position_t *y)
{
return font->get_glyph_contour_point_for_origin (glyph, point_index, direction, x, y);
}
@ -1286,7 +1309,8 @@ hb_font_get_glyph_contour_point_for_origin (hb_font_t *font,
void
hb_font_glyph_to_string (hb_font_t *font,
hb_codepoint_t glyph,
char *s, unsigned int size)
char *s,
unsigned int size)
{
font->glyph_to_string (glyph, s, size);
}
@ -1307,7 +1331,8 @@ hb_font_glyph_to_string (hb_font_t *font,
**/
hb_bool_t
hb_font_glyph_from_string (hb_font_t *font,
const char *s, int len, /* -1 means nul-terminated */
const char *s,
int len, /* -1 means nul-terminated */
hb_codepoint_t *glyph)
{
return font->glyph_from_string (s, len, glyph);
@ -1840,7 +1865,8 @@ hb_font_get_ppem (hb_font_t *font,
* Since: 1.6.0
**/
void
hb_font_set_ptem (hb_font_t *font, float ptem)
hb_font_set_ptem (hb_font_t *font,
float ptem)
{
if (hb_object_is_immutable (font))
return;
@ -2153,7 +2179,8 @@ hb_font_get_variation_glyph_trampoline (hb_font_t *font,
void
hb_font_funcs_set_glyph_func (hb_font_funcs_t *ffuncs,
hb_font_get_glyph_func_t func,
void *user_data, hb_destroy_func_t destroy)
void *user_data,
hb_destroy_func_t destroy)
{
if (hb_object_is_immutable (ffuncs))
{