/***************************************************************************/
/* */
/*ftwinfnt.h */
/* */
/*FreeType API for accessing Windows fnt-specific data.*/
/* */
/*Copyright 2003-2015 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
#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
/*************************************************************************/
/* */
/*
/*winfnt_fonts */
/* */
/*
/*************************************************************************
*
* @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
*
* 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
*
* https://msdn.microsoft.com/en-us/goglobal/bb964655,
*
* 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_CP12520
#define FT_WinFNT_ID_DEFAULT 1
#define FT_WinFNT_ID_SYMBOL2
#define FT_WinFNT_ID_MAC77
#define FT_WinFNT_ID_CP932 128
#define FT_WinFNT_ID_CP949 129
#define FT_WinFNT_ID_CP1361130
#define FT_WinFNT_ID_CP936 134
#define FT_WinFNT_ID_CP950 136
#define FT_WinFNT_ID_CP1253161
#define FT_WinFNT_ID_CP1254162
#define FT_WinFNT_ID_CP1258163
#define FT_WinFNT_ID_CP1255177
#define FT_WinFNT_ID_CP1256178
#define FT_WinFNT_ID_CP1257186
#define FT_WinFNT_ID_CP1251204
#define FT_WinFNT_ID_CP874 222
#define FT_WinFNT_ID_CP1250238
#define FT_WinFNT_ID_OEM 255
/*************************************************************************/
/* */
/*
/*FT_WinFNT_HeaderRec*/
/* */
/*
/*Windows FNT Header info. */
/* */
typedef structFT_WinFNT_HeaderRec_
{
FT_UShortversion;
FT_ULong file_size;
FT_Bytecopyright[60];
FT_UShortfile_type;
FT_UShortnominal_point_size;
FT_UShortvertical_resolution;
FT_UShorthorizontal_resolution;
FT_UShortascent;
FT_UShortinternal_leading;
FT_UShortexternal_leading;
FT_Byteitalic;
FT_Byteunderline;
FT_Bytestrike_out;
FT_UShortweight;
FT_Bytecharset;
FT_UShortpixel_width;
FT_UShortpixel_height;
FT_Bytepitch_and_family;
FT_UShortavg_width;
FT_UShortmax_width;
FT_Bytefirst_char;
FT_Bytelast_char;
FT_Bytedefault_char;
FT_Bytebreak_char;
FT_UShortbytes_per_row;
FT_ULong device_offset;
FT_ULong face_name_offset;
FT_ULong bits_pointer;
FT_ULong bits_offset;
FT_Bytereserved;
FT_ULong flags;
FT_UShortA_space;
FT_UShortB_space;
FT_UShortC_space;
FT_UShortcolor_table_offset;
FT_ULong reserved1[4];
} FT_WinFNT_HeaderRec;
/*************************************************************************/
/* */
/*
/*FT_WinFNT_Header */
/* */
/*
/*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: */
Reviews
There are no reviews yet.