t1tables.h: Whitespace.
This commit is contained in:
parent
338b4e8846
commit
c67ecb8c3a
|
@ -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 )
|
||||||
|
|
Loading…
Reference in New Issue