diff options
Diffstat (limited to 'thirdparties/common/include/libfreetype/freetype2/freetype/ftsnames.h')
-rwxr-xr-x | thirdparties/common/include/libfreetype/freetype2/freetype/ftsnames.h | 281 |
1 files changed, 140 insertions, 141 deletions
diff --git a/thirdparties/common/include/libfreetype/freetype2/freetype/ftsnames.h b/thirdparties/common/include/libfreetype/freetype2/freetype/ftsnames.h index 485e4e1..486b448 100755 --- a/thirdparties/common/include/libfreetype/freetype2/freetype/ftsnames.h +++ b/thirdparties/common/include/libfreetype/freetype2/freetype/ftsnames.h @@ -36,67 +36,66 @@ FT_BEGIN_HEADER - /*************************************************************************/ - /* */ - /* <Section> */ - /* sfnt_names */ - /* */ - /* <Title> */ - /* SFNT Names */ - /* */ - /* <Abstract> */ - /* Access the names embedded in TrueType and OpenType files. */ - /* */ - /* <Description> */ - /* The TrueType and OpenType specifications allow the inclusion of */ - /* a special `names table' in font files. This table contains */ - /* textual (and internationalized) information regarding the font, */ - /* like family name, copyright, version, etc. */ - /* */ - /* The definitions below are used to access them if available. */ - /* */ - /* Note that this has nothing to do with glyph names! */ - /* */ - /*************************************************************************/ - - - /*************************************************************************/ - /* */ - /* <Struct> */ - /* FT_SfntName */ - /* */ - /* <Description> */ - /* A structure used to model an SFNT `name' table entry. */ - /* */ - /* <Fields> */ - /* platform_id :: The platform ID for `string'. */ - /* */ - /* encoding_id :: The encoding ID for `string'. */ - /* */ - /* language_id :: The language ID for `string'. */ - /* */ - /* name_id :: An identifier for `string'. */ - /* */ - /* string :: The `name' string. Note that its format differs */ - /* depending on the (platform,encoding) pair. It can */ - /* be a Pascal String, a UTF-16 one, etc. */ - /* */ - /* Generally speaking, the string is not */ - /* zero-terminated. Please refer to the TrueType */ - /* specification for details. */ - /* */ - /* string_len :: The length of `string' in bytes. */ - /* */ - /* <Note> */ - /* Possible values for `platform_id', `encoding_id', `language_id', */ - /* and `name_id' are given in the file `ttnameid.h'. For details */ - /* please refer to the TrueType or OpenType specification. */ - /* */ - /* See also @TT_PLATFORM_XXX, @TT_APPLE_ID_XXX, @TT_MAC_ID_XXX, */ - /* @TT_ISO_ID_XXX, and @TT_MS_ID_XXX. */ - /* */ - typedef struct FT_SfntName_ - { +/*************************************************************************/ +/* */ +/* <Section> */ +/* sfnt_names */ +/* */ +/* <Title> */ +/* SFNT Names */ +/* */ +/* <Abstract> */ +/* Access the names embedded in TrueType and OpenType files. */ +/* */ +/* <Description> */ +/* The TrueType and OpenType specifications allow the inclusion of */ +/* a special `names table' in font files. This table contains */ +/* textual (and internationalized) information regarding the font, */ +/* like family name, copyright, version, etc. */ +/* */ +/* The definitions below are used to access them if available. */ +/* */ +/* Note that this has nothing to do with glyph names! */ +/* */ +/*************************************************************************/ + + +/*************************************************************************/ +/* */ +/* <Struct> */ +/* FT_SfntName */ +/* */ +/* <Description> */ +/* A structure used to model an SFNT `name' table entry. */ +/* */ +/* <Fields> */ +/* platform_id :: The platform ID for `string'. */ +/* */ +/* encoding_id :: The encoding ID for `string'. */ +/* */ +/* language_id :: The language ID for `string'. */ +/* */ +/* name_id :: An identifier for `string'. */ +/* */ +/* string :: The `name' string. Note that its format differs */ +/* depending on the (platform,encoding) pair. It can */ +/* be a Pascal String, a UTF-16 one, etc. */ +/* */ +/* Generally speaking, the string is not */ +/* zero-terminated. Please refer to the TrueType */ +/* specification for details. */ +/* */ +/* string_len :: The length of `string' in bytes. */ +/* */ +/* <Note> */ +/* Possible values for `platform_id', `encoding_id', `language_id', */ +/* and `name_id' are given in the file `ttnameid.h'. For details */ +/* please refer to the TrueType or OpenType specification. */ +/* */ +/* See also @TT_PLATFORM_XXX, @TT_APPLE_ID_XXX, @TT_MAC_ID_XXX, */ +/* @TT_ISO_ID_XXX, and @TT_MS_ID_XXX. */ +/* */ +typedef struct FT_SfntName_ { FT_UShort platform_id; FT_UShort encoding_id; FT_UShort language_id; @@ -105,91 +104,91 @@ FT_BEGIN_HEADER FT_Byte* string; /* this string is *not* null-terminated! */ FT_UInt string_len; /* in bytes */ - } FT_SfntName; - - - /*************************************************************************/ - /* */ - /* <Function> */ - /* FT_Get_Sfnt_Name_Count */ - /* */ - /* <Description> */ - /* Retrieve the number of name strings in the SFNT `name' table. */ - /* */ - /* <Input> */ - /* face :: A handle to the source face. */ - /* */ - /* <Return> */ - /* The number of strings in the `name' table. */ - /* */ - FT_EXPORT( FT_UInt ) - FT_Get_Sfnt_Name_Count( FT_Face face ); - - - /*************************************************************************/ - /* */ - /* <Function> */ - /* FT_Get_Sfnt_Name */ - /* */ - /* <Description> */ - /* Retrieve a string of the SFNT `name' table for a given index. */ - /* */ - /* <Input> */ - /* face :: A handle to the source face. */ - /* */ - /* idx :: The index of the `name' string. */ - /* */ - /* <Output> */ - /* aname :: The indexed @FT_SfntName structure. */ - /* */ - /* <Return> */ - /* FreeType error code. 0~means success. */ - /* */ - /* <Note> */ - /* The `string' array returned in the `aname' structure is not */ - /* null-terminated. The application should deallocate it if it is no */ - /* longer in use. */ - /* */ - /* 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, encoding, and name ID. */ - /* */ - FT_EXPORT( FT_Error ) - FT_Get_Sfnt_Name( FT_Face face, - FT_UInt idx, - FT_SfntName *aname ); - - - /*************************************************************************** - * - * @constant: - * FT_PARAM_TAG_IGNORE_PREFERRED_FAMILY - * - * @description: - * A constant used as the tag of @FT_Parameter structures to make - * FT_Open_Face() ignore preferred family subfamily names in `name' - * table since OpenType version 1.4. For backwards compatibility with - * legacy systems which has 4-face-per-family restriction. - * - */ +} FT_SfntName; + + +/*************************************************************************/ +/* */ +/* <Function> */ +/* FT_Get_Sfnt_Name_Count */ +/* */ +/* <Description> */ +/* Retrieve the number of name strings in the SFNT `name' table. */ +/* */ +/* <Input> */ +/* face :: A handle to the source face. */ +/* */ +/* <Return> */ +/* The number of strings in the `name' table. */ +/* */ +FT_EXPORT( FT_UInt ) +FT_Get_Sfnt_Name_Count( FT_Face face ); + + +/*************************************************************************/ +/* */ +/* <Function> */ +/* FT_Get_Sfnt_Name */ +/* */ +/* <Description> */ +/* Retrieve a string of the SFNT `name' table for a given index. */ +/* */ +/* <Input> */ +/* face :: A handle to the source face. */ +/* */ +/* idx :: The index of the `name' string. */ +/* */ +/* <Output> */ +/* aname :: The indexed @FT_SfntName structure. */ +/* */ +/* <Return> */ +/* FreeType error code. 0~means success. */ +/* */ +/* <Note> */ +/* The `string' array returned in the `aname' structure is not */ +/* null-terminated. The application should deallocate it if it is no */ +/* longer in use. */ +/* */ +/* 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, encoding, and name ID. */ +/* */ +FT_EXPORT( FT_Error ) +FT_Get_Sfnt_Name( FT_Face face, + FT_UInt idx, + FT_SfntName *aname ); + + +/*************************************************************************** + * + * @constant: + * FT_PARAM_TAG_IGNORE_PREFERRED_FAMILY + * + * @description: + * A constant used as the tag of @FT_Parameter structures to make + * FT_Open_Face() ignore preferred family subfamily names in `name' + * table since OpenType version 1.4. For backwards compatibility with + * legacy systems which has 4-face-per-family restriction. + * + */ #define FT_PARAM_TAG_IGNORE_PREFERRED_FAMILY FT_MAKE_TAG( 'i', 'g', 'p', 'f' ) - /*************************************************************************** - * - * @constant: - * FT_PARAM_TAG_IGNORE_PREFERRED_SUBFAMILY - * - * @description: - * A constant used as the tag of @FT_Parameter structures to make - * FT_Open_Face() ignore preferred subfamily names in `name' table since - * OpenType version 1.4. For backwards compatibility with legacy - * systems which has 4-face-per-family restriction. - * - */ +/*************************************************************************** + * + * @constant: + * FT_PARAM_TAG_IGNORE_PREFERRED_SUBFAMILY + * + * @description: + * A constant used as the tag of @FT_Parameter structures to make + * FT_Open_Face() ignore preferred subfamily names in `name' table since + * OpenType version 1.4. For backwards compatibility with legacy + * systems which has 4-face-per-family restriction. + * + */ #define FT_PARAM_TAG_IGNORE_PREFERRED_SUBFAMILY FT_MAKE_TAG( 'i', 'g', 'p', 's' ) - /* */ +/* */ FT_END_HEADER |