Edit

kc3-lang/freetype/include/ftwinfnt.h

Branch :

  • Show log

    Commit

  • Author : Werner Lemberg
    Date : 2013-11-13 08:55:46
    Hash : fae38207
    Message : Simplify header file hierarchy. This large patch changes the header file directory layout from `include/freetype/...' to `include/...', effectively removing one level. Since the file `ft2build.h' is also located in `include' (and it stays there even after installation), all FreeType header files are now in a single directory. Applications that use (a) `freetype-config' or FreeType's `pkg-config' file to get the include directory for the compiler, and (b) the documented way for header inclusion like #include <ft2build.h> #include FT_FREETYPE_H ... don't need any change to the source code. * include/freetype/*: Move up to... * include/*: ... this directory. * builds/amiga/include/freetype/*: Move up to... * builds/amiga/include/*: ... this directory. */*: Essentially do `s@/freetype/@/@' where appropriate. * CMakeList.txt: Simplify. * builds/unix/freetype-config.in, builds/unix/freetype2.in: For `--cflags', return a single directory. * builds/unix/install.mk (install): No longer try to remove `cache' and `internal' subdirectories; instead, remove the `freetype' subdirectory.

  • include/ftwinfnt.h
  • /***************************************************************************/
    /*                                                                         */
    /*  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:             */