minhngoc25a
/
freetype2
mirror of git://git.savannah.gnu.org/freetype/freetype2.git
2
1
Fork 2
Code Issues 4 Releases Wiki Activity

s/`....`/'....'/ for SFNT table tags in documentation.

This commit is contained in:
Werner Lemberg 2019-02-21 09:19:09 +01:00
parent 8de11f3def
commit a346abc093
15 changed files with 123 additions and 123 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

14
devel/ftoption.h
View File

@ -299,13 +299,13 @@ FT_BEGIN_HEADER
* By default, FreeType 2 is compiled with the 'psnames' module. This * By default, FreeType 2 is compiled with the 'psnames' module. This
* module is in charge of converting a glyph name string into a Unicode * module is in charge of converting a glyph name string into a Unicode
* value, or return a Macintosh standard glyph name for the use with the * value, or return a Macintosh standard glyph name for the use with the
* TrueType `post` table. * TrueType 'post' table.
* *
* Undefine this macro if you do not want 'psnames' compiled in your * Undefine this macro if you do not want 'psnames' compiled in your
* build of FreeType. This has the following effects: * build of FreeType. This has the following effects:
* *
* - The TrueType driver will provide its own set of glyph names, if you * - The TrueType driver will provide its own set of glyph names, if you
* build it to support postscript names in the TrueType `post` table, * build it to support postscript names in the TrueType 'post' table,
* but will not synthesize a missing Unicode charmap. * but will not synthesize a missing Unicode charmap.
* *
* - The Type~1 driver will not be able to synthesize a Unicode charmap * - The Type~1 driver will not be able to synthesize a Unicode charmap
@ -342,7 +342,7 @@ FT_BEGIN_HEADER
* (mac dfont, mac resource, macbinary containing a mac resource) on * (mac dfont, mac resource, macbinary containing a mac resource) on
* non-Mac platforms. * non-Mac platforms.
* *
* Note that the `FOND` resource isn't checked. * Note that the 'FOND' resource isn't checked.
*/ */
#define FT_CONFIG_OPTION_MAC_FONTS #define FT_CONFIG_OPTION_MAC_FONTS
@ -527,7 +527,7 @@ FT_BEGIN_HEADER
/************************************************************************** /**************************************************************************
* *
* Define `TT_CONFIG_OPTION_COLOR_LAYERS` if you want to support coloured * Define `TT_CONFIG_OPTION_COLOR_LAYERS` if you want to support coloured
* outlines (from the `COLR`/`CPAL` tables) in all formats using the 'sfnt' * outlines (from the 'COLR'/'CPAL' tables) in all formats using the 'sfnt'
* module (namely TrueType~& OpenType). * module (namely TrueType~& OpenType).
*/ */
#define TT_CONFIG_OPTION_COLOR_LAYERS #define TT_CONFIG_OPTION_COLOR_LAYERS
@ -684,8 +684,8 @@ FT_BEGIN_HEADER
/************************************************************************** /**************************************************************************
* *
* Define `TT_CONFIG_OPTION_GX_VAR_SUPPORT` if you want to include support * Define `TT_CONFIG_OPTION_GX_VAR_SUPPORT` if you want to include support
* for Apple's distortable font technology (`fvar`, `gvar`, `cvar`, and * for Apple's distortable font technology ('fvar', 'gvar', 'cvar', and
* `avar` tables). Tagged 'Font Variations', this is now part of OpenType * 'avar' tables). Tagged 'Font Variations', this is now part of OpenType
* also. This has many similarities to Type~1 Multiple Masters support. * also. This has many similarities to Type~1 Multiple Masters support.
*/ */
#define TT_CONFIG_OPTION_GX_VAR_SUPPORT #define TT_CONFIG_OPTION_GX_VAR_SUPPORT
@ -694,7 +694,7 @@ FT_BEGIN_HEADER
/************************************************************************** /**************************************************************************
* *
* Define `TT_CONFIG_OPTION_BDF` if you want to include support for an * Define `TT_CONFIG_OPTION_BDF` if you want to include support for an
* embedded `BDF ` table within SFNT-based bitmap formats. * embedded 'BDF~' table within SFNT-based bitmap formats.
*/ */
#define TT_CONFIG_OPTION_BDF #define TT_CONFIG_OPTION_BDF

10
include/freetype/config/ftheader.h
View File

@ -624,8 +624,8 @@
* *
* @description: * @description:
* A macro used in `#include` statements to name the file containing the * A macro used in `#include` statements to name the file containing the
* optional FreeType~2 API which validates OpenType tables (`BASE`, * optional FreeType~2 API which validates OpenType tables ('BASE',
* `GDEF`, `GPOS`, `GSUB`, `JSTF`). * 'GDEF', 'GPOS', 'GSUB', 'JSTF').
* *
*/ */
#define FT_OPENTYPE_VALIDATE_H <freetype/ftotval.h> #define FT_OPENTYPE_VALIDATE_H <freetype/ftotval.h>
@ -638,8 +638,8 @@
* *
* @description: * @description:
* A macro used in `#include` statements to name the file containing the * A macro used in `#include` statements to name the file containing the
* optional FreeType~2 API which validates TrueTypeGX/AAT tables (`feat`, * optional FreeType~2 API which validates TrueTypeGX/AAT tables ('feat',
* `mort`, `morx`, `bsln`, `just`, `kern`, `opbd`, `trak`, `prop`). * 'mort', 'morx', 'bsln', 'just', 'kern', 'opbd', 'trak', 'prop').
* *
*/ */
#define FT_GX_VALIDATE_H <freetype/ftgxval.h> #define FT_GX_VALIDATE_H <freetype/ftgxval.h>
@ -765,7 +765,7 @@
* *
* @description: * @description:
* A macro used in `#include` statements to name the file containing the * A macro used in `#include` statements to name the file containing the
* FreeType~2 API which handles the OpenType `CPAL` table. * FreeType~2 API which handles the OpenType 'CPAL' table.
*/ */
#define FT_COLOR_H <freetype/ftcolor.h> #define FT_COLOR_H <freetype/ftcolor.h>

14
include/freetype/config/ftoption.h
View File

@ -299,13 +299,13 @@ FT_BEGIN_HEADER
* By default, FreeType 2 is compiled with the 'psnames' module. This * By default, FreeType 2 is compiled with the 'psnames' module. This
* module is in charge of converting a glyph name string into a Unicode * module is in charge of converting a glyph name string into a Unicode
* value, or return a Macintosh standard glyph name for the use with the * value, or return a Macintosh standard glyph name for the use with the
* TrueType `post` table. * TrueType 'post' table.
* *
* Undefine this macro if you do not want 'psnames' compiled in your * Undefine this macro if you do not want 'psnames' compiled in your
* build of FreeType. This has the following effects: * build of FreeType. This has the following effects:
* *
* - The TrueType driver will provide its own set of glyph names, if you * - The TrueType driver will provide its own set of glyph names, if you
* build it to support postscript names in the TrueType `post` table, * build it to support postscript names in the TrueType 'post' table,
* but will not synthesize a missing Unicode charmap. * but will not synthesize a missing Unicode charmap.
* *
* - The Type~1 driver will not be able to synthesize a Unicode charmap * - The Type~1 driver will not be able to synthesize a Unicode charmap
@ -342,7 +342,7 @@ FT_BEGIN_HEADER
* (mac dfont, mac resource, macbinary containing a mac resource) on * (mac dfont, mac resource, macbinary containing a mac resource) on
* non-Mac platforms. * non-Mac platforms.
* *
* Note that the `FOND` resource isn't checked. * Note that the 'FOND' resource isn't checked.
*/ */
#define FT_CONFIG_OPTION_MAC_FONTS #define FT_CONFIG_OPTION_MAC_FONTS
@ -527,7 +527,7 @@ FT_BEGIN_HEADER
/************************************************************************** /**************************************************************************
* *
* Define `TT_CONFIG_OPTION_COLOR_LAYERS` if you want to support coloured * Define `TT_CONFIG_OPTION_COLOR_LAYERS` if you want to support coloured
* outlines (from the `COLR`/`CPAL` tables) in all formats using the 'sfnt' * outlines (from the 'COLR'/'CPAL' tables) in all formats using the 'sfnt'
* module (namely TrueType~& OpenType). * module (namely TrueType~& OpenType).
*/ */
#define TT_CONFIG_OPTION_COLOR_LAYERS #define TT_CONFIG_OPTION_COLOR_LAYERS
@ -684,8 +684,8 @@ FT_BEGIN_HEADER
/************************************************************************** /**************************************************************************
* *
* Define `TT_CONFIG_OPTION_GX_VAR_SUPPORT` if you want to include support * Define `TT_CONFIG_OPTION_GX_VAR_SUPPORT` if you want to include support
* for Apple's distortable font technology (`fvar`, `gvar`, `cvar`, and * for Apple's distortable font technology ('fvar', 'gvar', 'cvar', and
* `avar` tables). Tagged 'Font Variations', this is now part of OpenType * 'avar' tables). Tagged 'Font Variations', this is now part of OpenType
* also. This has many similarities to Type~1 Multiple Masters support. * also. This has many similarities to Type~1 Multiple Masters support.
*/ */
#define TT_CONFIG_OPTION_GX_VAR_SUPPORT #define TT_CONFIG_OPTION_GX_VAR_SUPPORT
@ -694,7 +694,7 @@ FT_BEGIN_HEADER
/************************************************************************** /**************************************************************************
* *
* Define `TT_CONFIG_OPTION_BDF` if you want to include support for an * Define `TT_CONFIG_OPTION_BDF` if you want to include support for an
* embedded `BDF ` table within SFNT-based bitmap formats. * embedded 'BDF~' table within SFNT-based bitmap formats.
*/ */
#define TT_CONFIG_OPTION_BDF #define TT_CONFIG_OPTION_BDF

28
include/freetype/freetype.h
View File

@ -308,7 +308,7 @@ FT_BEGIN_HEADER
* `horiAdvance` or `vertAdvance`; you have to manually adjust these * `horiAdvance` or `vertAdvance`; you have to manually adjust these
* values to account for the added width and height. * values to account for the added width and height.
* *
* FreeType doesn't use the `VORG` table data for CFF fonts because it * FreeType doesn't use the 'VORG' table data for CFF fonts because it
* doesn't have an interface to quickly retrieve the glyph height. The * doesn't have an interface to quickly retrieve the glyph height. The
* y~coordinate of the vertical origin can be simply computed as * y~coordinate of the vertical origin can be simply computed as
* `vertBearingY + height` after loading a glyph. * `vertBearingY + height` after loading a glyph.
@ -1032,7 +1032,7 @@ FT_BEGIN_HEADER
* *
* For an OpenType variation font, the values of the following fields can * For an OpenType variation font, the values of the following fields can
* change after a call to @FT_Set_Var_Design_Coordinates (and friends) if * change after a call to @FT_Set_Var_Design_Coordinates (and friends) if
* the font contains an `MVAR` table: `ascender`, `descender`, `height`, * the font contains an 'MVAR' table: `ascender`, `descender`, `height`,
* `underline_position`, and `underline_thickness`. * `underline_position`, and `underline_thickness`.
* *
* Especially for TrueType fonts see also the documentation for * Especially for TrueType fonts see also the documentation for
@ -1137,7 +1137,7 @@ FT_BEGIN_HEADER
* The face contains kerning information. If set, the kerning distance * The face contains kerning information. If set, the kerning distance
* can be retrieved using the function @FT_Get_Kerning. Otherwise the * can be retrieved using the function @FT_Get_Kerning. Otherwise the
* function always return the vector (0,0). Note that FreeType doesn't * function always return the vector (0,0). Note that FreeType doesn't
* handle kerning data from the SFNT `GPOS` table (as present in many * handle kerning data from the SFNT 'GPOS' table (as present in many
* OpenType fonts). * OpenType fonts).
* *
* FT_FACE_FLAG_FAST_GLYPHS :: * FT_FACE_FLAG_FAST_GLYPHS ::
@ -1163,7 +1163,7 @@ FT_BEGIN_HEADER
* *
* FT_FACE_FLAG_HINTER :: * FT_FACE_FLAG_HINTER ::
* The font driver has a hinting machine of its own. For example, with * The font driver has a hinting machine of its own. For example, with
* TrueType fonts, it makes sense to use data from the SFNT `gasp` * TrueType fonts, it makes sense to use data from the SFNT 'gasp'
* table only if the native TrueType hinting engine (with the bytecode * table only if the native TrueType hinting engine (with the bytecode
* interpreter) is available and active. * interpreter) is available and active.
* *
@ -1482,7 +1482,7 @@ FT_BEGIN_HEADER
* @note: * @note:
* The style information as provided by FreeType is very basic. More * The style information as provided by FreeType is very basic. More
* details are beyond the scope and should be done on a higher level (for * details are beyond the scope and should be done on a higher level (for
* example, by analyzing various fields of the `OS/2` table in SFNT based * example, by analyzing various fields of the 'OS/2' table in SFNT based
* fonts). * fonts).
*/ */
#define FT_STYLE_FLAG_ITALIC ( 1 << 0 ) #define FT_STYLE_FLAG_ITALIC ( 1 << 0 )
@ -2969,7 +2969,7 @@ FT_BEGIN_HEADER
* bitmaps, using the @FT_PIXEL_MODE_GRAY format. * bitmaps, using the @FT_PIXEL_MODE_GRAY format.
* *
* [Since 2.10] If the glyph index contains an entry in the face's * [Since 2.10] If the glyph index contains an entry in the face's
* `COLR` table with a `CPAL` palette table (as defined in the OpenType * 'COLR' table with a 'CPAL' palette table (as defined in the OpenType
* specification), make @FT_Render_Glyph provide a default blending of * specification), make @FT_Render_Glyph provide a default blending of
* the color glyph layers associated with the glyph index, using the * the color glyph layers associated with the glyph index, using the
* same bitmap format as embedded color bitmap images. This is mainly * same bitmap format as embedded color bitmap images. This is mainly
@ -2980,7 +2980,7 @@ FT_BEGIN_HEADER
* *
* FT_LOAD_COMPUTE_METRICS :: * FT_LOAD_COMPUTE_METRICS ::
* [Since 2.6.1] Compute glyph metrics from the glyph data, without the * [Since 2.6.1] Compute glyph metrics from the glyph data, without the
* use of bundled metrics tables (for example, the `hdmx` table in * use of bundled metrics tables (for example, the 'hdmx' table in
* TrueType fonts). This flag is mainly used by font validating or * TrueType fonts). This flag is mainly used by font validating or
* font editing applications, which need to ignore, verify, or edit * font editing applications, which need to ignore, verify, or edit
* those tables. * those tables.
@ -3460,7 +3460,7 @@ FT_BEGIN_HEADER
* out of the scope of this API function -- they can be implemented * out of the scope of this API function -- they can be implemented
* through format-specific interfaces. * through format-specific interfaces.
* *
* Kerning for OpenType fonts implemented in a `GPOS` table is not * Kerning for OpenType fonts implemented in a 'GPOS' table is not
* supported; use @FT_HAS_KERNING to find out whether a font has data * supported; use @FT_HAS_KERNING to find out whether a font has data
* that can be extracted with `FT_Get_Kerning`. * that can be extracted with `FT_Get_Kerning`.
*/ */
@ -3590,7 +3590,7 @@ FT_BEGIN_HEADER
* *
* [Since 2.9] Special PostScript names for named instances are only * [Since 2.9] Special PostScript names for named instances are only
* returned if the named instance is set with @FT_Set_Named_Instance (and * returned if the named instance is set with @FT_Set_Named_Instance (and
* the font has corresponding entries in its `fvar` table). If * the font has corresponding entries in its 'fvar' table). If
* @FT_IS_VARIATION returns true, the algorithmically derived PostScript * @FT_IS_VARIATION returns true, the algorithmically derived PostScript
* name is provided, not looking up special entries for named instances. * name is provided, not looking up special entries for named instances.
*/ */
@ -3941,7 +3941,7 @@ FT_BEGIN_HEADER
* FT_SUBGLYPH_FLAG_XXX * FT_SUBGLYPH_FLAG_XXX
* *
* @description: * @description:
* A list of constants describing subglyphs. Please refer to the `glyf` * A list of constants describing subglyphs. Please refer to the 'glyf'
* table description in the OpenType specification for the meaning of the * table description in the OpenType specification for the meaning of the
* various flags (which get synthesized for non-OpenType subglyphs). * various flags (which get synthesized for non-OpenType subglyphs).
* *
@ -4030,11 +4030,11 @@ FT_BEGIN_HEADER
* Glyph Layer Management * Glyph Layer Management
* *
* @abstract: * @abstract:
* Retrieving and manipulating OpenType's `COLR` table data. * Retrieving and manipulating OpenType's 'COLR' table data.
* *
* @description: * @description:
* The functions described here allow access of colored glyph layer data * The functions described here allow access of colored glyph layer data
* in OpenType's `COLR` tables. * in OpenType's 'COLR' tables.
*/ */
@ -4055,7 +4055,7 @@ FT_BEGIN_HEADER
* The current layer. Will be set by @FT_Get_Color_Glyph_Layer. * The current layer. Will be set by @FT_Get_Color_Glyph_Layer.
* *
* p :: * p ::
* An opaque pointer into `COLR` table data. The caller must set this * An opaque pointer into 'COLR' table data. The caller must set this
* to `NULL` before the first call of @FT_Get_Color_Glyph_Layer. * to `NULL` before the first call of @FT_Get_Color_Glyph_Layer.
*/ */
typedef struct FT_LayerIterator_ typedef struct FT_LayerIterator_
@ -4073,7 +4073,7 @@ FT_BEGIN_HEADER
* FT_Get_Color_Glyph_Layer * FT_Get_Color_Glyph_Layer
* *
* @description: * @description:
* This is an interface to the `COLR` table in OpenType fonts to * This is an interface to the 'COLR' table in OpenType fonts to
* iteratively retrieve the colored glyph layers associated with the * iteratively retrieve the colored glyph layers associated with the
* current glyph slot. * current glyph slot.
* *

28
include/freetype/ftcolor.h
View File

@ -41,11 +41,11 @@ FT_BEGIN_HEADER
* Glyph Color Management * Glyph Color Management
* *
* @abstract: * @abstract:
* Retrieving and manipulating OpenType's `CPAL` table data. * Retrieving and manipulating OpenType's 'CPAL' table data.
* *
* @description: * @description:
* The functions described here allow access and manipulation of color * The functions described here allow access and manipulation of color
* palette entries in OpenType's `CPAL` tables. * palette entries in OpenType's 'CPAL' tables.
*/ */
@ -55,7 +55,7 @@ FT_BEGIN_HEADER
* FT_Color * FT_Color
* *
* @description: * @description:
* This structure models a BGRA color value of a `CPAL` palette entry. * This structure models a BGRA color value of a 'CPAL' palette entry.
* *
* The used color space is sRGB; the colors are not pre-multiplied, and * The used color space is sRGB; the colors are not pre-multiplied, and
* alpha values must be explicitly set. * alpha values must be explicitly set.
@ -118,7 +118,7 @@ FT_BEGIN_HEADER
* FT_Palette_Data * FT_Palette_Data
* *
* @description: * @description:
* This structure holds the data of the `CPAL` table. * This structure holds the data of the 'CPAL' table.
* *
* @fields: * @fields:
* num_palettes :: * num_palettes ::
@ -126,13 +126,13 @@ FT_BEGIN_HEADER
* *
* palette_name_ids :: * palette_name_ids ::
* A read-only array of palette name IDs with `num_palettes` elements, * A read-only array of palette name IDs with `num_palettes` elements,
* corresponding to entries like 'dark' or 'light' in the font's `name` * corresponding to entries like 'dark' or 'light' in the font's 'name'
* table. * table.
* *
* An empty name ID in the `CPAL` table gets represented as value * An empty name ID in the 'CPAL' table gets represented as value
* 0xFFFF. * 0xFFFF.
* *
* `NULL` if the font's `CPAL` table doesn't contain appropriate data. * `NULL` if the font's 'CPAL' table doesn't contain appropriate data.
* *
* palette_flags :: * palette_flags ::
* A read-only array of palette flags with `num_palettes` elements. * A read-only array of palette flags with `num_palettes` elements.
@ -140,7 +140,7 @@ FT_BEGIN_HEADER
* @FT_PALETTE_FOR_LIGHT_BACKGROUND and * @FT_PALETTE_FOR_LIGHT_BACKGROUND and
* @FT_PALETTE_FOR_DARK_BACKGROUND. * @FT_PALETTE_FOR_DARK_BACKGROUND.
* *
* `NULL` if the font's `CPAL` table doesn't contain appropriate data. * `NULL` if the font's 'CPAL' table doesn't contain appropriate data.
* *
* num_palette_entries :: * num_palette_entries ::
* The number of entries in a single palette. All palettes have the * The number of entries in a single palette. All palettes have the
@ -150,14 +150,14 @@ FT_BEGIN_HEADER
* A read-only array of palette entry name IDs with * A read-only array of palette entry name IDs with
* `num_palette_entries`. In each palette, entries with the same index * `num_palette_entries`. In each palette, entries with the same index
* have the same function. For example, index~0 might correspond to * have the same function. For example, index~0 might correspond to
* string 'outline' in the font's `name` table to indicate that this * string 'outline' in the font's 'name' table to indicate that this
* palette entry is used for outlines, index~1 might correspond to * palette entry is used for outlines, index~1 might correspond to
* 'fill' to indicate the filling color palette entry, etc. * 'fill' to indicate the filling color palette entry, etc.
* *
* An empty entry name ID in the `CPAL` table gets represented as value * An empty entry name ID in the 'CPAL' table gets represented as value
* 0xFFFF. * 0xFFFF.
* *
* `NULL` if the font's `CPAL` table doesn't contain appropriate data. * `NULL` if the font's 'CPAL' table doesn't contain appropriate data.
* *
* @note: * @note:
* Use function @FT_Get_Sfnt_Name to map name IDs and entry name IDs to * Use function @FT_Get_Sfnt_Name to map name IDs and entry name IDs to
@ -226,7 +226,7 @@ FT_BEGIN_HEADER
* *
* A corollary of (2) is that calling the function, then modifying some * A corollary of (2) is that calling the function, then modifying some
* values, then calling the function again with the same arguments resets * values, then calling the function again with the same arguments resets
* all color entries to the original `CPAL` values; all user modifications * all color entries to the original 'CPAL' values; all user modifications
* are lost. * are lost.
* *
* @input: * @input:
@ -273,7 +273,7 @@ FT_BEGIN_HEADER
* FT_Palette_Set_Foreground_Color * FT_Palette_Set_Foreground_Color
* *
* @description: * @description:
* `COLR` uses palette index 0xFFFF to indicate a 'text foreground * 'COLR' uses palette index 0xFFFF to indicate a 'text foreground
* color'. This function sets this value. * color'. This function sets this value.
* *
* @input: * @input:
@ -291,7 +291,7 @@ FT_BEGIN_HEADER
* white opaque (BGRA value 0xFFFFFFFF) if * white opaque (BGRA value 0xFFFFFFFF) if
* @FT_PALETTE_FOR_DARK_BACKGROUND is present for the current palette, * @FT_PALETTE_FOR_DARK_BACKGROUND is present for the current palette,
* and black opaque (BGRA value 0x000000FF) otherwise, including the case * and black opaque (BGRA value 0x000000FF) otherwise, including the case
* that no palette types are available in the `CPAL` table. * that no palette types are available in the 'CPAL' table.
* *
* This function always returns an error if the config macro * This function always returns an error if the config macro
* `TT_CONFIG_OPTION_COLOR_LAYERS` is not defined in `ftoption.h`. * `TT_CONFIG_OPTION_COLOR_LAYERS` is not defined in `ftoption.h`.

4
include/freetype/ftdriver.h
View File

@ -233,7 +233,7 @@ FT_BEGIN_HEADER
* achieve some level of glyph symmetry. To enable reasonable * achieve some level of glyph symmetry. To enable reasonable
* performance (e.g., not having to run hinting on all glyphs just to get * performance (e.g., not having to run hinting on all glyphs just to get
* the widths) there was a bit in the head table indicating if the side * the widths) there was a bit in the head table indicating if the side
* bearing was hinted, and additional tables, `hdmx` and `LTSH`, to cache * bearing was hinted, and additional tables, 'hdmx' and 'LTSH', to cache
* hinting widths across multiple sizes and device aspect ratios. * hinting widths across multiple sizes and device aspect ratios.
* *
* _Font Smoothing_ * _Font Smoothing_
@ -1070,7 +1070,7 @@ FT_BEGIN_HEADER
* coverages, this property sets the (auto-fitter) script to be used for * coverages, this property sets the (auto-fitter) script to be used for
* the default (OpenType) script data of a font's GSUB table. Features * the default (OpenType) script data of a font's GSUB table. Features
* for the default script are intended for all scripts not explicitly * for the default script are intended for all scripts not explicitly
* handled in GSUB; an example is a `dlig` feature, containing the * handled in GSUB; an example is a 'dlig' feature, containing the
* combination of the characters 'T', 'E', and 'L' to form a 'TEL' * combination of the characters 'T', 'E', and 'L' to form a 'TEL'
* ligature. * ligature.
* *

10
include/freetype/ftgasp.h
View File

@ -2,7 +2,7 @@
* *
* ftgasp.h * ftgasp.h
* *
* Access of TrueType's `gasp` table (specification). * Access of TrueType's 'gasp' table (specification).
* *
* Copyright 2007-2019 by * Copyright 2007-2019 by
* David Turner, Robert Wilhelm, and Werner Lemberg. * David Turner, Robert Wilhelm, and Werner Lemberg.
@ -41,11 +41,11 @@ FT_BEGIN_HEADER
* Gasp Table * Gasp Table
* *
* @abstract: * @abstract:
* Retrieving TrueType `gasp` table entries. * Retrieving TrueType 'gasp' table entries.
* *
* @description: * @description:
* The function @FT_Get_Gasp can be used to query a TrueType or OpenType * The function @FT_Get_Gasp can be used to query a TrueType or OpenType
* font for specific entries in its `gasp` table, if any. This is mainly * font for specific entries in its 'gasp' table, if any. This is mainly
* useful when implementing native TrueType hinting with the bytecode * useful when implementing native TrueType hinting with the bytecode
* interpreter to duplicate the Windows text rendering results. * interpreter to duplicate the Windows text rendering results.
*/ */
@ -106,7 +106,7 @@ FT_BEGIN_HEADER
* *
* @description: * @description:
* For a TrueType or OpenType font file, return the rasterizer behaviour * For a TrueType or OpenType font file, return the rasterizer behaviour
* flags from the font's `gasp` table corresponding to a given character * flags from the font's 'gasp' table corresponding to a given character
* pixel size. * pixel size.
* *
* @input: * @input:
@ -118,7 +118,7 @@ FT_BEGIN_HEADER
* *
* @return: * @return:
* Bit flags (see @FT_GASP_XXX), or @FT_GASP_NO_TABLE if there is no * Bit flags (see @FT_GASP_XXX), or @FT_GASP_NO_TABLE if there is no
* `gasp` table in the face. * 'gasp' table in the face.
* *
* @note: * @note:
* If you want to use the MM functionality of OpenType variation fonts * If you want to use the MM functionality of OpenType variation fonts

28
include/freetype/ftgxval.h
View File

@ -123,34 +123,34 @@ FT_BEGIN_HEADER
* *
* @values: * @values:
* FT_VALIDATE_feat :: * FT_VALIDATE_feat ::
* Validate `feat` table. * Validate 'feat' table.
* *
* FT_VALIDATE_mort :: * FT_VALIDATE_mort ::
* Validate `mort` table. * Validate 'mort' table.
* *
* FT_VALIDATE_morx :: * FT_VALIDATE_morx ::
* Validate `morx` table. * Validate 'morx' table.
* *
* FT_VALIDATE_bsln :: * FT_VALIDATE_bsln ::
* Validate `bsln` table. * Validate 'bsln' table.
* *
* FT_VALIDATE_just :: * FT_VALIDATE_just ::
* Validate `just` table. * Validate 'just' table.
* *
* FT_VALIDATE_kern :: * FT_VALIDATE_kern ::
* Validate `kern` table. * Validate 'kern' table.
* *
* FT_VALIDATE_opbd :: * FT_VALIDATE_opbd ::
* Validate `opbd` table. * Validate 'opbd' table.
* *
* FT_VALIDATE_trak :: * FT_VALIDATE_trak ::
* Validate `trak` table. * Validate 'trak' table.
* *
* FT_VALIDATE_prop :: * FT_VALIDATE_prop ::
* Validate `prop` table. * Validate 'prop' table.
* *
* FT_VALIDATE_lcar :: * FT_VALIDATE_lcar ::
* Validate `lcar` table. * Validate 'lcar' table.
* *
* FT_VALIDATE_GX :: * FT_VALIDATE_GX ::
* Validate all TrueTypeGX tables (feat, mort, morx, bsln, just, kern, * Validate all TrueTypeGX tables (feat, mort, morx, bsln, just, kern,
@ -265,13 +265,13 @@ FT_BEGIN_HEADER
* *
* @values: * @values:
* FT_VALIDATE_MS :: * FT_VALIDATE_MS ::
* Handle the `kern` table as a classic Microsoft kern table. * Handle the 'kern' table as a classic Microsoft kern table.
* *
* FT_VALIDATE_APPLE :: * FT_VALIDATE_APPLE ::
* Handle the `kern` table as a classic Apple kern table. * Handle the 'kern' table as a classic Apple kern table.
* *
* FT_VALIDATE_CKERN :: * FT_VALIDATE_CKERN ::
* Handle the `kern` as either classic Apple or Microsoft kern table. * Handle the 'kern' as either classic Apple or Microsoft kern table.
*/ */
#define FT_VALIDATE_MS ( FT_VALIDATE_GX_START << 0 ) #define FT_VALIDATE_MS ( FT_VALIDATE_GX_START << 0 )
#define FT_VALIDATE_APPLE ( FT_VALIDATE_GX_START << 1 ) #define FT_VALIDATE_APPLE ( FT_VALIDATE_GX_START << 1 )
@ -290,7 +290,7 @@ FT_BEGIN_HEADER
* library that actually does the text layout can access those tables * library that actually does the text layout can access those tables
* without error checking (which can be quite time consuming). * without error checking (which can be quite time consuming).
* *
* The `kern` table validator in @FT_TrueTypeGX_Validate deals with both * The 'kern' table validator in @FT_TrueTypeGX_Validate deals with both
* the new 32-bit format and the classic 16-bit format, while * the new 32-bit format and the classic 16-bit format, while
* FT_ClassicKern_Validate only supports the classic 16-bit format. * FT_ClassicKern_Validate only supports the classic 16-bit format.
* *

2
include/freetype/ftincrem.h
View File

@ -148,7 +148,7 @@ FT_BEGIN_HEADER
* *
* Note that the format of the glyph's data bytes depends on the font * Note that the format of the glyph's data bytes depends on the font
* file format. For TrueType, it must correspond to the raw bytes within * file format. For TrueType, it must correspond to the raw bytes within
* the `glyf` table. For PostScript formats, it must correspond to the * the 'glyf' table. For PostScript formats, it must correspond to the
* **unencrypted** charstring bytes, without any `lenIV` header. It is * **unencrypted** charstring bytes, without any `lenIV` header. It is
* undefined for any other format. * undefined for any other format.
* *

8
include/freetype/ftmm.h
View File

@ -144,7 +144,7 @@ FT_BEGIN_HEADER
* Adobe MM fonts if possible. * Adobe MM fonts if possible.
* *
* strid :: * strid ::
* The axis name entry in the font's `name` table. This is another * The axis name entry in the font's 'name' table. This is another
* (and often better) version of the 'name' field for TrueType GX or * (and often better) version of the 'name' field for TrueType GX or
* OpenType variation fonts. Not meaningful for Adobe MM fonts. * OpenType variation fonts. Not meaningful for Adobe MM fonts.
* *
@ -184,10 +184,10 @@ FT_BEGIN_HEADER
* entry for each axis. * entry for each axis.
* *
* strid :: * strid ::
* The entry in `name` table identifying this instance. * The entry in 'name' table identifying this instance.
* *
* psid :: * psid ::
* The entry in `name` table identifying a PostScript name for this * The entry in 'name' table identifying a PostScript name for this
* instance. Value 0xFFFF indicates a missing entry. * instance. Value 0xFFFF indicates a missing entry.
*/ */
typedef struct FT_Var_Named_Style_ typedef struct FT_Var_Named_Style_
@ -222,7 +222,7 @@ FT_BEGIN_HEADER
* *
* num_namedstyles :: * num_namedstyles ::
* The number of named styles; a 'named style' is a tuple of design * The number of named styles; a 'named style' is a tuple of design
* coordinates that has a string ID (in the `name` table) associated * coordinates that has a string ID (in the 'name' table) associated
* with it. The font can tell the user that, for example, * with it. The font can tell the user that, for example,
* [Weight=1.5,Width=1.1] is 'Bold'. Another name for 'named style' is * [Weight=1.5,Width=1.1] is 'Bold'. Another name for 'named style' is
* 'named instance'. * 'named instance'.

4
include/freetype/ftparams.h
View File

@ -58,7 +58,7 @@ FT_BEGIN_HEADER
* *
* @description: * @description:
* A tag for @FT_Parameter to make @FT_Open_Face ignore typographic * A tag for @FT_Parameter to make @FT_Open_Face ignore typographic
* family names in the `name` table (introduced in OpenType version 1.4). * family names in the 'name' table (introduced in OpenType version 1.4).
* Use this for backward compatibility with legacy systems that have a * Use this for backward compatibility with legacy systems that have a
* four-faces-per-family restriction. * four-faces-per-family restriction.
* *
@ -82,7 +82,7 @@ FT_BEGIN_HEADER
* *
* @description: * @description:
* A tag for @FT_Parameter to make @FT_Open_Face ignore typographic * A tag for @FT_Parameter to make @FT_Open_Face ignore typographic
* subfamily names in the `name` table (introduced in OpenType version * subfamily names in the 'name' table (introduced in OpenType version
* 1.4). Use this for backward compatibility with legacy systems that * 1.4). Use this for backward compatibility with legacy systems that
* have a four-faces-per-family restriction. * have a four-faces-per-family restriction.
* *

24
include/freetype/ftsnames.h
View File

@ -2,7 +2,7 @@
* *
* ftsnames.h * ftsnames.h
* *
* Simple interface to access SFNT `name` tables (which are used * Simple interface to access SFNT 'name' tables (which are used
* to hold font names, copyright info, notices, etc.) (specification). * to hold font names, copyright info, notices, etc.) (specification).
* *
* This is _not_ used to retrieve glyph names! * This is _not_ used to retrieve glyph names!
@ -50,7 +50,7 @@ FT_BEGIN_HEADER
* *
* @description: * @description:
* The TrueType and OpenType specifications allow the inclusion of a * The TrueType and OpenType specifications allow the inclusion of a
* special names table (`name`) in font files. This table contains * special names table ('name') in font files. This table contains
* textual (and internationalized) information regarding the font, like * textual (and internationalized) information regarding the font, like
* family name, copyright, version, etc. * family name, copyright, version, etc.
* *
@ -67,7 +67,7 @@ FT_BEGIN_HEADER
* FT_SfntName * FT_SfntName
* *
* @description: * @description:
* A structure used to model an SFNT `name` table entry. * A structure used to model an SFNT 'name' table entry.
* *
* @fields: * @fields:
* platform_id :: * platform_id ::
@ -124,14 +124,14 @@ FT_BEGIN_HEADER
* FT_Get_Sfnt_Name_Count * FT_Get_Sfnt_Name_Count
* *
* @description: * @description:
* Retrieve the number of name strings in the SFNT `name` table. * Retrieve the number of name strings in the SFNT 'name' table.
* *
* @input: * @input:
* face :: * face ::
* A handle to the source face. * A handle to the source face.
* *
* @return: * @return:
* The number of strings in the `name` table. * The number of strings in the 'name' table.
* *
* @note: * @note:
* This function always returns an error if the config macro * This function always returns an error if the config macro
@ -147,7 +147,7 @@ FT_BEGIN_HEADER
* FT_Get_Sfnt_Name * FT_Get_Sfnt_Name
* *
* @description: * @description:
* Retrieve a string of the SFNT `name` table for a given index. * Retrieve a string of the SFNT 'name' table for a given index.
* *
* @input: * @input:
* face :: * face ::
@ -169,10 +169,10 @@ FT_BEGIN_HEADER
* yourself; FreeType takes care of it if you call @FT_Done_Face. * yourself; FreeType takes care of it if you call @FT_Done_Face.
* *
* Use @FT_Get_Sfnt_Name_Count to get the total number of available * Use @FT_Get_Sfnt_Name_Count to get the total number of available
* `name` table entries, then do a loop until you get the right platform, * 'name' table entries, then do a loop until you get the right platform,
* encoding, and name ID. * encoding, and name ID.
* *
* `name` table format~1 entries can use language tags also, see * 'name' table format~1 entries can use language tags also, see
* @FT_Get_Sfnt_LangTag. * @FT_Get_Sfnt_LangTag.
* *
* This function always returns an error if the config macro * This function always returns an error if the config macro
@ -190,7 +190,7 @@ FT_BEGIN_HEADER
* FT_SfntLangTag * FT_SfntLangTag
* *
* @description: * @description:
* A structure to model a language tag entry from an SFNT `name` table. * A structure to model a language tag entry from an SFNT 'name' table.
* *
* @fields: * @fields:
* string :: * string ::
@ -222,7 +222,7 @@ FT_BEGIN_HEADER
* *
* @description: * @description:
* Retrieve the language tag associated with a language ID of an SFNT * Retrieve the language tag associated with a language ID of an SFNT
* `name` table entry. * 'name' table entry.
* *
* @input: * @input:
* face :: * face ::
@ -234,7 +234,7 @@ FT_BEGIN_HEADER
* *
* @output: * @output:
* alangTag :: * alangTag ::
* The language tag associated with the `name` table entry's language * The language tag associated with the 'name' table entry's language
* ID. * ID.
* *
* @return: * @return:
@ -245,7 +245,7 @@ FT_BEGIN_HEADER
* null-terminated. Note that you don't have to deallocate `string` by * null-terminated. Note that you don't have to deallocate `string` by
* yourself; FreeType takes care of it if you call @FT_Done_Face. * yourself; FreeType takes care of it if you call @FT_Done_Face.
* *
* Only `name` table format~1 supports language tags. For format~0 * Only 'name' table format~1 supports language tags. For format~0
* tables, this function always returns FT_Err_Invalid_Table. For * tables, this function always returns FT_Err_Invalid_Table. For
* invalid format~1 language ID values, FT_Err_Invalid_Argument is * invalid format~1 language ID values, FT_Err_Invalid_Argument is
* returned. * returned.

4
include/freetype/internal/tttypes.h
View File

@ -58,7 +58,7 @@ FT_BEGIN_HEADER
* *
* @fields: * @fields:
* tag :: * tag ::
* Must be 'ttc ' to indicate a TrueType collection. * Must be 'ttc~' to indicate a TrueType collection.
* *
* version :: * version ::
* The version number. * The version number.
@ -1395,7 +1395,7 @@ FT_BEGIN_HEADER
* *
* cvt :: * cvt ::
* The face's original control value table. Coordinates are expressed * The face's original control value table. Coordinates are expressed
* in unscaled font units. Comes from the 'cvt ' table. Ignored for * in unscaled font units. Comes from the 'cvt~' table. Ignored for
* Type 2 fonts. * Type 2 fonts.
* *
* interpreter :: * interpreter ::

12
include/freetype/ttnameid.h
View File

@ -36,7 +36,7 @@ FT_BEGIN_HEADER
/************************************************************************** /**************************************************************************
* *
* Possible values for the 'platform' identifier code in the name records * Possible values for the 'platform' identifier code in the name records
* of an SFNT `name` table. * of an SFNT 'name' table.
* *
*/ */
@ -291,7 +291,7 @@ FT_BEGIN_HEADER
* *
* @description: * @description:
* Possible values of the language identifier field in the name records * Possible values of the language identifier field in the name records
* of the SFNT `name` table if the 'platform' identifier code is * of the SFNT 'name' table if the 'platform' identifier code is
* @TT_PLATFORM_MACINTOSH. These values are also used as return values * @TT_PLATFORM_MACINTOSH. These values are also used as return values
* for function @FT_Get_CMap_Language_ID. * for function @FT_Get_CMap_Language_ID.
* *
@ -431,7 +431,7 @@ FT_BEGIN_HEADER
* *
* @description: * @description:
* Possible values of the language identifier field in the name records * Possible values of the language identifier field in the name records
* of the SFNT `name` table if the 'platform' identifier code is * of the SFNT 'name' table if the 'platform' identifier code is
* @TT_PLATFORM_MICROSOFT. These values are also used as return values * @TT_PLATFORM_MICROSOFT. These values are also used as return values
* for function @FT_Get_CMap_Language_ID. * for function @FT_Get_CMap_Language_ID.
* *
@ -441,7 +441,7 @@ FT_BEGIN_HEADER
* *
* however, we only provide macros for language identifiers present in * however, we only provide macros for language identifiers present in
* the OpenType specification: Microsoft has abandoned the concept of * the OpenType specification: Microsoft has abandoned the concept of
* LCIDs (language code identifiers), and format~1 of the `name` table * LCIDs (language code identifiers), and format~1 of the 'name' table
* provides a better mechanism for languages not covered here. * provides a better mechanism for languages not covered here.
* *
* More legacy values not listed in the reference can be found in the * More legacy values not listed in the reference can be found in the
@ -787,7 +787,7 @@ FT_BEGIN_HEADER
* *
* @description: * @description:
* Possible values of the 'name' identifier field in the name records of * Possible values of the 'name' identifier field in the name records of
* an SFNT `name` table. These values are platform independent. * an SFNT 'name' table. These values are platform independent.
*/ */
#define TT_NAME_ID_COPYRIGHT 0 #define TT_NAME_ID_COPYRIGHT 0
@ -841,7 +841,7 @@ FT_BEGIN_HEADER
* *
* @description: * @description:
* Possible bit mask values for the `ulUnicodeRangeX` fields in an SFNT * Possible bit mask values for the `ulUnicodeRangeX` fields in an SFNT
* `OS/2` table. * 'OS/2' table.
*/ */
/* ulUnicodeRange1 */ /* ulUnicodeRange1 */

56
include/freetype/tttables.h
View File

@ -117,8 +117,8 @@ FT_BEGIN_HEADER
* TT_HoriHeader * TT_HoriHeader
* *
* @description: * @description:
* A structure to model a TrueType horizontal header, the `hhea` table, * A structure to model a TrueType horizontal header, the 'hhea' table,
* as well as the corresponding horizontal metrics table, `hmtx`. * as well as the corresponding horizontal metrics table, 'hmtx'.
* *
* @fields: * @fields:
* Version :: * Version ::
@ -132,7 +132,7 @@ FT_BEGIN_HEADER
* font designer, and often reflects only a portion of the glyphs found * font designer, and often reflects only a portion of the glyphs found
* in the font (maybe ASCII). * in the font (maybe ASCII).
* *
* You should use the `sTypoAscender` field of the `OS/2` table instead * You should use the `sTypoAscender` field of the 'OS/2' table instead
* if you want the correct one. * if you want the correct one.
* *
* Descender :: * Descender ::
@ -143,7 +143,7 @@ FT_BEGIN_HEADER
* font designer, and often reflects only a portion of the glyphs found * font designer, and often reflects only a portion of the glyphs found
* in the font (maybe ASCII). * in the font (maybe ASCII).
* *
* You should use the `sTypoDescender` field of the `OS/2` table * You should use the `sTypoDescender` field of the 'OS/2' table
* instead if you want the correct one. * instead if you want the correct one.
* *
* Line_Gap :: * Line_Gap ::
@ -183,19 +183,19 @@ FT_BEGIN_HEADER
* Always~0. * Always~0.
* *
* number_Of_HMetrics :: * number_Of_HMetrics ::
* Number of HMetrics entries in the `hmtx` table -- this value can be * Number of HMetrics entries in the 'hmtx' table -- this value can be
* smaller than the total number of glyphs in the font. * smaller than the total number of glyphs in the font.
* *
* long_metrics :: * long_metrics ::
* A pointer into the `hmtx` table. * A pointer into the 'hmtx' table.
* *
* short_metrics :: * short_metrics ::
* A pointer into the `hmtx` table. * A pointer into the 'hmtx' table.
* *
* @note: * @note:
* For an OpenType variation font, the values of the following fields can * For an OpenType variation font, the values of the following fields can
* change after a call to @FT_Set_Var_Design_Coordinates (and friends) if * change after a call to @FT_Set_Var_Design_Coordinates (and friends) if
* the font contains an `MVAR` table: `caret_Slope_Rise`, * the font contains an 'MVAR' table: `caret_Slope_Rise`,
* `caret_Slope_Run`, and `caret_Offset`. * `caret_Slope_Run`, and `caret_Offset`.
*/ */
typedef struct TT_HoriHeader_ typedef struct TT_HoriHeader_
@ -221,7 +221,7 @@ FT_BEGIN_HEADER
/* The following fields are not defined by the OpenType specification */ /* The following fields are not defined by the OpenType specification */
/* but they are used to connect the metrics header to the relevant */ /* but they are used to connect the metrics header to the relevant */
/* `hmtx` table. */ /* 'hmtx' table. */
void* long_metrics; void* long_metrics;
void* short_metrics; void* short_metrics;
@ -235,8 +235,8 @@ FT_BEGIN_HEADER
* TT_VertHeader * TT_VertHeader
* *
* @description: * @description:
* A structure used to model a TrueType vertical header, the `vhea` * A structure used to model a TrueType vertical header, the 'vhea'
* table, as well as the corresponding vertical metrics table, `vmtx`. * table, as well as the corresponding vertical metrics table, 'vmtx'.
* *
* @fields: * @fields:
* Version :: * Version ::
@ -250,7 +250,7 @@ FT_BEGIN_HEADER
* font designer, and often reflects only a portion of the glyphs found * font designer, and often reflects only a portion of the glyphs found
* in the font (maybe ASCII). * in the font (maybe ASCII).
* *
* You should use the `sTypoAscender` field of the `OS/2` table instead * You should use the `sTypoAscender` field of the 'OS/2' table instead
* if you want the correct one. * if you want the correct one.
* *
* Descender :: * Descender ::
@ -261,7 +261,7 @@ FT_BEGIN_HEADER
* font designer, and often reflects only a portion of the glyphs found * font designer, and often reflects only a portion of the glyphs found
* in the font (maybe ASCII). * in the font (maybe ASCII).
* *
* You should use the `sTypoDescender` field of the `OS/2` table * You should use the `sTypoDescender` field of the 'OS/2' table
* instead if you want the correct one. * instead if you want the correct one.
* *
* Line_Gap :: * Line_Gap ::
@ -301,19 +301,19 @@ FT_BEGIN_HEADER
* Always~0. * Always~0.
* *
* number_Of_VMetrics :: * number_Of_VMetrics ::
* Number of VMetrics entries in the `vmtx` table -- this value can be * Number of VMetrics entries in the 'vmtx' table -- this value can be
* smaller than the total number of glyphs in the font. * smaller than the total number of glyphs in the font.
* *
* long_metrics :: * long_metrics ::
* A pointer into the `vmtx` table. * A pointer into the 'vmtx' table.
* *
* short_metrics :: * short_metrics ::
* A pointer into the `vmtx` table. * A pointer into the 'vmtx' table.
* *
* @note: * @note:
* For an OpenType variation font, the values of the following fields can * For an OpenType variation font, the values of the following fields can
* change after a call to @FT_Set_Var_Design_Coordinates (and friends) if * change after a call to @FT_Set_Var_Design_Coordinates (and friends) if
* the font contains an `MVAR` table: `Ascender`, `Descender`, * the font contains an 'MVAR' table: `Ascender`, `Descender`,
* `Line_Gap`, `caret_Slope_Rise`, `caret_Slope_Run`, and `caret_Offset`. * `Line_Gap`, `caret_Slope_Rise`, `caret_Slope_Run`, and `caret_Offset`.
*/ */
typedef struct TT_VertHeader_ typedef struct TT_VertHeader_
@ -339,7 +339,7 @@ FT_BEGIN_HEADER
/* The following fields are not defined by the OpenType specification */ /* The following fields are not defined by the OpenType specification */
/* but they are used to connect the metrics header to the relevant */ /* but they are used to connect the metrics header to the relevant */
/* `vmtx` table. */ /* 'vmtx' table. */
void* long_metrics; void* long_metrics;
void* short_metrics; void* short_metrics;
@ -353,16 +353,16 @@ FT_BEGIN_HEADER
* TT_OS2 * TT_OS2
* *
* @description: * @description:
* A structure to model a TrueType `OS/2` table. All fields comply to * A structure to model a TrueType 'OS/2' table. All fields comply to
* the OpenType specification. * the OpenType specification.
* *
* Note that we now support old Mac fonts that do not include an `OS/2` * Note that we now support old Mac fonts that do not include an 'OS/2'
* table. In this case, the `version` field is always set to 0xFFFF. * table. In this case, the `version` field is always set to 0xFFFF.
* *
* @note: * @note:
* For an OpenType variation font, the values of the following fields can * For an OpenType variation font, the values of the following fields can
* change after a call to @FT_Set_Var_Design_Coordinates (and friends) if * change after a call to @FT_Set_Var_Design_Coordinates (and friends) if
* the font contains an `MVAR` table: `sCapHeight`, `sTypoAscender`, * the font contains an 'MVAR' table: `sCapHeight`, `sTypoAscender`,
* `sTypoDescender`, `sTypoLineGap`, `sxHeight`, `usWinAscent`, * `sTypoDescender`, `sTypoLineGap`, `sxHeight`, `usWinAscent`,
* `usWinDescent`, `yStrikeoutPosition`, `yStrikeoutSize`, * `usWinDescent`, `yStrikeoutPosition`, `yStrikeoutSize`,
* `ySubscriptXOffset`, `ySubScriptXSize`, `ySubscriptYOffset`, * `ySubscriptXOffset`, `ySubScriptXSize`, `ySubscriptYOffset`,
@ -437,7 +437,7 @@ FT_BEGIN_HEADER
* TT_Postscript * TT_Postscript
* *
* @description: * @description:
* A structure to model a TrueType `post` table. All fields comply to * A structure to model a TrueType 'post' table. All fields comply to
* the OpenType specification. This structure does not reference a * the OpenType specification. This structure does not reference a
* font's PostScript glyph names; use @FT_Get_Glyph_Name to retrieve * font's PostScript glyph names; use @FT_Get_Glyph_Name to retrieve
* them. * them.
@ -445,7 +445,7 @@ FT_BEGIN_HEADER
* @note: * @note:
* For an OpenType variation font, the values of the following fields can * For an OpenType variation font, the values of the following fields can
* change after a call to @FT_Set_Var_Design_Coordinates (and friends) if * change after a call to @FT_Set_Var_Design_Coordinates (and friends) if
* the font contains an `MVAR` table: `underlinePosition` and * the font contains an 'MVAR' table: `underlinePosition` and
* `underlineThickness`. * `underlineThickness`.
*/ */
typedef struct TT_Postscript_ typedef struct TT_Postscript_
@ -460,7 +460,7 @@ FT_BEGIN_HEADER
FT_ULong minMemType1; FT_ULong minMemType1;
FT_ULong maxMemType1; FT_ULong maxMemType1;
/* Glyph names follow in the `post` table, but we don't */ /* Glyph names follow in the 'post' table, but we don't */
/* load them by default. */ /* load them by default. */
} TT_Postscript; } TT_Postscript;
@ -472,7 +472,7 @@ FT_BEGIN_HEADER
* TT_PCLT * TT_PCLT
* *
* @description: * @description:
* A structure to model a TrueType `PCLT` table. All fields comply to * A structure to model a TrueType 'PCLT' table. All fields comply to
* the OpenType specification. * the OpenType specification.
*/ */
typedef struct TT_PCLT_ typedef struct TT_PCLT_
@ -502,7 +502,7 @@ FT_BEGIN_HEADER
* TT_MaxProfile * TT_MaxProfile
* *
* @description: * @description:
* The maximum profile (`maxp`) table contains many max values, which can * The maximum profile ('maxp') table contains many max values, which can
* be used to pre-allocate arrays for speeding up glyph loading and * be used to pre-allocate arrays for speeding up glyph loading and
* hinting. * hinting.
* *
@ -673,7 +673,7 @@ FT_BEGIN_HEADER
* list. * list.
* *
* @example: * @example:
* Here an example how to access the `vhea` table. * Here an example how to access the 'vhea' table.
* *
* ``` * ```
* TT_VertHeader* vert_header; * TT_VertHeader* vert_header;
@ -832,7 +832,7 @@ FT_BEGIN_HEADER
* FT_Get_CMap_Format * FT_Get_CMap_Format
* *
* @description: * @description:
* Return the format of an SFNT `cmap` table. * Return the format of an SFNT 'cmap' table.
* *
* @input: * @input:
* charmap :: * charmap ::