276 lines
10 KiB
C
276 lines
10 KiB
C
|
/***************************************************************************/
|
||
|
|
/* */
|
||
|
|
/* ftwinfnt.h */
|
||
|
|
/* */
|
||
|
|
/* FreeType API for accessing Windows fnt-specific data. */
|
||
|
|
/* */
|
||
|
|
/* Copyright 2003, 2004, 2008 by */
|
||
|
|
/* David Turner, Robert Wilhelm, and Werner Lemberg. */
|
||
|
|
/* */
|
||
|
|
/* This file is part of the FreeType project, and may only be used, */
|
||
|
|
/* modified, and distributed under the terms of the FreeType project */
|
||
|
|
/* license, LICENSE.TXT. By continuing to use, modify, or distribute */
|
||
|
|
/* this file you indicate that you have read the license and */
|
||
|
|
/* understand and accept it fully. */
|
||
|
|
/* */
|
||
|
|
/***************************************************************************/
|
||
|
|
|
||
|
|
|
||
|
|
#ifndef __FTWINFNT_H__
|
||
|
|
#define __FTWINFNT_H__
|
||
|
|
|
||
|
|
#include <ft2build.h>
|
||
|
|
#include FT_FREETYPE_H
|
||
|
|
|
||
|
|
#ifdef FREETYPE_H
|
||
|
|
#error "freetype.h of FreeType 1 has been loaded!"
|
||
|
|
#error "Please fix the directory search order for header files"
|
||
|
|
#error "so that freetype.h of FreeType 2 is found first."
|
||
|
|
#endif
|
||
|
|
|
||
|
|
|
||
|
|
FT_BEGIN_HEADER
|
||
|
|
|
||
|
|
|
||
|
|
/*************************************************************************/
|
||
|
|
/* */
|
||
|
|
/* <Section> */
|
||
|
|
/* winfnt_fonts */
|
||
|
|
/* */
|
||
|
|
/* <Title> */
|
||
|
|
/* Window FNT Files */
|
||
|
|
/* */
|
||
|
|
/* <Abstract> */
|
||
|
|
/* Windows FNT specific API. */
|
||
|
|
/* */
|
||
|
|
/* <Description> */
|
||
|
|
/* This section contains the declaration of Windows FNT specific */
|
||
|
|
/* functions. */
|
||
|
|
/* */
|
||
|
|
/*************************************************************************/
|
||
|
|
|
||
|
|
|
||
|
|
/*************************************************************************
|
||
|
|
*
|
||
|
|
* @enum:
|
||
|
|
* FT_WinFNT_ID_XXX
|
||
|
|
*
|
||
|
|
* @description:
|
||
|
|
* A list of valid values for the `charset' byte in
|
||
|
|
* @FT_WinFNT_HeaderRec. Exact mapping tables for the various cpXXXX
|
||
|
|
* encodings (except for cp1361) can be found at
|
||
|
|
* ftp://ftp.unicode.org/public in the MAPPINGS/VENDORS/MICSFT/WINDOWS
|
||
|
|
* subdirectory. cp1361 is roughly a superset of
|
||
|
|
* MAPPINGS/OBSOLETE/EASTASIA/KSC/JOHAB.TXT.
|
||
|
|
*
|
||
|
|
* @values:
|
||
|
|
* FT_WinFNT_ID_DEFAULT ::
|
||
|
|
* This is used for font enumeration and font creation as a
|
||
|
|
* `don't care' value. Valid font files don't contain this value.
|
||
|
|
* When querying for information about the character set of the font
|
||
|
|
* that is currently selected into a specified device context, this
|
||
|
|
* return value (of the related Windows API) simply denotes failure.
|
||
|
|
*
|
||
|
|
* FT_WinFNT_ID_SYMBOL ::
|
||
|
|
* There is no known mapping table available.
|
||
|
|
*
|
||
|
|
* FT_WinFNT_ID_MAC ::
|
||
|
|
* Mac Roman encoding.
|
||
|
|
*
|
||
|
|
* FT_WinFNT_ID_OEM ::
|
||
|
|
* From Michael Pöttgen <michael@poettgen.de>:
|
||
|
|
*
|
||
|
|
* The `Windows Font Mapping' article says that FT_WinFNT_ID_OEM
|
||
|
|
* is used for the charset of vector fonts, like `modern.fon',
|
||
|
|
* `roman.fon', and `script.fon' on Windows.
|
||
|
|
*
|
||
|
|
* The `CreateFont' documentation says: The FT_WinFNT_ID_OEM value
|
||
|
|
* specifies a character set that is operating-system dependent.
|
||
|
|
*
|
||
|
|
* The `IFIMETRICS' documentation from the `Windows Driver
|
||
|
|
* Development Kit' says: This font supports an OEM-specific
|
||
|
|
* character set. The OEM character set is system dependent.
|
||
|
|
*
|
||
|
|
* In general OEM, as opposed to ANSI (i.e., cp1252), denotes the
|
||
|
|
* second default codepage that most international versions of
|
||
|
|
* Windows have. It is one of the OEM codepages from
|
||
|
|
*
|
||
|
|
* http://www.microsoft.com/globaldev/reference/cphome.mspx,
|
||
|
|
*
|
||
|
|
* and is used for the `DOS boxes', to support legacy applications.
|
||
|
|
* A German Windows version for example usually uses ANSI codepage
|
||
|
|
* 1252 and OEM codepage 850.
|
||
|
|
*
|
||
|
|
* FT_WinFNT_ID_CP874 ::
|
||
|
|
* A superset of Thai TIS 620 and ISO 8859-11.
|
||
|
|
*
|
||
|
|
* FT_WinFNT_ID_CP932 ::
|
||
|
|
* A superset of Japanese Shift-JIS (with minor deviations).
|
||
|
|
*
|
||
|
|
* FT_WinFNT_ID_CP936 ::
|
||
|
|
* A superset of simplified Chinese GB 2312-1980 (with different
|
||
|
|
* ordering and minor deviations).
|
||
|
|
*
|
||
|
|
* FT_WinFNT_ID_CP949 ::
|
||
|
|
* A superset of Korean Hangul KS~C 5601-1987 (with different
|
||
|
|
* ordering and minor deviations).
|
||
|
|
*
|
||
|
|
* FT_WinFNT_ID_CP950 ::
|
||
|
|
* A superset of traditional Chinese Big~5 ETen (with different
|
||
|
|
* ordering and minor deviations).
|
||
|
|
*
|
||
|
|
* FT_WinFNT_ID_CP1250 ::
|
||
|
|
* A superset of East European ISO 8859-2 (with slightly different
|
||
|
|
* ordering).
|
||
|
|
*
|
||
|
|
* FT_WinFNT_ID_CP1251 ::
|
||
|
|
* A superset of Russian ISO 8859-5 (with different ordering).
|
||
|
|
*
|
||
|
|
* FT_WinFNT_ID_CP1252 ::
|
||
|
|
* ANSI encoding. A superset of ISO 8859-1.
|
||
|
|
*
|
||
|
|
* FT_WinFNT_ID_CP1253 ::
|
||
|
|
* A superset of Greek ISO 8859-7 (with minor modifications).
|
||
|
|
*
|
||
|
|
* FT_WinFNT_ID_CP1254 ::
|
||
|
|
* A superset of Turkish ISO 8859-9.
|
||
|
|
*
|
||
|
|
* FT_WinFNT_ID_CP1255 ::
|
||
|
|
* A superset of Hebrew ISO 8859-8 (with some modifications).
|
||
|
|
*
|
||
|
|
* FT_WinFNT_ID_CP1256 ::
|
||
|
|
* A superset of Arabic ISO 8859-6 (with different ordering).
|
||
|
|
*
|
||
|
|
* FT_WinFNT_ID_CP1257 ::
|
||
|
|
* A superset of Baltic ISO 8859-13 (with some deviations).
|
||
|
|
*
|
||
|
|
* FT_WinFNT_ID_CP1258 ::
|
||
|
|
* For Vietnamese. This encoding doesn't cover all necessary
|
||
|
|
* characters.
|
||
|
|
*
|
||
|
|
* FT_WinFNT_ID_CP1361 ::
|
||
|
|
* Korean (Johab).
|
||
|
|
*/
|
||
|
|
|
||
|
|
#define FT_WinFNT_ID_CP1252 0
|
||
|
|
#define FT_WinFNT_ID_DEFAULT 1
|
||
|
|
#define FT_WinFNT_ID_SYMBOL 2
|
||
|
|
#define FT_WinFNT_ID_MAC 77
|
||
|
|
#define FT_WinFNT_ID_CP932 128
|
||
|
|
#define FT_WinFNT_ID_CP949 129
|
||
|
|
#define FT_WinFNT_ID_CP1361 130
|
||
|
|
#define FT_WinFNT_ID_CP936 134
|
||
|
|
#define FT_WinFNT_ID_CP950 136
|
||
|
|
#define FT_WinFNT_ID_CP1253 161
|
||
|
|
#define FT_WinFNT_ID_CP1254 162
|
||
|
|
#define FT_WinFNT_ID_CP1258 163
|
||
|
|
#define FT_WinFNT_ID_CP1255 177
|
||
|
|
#define FT_WinFNT_ID_CP1256 178
|
||
|
|
#define FT_WinFNT_ID_CP1257 186
|
||
|
|
#define FT_WinFNT_ID_CP1251 204
|
||
|
|
#define FT_WinFNT_ID_CP874 222
|
||
|
|
#define FT_WinFNT_ID_CP1250 238
|
||
|
|
#define FT_WinFNT_ID_OEM 255
|
||
|
|
|
||
|
|
|
||
|
|
/*************************************************************************/
|
||
|
|
/* */
|
||
|
|
/* <Struct> */
|
||
|
|
/* FT_WinFNT_HeaderRec */
|
||
|
|
/* */
|
||
|
|
/* <Description> */
|
||
|
|
/* Windows FNT Header info. */
|
||
|
|
/* */
|
||
|
|
typedef struct FT_WinFNT_HeaderRec_
|
||
|
|
{
|
||
|
|
FT_UShort version;
|
||
|
|
FT_ULong file_size;
|
||
|
|
FT_Byte copyright[60];
|
||
|
|
FT_UShort file_type;
|
||
|
|
FT_UShort nominal_point_size;
|
||
|
|
FT_UShort vertical_resolution;
|
||
|
|
FT_UShort horizontal_resolution;
|
||
|
|
FT_UShort ascent;
|
||
|
|
FT_UShort internal_leading;
|
||
|
|
FT_UShort external_leading;
|
||
|
|
FT_Byte italic;
|
||
|
|
FT_Byte underline;
|
||
|
|
FT_Byte strike_out;
|
||
|
|
FT_UShort weight;
|
||
|
|
FT_Byte charset;
|
||
|
|
FT_UShort pixel_width;
|
||
|
|
FT_UShort pixel_height;
|
||
|
|
FT_Byte pitch_and_family;
|
||
|
|
FT_UShort avg_width;
|
||
|
|
FT_UShort max_width;
|
||
|
|
FT_Byte first_char;
|
||
|
|
FT_Byte last_char;
|
||
|
|
FT_Byte default_char;
|
||
|
|
FT_Byte break_char;
|
||
|
|
FT_UShort bytes_per_row;
|
||
|
|
FT_ULong device_offset;
|
||
|
|
FT_ULong face_name_offset;
|
||
|
|
FT_ULong bits_pointer;
|
||
|
|
FT_ULong bits_offset;
|
||
|
|
FT_Byte reserved;
|
||
|
|
FT_ULong flags;
|
||
|
|
FT_UShort A_space;
|
||
|
|
FT_UShort B_space;
|
||
|
|
FT_UShort C_space;
|
||
|
|
FT_UShort color_table_offset;
|
||
|
|
FT_ULong reserved1[4];
|
||
|
|
|
||
|
|
} FT_WinFNT_HeaderRec;
|
||
|
|
|
||
|
|
|
||
|
|
/*************************************************************************/
|
||
|
|
/* */
|
||
|
|
/* <Struct> */
|
||
|
|
/* FT_WinFNT_Header */
|
||
|
|
/* */
|
||
|
|
/* <Description> */
|
||
|
|
/* A handle to an @FT_WinFNT_HeaderRec structure. */
|
||
|
|
/* */
|
||
|
|
typedef struct FT_WinFNT_HeaderRec_* FT_WinFNT_Header;
|
||
|
|
|
||
|
|
|
||
|
|
/**********************************************************************
|
||
|
|
*
|
||
|
|
* @function:
|
||
|
|
* FT_Get_WinFNT_Header
|
||
|
|
*
|
||
|
|
* @description:
|
||
|
|
* Retrieve a Windows FNT font info header.
|
||
|
|
*
|
||
|
|
* @input:
|
||
|
|
* face :: A handle to the input face.
|
||
|
|
*
|
||
|
|
* @output:
|
||
|
|
* aheader :: The WinFNT header.
|
||
|
|
*
|
||
|
|
* @return:
|
||
|
|
* FreeType error code. 0~means success.
|
||
|
|
*
|
||
|
|
* @note:
|
||
|
|
* This function only works with Windows FNT faces, returning an error
|
||
|
|
* otherwise.
|
||
|
|
*/
|
||
|
|
FT_EXPORT( FT_Error )
|
||
|
|
FT_Get_WinFNT_Header( FT_Face face,
|
||
|
|
FT_WinFNT_HeaderRec *aheader );
|
||
|
|
|
||
|
|
/* */
|
||
|
|
|
||
|
|
|
||
|
|
FT_END_HEADER
|
||
|
|
|
||
|
|
#endif /* __FTWINFNT_H__ */
|
||
|
|
|
||
|
|
|
||
|
|
/* END */
|
||
|
|
|
||
|
|
|
||
|
|
/* Local Variables: */
|
||
|
|
/* coding: utf-8 */
|
||
|
|
/* End: */
|