t1tables.h: Whitespace.

This commit is contained in:
Werner Lemberg 2022-02-12 07:52:57 +01:00
parent 338b4e8846
commit c67ecb8c3a
1 changed files with 73 additions and 73 deletions

View File

@ -453,22 +453,22 @@ FT_BEGIN_HEADER
/************************************************************************** /**************************************************************************
* *
* @function: * @function:
* FT_Has_PS_Glyph_Names * FT_Has_PS_Glyph_Names
* *
* @description: * @description:
* Return true if a given face provides reliable PostScript glyph names. * Return true if a given face provides reliable PostScript glyph names.
* This is similar to using the @FT_HAS_GLYPH_NAMES macro, except that * This is similar to using the @FT_HAS_GLYPH_NAMES macro, except that
* certain fonts (mostly TrueType) contain incorrect glyph name tables. * certain fonts (mostly TrueType) contain incorrect glyph name tables.
* *
* When this function returns true, the caller is sure that the glyph * When this function returns true, the caller is sure that the glyph
* names returned by @FT_Get_Glyph_Name are reliable. * names returned by @FT_Get_Glyph_Name are reliable.
* *
* @input: * @input:
* face :: * face ::
* face handle * face handle
* *
* @return: * @return:
* Boolean. True if glyph names are reliable. * Boolean. True if glyph names are reliable.
* *
*/ */
FT_EXPORT( FT_Int ) FT_EXPORT( FT_Int )
@ -478,30 +478,30 @@ FT_BEGIN_HEADER
/************************************************************************** /**************************************************************************
* *
* @function: * @function:
* FT_Get_PS_Font_Info * FT_Get_PS_Font_Info
* *
* @description: * @description:
* Retrieve the @PS_FontInfoRec structure corresponding to a given * Retrieve the @PS_FontInfoRec structure corresponding to a given
* PostScript font. * PostScript font.
* *
* @input: * @input:
* face :: * face ::
* PostScript face handle. * PostScript face handle.
* *
* @output: * @output:
* afont_info :: * afont_info ::
* Output font info structure pointer. * Output font info structure pointer.
* *
* @return: * @return:
* FreeType error code. 0~means success. * FreeType error code. 0~means success.
* *
* @note: * @note:
* String pointers within the @PS_FontInfoRec structure are owned by the * String pointers within the @PS_FontInfoRec structure are owned by the
* face and don't need to be freed by the caller. Missing entries in * face and don't need to be freed by the caller. Missing entries in
* the font's FontInfo dictionary are represented by `NULL` pointers. * the font's FontInfo dictionary are represented by `NULL` pointers.
* *
* If the font's format is not PostScript-based, this function will * If the font's format is not PostScript-based, this function will
* return the `FT_Err_Invalid_Argument` error code. * return the `FT_Err_Invalid_Argument` error code.
* *
*/ */
FT_EXPORT( FT_Error ) FT_EXPORT( FT_Error )
@ -512,29 +512,29 @@ FT_BEGIN_HEADER
/************************************************************************** /**************************************************************************
* *
* @function: * @function:
* FT_Get_PS_Font_Private * FT_Get_PS_Font_Private
* *
* @description: * @description:
* Retrieve the @PS_PrivateRec structure corresponding to a given * Retrieve the @PS_PrivateRec structure corresponding to a given
* PostScript font. * PostScript font.
* *
* @input: * @input:
* face :: * face ::
* PostScript face handle. * PostScript face handle.
* *
* @output: * @output:
* afont_private :: * afont_private ::
* Output private dictionary structure pointer. * Output private dictionary structure pointer.
* *
* @return: * @return:
* FreeType error code. 0~means success. * FreeType error code. 0~means success.
* *
* @note: * @note:
* The string pointers within the @PS_PrivateRec structure are owned by * The string pointers within the @PS_PrivateRec structure are owned by
* the face and don't need to be freed by the caller. * the face and don't need to be freed by the caller.
* *
* If the font's format is not PostScript-based, this function returns * If the font's format is not PostScript-based, this function returns
* the `FT_Err_Invalid_Argument` error code. * the `FT_Err_Invalid_Argument` error code.
* *
*/ */
FT_EXPORT( FT_Error ) FT_EXPORT( FT_Error )
@ -693,67 +693,67 @@ FT_BEGIN_HEADER
/************************************************************************** /**************************************************************************
* *
* @function: * @function:
* FT_Get_PS_Font_Value * FT_Get_PS_Font_Value
* *
* @description: * @description:
* Retrieve the value for the supplied key from a PostScript font. * Retrieve the value for the supplied key from a PostScript font.
* *
* @input: * @input:
* face :: * face ::
* PostScript face handle. * PostScript face handle.
* *
* key :: * key ::
* An enumeration value representing the dictionary key to retrieve. * An enumeration value representing the dictionary key to retrieve.
* *
* idx :: * idx ::
* For array values, this specifies the index to be returned. * For array values, this specifies the index to be returned.
* *
* value :: * value ::
* A pointer to memory into which to write the value. * A pointer to memory into which to write the value.
* *
* valen_len :: * valen_len ::
* The size, in bytes, of the memory supplied for the value. * The size, in bytes, of the memory supplied for the value.
* *
* @output: * @output:
* value :: * value ::
* The value matching the above key, if it exists. * The value matching the above key, if it exists.
* *
* @return: * @return:
* The amount of memory (in bytes) required to hold the requested value * The amount of memory (in bytes) required to hold the requested value
* (if it exists, -1 otherwise). * (if it exists, -1 otherwise).
* *
* @note: * @note:
* The values returned are not pointers into the internal structures of * The values returned are not pointers into the internal structures of
* the face, but are 'fresh' copies, so that the memory containing them * the face, but are 'fresh' copies, so that the memory containing them
* belongs to the calling application. This also enforces the * belongs to the calling application. This also enforces the
* 'read-only' nature of these values, i.e., this function cannot be * 'read-only' nature of these values, i.e., this function cannot be
* used to manipulate the face. * used to manipulate the face.
* *
* `value` is a void pointer because the values returned can be of * `value` is a void pointer because the values returned can be of
* various types. * various types.
* *
* If either `value` is `NULL` or `value_len` is too small, just the * If either `value` is `NULL` or `value_len` is too small, just the
* required memory size for the requested entry is returned. * required memory size for the requested entry is returned.
* *
* The `idx` parameter is used, not only to retrieve elements of, for * The `idx` parameter is used, not only to retrieve elements of, for
* example, the FontMatrix or FontBBox, but also to retrieve name keys * example, the FontMatrix or FontBBox, but also to retrieve name keys
* from the CharStrings dictionary, and the charstrings themselves. It * from the CharStrings dictionary, and the charstrings themselves. It
* is ignored for atomic values. * is ignored for atomic values.
* *
* `PS_DICT_BLUE_SCALE` returns a value that is scaled up by 1000. To * `PS_DICT_BLUE_SCALE` returns a value that is scaled up by 1000. To
* get the value as in the font stream, you need to divide by 65536000.0 * get the value as in the font stream, you need to divide by 65536000.0
* (to remove the FT_Fixed scale, and the x1000 scale). * (to remove the FT_Fixed scale, and the x1000 scale).
* *
* IMPORTANT: Only key/value pairs read by the FreeType interpreter can * IMPORTANT: Only key/value pairs read by the FreeType interpreter can
* be retrieved. So, for example, PostScript procedures such as NP, ND, * be retrieved. So, for example, PostScript procedures such as NP, ND,
* and RD are not available. Arbitrary keys are, obviously, not be * and RD are not available. Arbitrary keys are, obviously, not be
* available either. * available either.
* *
* If the font's format is not PostScript-based, this function returns * If the font's format is not PostScript-based, this function returns
* the `FT_Err_Invalid_Argument` error code. * the `FT_Err_Invalid_Argument` error code.
* *
* @since: * @since:
* 2.4.8 * 2.4.8
* *
*/ */
FT_EXPORT( FT_Long ) FT_EXPORT( FT_Long )