开通博客赚积分
发布资源赚积分
分类

源码开发语言/平台
当前位置：首页 > 源码/资料 > Windows编程 > 多媒体编程 > 查看源码
TextCommon.h
资源名称：fullMPCcode.rar　[点击查看]
上传用户：xjjlds
上传日期：2015-12-05
资源大小：22823k
文件大小：37k
源码类别：

多媒体编程

开发平台：

Visual C++

TextCommon.h：源码内容
  1. /*
  2.      File:       TextCommon.h
  3.  
  4.      Contains:   TextEncoding-related types and constants, and prototypes for related functions
  5.  
  6.      Version:    Technology: Mac OS 9.0
  7.                  Release:    QuickTime 6.0.2
  8.  
  9.      Copyright:  (c) 1995-2001 by Apple Computer, Inc., all rights reserved.
  10.  
  11.      Bugs?:      For bug reports, consult the following page on
  12.                  the World Wide Web:
  13.  
  14.                      http://developer.apple.com/bugreporter/
  15.  
  16. */
  17. #ifndef __TEXTCOMMON__
  18. #define __TEXTCOMMON__
  20. #ifndef __MACTYPES__
  21. #include "MacTypes.h"
  22. #endif
  27. #if PRAGMA_ONCE
  28. #pragma once
  29. #endif
  31. #ifdef __cplusplus
  32. extern "C" {
  33. #endif
  35. #if PRAGMA_IMPORT
  36. #pragma import on
  37. #endif
  39. #if PRAGMA_STRUCT_ALIGN
  40.     #pragma options align=mac68k
  41. #elif PRAGMA_STRUCT_PACKPUSH
  42.     #pragma pack(push, 2)
  43. #elif PRAGMA_STRUCT_PACK
  44.     #pragma pack(2)
  45. #endif
  47. /* TextEncodingBase type & values */
  48. /* (values 0-32 correspond to the Script Codes defined in Inside Macintosh: Text pages 6-52 and 6-53 */
  49. typedef UInt32                          TextEncodingBase;
  50. enum {
  51.                                                                 /* Mac OS encodings*/
  52.     kTextEncodingMacRoman       = 0L,
  53.     kTextEncodingMacJapanese    = 1,
  54.     kTextEncodingMacChineseTrad = 2,
  55.     kTextEncodingMacKorean      = 3,
  56.     kTextEncodingMacArabic      = 4,
  57.     kTextEncodingMacHebrew      = 5,
  58.     kTextEncodingMacGreek       = 6,
  59.     kTextEncodingMacCyrillic    = 7,
  60.     kTextEncodingMacDevanagari  = 9,
  61.     kTextEncodingMacGurmukhi    = 10,
  62.     kTextEncodingMacGujarati    = 11,
  63.     kTextEncodingMacOriya       = 12,
  64.     kTextEncodingMacBengali     = 13,
  65.     kTextEncodingMacTamil       = 14,
  66.     kTextEncodingMacTelugu      = 15,
  67.     kTextEncodingMacKannada     = 16,
  68.     kTextEncodingMacMalayalam   = 17,
  69.     kTextEncodingMacSinhalese   = 18,
  70.     kTextEncodingMacBurmese     = 19,
  71.     kTextEncodingMacKhmer       = 20,
  72.     kTextEncodingMacThai        = 21,
  73.     kTextEncodingMacLaotian     = 22,
  74.     kTextEncodingMacGeorgian    = 23,
  75.     kTextEncodingMacArmenian    = 24,
  76.     kTextEncodingMacChineseSimp = 25,
  77.     kTextEncodingMacTibetan     = 26,
  78.     kTextEncodingMacMongolian   = 27,
  79.     kTextEncodingMacEthiopic    = 28,
  80.     kTextEncodingMacCentralEurRoman = 29,
  81.     kTextEncodingMacVietnamese  = 30,
  82.     kTextEncodingMacExtArabic   = 31,                           /* The following use script code 0, smRoman*/
  83.     kTextEncodingMacSymbol      = 33,
  84.     kTextEncodingMacDingbats    = 34,
  85.     kTextEncodingMacTurkish     = 35,
  86.     kTextEncodingMacCroatian    = 36,
  87.     kTextEncodingMacIcelandic   = 37,
  88.     kTextEncodingMacRomanian    = 38,
  89.     kTextEncodingMacCeltic      = 39,
  90.     kTextEncodingMacGaelic      = 40,                           /* Beginning in Mac OS 8.5, the following meta-value is used to indicate Unicode in some parts*/
  91.                                                                 /* of the Mac OS which previously only expected a Mac OS script code. In some of these places,*/
  92.                                                                 /* only 7 bits are available to indicate encoding (script code), so kTextEncodingUnicodeDefault*/
  93.                                                                 /* cannot be used. For example, kTextEncodingMacUnicode can be used to indicate Unicode in the*/
  94.                                                                 /* 7-bit script code field of a Unicode input method's ComponentDescription.componentFlags field;*/
  95.                                                                 /* it can also be used to indicate Unicode in the 16-bit script code field of an AppleEvent's*/
  96.                                                                 /* typeIntlWritingCode text tag.*/
  97.     kTextEncodingMacUnicode     = 0x7E,                         /* Meta-value, Unicode as a Mac encoding*/
  98.                                                                 /* The following use script code 4, smArabic*/
  99.     kTextEncodingMacFarsi       = 0x8C,                         /* Like MacArabic but uses Farsi digits*/
  100.                                                                 /* The following use script code 7, smCyrillic*/
  101.     kTextEncodingMacUkrainian   = 0x98,                         /* Meta-value in TEC 1.5 & later; maps to kTextEncodingMacCyrillic variant    */
  102.                                                                 /* The following use script code 28, smEthiopic*/
  103.     kTextEncodingMacInuit       = 0xEC,                         /* The following use script code 32, smUnimplemented*/
  104.     kTextEncodingMacVT100       = 0xFC,                         /* VT100/102 font from Comm Toolbox: Latin-1 repertoire + box drawing etc*/
  105.                                                                 /* Special Mac OS encodings*/
  106.     kTextEncodingMacHFS         = 0xFF,                         /* Meta-value, should never appear in a table.*/
  107.                                                                 /* Unicode & ISO UCS encodings begin at 0x100*/
  108.     kTextEncodingUnicodeDefault = 0x0100,                       /* Meta-value, should never appear in a table.*/
  109.     kTextEncodingUnicodeV1_1    = 0x0101,
  110.     kTextEncodingISO10646_1993  = 0x0101,                       /* Code points identical to Unicode 1.1*/
  111.     kTextEncodingUnicodeV2_0    = 0x0103,                       /* New location for Korean Hangul*/
  112.     kTextEncodingUnicodeV2_1    = 0x0103,                       /* We treat both Unicode 2.0 and Unicode 2.1 as 2.1*/
  113.                                                                 /* ISO 8-bit and 7-bit encodings begin at 0x200*/
  114.     kTextEncodingISOLatin1      = 0x0201,                       /* ISO 8859-1*/
  115.     kTextEncodingISOLatin2      = 0x0202,                       /* ISO 8859-2*/
  116.     kTextEncodingISOLatin3      = 0x0203,                       /* ISO 8859-3*/
  117.     kTextEncodingISOLatin4      = 0x0204,                       /* ISO 8859-4*/
  118.     kTextEncodingISOLatinCyrillic = 0x0205,                     /* ISO 8859-5*/
  119.     kTextEncodingISOLatinArabic = 0x0206,                       /* ISO 8859-6, = ASMO 708, =DOS CP 708*/
  120.     kTextEncodingISOLatinGreek  = 0x0207,                       /* ISO 8859-7*/
  121.     kTextEncodingISOLatinHebrew = 0x0208,                       /* ISO 8859-8*/
  122.     kTextEncodingISOLatin5      = 0x0209,                       /* ISO 8859-9*/
  123.     kTextEncodingISOLatin6      = 0x020A,                       /* ISO 8859-10                           */
  124.     kTextEncodingISOLatin7      = 0x020D,                       /* ISO 8859-13, Baltic Rim                   */
  125.     kTextEncodingISOLatin8      = 0x020E,                       /* ISO 8859-14, Celtic                    */
  126.     kTextEncodingISOLatin9      = 0x020F,                       /* ISO 8859-15, 8859-1 changed for EURO & CP1252 letters  */
  127.                                                                 /* MS-DOS & Windows encodings begin at 0x400*/
  128.     kTextEncodingDOSLatinUS     = 0x0400,                       /* code page 437*/
  129.     kTextEncodingDOSGreek       = 0x0405,                       /* code page 737 (formerly code page 437G)*/
  130.     kTextEncodingDOSBalticRim   = 0x0406,                       /* code page 775*/
  131.     kTextEncodingDOSLatin1      = 0x0410,                       /* code page 850, "Multilingual"*/
  132.     kTextEncodingDOSGreek1      = 0x0411,                       /* code page 851*/
  133.     kTextEncodingDOSLatin2      = 0x0412,                       /* code page 852, Slavic*/
  134.     kTextEncodingDOSCyrillic    = 0x0413,                       /* code page 855, IBM Cyrillic*/
  135.     kTextEncodingDOSTurkish     = 0x0414,                       /* code page 857, IBM Turkish*/
  136.     kTextEncodingDOSPortuguese  = 0x0415,                       /* code page 860*/
  137.     kTextEncodingDOSIcelandic   = 0x0416,                       /* code page 861*/
  138.     kTextEncodingDOSHebrew      = 0x0417,                       /* code page 862*/
  139.     kTextEncodingDOSCanadianFrench = 0x0418,                    /* code page 863*/
  140.     kTextEncodingDOSArabic      = 0x0419,                       /* code page 864*/
  141.     kTextEncodingDOSNordic      = 0x041A,                       /* code page 865*/
  142.     kTextEncodingDOSRussian     = 0x041B,                       /* code page 866*/
  143.     kTextEncodingDOSGreek2      = 0x041C,                       /* code page 869, IBM Modern Greek*/
  144.     kTextEncodingDOSThai        = 0x041D,                       /* code page 874, also for Windows*/
  145.     kTextEncodingDOSJapanese    = 0x0420,                       /* code page 932, also for Windows; Shift-JIS with additions*/
  146.     kTextEncodingDOSChineseSimplif = 0x0421,                    /* code page 936, also for Windows; was EUC-CN, now GBK (EUC-CN extended)*/
  147.     kTextEncodingDOSKorean      = 0x0422,                       /* code page 949, also for Windows; Unified Hangul Code (EUC-KR extended)*/
  148.     kTextEncodingDOSChineseTrad = 0x0423,                       /* code page 950, also for Windows; Big-5*/
  149.     kTextEncodingWindowsLatin1  = 0x0500,                       /* code page 1252*/
  150.     kTextEncodingWindowsANSI    = 0x0500,                       /* code page 1252 (alternate name)*/
  151.     kTextEncodingWindowsLatin2  = 0x0501,                       /* code page 1250, Central Europe*/
  152.     kTextEncodingWindowsCyrillic = 0x0502,                      /* code page 1251, Slavic Cyrillic*/
  153.     kTextEncodingWindowsGreek   = 0x0503,                       /* code page 1253*/
  154.     kTextEncodingWindowsLatin5  = 0x0504,                       /* code page 1254, Turkish*/
  155.     kTextEncodingWindowsHebrew  = 0x0505,                       /* code page 1255*/
  156.     kTextEncodingWindowsArabic  = 0x0506,                       /* code page 1256*/
  157.     kTextEncodingWindowsBalticRim = 0x0507,                     /* code page 1257*/
  158.     kTextEncodingWindowsVietnamese = 0x0508,                    /* code page 1258*/
  159.     kTextEncodingWindowsKoreanJohab = 0x0510,                   /* code page 1361, for Windows NT*/
  160.                                                                 /* Various national standards begin at 0x600*/
  161.     kTextEncodingUS_ASCII       = 0x0600,
  162.     kTextEncodingJIS_X0201_76   = 0x0620,                       /* JIS Roman and 1-byte katakana (halfwidth)*/
  163.     kTextEncodingJIS_X0208_83   = 0x0621,
  164.     kTextEncodingJIS_X0208_90   = 0x0622,
  165.     kTextEncodingJIS_X0212_90   = 0x0623,
  166.     kTextEncodingJIS_C6226_78   = 0x0624,
  167.     kTextEncodingGB_2312_80     = 0x0630,
  168.     kTextEncodingGBK_95         = 0x0631,                       /* annex to GB 13000-93; for Windows 95; EUC-CN extended*/
  169.     kTextEncodingKSC_5601_87    = 0x0640,                       /* same as KSC 5601-92 without Johab annex*/
  170.     kTextEncodingKSC_5601_92_Johab = 0x0641,                    /* KSC 5601-92 Johab annex*/
  171.     kTextEncodingCNS_11643_92_P1 = 0x0651,                      /* CNS 11643-1992 plane 1*/
  172.     kTextEncodingCNS_11643_92_P2 = 0x0652,                      /* CNS 11643-1992 plane 2*/
  173.     kTextEncodingCNS_11643_92_P3 = 0x0653,                      /* CNS 11643-1992 plane 3 (was plane 14 in 1986 version)*/
  174.                                                                 /* ISO 2022 collections begin at 0x800*/
  175.     kTextEncodingISO_2022_JP    = 0x0820,
  176.     kTextEncodingISO_2022_JP_2  = 0x0821,
  177.     kTextEncodingISO_2022_CN    = 0x0830,
  178.     kTextEncodingISO_2022_CN_EXT = 0x0831,
  179.     kTextEncodingISO_2022_KR    = 0x0840,                       /* EUC collections begin at 0x900*/
  180.     kTextEncodingEUC_JP         = 0x0920,                       /* ISO 646, 1-byte katakana, JIS 208, JIS 212*/
  181.     kTextEncodingEUC_CN         = 0x0930,                       /* ISO 646, GB 2312-80*/
  182.     kTextEncodingEUC_TW         = 0x0931,                       /* ISO 646, CNS 11643-1992 Planes 1-16*/
  183.     kTextEncodingEUC_KR         = 0x0940,                       /* ISO 646, KS C 5601-1987*/
  184.                                                                 /* Misc standards begin at 0xA00*/
  185.     kTextEncodingShiftJIS       = 0x0A01,                       /* plain Shift-JIS*/
  186.     kTextEncodingKOI8_R         = 0x0A02,                       /* Russian internet standard*/
  187.     kTextEncodingBig5           = 0x0A03,                       /* Big-5 (has variants)*/
  188.     kTextEncodingMacRomanLatin1 = 0x0A04,                       /* Mac OS Roman permuted to align with ISO Latin-1*/
  189.     kTextEncodingHZ_GB_2312     = 0x0A05,                       /* HZ (RFC 1842, for Chinese mail & news)*/
  190.                                                                 /* Other platform encodings*/
  191.     kTextEncodingNextStepLatin  = 0x0B01,                       /* NextStep encoding*/
  192.                                                                 /* EBCDIC & IBM host encodings begin at 0xC00*/
  193.     kTextEncodingEBCDIC_US      = 0x0C01,                       /* basic EBCDIC-US*/
  194.     kTextEncodingEBCDIC_CP037   = 0x0C02,                       /* code page 037, extended EBCDIC (Latin-1 set) for US,Canada...*/
  195.                                                                 /* Special values*/
  196.     kTextEncodingMultiRun       = 0x0FFF,                       /* Multi-encoding text with external run info*/
  197.     kTextEncodingUnknown        = 0xFFFF,                       /* Unknown or unspecified                  */
  198.                                                                 /* The following are older names for backward compatibility*/
  199.     kTextEncodingMacTradChinese = 2,
  200.     kTextEncodingMacRSymbol     = 8,
  201.     kTextEncodingMacSimpChinese = 25,
  202.     kTextEncodingMacGeez        = 28,
  203.     kTextEncodingMacEastEurRoman = 29,
  204.     kTextEncodingMacUninterp    = 32
  205. };
  207. /* TextEncodingVariant type & values */
  208. typedef UInt32                          TextEncodingVariant;
  209. enum {
  210.                                                                 /* Default TextEncodingVariant, for any TextEncodingBase*/
  211.     kTextEncodingDefaultVariant = 0,                            /* Variants of kTextEncodingMacRoman                                 */
  212.     kMacRomanDefaultVariant     = 0,                            /* meta value, maps to 1 or 2 depending on System */
  213.     kMacRomanCurrencySignVariant = 1,                           /* Mac OS version < 8.5, 0xDB is CURRENCY SIGN*/
  214.     kMacRomanEuroSignVariant    = 2,                            /* Mac OS version >= 8.5, 0xDB is EURO SIGN      */
  215.                                                                 /* Variants of kTextEncodingMacCyrillic (for TEC 1.5 and later)                    */
  216.     kMacCyrillicDefaultVariant  = 0,                            /* meta value, maps to 1, 2, or 3 depending on System*/
  217.     kMacCyrillicCurrSignStdVariant = 1,                         /* Mac OS < 9.0 (RU,BG), 0xFF = CURRENCY SIGN, 0xA2/0xB6 = CENT / PARTIAL DIFF.*/
  218.     kMacCyrillicCurrSignUkrVariant = 2,                         /* Mac OS < 9.0 (UA,LangKit), 0xFF = CURRENCY SIGN, 0xA2/0xB6 = GHE WITH UPTURN*/
  219.     kMacCyrillicEuroSignVariant = 3,                            /* Mac OS >= 9.0, 0xFF is EURO SIGN, 0xA2/0xB6 = GHE WITH UPTURN*/
  220.                                                                 /* Variants of kTextEncodingMacIcelandic                                */
  221.     kMacIcelandicStdDefaultVariant = 0,                         /* meta value, maps to 2 or 4 depending on System */
  222.     kMacIcelandicTTDefaultVariant = 1,                          /* meta value, maps to 3 or 5 depending on System */
  223.                                                                 /* The following are for Mac OS version < 8.5, 0xDB is CURRENCY SIGN             */
  224.     kMacIcelandicStdCurrSignVariant = 2,                        /* 0xBB/0xBC are fem./masc. ordinal indicators*/
  225.     kMacIcelandicTTCurrSignVariant = 3,                         /* 0xBB/0xBC are fi/fl ligatures*/
  226.                                                                 /* The following are for Mac OS version >= 8.5, 0xDB is EURO SIGN                  */
  227.     kMacIcelandicStdEuroSignVariant = 4,                        /* 0xBB/0xBC are fem./masc. ordinal indicators*/
  228.     kMacIcelandicTTEuroSignVariant = 5,                         /* 0xBB/0xBC are fi/fl ligatures*/
  229.                                                                 /* Variants of kTextEncodingMacCroatian                                   */
  230.     kMacCroatianDefaultVariant  = 0,                            /* meta value, maps to 1 or 2 depending on System */
  231.     kMacCroatianCurrencySignVariant = 1,                        /* Mac OS version < 8.5, 0xDB is CURRENCY SIGN       */
  232.     kMacCroatianEuroSignVariant = 2,                            /* Mac OS version >= 8.5, 0xDB is EURO SIGN      */
  233.                                                                 /* Variants of kTextEncodingMacRomanian                                   */
  234.     kMacRomanianDefaultVariant  = 0,                            /* meta value, maps to 1 or 2 depending on System */
  235.     kMacRomanianCurrencySignVariant = 1,                        /* Mac OS version < 8.5, 0xDB is CURRENCY SIGN       */
  236.     kMacRomanianEuroSignVariant = 2,                            /* Mac OS version >= 8.5, 0xDB is EURO SIGN      */
  237.                                                                 /* Variants of kTextEncodingMacJapanese*/
  238.     kMacJapaneseStandardVariant = 0,
  239.     kMacJapaneseStdNoVerticalsVariant = 1,
  240.     kMacJapaneseBasicVariant    = 2,
  241.     kMacJapanesePostScriptScrnVariant = 3,
  242.     kMacJapanesePostScriptPrintVariant = 4,
  243.     kMacJapaneseVertAtKuPlusTenVariant = 5,                     /* Variants of kTextEncodingMacArabic*/
  244.     kMacArabicStandardVariant   = 0,                            /* 0xC0 is 8-spoke asterisk, 0x2A & 0xAA are asterisk (e.g. Cairo)*/
  245.     kMacArabicTrueTypeVariant   = 1,                            /* 0xC0 is asterisk, 0x2A & 0xAA are multiply signs (e.g. Baghdad)*/
  246.     kMacArabicThuluthVariant    = 2,                            /* 0xC0 is Arabic five-point star, 0x2A & 0xAA are multiply signs*/
  247.     kMacArabicAlBayanVariant    = 3,                            /* 8-spoke asterisk, multiply sign, Koranic ligatures & parens*/
  248.                                                                 /* Variants of kTextEncodingMacFarsi*/
  249.     kMacFarsiStandardVariant    = 0,                            /* 0xC0 is 8-spoke asterisk, 0x2A & 0xAA are asterisk (e.g. Tehran)*/
  250.     kMacFarsiTrueTypeVariant    = 1,                            /* asterisk, multiply signs, Koranic ligatures, geometric shapes*/
  251.                                                                 /* Variants of kTextEncodingMacHebrew*/
  252.     kMacHebrewStandardVariant   = 0,
  253.     kMacHebrewFigureSpaceVariant = 1,                           /* Variants of kTextEncodingMacVT100                                 */
  254.     kMacVT100DefaultVariant     = 0,                            /* meta value, maps to 1 or 2 depending on System */
  255.     kMacVT100CurrencySignVariant = 1,                           /* Mac OS version < 8.5, 0xDB is CURRENCY SIGN       */
  256.     kMacVT100EuroSignVariant    = 2,                            /* Mac OS version >= 8.5, 0xDB is EURO SIGN      */
  257.                                                                 /* Variants of Unicode & ISO 10646 encodings*/
  258.     kUnicodeNoSubset            = 0,
  259.     kUnicodeCanonicalDecompVariant = 2,                         /* canonical decomposition; excludes composed characters*/
  260.                                                                 /* Variants of Big-5 encoding*/
  261.     kBig5_BasicVariant          = 0,
  262.     kBig5_StandardVariant       = 1,                            /* 0xC6A1-0xC7FC: kana, Cyrillic, enclosed numerics*/
  263.     kBig5_ETenVariant           = 2,                            /* adds kana, Cyrillic, radicals, etc with hi bytes C6-C8,F9*/
  264.                                                                 /* Unicode variants not yet supported (and not fully defined)*/
  265.     kUnicodeNoCompatibilityVariant = 1,
  266.     kUnicodeNoComposedVariant   = 3,
  267.     kUnicodeNoCorporateVariant  = 4,                            /* The following are older names for backward compatibility*/
  268.     kMacRomanStandardVariant    = 0,
  269.     kMacIcelandicStandardVariant = 0,
  270.     kMacIcelandicTrueTypeVariant = 1,
  271.     kJapaneseStandardVariant    = 0,
  272.     kJapaneseStdNoVerticalsVariant = 1,
  273.     kJapaneseBasicVariant       = 2,
  274.     kJapanesePostScriptScrnVariant = 3,
  275.     kJapanesePostScriptPrintVariant = 4,
  276.     kJapaneseVertAtKuPlusTenVariant = 5,                        /* kJapaneseStdNoOneByteKanaVariant = 6,  // replaced by kJapaneseNoOneByteKanaOption*/
  277.                                                                 /* kJapaneseBasicNoOneByteKanaVariant = 7,    // replaced by kJapaneseNoOneByteKanaOption    */
  278.     kHebrewStandardVariant      = 0,
  279.     kHebrewFigureSpaceVariant   = 1,
  280.     kUnicodeMaxDecomposedVariant = 2,                           /* replaced by kUnicodeCanonicalDecompVariant*/
  281.                                                                 /* The following Japanese variant options were never supported and are now deprecated.*/
  282.                                                                 /* In TEC 1.4 and later their functionality is replaced by the Unicode Converter options listed.*/
  283.     kJapaneseNoOneByteKanaOption = 0x20,                        /* replaced by UnicodeConverter option kUnicodeNoHalfwidthCharsBit*/
  284.     kJapaneseUseAsciiBackslashOption = 0x40                     /* replaced by UnicodeConverter option kUnicodeForceASCIIRangeBit*/
  285. };
  287. /* TextEncodingFormat type & values */
  288. typedef UInt32                          TextEncodingFormat;
  289. enum {
  290.                                                                 /* Default TextEncodingFormat for any TextEncodingBase*/
  291.     kTextEncodingDefaultFormat  = 0,                            /* Formats for Unicode & ISO 10646*/
  292.     kUnicode16BitFormat         = 0,
  293.     kUnicodeUTF7Format          = 1,
  294.     kUnicodeUTF8Format          = 2,
  295.     kUnicode32BitFormat         = 3
  296. };
  298. /* TextEncoding type */
  299. typedef UInt32                          TextEncoding;
  300. /* name part selector for GetTextEncodingName*/
  301. typedef UInt32                          TextEncodingNameSelector;
  302. enum {
  303.     kTextEncodingFullName       = 0,
  304.     kTextEncodingBaseName       = 1,
  305.     kTextEncodingVariantName    = 2,
  306.     kTextEncodingFormatName     = 3
  307. };
  309. /* Types used in conversion */
  311. struct TextEncodingRun {
  312.     ByteOffset                      offset;
  313.     TextEncoding                    textEncoding;
  314. };
  315. typedef struct TextEncodingRun          TextEncodingRun;
  316. typedef TextEncodingRun *               TextEncodingRunPtr;
  318. typedef const TextEncodingRun *         ConstTextEncodingRunPtr;
  320. struct ScriptCodeRun {
  321.     ByteOffset                      offset;
  322.     ScriptCode                      script;
  323. };
  324. typedef struct ScriptCodeRun            ScriptCodeRun;
  325. typedef ScriptCodeRun *                 ScriptCodeRunPtr;
  327. typedef const ScriptCodeRun *           ConstScriptCodeRunPtr;
  328. typedef UInt8 *                         TextPtr;
  329. typedef const UInt8 *                   ConstTextPtr;
  330. /* Basic types for Unicode characters and strings:*/
  331. typedef UniChar *                       UniCharArrayPtr;
  332. typedef const UniChar *                 ConstUniCharArrayPtr;
  333. /*
  334.    UniCharArrayHandle is a handle type to correspond to UniCharArrayPtr,
  335.    i.e. a handle to an array of UniChars (UInt16s).
  336. */
  337. typedef UniCharArrayPtr *               UniCharArrayHandle;
  338. /*
  339.    UniCharArrayOffset is used to indicate an edge offset in an array
  340.    of UniChars (UInt16s).  
  341. */
  342. typedef UInt32                          UniCharArrayOffset;
  343. /* enums for TextEncoding Conversion routines*/
  344. enum {
  345.     kTextScriptDontCare         = -128,
  346.     kTextLanguageDontCare       = -128,
  347.     kTextRegionDontCare         = -128
  348. };
  350. /* struct for TECGetInfo*/
  353. struct TECInfo {
  354.     UInt16                          format;                     /* format code for this struct*/
  355.     UInt16                          tecVersion;                 /* TEC version in BCD, e.g. 0x0121 for 1.2.1*/
  356.     UInt32                          tecTextConverterFeatures;   /* bitmask indicating TEC features/fixes*/
  357.     UInt32                          tecUnicodeConverterFeatures; /* bitmask indicating UnicodeConverter features/fixes*/
  358.     UInt32                          tecTextCommonFeatures;      /* bitmask indicating TextCommon features/fixes*/
  359.     Str31                           tecTextEncodingsFolderName; /* localized name of Text Encodings folder (pascal string)*/
  360.     Str31                           tecExtensionFileName;       /* localized name of TEC extension (pascal string)*/
  361.     UInt16                          tecLowestTEFileVersion;     /* Lowest version (BCD) of all files in Text Encodings folder*/
  362.     UInt16                          tecHighestTEFileVersion;    /* Highest version (BCD) of all files in Text Encodings folder*/
  363. };
  364. typedef struct TECInfo                  TECInfo;
  365. typedef TECInfo *                       TECInfoPtr;
  366. typedef TECInfoPtr *                    TECInfoHandle;
  367. /* Value for TECInfo format code*/
  368. enum {
  369.     kTECInfoCurrentFormat       = 2                             /* any future formats will just add fields at the end*/
  370. };
  372. /*
  373.    Defined feature/fix bits for tecUnicodeConverterFeatures field
  374.    Bit:                             Meaning if set:
  375.    ----                             ---------------
  376.    kTECKeepInfoFixBit               Unicode Converter no longer ignores other control flags if
  377.                                     kUnicodeKeepInfoBit is set. Bug fix in TEC Manager 1.2.1.
  378.    kTECFallbackTextLengthFixBit     Unicode Converter honors the *srcConvLen and *destConvLen
  379.                                     returned by caller-supplied fallback handler for any status it
  380.                                     returns except for kTECUnmappableElementErr (previously it only
  381.                                     honored these values if noErr was returned). Bug fix in TEC
  382.                                     Manager 1.2.1.
  383.    kTECTextRunBitClearFixBit        ConvertFromUnicodeToTextRun & ConvertFromUnicodeToScriptCodeRun
  384.                                     function correctly if the kUnicodeTextRunBit is set (previously
  385.                                     their determination of best target encoding was incorrect). Bug
  386.                                     fix in TEC Manager 1.3.
  387.    kTECTextToUnicodeScanFixBit      ConvertFromTextToUnicode uses an improved scanner and maintains
  388.                                     some resulting state information, which it uses for mapping.
  389.                                     This has several effects:
  390.                                     - Improved mapping of 0x30-0x39 digits in Mac OS Arabic, fewer
  391.                                       direction overrides when mapping Mac OS Arabic & Hebrew, and
  392.                                       improved mapping of certain characters in Indic encodings.
  393.                                     - Malformed input produces kTextMalformedInputErr.
  394.                                     - ConvertFromTextToUnicode accepts and uses the control flags
  395.                                       kUnicodeKeepInfoMask and kUnicodeStringUnterminatedMask.
  396.                                     Bug fix and enhancement in TEC Manager 1.3.
  397.    kTECAddForceASCIIChangesBit      Define new control flag bits kUnicodeForceASCIIRangeBit and
  398.                                     kUnicodeNoHalfwidthCharsBit for use with
  399.                                     ConvertFromTextToUnicode, ConvertFromUnicodeToText, etc.
  400.                                     Enhancement in TEC Manager 1.4.
  401.    kTECPreferredEncodingFixBit      CreateUnicodeToTextRunInfo and related functions fix a problem
  402.                                     that occurred when a preferred encoding was specified that did
  403.                                     not match the System script; the preferred script was not
  404.                                     actually placed first in the ordered list of encodings to use.
  405.                                     Bug fix in TEC Manager 1.4.
  406.    kTECAddTextRunHeuristicsBit      Define new control flag bit kUnicodeTextRunHeuristicsBit for
  407.                                     use with ConvertFromUnicodeToTextRun.
  408.    kTECAddFallbackInterruptBit      Define new option kUnicodeFallbackInterruptSafeMask for use
  409.                                     with SetFallbackUnicodeToText. If a client fallback handler is
  410.                                     installed without specifying this bit, ConvertFromUnicodeToText
  411.                                     will HLock the tables it uses (in case the fallback handler
  412.                                     moves memory); otherwise, it won't.
  413. */
  415. enum {
  416.     kTECKeepInfoFixBit          = 0,
  417.     kTECFallbackTextLengthFixBit = 1,
  418.     kTECTextRunBitClearFixBit   = 2,
  419.     kTECTextToUnicodeScanFixBit = 3,
  420.     kTECAddForceASCIIChangesBit = 4,
  421.     kTECPreferredEncodingFixBit = 5,
  422.     kTECAddTextRunHeuristicsBit = 6,
  423.     kTECAddFallbackInterruptBit = 7
  424. };
  426. enum {
  427.     kTECKeepInfoFixMask         = 1L << kTECKeepInfoFixBit,
  428.     kTECFallbackTextLengthFixMask = 1L << kTECFallbackTextLengthFixBit,
  429.     kTECTextRunBitClearFixMask  = 1L << kTECTextRunBitClearFixBit,
  430.     kTECTextToUnicodeScanFixMask = 1L << kTECTextToUnicodeScanFixBit,
  431.     kTECAddForceASCIIChangesMask = 1L << kTECAddForceASCIIChangesBit,
  432.     kTECPreferredEncodingFixMask = 1L << kTECPreferredEncodingFixBit,
  433.     kTECAddTextRunHeuristicsMask = 1L << kTECAddTextRunHeuristicsBit,
  434.     kTECAddFallbackInterruptMask = 1L << kTECAddFallbackInterruptBit
  435. };
  437. /*
  438.    -------------------------------------------------------------------------------------------------
  439.    CONSTANTS & DATA STRUCTURES for Unicode Properties
  440.    -------------------------------------------------------------------------------------------------
  441. */
  443. typedef SInt32                          UCCharPropertyType;
  444. enum {
  445.     kUCCharPropTypeGenlCategory = 1,                            /* requests enumeration value*/
  446.     kUCCharPropTypeCombiningClass = 2,                          /* requests numeric value 0..255*/
  447.     kUCCharPropTypeBidiCategory = 3                             /* requests enumeration value*/
  448. };
  450. typedef UInt32                          UCCharPropertyValue;
  451. /* General Category enumeration values (requested by kUCCharPropTypeGenlCategory)*/
  452. enum {
  453.                                                                 /* Normative categories:*/
  454.     kUCGenlCatOtherNotAssigned  = 0,                            /* Cn Other, Not Assigned*/
  455.     kUCGenlCatOtherControl      = 1,                            /* Cc Other, Control*/
  456.     kUCGenlCatOtherFormat       = 2,                            /* Cf Other, Format*/
  457.     kUCGenlCatOtherSurrogate    = 3,                            /* Cs Other, Surrogate*/
  458.     kUCGenlCatOtherPrivateUse   = 4,                            /* Co Other, Private Use*/
  459.     kUCGenlCatMarkNonSpacing    = 5,                            /* Mn Mark, Non-Spacing*/
  460.     kUCGenlCatMarkSpacingCombining = 6,                         /* Mc Mark, Spacing Combining*/
  461.     kUCGenlCatMarkEnclosing     = 7,                            /* Me Mark, Enclosing*/
  462.     kUCGenlCatNumberDecimalDigit = 8,                           /* Nd Number, Decimal Digit*/
  463.     kUCGenlCatNumberLetter      = 9,                            /* Nl Number, Letter*/
  464.     kUCGenlCatNumberOther       = 10,                           /* No Number, Other*/
  465.     kUCGenlCatSeparatorSpace    = 11,                           /* Zs Separator, Space*/
  466.     kUCGenlCatSeparatorLine     = 12,                           /* Zl Separator, Line*/
  467.     kUCGenlCatSeparatorParagraph = 13,                          /* Zp Separator, Paragraph*/
  468.                                                                 /* Informative categories:*/
  469.     kUCGenlCatLetterUppercase   = 14,                           /* Lu Letter, Uppercase*/
  470.     kUCGenlCatLetterLowercase   = 15,                           /* Ll Letter, Lowercase*/
  471.     kUCGenlCatLetterTitlecase   = 16,                           /* Lt Letter, Titlecase*/
  472.     kUCGenlCatLetterModifier    = 17,                           /* Lm Letter, Modifier*/
  473.     kUCGenlCatLetterOther       = 18,                           /* Lo Letter, Other*/
  474.     kUCGenlCatPunctConnector    = 20,                           /* Pc Punctuation, Connector*/
  475.     kUCGenlCatPunctDash         = 21,                           /* Pd Punctuation, Dash*/
  476.     kUCGenlCatPunctOpen         = 22,                           /* Ps Punctuation, Open*/
  477.     kUCGenlCatPunctClose        = 23,                           /* Pe Punctuation, Close*/
  478.     kUCGenlCatPunctInitialQuote = 24,                           /* Pi Punctuation, Initial quote*/
  479.     kUCGenlCatPunctFinalQuote   = 25,                           /* Pf Punctuation, Final quote*/
  480.     kUCGenlCatPunctOther        = 26,                           /* Po Punctuation, Other*/
  481.     kUCGenlCatSymbolMath        = 28,                           /* Sm Symbol, Math*/
  482.     kUCGenlCatSymbolCurrency    = 29,                           /* Sc Symbol, Currency*/
  483.     kUCGenlCatSymbolModifier    = 30,                           /* Sk Symbol, Modifier*/
  484.     kUCGenlCatSymbolOther       = 31                            /* So Symbol, Other*/
  485. };
  487. /* Bidirectional Category enumeration values (requested by kUCCharPropTypeBidiCategory)*/
  488. enum {
  489.     kUCBidiCatNotApplicable     = 0,                            /* for now use this for unassigned*/
  490.                                                                 /* Strong types:*/
  491.     kUCBidiCatLeftRight         = 1,                            /* L  Left-Right*/
  492.     kUCBidiCatRightLeft         = 2,                            /* R  Right-Left*/
  493.                                                                 /* Weak types:*/
  494.     kUCBidiCatEuroNumber        = 3,                            /* EN European Number*/
  495.     kUCBidiCatEuroNumberSeparator = 4,                          /* ES European Number Separator*/
  496.     kUCBidiCatEuroNumberTerminator = 5,                         /* ET European Number Terminator*/
  497.     kUCBidiCatArabicNumber      = 6,                            /* AN Arabic Number*/
  498.     kUCBidiCatCommonNumberSeparator = 7,                        /* CS Common Number Separator*/
  499.                                                                 /* Separators:*/
  500.     kUCBidiCatBlockSeparator    = 8,                            /* B  Block Separator*/
  501.     kUCBidiCatSegmentSeparator  = 9,                            /* S  Segment Separator*/
  502.                                                                 /* Neutrals:*/
  503.     kUCBidiCatWhitespace        = 10,                           /* WS Whitespace*/
  504.     kUCBidiCatOtherNeutral      = 11                            /* ON Other Neutrals (unassigned codes could use this)*/
  505. };
  507. /* Prototypes for TextEncoding functions*/
  509. EXTERN_API( TextEncoding )
  510. CreateTextEncoding              (TextEncodingBase       encodingBase,
  511.                                  TextEncodingVariant    encodingVariant,
  512.                                  TextEncodingFormat     encodingFormat);
  514. EXTERN_API( TextEncodingBase )
  515. GetTextEncodingBase             (TextEncoding           encoding);
  517. EXTERN_API( TextEncodingVariant )
  518. GetTextEncodingVariant          (TextEncoding           encoding);
  520. EXTERN_API( TextEncodingFormat )
  521. GetTextEncodingFormat           (TextEncoding           encoding);
  523. EXTERN_API( TextEncoding )
  524. ResolveDefaultTextEncoding      (TextEncoding           encoding);
  526. EXTERN_API_C( OSStatus )
  527. GetTextEncodingName             (TextEncoding           iEncoding,
  528.                                  TextEncodingNameSelector  iNamePartSelector,
  529.                                  RegionCode             iPreferredRegion,
  530.                                  TextEncoding           iPreferredEncoding,
  531.                                  ByteCount              iOutputBufLen,
  532.                                  ByteCount *            oNameLength,
  533.                                  RegionCode *           oActualRegion, /* can be NULL */
  534.                                  TextEncoding *         oActualEncoding, /* can be NULL */
  535.                                  TextPtr                oEncodingName);
  537. EXTERN_API( OSStatus )
  538. TECGetInfo                      (TECInfoHandle *        tecInfo);
  541. EXTERN_API( OSStatus )
  542. UpgradeScriptInfoToTextEncoding (ScriptCode             iTextScriptID,
  543.                                  LangCode               iTextLanguageID,
  544.                                  RegionCode             iRegionID,
  545.                                  ConstStr255Param       iTextFontname,
  546.                                  TextEncoding *         oEncoding);
  548. EXTERN_API( OSStatus )
  549. RevertTextEncodingToScriptInfo  (TextEncoding           iEncoding,
  550.                                  ScriptCode *           oTextScriptID,
  551.                                  LangCode *             oTextLanguageID, /* can be NULL */
  552.                                  Str255                 oTextFontname) /* can be NULL */;
  554. EXTERN_API( OSStatus )
  555. NearestMacTextEncodings         (TextEncoding           generalEncoding,
  556.                                  TextEncoding *         bestMacEncoding,
  557.                                  TextEncoding *         alternateMacEncoding);
  559. EXTERN_API_C( OSStatus )
  560. UCGetCharProperty               (const UniChar *        charPtr,
  561.                                  UniCharCount           textLength,
  562.                                  UCCharPropertyType     propType,
  563.                                  UCCharPropertyValue *  propValue);
  566. #if PRAGMA_STRUCT_ALIGN
  567.     #pragma options align=reset
  568. #elif PRAGMA_STRUCT_PACKPUSH
  569.     #pragma pack(pop)
  570. #elif PRAGMA_STRUCT_PACK
  571.     #pragma pack()
  572. #endif
  574. #ifdef PRAGMA_IMPORT_OFF
  575. #pragma import off
  576. #elif PRAGMA_IMPORT
  577. #pragma import reset
  578. #endif
  580. #ifdef __cplusplus
  581. }
  582. #endif
  584. #endif /* __TEXTCOMMON__ */