-
Notifications
You must be signed in to change notification settings - Fork 0
/
TextCommon.h
1136 lines (1011 loc) · 50.2 KB
/
TextCommon.h
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
/*
File: CarbonCore/TextCommon.h
Contains: TextEncoding-related types and constants, and prototypes for related functions
Version: CarbonCore-783~2
Copyright: © 1995-2006 by Apple Computer, Inc., all rights reserved.
Bugs?: For bug reports, consult the following page on
the World Wide Web:
http://developer.apple.com/bugreporter/
*/
#ifndef __TEXTCOMMON__
#define __TEXTCOMMON__
#ifndef __MACTYPES__
#include <CarbonCore/MacTypes.h>
#endif
#include <AvailabilityMacros.h>
#if PRAGMA_ONCE
#pragma once
#endif
#ifdef __cplusplus
extern "C" {
#endif
#pragma pack(push, 2)
/*
* Generic Text Alignment Constants
*
* Summary:
* These constants are implemented to supplant the old TextEdit
* Manager constants ( teFlushDefault, teCenter teFlushRight,
* teFlushLeft ) These constants are used outside the context of the
* legacy TextEdit Manager Framework. Use these as you would use the
* old TextEdit.h constants to specify how text should be justified
* (word aligned.) The new constants use the same values as the the
* old TextEdit ones, for backwards compatibility.
*/
enum {
/*
* Flush according to the line direction
*/
kTextFlushDefault = 0,
/*
* Center justify (word alignment)
*/
kTextCenter = 1,
/*
* Flush right
*/
kTextFlushRight = -1,
/*
* Flush left
*/
kTextFlushLeft = -2
};
/* TextEncodingBase type & values */
/* (values 0-32 correspond to the Script Codes defined in Inside Macintosh: Text pages 6-52 and 6-53 */
typedef UInt32 TextEncodingBase;
enum {
/* Mac OS encodings*/
kTextEncodingMacRoman = 0L,
kTextEncodingMacJapanese = 1,
kTextEncodingMacChineseTrad = 2,
kTextEncodingMacKorean = 3,
kTextEncodingMacArabic = 4,
kTextEncodingMacHebrew = 5,
kTextEncodingMacGreek = 6,
kTextEncodingMacCyrillic = 7,
kTextEncodingMacDevanagari = 9,
kTextEncodingMacGurmukhi = 10,
kTextEncodingMacGujarati = 11,
kTextEncodingMacOriya = 12,
kTextEncodingMacBengali = 13,
kTextEncodingMacTamil = 14,
kTextEncodingMacTelugu = 15,
kTextEncodingMacKannada = 16,
kTextEncodingMacMalayalam = 17,
kTextEncodingMacSinhalese = 18,
kTextEncodingMacBurmese = 19,
kTextEncodingMacKhmer = 20,
kTextEncodingMacThai = 21,
kTextEncodingMacLaotian = 22,
kTextEncodingMacGeorgian = 23,
kTextEncodingMacArmenian = 24,
kTextEncodingMacChineseSimp = 25,
kTextEncodingMacTibetan = 26,
kTextEncodingMacMongolian = 27,
kTextEncodingMacEthiopic = 28,
kTextEncodingMacCentralEurRoman = 29,
kTextEncodingMacVietnamese = 30,
kTextEncodingMacExtArabic = 31, /* The following use script code 0, smRoman*/
kTextEncodingMacSymbol = 33,
kTextEncodingMacDingbats = 34,
kTextEncodingMacTurkish = 35,
kTextEncodingMacCroatian = 36,
kTextEncodingMacIcelandic = 37,
kTextEncodingMacRomanian = 38,
kTextEncodingMacCeltic = 39,
kTextEncodingMacGaelic = 40,
kTextEncodingMacKeyboardGlyphs = 41
};
/* The following are older names for backward compatibility*/
enum {
kTextEncodingMacTradChinese = kTextEncodingMacChineseTrad,
kTextEncodingMacRSymbol = 8,
kTextEncodingMacSimpChinese = kTextEncodingMacChineseSimp,
kTextEncodingMacGeez = kTextEncodingMacEthiopic,
kTextEncodingMacEastEurRoman = kTextEncodingMacCentralEurRoman,
kTextEncodingMacUninterp = 32
};
/*
Beginning in Mac OS 8.5, the following meta-value is used to indicate Unicode in some parts
of the Mac OS which previously only expected a Mac OS script code. In some of these places,
only 7 bits are available to indicate encoding (script code), so kTextEncodingUnicodeDefault
cannot be used. For example, kTextEncodingMacUnicode can be used to indicate Unicode in the
7-bit script code field of a Unicode input method's ComponentDescription.componentFlags field;
it can also be used to indicate Unicode in the 16-bit script code field of an AppleEvent's
typeIntlWritingCode text tag.
*/
enum {
kTextEncodingMacUnicode = 0x7E /* Meta-value, Unicode as a Mac encoding*/
};
/* Variant Mac OS encodings that use script codes other than 0*/
enum {
/* The following use script code 4, smArabic*/
kTextEncodingMacFarsi = 0x8C, /* Like MacArabic but uses Farsi digits*/
/* The following use script code 7, smCyrillic*/
kTextEncodingMacUkrainian = 0x98, /* Meta-value in TEC 1.5 & later; maps to kTextEncodingMacCyrillic variant */
/* The following use script code 28, smEthiopic*/
kTextEncodingMacInuit = 0xEC, /* The following use script code 32, smUnimplemented*/
kTextEncodingMacVT100 = 0xFC /* VT100/102 font from Comm Toolbox: Latin-1 repertoire + box drawing etc*/
};
/* Special Mac OS encodings*/
enum {
kTextEncodingMacHFS = 0xFF /* Meta-value, should never appear in a table.*/
};
/* Unicode & ISO UCS encodings begin at 0x100*/
enum {
kTextEncodingUnicodeDefault = 0x0100, /* Meta-value, should never appear in a table.*/
kTextEncodingUnicodeV1_1 = 0x0101,
kTextEncodingISO10646_1993 = 0x0101, /* Code points identical to Unicode 1.1*/
kTextEncodingUnicodeV2_0 = 0x0103, /* New location for Korean Hangul*/
kTextEncodingUnicodeV2_1 = 0x0103, /* We treat both Unicode 2.0 and Unicode 2.1 as 2.1*/
kTextEncodingUnicodeV3_0 = 0x0104,
kTextEncodingUnicodeV3_1 = 0x0105, /* Adds characters requiring surrogate pairs in UTF-16*/
kTextEncodingUnicodeV3_2 = 0x0106,
kTextEncodingUnicodeV4_0 = 0x0108,
kTextEncodingUnicodeV5_0 = 0x010A
};
/* ISO 8-bit and 7-bit encodings begin at 0x200*/
enum {
kTextEncodingISOLatin1 = 0x0201, /* ISO 8859-1, Western European*/
kTextEncodingISOLatin2 = 0x0202, /* ISO 8859-2, Central European*/
kTextEncodingISOLatin3 = 0x0203, /* ISO 8859-3, South European (Maltese...)*/
kTextEncodingISOLatin4 = 0x0204, /* ISO 8859-4, North European & some Baltic*/
kTextEncodingISOLatinCyrillic = 0x0205, /* ISO 8859-5*/
kTextEncodingISOLatinArabic = 0x0206, /* ISO 8859-6, = ASMO 708, =DOS CP 708*/
kTextEncodingISOLatinGreek = 0x0207, /* ISO 8859-7*/
kTextEncodingISOLatinHebrew = 0x0208, /* ISO 8859-8*/
kTextEncodingISOLatin5 = 0x0209, /* ISO 8859-9, Turkish*/
kTextEncodingISOLatin6 = 0x020A, /* ISO 8859-10, Nordic */
kTextEncodingISOLatin7 = 0x020D, /* ISO 8859-13, Baltic Rim */
kTextEncodingISOLatin8 = 0x020E, /* ISO 8859-14, Celtic */
kTextEncodingISOLatin9 = 0x020F, /* ISO 8859-15, 8859-1 changed for EURO & CP1252 letters */
kTextEncodingISOLatin10 = 0x0210 /* ISO 8859-16, Romanian*/
};
/* MS-DOS & Windows encodings begin at 0x400*/
enum {
kTextEncodingDOSLatinUS = 0x0400, /* code page 437*/
kTextEncodingDOSGreek = 0x0405, /* code page 737 (formerly code page 437G)*/
kTextEncodingDOSBalticRim = 0x0406, /* code page 775*/
kTextEncodingDOSLatin1 = 0x0410, /* code page 850, "Multilingual"*/
kTextEncodingDOSGreek1 = 0x0411, /* code page 851*/
kTextEncodingDOSLatin2 = 0x0412, /* code page 852, Slavic*/
kTextEncodingDOSCyrillic = 0x0413, /* code page 855, IBM Cyrillic*/
kTextEncodingDOSTurkish = 0x0414, /* code page 857, IBM Turkish*/
kTextEncodingDOSPortuguese = 0x0415, /* code page 860*/
kTextEncodingDOSIcelandic = 0x0416, /* code page 861*/
kTextEncodingDOSHebrew = 0x0417, /* code page 862*/
kTextEncodingDOSCanadianFrench = 0x0418, /* code page 863*/
kTextEncodingDOSArabic = 0x0419, /* code page 864*/
kTextEncodingDOSNordic = 0x041A, /* code page 865*/
kTextEncodingDOSRussian = 0x041B, /* code page 866*/
kTextEncodingDOSGreek2 = 0x041C, /* code page 869, IBM Modern Greek*/
kTextEncodingDOSThai = 0x041D, /* code page 874, also for Windows*/
kTextEncodingDOSJapanese = 0x0420, /* code page 932, also for Windows; Shift-JIS with additions*/
kTextEncodingDOSChineseSimplif = 0x0421, /* code page 936, also for Windows; was EUC-CN, now GBK (EUC-CN extended)*/
kTextEncodingDOSKorean = 0x0422, /* code page 949, also for Windows; Unified Hangul Code (EUC-KR extended)*/
kTextEncodingDOSChineseTrad = 0x0423, /* code page 950, also for Windows; Big-5*/
kTextEncodingWindowsLatin1 = 0x0500, /* code page 1252*/
kTextEncodingWindowsANSI = 0x0500, /* code page 1252 (alternate name)*/
kTextEncodingWindowsLatin2 = 0x0501, /* code page 1250, Central Europe*/
kTextEncodingWindowsCyrillic = 0x0502, /* code page 1251, Slavic Cyrillic*/
kTextEncodingWindowsGreek = 0x0503, /* code page 1253*/
kTextEncodingWindowsLatin5 = 0x0504, /* code page 1254, Turkish*/
kTextEncodingWindowsHebrew = 0x0505, /* code page 1255*/
kTextEncodingWindowsArabic = 0x0506, /* code page 1256*/
kTextEncodingWindowsBalticRim = 0x0507, /* code page 1257*/
kTextEncodingWindowsVietnamese = 0x0508, /* code page 1258*/
kTextEncodingWindowsKoreanJohab = 0x0510 /* code page 1361, for Windows NT*/
};
/* Various national standards begin at 0x600*/
enum {
kTextEncodingUS_ASCII = 0x0600,
kTextEncodingANSEL = 0x0601, /* ANSEL (ANSI Z39.47) for library use*/
kTextEncodingJIS_X0201_76 = 0x0620, /* JIS Roman and 1-byte katakana (halfwidth)*/
kTextEncodingJIS_X0208_83 = 0x0621,
kTextEncodingJIS_X0208_90 = 0x0622,
kTextEncodingJIS_X0212_90 = 0x0623,
kTextEncodingJIS_C6226_78 = 0x0624,
kTextEncodingShiftJIS_X0213 = 0x0628, /* Shift-JIS format encoding of JIS X0213 planes 1 and 2*/
kTextEncodingJIS_X0213_MenKuTen = 0x0629, /* JIS X0213 in plane-row-column notation (3 bytes)*/
kTextEncodingGB_2312_80 = 0x0630,
kTextEncodingGBK_95 = 0x0631, /* annex to GB 13000-93; for Windows 95; EUC-CN extended*/
kTextEncodingGB_18030_2000 = 0x0632,
kTextEncodingKSC_5601_87 = 0x0640, /* same as KSC 5601-92 without Johab annex*/
kTextEncodingKSC_5601_92_Johab = 0x0641, /* KSC 5601-92 Johab annex*/
kTextEncodingCNS_11643_92_P1 = 0x0651, /* CNS 11643-1992 plane 1*/
kTextEncodingCNS_11643_92_P2 = 0x0652, /* CNS 11643-1992 plane 2*/
kTextEncodingCNS_11643_92_P3 = 0x0653 /* CNS 11643-1992 plane 3 (was plane 14 in 1986 version)*/
};
/* ISO 2022 collections begin at 0x800*/
enum {
kTextEncodingISO_2022_JP = 0x0820, /* RFC 1468*/
kTextEncodingISO_2022_JP_2 = 0x0821, /* RFC 1554*/
kTextEncodingISO_2022_JP_1 = 0x0822, /* RFC 2237*/
kTextEncodingISO_2022_JP_3 = 0x0823, /* JIS X0213*/
kTextEncodingISO_2022_CN = 0x0830, /* RFC 1922*/
kTextEncodingISO_2022_CN_EXT = 0x0831, /* RFC 1922*/
kTextEncodingISO_2022_KR = 0x0840 /* RFC 1557*/
};
/* EUC collections begin at 0x900*/
enum {
kTextEncodingEUC_JP = 0x0920, /* ISO 646, 1-byte katakana, JIS 208, JIS 212*/
kTextEncodingEUC_CN = 0x0930, /* ISO 646, GB 2312-80*/
kTextEncodingEUC_TW = 0x0931, /* ISO 646, CNS 11643-1992 Planes 1-16*/
kTextEncodingEUC_KR = 0x0940 /* RFC 1557: ISO 646, KS C 5601-1987*/
};
/* Misc standards begin at 0xA00*/
enum {
kTextEncodingShiftJIS = 0x0A01, /* plain Shift-JIS*/
kTextEncodingKOI8_R = 0x0A02, /* RFC 1489, Russian internet standard*/
kTextEncodingBig5 = 0x0A03, /* Big-5 (has variants)*/
kTextEncodingMacRomanLatin1 = 0x0A04, /* Mac OS Roman permuted to align with ISO Latin-1*/
kTextEncodingHZ_GB_2312 = 0x0A05, /* HZ (RFC 1842, for Chinese mail & news)*/
kTextEncodingBig5_HKSCS_1999 = 0x0A06, /* Big-5 with Hong Kong special char set supplement*/
kTextEncodingVISCII = 0x0A07, /* RFC 1456, Vietnamese*/
kTextEncodingKOI8_U = 0x0A08, /* RFC 2319, Ukrainian*/
kTextEncodingBig5_E = 0x0A09 /* Taiwan Big-5E standard*/
};
/* Other platform encodings*/
enum {
kTextEncodingNextStepLatin = 0x0B01, /* NextStep Latin encoding*/
kTextEncodingNextStepJapanese = 0x0B02 /* NextStep Japanese encoding (variant of EUC-JP)*/
};
/* EBCDIC & IBM host encodings begin at 0xC00*/
enum {
kTextEncodingEBCDIC_US = 0x0C01, /* basic EBCDIC-US*/
kTextEncodingEBCDIC_CP037 = 0x0C02 /* code page 037, extended EBCDIC (Latin-1 set) for US,Canada...*/
};
/* Special values*/
enum {
kTextEncodingMultiRun = 0x0FFF, /* Multi-encoding text with external run info*/
kTextEncodingUnknown = 0xFFFF /* Unknown or unspecified */
};
/* TextEncodingVariant type & values */
typedef UInt32 TextEncodingVariant;
/* Default TextEncodingVariant, for any TextEncodingBase*/
enum {
kTextEncodingDefaultVariant = 0
};
/* Variants of kTextEncodingMacRoman */
enum {
kMacRomanDefaultVariant = 0, /* meta value, maps to 1 or 2 depending on System */
kMacRomanCurrencySignVariant = 1, /* Mac OS version < 8.5, 0xDB is CURRENCY SIGN*/
kMacRomanEuroSignVariant = 2 /* Mac OS version >= 8.5, 0xDB is EURO SIGN */
};
/* Variants of kTextEncodingMacCyrillic (for TEC 1.5 and later) */
enum {
kMacCyrillicDefaultVariant = 0, /* meta value, maps to 1, 2, or 3 depending on System*/
kMacCyrillicCurrSignStdVariant = 1, /* Mac OS < 9.0 (RU,BG), 0xFF = CURRENCY SIGN, 0xA2/0xB6 = CENT / PARTIAL DIFF.*/
kMacCyrillicCurrSignUkrVariant = 2, /* Mac OS < 9.0 (UA,LangKit), 0xFF = CURRENCY SIGN, 0xA2/0xB6 = GHE WITH UPTURN*/
kMacCyrillicEuroSignVariant = 3 /* Mac OS >= 9.0, 0xFF is EURO SIGN, 0xA2/0xB6 = GHE WITH UPTURN*/
};
/* Variants of kTextEncodingMacIcelandic */
enum {
kMacIcelandicStdDefaultVariant = 0, /* meta value, maps to 2 or 4 depending on System */
kMacIcelandicTTDefaultVariant = 1, /* meta value, maps to 3 or 5 depending on System */
/* The following are for Mac OS version < 8.5, 0xDB is CURRENCY SIGN */
kMacIcelandicStdCurrSignVariant = 2, /* 0xBB/0xBC are fem./masc. ordinal indicators*/
kMacIcelandicTTCurrSignVariant = 3, /* 0xBB/0xBC are fi/fl ligatures*/
/* The following are for Mac OS version >= 8.5, 0xDB is EURO SIGN */
kMacIcelandicStdEuroSignVariant = 4, /* 0xBB/0xBC are fem./masc. ordinal indicators*/
kMacIcelandicTTEuroSignVariant = 5 /* 0xBB/0xBC are fi/fl ligatures*/
};
/* Variants of kTextEncodingMacCroatian */
enum {
kMacCroatianDefaultVariant = 0, /* meta value, maps to 1 or 2 depending on System */
kMacCroatianCurrencySignVariant = 1, /* Mac OS version < 8.5, 0xDB is CURRENCY SIGN */
kMacCroatianEuroSignVariant = 2 /* Mac OS version >= 8.5, 0xDB is EURO SIGN */
};
/* Variants of kTextEncodingMacRomanian */
enum {
kMacRomanianDefaultVariant = 0, /* meta value, maps to 1 or 2 depending on System */
kMacRomanianCurrencySignVariant = 1, /* Mac OS version < 8.5, 0xDB is CURRENCY SIGN */
kMacRomanianEuroSignVariant = 2 /* Mac OS version >= 8.5, 0xDB is EURO SIGN */
};
/* Variants of kTextEncodingMacJapanese*/
enum {
kMacJapaneseStandardVariant = 0,
kMacJapaneseStdNoVerticalsVariant = 1,
kMacJapaneseBasicVariant = 2,
kMacJapanesePostScriptScrnVariant = 3,
kMacJapanesePostScriptPrintVariant = 4,
kMacJapaneseVertAtKuPlusTenVariant = 5
};
/* Variants of kTextEncodingMacArabic*/
enum {
kMacArabicStandardVariant = 0, /* 0xC0 is 8-spoke asterisk, 0x2A & 0xAA are asterisk (e.g. Cairo)*/
kMacArabicTrueTypeVariant = 1, /* 0xC0 is asterisk, 0x2A & 0xAA are multiply signs (e.g. Baghdad)*/
kMacArabicThuluthVariant = 2, /* 0xC0 is Arabic five-point star, 0x2A & 0xAA are multiply signs*/
kMacArabicAlBayanVariant = 3 /* 8-spoke asterisk, multiply sign, Koranic ligatures & parens*/
};
/* Variants of kTextEncodingMacFarsi*/
enum {
kMacFarsiStandardVariant = 0, /* 0xC0 is 8-spoke asterisk, 0x2A & 0xAA are asterisk (e.g. Tehran)*/
kMacFarsiTrueTypeVariant = 1 /* asterisk, multiply signs, Koranic ligatures, geometric shapes*/
};
/* Variants of kTextEncodingMacHebrew*/
enum {
kMacHebrewStandardVariant = 0,
kMacHebrewFigureSpaceVariant = 1
};
/* Variants of kTextEncodingMacGreek*/
enum {
kMacGreekDefaultVariant = 0, /* meta value, maps to 1 or 2 depending on System*/
kMacGreekNoEuroSignVariant = 1, /* Mac OS version < 9.2.2, 0x9C is SOFT HYPHEN, 0xFF is undefined*/
kMacGreekEuroSignVariant = 2 /* Mac OS version >= 9.2.2, 0x9C is EURO SIGN, 0xFF is SOFT HYPHEN*/
};
/* Variants of kTextEncodingMacVT100 */
enum {
kMacVT100DefaultVariant = 0, /* meta value, maps to 1 or 2 depending on System */
kMacVT100CurrencySignVariant = 1, /* Mac OS version < 8.5, 0xDB is CURRENCY SIGN */
kMacVT100EuroSignVariant = 2 /* Mac OS version >= 8.5, 0xDB is EURO SIGN */
};
/* Variants of Unicode & ISO 10646 encodings*/
enum {
kUnicodeNoSubset = 0,
kUnicodeNormalizationFormD = 5, /* canonical decomposition (NFD); excludes composed chars*/
kUnicodeNormalizationFormC = 3, /* canonical composition (NFC); uses the composed chars as of Unicode 3.1*/
kUnicodeHFSPlusDecompVariant = 8, /* decomposition for HFS+; doesn't decompose in 2000-2FFF, F900-FAFF, 2F800-2FAFF*/
kUnicodeHFSPlusCompVariant = 9 /* composition based on HFS+ decomposition*/
};
/* Variants of kTextEncodingISOLatin1*/
enum {
kISOLatin1StandardVariant = 0,
kISOLatin1MusicCDVariant = 1
};
/*
Variants of kTextEncodingISOLatinArabic, kTextEncodingISOLatinHebrew.
Per RFC 1556 and ECMA TR/53, there are three ways of handling bidirectional text
in the ISO character sets 8859-6 (Arabic) and 8859-8 (Hebrew).
1. Implicit or Logical order is "a presentation method in which the direction is
determined by an algorithm according to the type of characters and their position
relative to the adjacent characters and according to their primary direction." This
is the method normally used for Unicode and for the Mac OS and Windows Arabic and
Hebrew encodings.
2. Visual order assumes the text is already ordered such that it can be displayed
in a left-to-right display direction with no further directional processing. This
is equivalent to treating all characters as having strong left-right directionality.
This is the default assumed for internet Hebrew text encoded in ISO 8859-8, unless
the charset label suffix specifically indicates implicit (-i) or explicit (-e)
ordering.
3. Explicit order is "a presentation method in which the direction is explicitly
defined by using control sequences which are interleaved within the text and are
used for direction determination."
*/
enum {
kISOLatinArabicImplicitOrderVariant = 0,
kISOLatinArabicVisualOrderVariant = 1,
kISOLatinArabicExplicitOrderVariant = 2
};
enum {
kISOLatinHebrewImplicitOrderVariant = 0,
kISOLatinHebrewVisualOrderVariant = 1,
kISOLatinHebrewExplicitOrderVariant = 2
};
/* Variants of kTextEncodingWindowsLatin1*/
enum {
kWindowsLatin1StandardVariant = 0,
kWindowsLatin1PalmVariant = 1 /* PalmSource variant of cp1252*/
};
/* Variants of kTextEncodingDOSJapanese*/
enum {
kDOSJapaneseStandardVariant = 0,
kDOSJapanesePalmVariant = 1 /* PalmSource variant of cp932*/
};
/*
Variants of EUC_CN
The DOSVariant is like kTextEncodingDOSChineseSimplif, but with the
basic EUC_CN part mapped as per kTextEncodingEUC_CN.
*/
enum {
kEUC_CN_BasicVariant = 0,
kEUC_CN_DOSVariant = 1
};
/*
Variants of EUC_KR
The DOSVariant is like kTextEncodingDOSKorean, but with the
basic EUC_KR part mapped as per kTextEncodingEUC_KR.
*/
enum {
kEUC_KR_BasicVariant = 0,
kEUC_KR_DOSVariant = 1
};
/*
Variants of ShiftJIS
The DOSVariant is like kTextEncodingDOSJapanese, but with the
basic ShiftJIS part mapped as per kTextEncodingShiftJIS.
*/
enum {
kShiftJIS_BasicVariant = 0,
kShiftJIS_DOSVariant = 1,
kShiftJIS_MusicCDVariant = 2 /* MusicShiftJIS, per RIS-506 (RIAJ)*/
};
/*
Variants of Big-5 encoding
The DOSVariant is like kTextEncodingDOSChineseTrad, but with the
basic Big5 part mapped as per kTextEncodingBig5.
*/
enum {
kBig5_BasicVariant = 0,
kBig5_StandardVariant = 1, /* 0xC6A1-0xC7FC: kana, Cyrillic, enclosed numerics*/
kBig5_ETenVariant = 2, /* adds kana, Cyrillic, radicals, etc with hi bytes C6-C8,F9*/
kBig5_DOSVariant = 3
};
/* Variants of MacRomanLatin1 */
enum {
kMacRomanLatin1DefaultVariant = 0, /* meta value, maps to others depending on System*/
kMacRomanLatin1StandardVariant = 2, /* permuted MacRoman, EuroSignVariant*/
kMacRomanLatin1TurkishVariant = 6, /* permuted MacTurkish*/
kMacRomanLatin1CroatianVariant = 8, /* permuted MacCroatian, EuroSignVariant*/
kMacRomanLatin1IcelandicVariant = 11, /* permuted MacIcelandic, StdEuroSignVariant*/
kMacRomanLatin1RomanianVariant = 14 /* permuted MacRomanian, EuroSignVariant*/
};
/* Unicode variants not yet supported (and not fully defined)*/
enum {
kUnicodeNoCompatibilityVariant = 1,
kUnicodeNoCorporateVariant = 4
};
/* The following are older names for backward compatibility*/
enum {
kMacRomanStandardVariant = 0,
kMacIcelandicStandardVariant = 0,
kMacIcelandicTrueTypeVariant = 1,
kJapaneseStandardVariant = 0,
kJapaneseStdNoVerticalsVariant = 1,
kJapaneseBasicVariant = 2,
kJapanesePostScriptScrnVariant = 3,
kJapanesePostScriptPrintVariant = 4,
kJapaneseVertAtKuPlusTenVariant = 5,
kTextEncodingShiftJIS_X0213_00 = 0x0628, /* Shift-JIS format encoding of JIS X0213 planes 1 and 2*/
/* kJapaneseStdNoOneByteKanaVariant = 6, // replaced by kJapaneseNoOneByteKanaOption*/
/* kJapaneseBasicNoOneByteKanaVariant = 7, // replaced by kJapaneseNoOneByteKanaOption */
kHebrewStandardVariant = 0,
kHebrewFigureSpaceVariant = 1, /* Old Unicode variants. Variant 2 (kUnicodeCanonicalDecompVariant, kUnicodeMaxDecomposedVariant) is ambiguous and means*/
/* different things in different contexts. When normalizing (using ConvertFromUnicodeToText to convert from arbitrary*/
/* Unicode to a normalized form), Unicode variant 2 means the same thing as kUnicodeNormalizationFormD (i.e. NFD).*/
/* However, when converting between Unicode and traditional Mac OS encodings, Unicode variant 2 means the same thing as*/
/* kUnicodeHFSPlusDecompVariant (i.e. the special HFS decomposition which excludes some character ranges from normalization).*/
/* For clarity, please use the less ambiguous constants: kUnicodeNormalizationFormD = 5, kUnicodeHFSPlusDecompVariant = 8.*/
/* */
kUnicodeCanonicalDecompVariant = 2, /* use kUnicodeNormalizationFormD or kUnicodeHFSPlusDecompVariant*/
kUnicodeMaxDecomposedVariant = 2, /* use kUnicodeNormalizationFormD or kUnicodeHFSPlusDecompVariant*/
kUnicodeCanonicalCompVariant = 3, /* replaced by kUnicodeNormalizationFormC*/
kUnicodeNoComposedVariant = 3 /* this really meant NoComposing; replaced by kUnicodeNormalizationFormC*/
};
/* TextEncodingFormat type & values */
typedef UInt32 TextEncodingFormat;
enum {
/* Default TextEncodingFormat for any TextEncodingBase*/
kTextEncodingDefaultFormat = 0, /* Formats for Unicode & ISO 10646*/
kUnicodeUTF16Format = 0, /* UTF16 form (16-bit units), native or external byte order (see below)*/
kUnicodeUTF7Format = 1, /* UTF7 form*/
kUnicodeUTF8Format = 2, /* UTF8 form*/
kUnicodeUTF32Format = 3, /* UTF32 form (32-bit units), native or external byte order (see below)*/
kUnicodeUTF16BEFormat = 4, /* UTF16 form, explicit big-endian byte order, no BOM*/
kUnicodeUTF16LEFormat = 5, /* UTF16 form, explicit little-endian byte order, no BOM*/
kUnicodeUTF32BEFormat = 6, /* UTF32 form, explicit big-endian byte order, no BOM*/
kUnicodeUTF32LEFormat = 7, /* UTF32 form, explicit little-endian byte order, no BOM*/
kUnicodeSCSUFormat = 8, /* Std. Compression Scheme for Unicode, Unicode Tech Std. #6*/
/* Note for kUnicodeUTF16Format and kUnicodeUTF32Format:*/
/* - An array of UTF16Char (UniChar) or UTF32Char is normally understood to use "internal" or*/
/* platform-native byte ordering for kUnicodeUTF16Format and kUnicodeUTF32Format; the array MAY*/
/* begin with byte-order mark (BOM), but the BOM should match the internal ordering.*/
/* - If an array of bytes (such as char *) that can be in various encodings is specified to be*/
/* in Unicode with kUnicodeUTF16Format or kUnicodeUTF32Format (not explicitly BE or LE), then it*/
/* is assumed to use "external" byte ordering, which means: If there is a BOM at the beginning*/
/* of text, the BOM specifies the byte ordering, otherwise big-endian is assumed.*/
/* Synonyms for some Unicode formats*/
kUnicode16BitFormat = 0,
kUnicode32BitFormat = 3
};
/* TextEncoding type */
typedef UInt32 TextEncoding;
/* name part selector for GetTextEncodingName*/
typedef UInt32 TextEncodingNameSelector;
enum {
kTextEncodingFullName = 0,
kTextEncodingBaseName = 1,
kTextEncodingVariantName = 2,
kTextEncodingFormatName = 3
};
/* Types used in conversion */
struct TextEncodingRun {
ByteOffset offset;
TextEncoding textEncoding;
};
typedef struct TextEncodingRun TextEncodingRun;
typedef TextEncodingRun * TextEncodingRunPtr;
typedef const TextEncodingRun * ConstTextEncodingRunPtr;
struct ScriptCodeRun {
ByteOffset offset;
ScriptCode script;
};
typedef struct ScriptCodeRun ScriptCodeRun;
typedef ScriptCodeRun * ScriptCodeRunPtr;
typedef const ScriptCodeRun * ConstScriptCodeRunPtr;
typedef UInt8 * TextPtr;
typedef const UInt8 * ConstTextPtr;
/* Basic types for Unicode characters and strings:*/
typedef UniChar * UniCharArrayPtr;
typedef const UniChar * ConstUniCharArrayPtr;
/*
UniCharArrayHandle is a handle type to correspond to UniCharArrayPtr,
i.e. a handle to an array of UniChars (UInt16s).
*/
typedef UniCharArrayPtr * UniCharArrayHandle;
/*
UniCharArrayOffset is used to indicate an edge offset in an array
of UniChars (UInt16s).
*/
typedef unsigned long UniCharArrayOffset;
/* enums for TextEncoding Conversion routines*/
enum {
kTextScriptDontCare = -128,
kTextLanguageDontCare = -128,
kTextRegionDontCare = -128
};
/* struct for TECGetInfo*/
struct TECInfo {
UInt16 format; /* format code for this struct*/
UInt16 tecVersion; /* TEC version in BCD, e.g. 0x0121 for 1.2.1*/
UInt32 tecTextConverterFeatures; /* bitmask indicating TEC features/fixes*/
UInt32 tecUnicodeConverterFeatures; /* bitmask indicating UnicodeConverter features/fixes*/
UInt32 tecTextCommonFeatures; /* bitmask indicating TextCommon features/fixes*/
Str31 tecTextEncodingsFolderName; /* localized name of Text Encodings folder (pascal string)*/
Str31 tecExtensionFileName; /* localized name of TEC extension (pascal string)*/
UInt16 tecLowestTEFileVersion; /* Lowest version (BCD) of all files in Text Encodings folder*/
UInt16 tecHighestTEFileVersion; /* Highest version (BCD) of all files in Text Encodings folder*/
};
typedef struct TECInfo TECInfo;
typedef TECInfo * TECInfoPtr;
typedef TECInfoPtr * TECInfoHandle;
/* Value for TECInfo format code*/
enum {
kTECInfoCurrentFormat = 2 /* any future formats will just add fields at the end*/
};
/*
Defined feature/fix bits for tecUnicodeConverterFeatures field
Bit: Meaning if set:
---- ---------------
kTECKeepInfoFixBit Unicode Converter no longer ignores other control flags if
kUnicodeKeepInfoBit is set. Bug fix in TEC Manager 1.2.1.
kTECFallbackTextLengthFixBit Unicode Converter honors the *srcConvLen and *destConvLen
returned by caller-supplied fallback handler for any status it
returns except for kTECUnmappableElementErr (previously it only
honored these values if noErr was returned). Bug fix in TEC
Manager 1.2.1.
kTECTextRunBitClearFixBit ConvertFromUnicodeToTextRun & ConvertFromUnicodeToScriptCodeRun
function correctly if the kUnicodeTextRunBit is set (previously
their determination of best target encoding was incorrect). Bug
fix in TEC Manager 1.3.
kTECTextToUnicodeScanFixBit ConvertFromTextToUnicode uses an improved scanner and maintains
some resulting state information, which it uses for mapping.
This has several effects:
- Improved mapping of 0x30-0x39 digits in Mac OS Arabic, fewer
direction overrides when mapping Mac OS Arabic & Hebrew, and
improved mapping of certain characters in Indic encodings.
- Malformed input produces kTextMalformedInputErr.
- ConvertFromTextToUnicode accepts and uses the control flags
kUnicodeKeepInfoMask and kUnicodeStringUnterminatedMask.
Bug fix and enhancement in TEC Manager 1.3.
kTECAddForceASCIIChangesBit Define new control flag bits kUnicodeForceASCIIRangeBit and
kUnicodeNoHalfwidthCharsBit for use with
ConvertFromTextToUnicode, ConvertFromUnicodeToText, etc.
Enhancement in TEC Manager 1.4.
kTECPreferredEncodingFixBit CreateUnicodeToTextRunInfo and related functions fix a problem
that occurred when a preferred encoding was specified that did
not match the System script; the preferred script was not
actually placed first in the ordered list of encodings to use.
Bug fix in TEC Manager 1.4.
kTECAddTextRunHeuristicsBit Define new control flag bit kUnicodeTextRunHeuristicsBit for
use with ConvertFromUnicodeToTextRun.
kTECAddFallbackInterruptBit Define new option kUnicodeFallbackInterruptSafeMask for use
with SetFallbackUnicodeToText. If a client fallback handler is
installed without specifying this bit, ConvertFromUnicodeToText
will HLock the tables it uses (in case the fallback handler
moves memory); otherwise, it won't.
*/
enum {
kTECKeepInfoFixBit = 0,
kTECFallbackTextLengthFixBit = 1,
kTECTextRunBitClearFixBit = 2,
kTECTextToUnicodeScanFixBit = 3,
kTECAddForceASCIIChangesBit = 4,
kTECPreferredEncodingFixBit = 5,
kTECAddTextRunHeuristicsBit = 6,
kTECAddFallbackInterruptBit = 7
};
enum {
kTECKeepInfoFixMask = 1L << kTECKeepInfoFixBit,
kTECFallbackTextLengthFixMask = 1L << kTECFallbackTextLengthFixBit,
kTECTextRunBitClearFixMask = 1L << kTECTextRunBitClearFixBit,
kTECTextToUnicodeScanFixMask = 1L << kTECTextToUnicodeScanFixBit,
kTECAddForceASCIIChangesMask = 1L << kTECAddForceASCIIChangesBit,
kTECPreferredEncodingFixMask = 1L << kTECPreferredEncodingFixBit,
kTECAddTextRunHeuristicsMask = 1L << kTECAddTextRunHeuristicsBit,
kTECAddFallbackInterruptMask = 1L << kTECAddFallbackInterruptBit
};
/*
-------------------------------------------------------------------------------------------------
CONSTANTS for common and special Unicode code values
-------------------------------------------------------------------------------------------------
*/
enum {
kUnicodeByteOrderMark = 0xFEFF,
kUnicodeObjectReplacement = 0xFFFC, /* placeholder for non-text object*/
kUnicodeReplacementChar = 0xFFFD, /* Unicode replacement for unconvertable input char*/
kUnicodeSwappedByteOrderMark = 0xFFFE, /* not a Unicode char; byte-swapped version of FEFF*/
kUnicodeNotAChar = 0xFFFF /* not a Unicode char; may be used as a terminator*/
};
/*
-------------------------------------------------------------------------------------------------
CONSTANTS & DATA STRUCTURES for Unicode Properties
-------------------------------------------------------------------------------------------------
*/
typedef SInt32 UCCharPropertyType;
enum {
kUCCharPropTypeGenlCategory = 1, /* requests enumeration value*/
kUCCharPropTypeCombiningClass = 2, /* requests numeric value 0..255*/
kUCCharPropTypeBidiCategory = 3, /* requests enumeration value*/
kUCCharPropTypeDecimalDigitValue = 4 /* requests numeric value 0..9 for decimal digit chars (get err for others)*/
};
typedef UInt32 UCCharPropertyValue;
/* General Category enumeration values (requested by kUCCharPropTypeGenlCategory)*/
enum {
/* Normative categories:*/
kUCGenlCatOtherNotAssigned = 0, /* Cn Other, Not Assigned*/
kUCGenlCatOtherControl = 1, /* Cc Other, Control*/
kUCGenlCatOtherFormat = 2, /* Cf Other, Format*/
kUCGenlCatOtherSurrogate = 3, /* Cs Other, Surrogate*/
kUCGenlCatOtherPrivateUse = 4, /* Co Other, Private Use*/
kUCGenlCatMarkNonSpacing = 5, /* Mn Mark, Non-Spacing*/
kUCGenlCatMarkSpacingCombining = 6, /* Mc Mark, Spacing Combining*/
kUCGenlCatMarkEnclosing = 7, /* Me Mark, Enclosing*/
kUCGenlCatNumberDecimalDigit = 8, /* Nd Number, Decimal Digit*/
kUCGenlCatNumberLetter = 9, /* Nl Number, Letter*/
kUCGenlCatNumberOther = 10, /* No Number, Other*/
kUCGenlCatSeparatorSpace = 11, /* Zs Separator, Space*/
kUCGenlCatSeparatorLine = 12, /* Zl Separator, Line*/
kUCGenlCatSeparatorParagraph = 13, /* Zp Separator, Paragraph*/
kUCGenlCatLetterUppercase = 14, /* Lu Letter, Uppercase*/
kUCGenlCatLetterLowercase = 15, /* Ll Letter, Lowercase*/
kUCGenlCatLetterTitlecase = 16, /* Lt Letter, Titlecase*/
/* Informative categories:*/
kUCGenlCatLetterModifier = 17, /* Lm Letter, Modifier*/
kUCGenlCatLetterOther = 18, /* Lo Letter, Other*/
kUCGenlCatPunctConnector = 20, /* Pc Punctuation, Connector*/
kUCGenlCatPunctDash = 21, /* Pd Punctuation, Dash*/
kUCGenlCatPunctOpen = 22, /* Ps Punctuation, Open*/
kUCGenlCatPunctClose = 23, /* Pe Punctuation, Close*/
kUCGenlCatPunctInitialQuote = 24, /* Pi Punctuation, Initial quote*/
kUCGenlCatPunctFinalQuote = 25, /* Pf Punctuation, Final quote*/
kUCGenlCatPunctOther = 26, /* Po Punctuation, Other*/
kUCGenlCatSymbolMath = 28, /* Sm Symbol, Math*/
kUCGenlCatSymbolCurrency = 29, /* Sc Symbol, Currency*/
kUCGenlCatSymbolModifier = 30, /* Sk Symbol, Modifier*/
kUCGenlCatSymbolOther = 31 /* So Symbol, Other*/
};
/* Bidirectional Category enumeration values (requested by kUCCharPropTypeBidiCategory)*/
enum {
kUCBidiCatNotApplicable = 0, /* for now use this for unassigned*/
/* Strong types:*/
kUCBidiCatLeftRight = 1, /* L Left-to-Right*/
kUCBidiCatRightLeft = 2, /* R Right-to-Left*/
/* Weak types:*/
kUCBidiCatEuroNumber = 3, /* EN European Number*/
kUCBidiCatEuroNumberSeparator = 4, /* ES European Number Separator*/
kUCBidiCatEuroNumberTerminator = 5, /* ET European Number Terminator*/
kUCBidiCatArabicNumber = 6, /* AN Arabic Number*/
kUCBidiCatCommonNumberSeparator = 7, /* CS Common Number Separator*/
/* Separators:*/
kUCBidiCatBlockSeparator = 8, /* B Paragraph Separator (was Block Separator)*/
kUCBidiCatSegmentSeparator = 9, /* S Segment Separator*/
/* Neutrals:*/
kUCBidiCatWhitespace = 10, /* WS Whitespace*/
kUCBidiCatOtherNeutral = 11, /* ON Other Neutrals (unassigned codes could use this)*/
/* New categories for Unicode 3.0*/
kUCBidiCatRightLeftArabic = 12, /* AL Right-to-Left Arabic (was Arabic Letter)*/
kUCBidiCatLeftRightEmbedding = 13, /* LRE Left-to-Right Embedding*/
kUCBidiCatRightLeftEmbedding = 14, /* RLE Right-to-Left Embedding*/
kUCBidiCatLeftRightOverride = 15, /* LRO Left-to-Right Override*/
kUCBidiCatRightLeftOverride = 16, /* RLO Right-to-Left Override*/
kUCBidiCatPopDirectionalFormat = 17, /* PDF Pop Directional Format*/
kUCBidiCatNonSpacingMark = 18, /* NSM Non-Spacing Mark*/
kUCBidiCatBoundaryNeutral = 19 /* BN Boundary Neutral*/
};
/*
-------------------------------------------------------------------------------------------------
Prototypes for TextEncoding functions
-------------------------------------------------------------------------------------------------
*/
/*
* CreateTextEncoding()
*
* Availability:
* Mac OS X: in version 10.0 and later in CoreServices.framework
* CarbonLib: in CarbonLib 1.0 and later
* Non-Carbon CFM: in TextCommon 1.1 and later
*/
extern TextEncoding
CreateTextEncoding(
TextEncodingBase encodingBase,
TextEncodingVariant encodingVariant,
TextEncodingFormat encodingFormat) AVAILABLE_MAC_OS_X_VERSION_10_0_AND_LATER;
/*
* GetTextEncodingBase()
*
* Availability:
* Mac OS X: in version 10.0 and later in CoreServices.framework
* CarbonLib: in CarbonLib 1.0 and later
* Non-Carbon CFM: in TextCommon 1.1 and later
*/
extern TextEncodingBase
GetTextEncodingBase(TextEncoding encoding) AVAILABLE_MAC_OS_X_VERSION_10_0_AND_LATER;
/*
* GetTextEncodingVariant()
*
* Availability:
* Mac OS X: in version 10.0 and later in CoreServices.framework
* CarbonLib: in CarbonLib 1.0 and later
* Non-Carbon CFM: in TextCommon 1.1 and later
*/
extern TextEncodingVariant
GetTextEncodingVariant(TextEncoding encoding) AVAILABLE_MAC_OS_X_VERSION_10_0_AND_LATER;
/*
* GetTextEncodingFormat()
*
* Availability:
* Mac OS X: in version 10.0 and later in CoreServices.framework
* CarbonLib: in CarbonLib 1.0 and later
* Non-Carbon CFM: in TextCommon 1.1 and later
*/
extern TextEncodingFormat
GetTextEncodingFormat(TextEncoding encoding) AVAILABLE_MAC_OS_X_VERSION_10_0_AND_LATER;
/*
* ResolveDefaultTextEncoding()
*
* Availability:
* Mac OS X: in version 10.0 and later in CoreServices.framework
* CarbonLib: in CarbonLib 1.0 and later
* Non-Carbon CFM: in TextCommon 1.1 and later
*/
extern TextEncoding
ResolveDefaultTextEncoding(TextEncoding encoding) AVAILABLE_MAC_OS_X_VERSION_10_0_AND_LATER;
/*
* GetTextEncodingName()
*
* Availability:
* Mac OS X: in version 10.0 and later in CoreServices.framework
* CarbonLib: in CarbonLib 1.0 and later
* Non-Carbon CFM: in TextCommon 1.1 and later
*/
extern OSStatus
GetTextEncodingName(
TextEncoding iEncoding,
TextEncodingNameSelector iNamePartSelector,
RegionCode iPreferredRegion,
TextEncoding iPreferredEncoding,
ByteCount iOutputBufLen,
ByteCount * oNameLength,
RegionCode * oActualRegion, /* can be NULL */
TextEncoding * oActualEncoding, /* can be NULL */
TextPtr oEncodingName) AVAILABLE_MAC_OS_X_VERSION_10_0_AND_LATER;
/*
* TECGetInfo()
*
* Availability:
* Mac OS X: in version 10.0 and later in CoreServices.framework
* CarbonLib: in CarbonLib 1.0 and later
* Non-Carbon CFM: in TextCommon 1.2.1 and later
*/
extern OSStatus
TECGetInfo(TECInfoHandle * tecInfo) AVAILABLE_MAC_OS_X_VERSION_10_0_AND_LATER;
/*
* UpgradeScriptInfoToTextEncoding()
*
* Availability:
* Mac OS X: in version 10.0 and later in CoreServices.framework
* CarbonLib: in CarbonLib 1.0 and later
* Non-Carbon CFM: in TextCommon 1.1 and later
*/
extern OSStatus
UpgradeScriptInfoToTextEncoding(
ScriptCode iTextScriptID,
LangCode iTextLanguageID,
RegionCode iRegionID,
ConstStr255Param iTextFontname,
TextEncoding * oEncoding) AVAILABLE_MAC_OS_X_VERSION_10_0_AND_LATER;
/*
* RevertTextEncodingToScriptInfo()
*
* Availability:
* Mac OS X: in version 10.0 and later in CoreServices.framework
* CarbonLib: in CarbonLib 1.0 and later
* Non-Carbon CFM: in TextCommon 1.1 and later
*/
extern OSStatus
RevertTextEncodingToScriptInfo(
TextEncoding iEncoding,
ScriptCode * oTextScriptID,
LangCode * oTextLanguageID, /* can be NULL */
Str255 oTextFontname) /* can be NULL */ AVAILABLE_MAC_OS_X_VERSION_10_0_AND_LATER;
/*
* GetTextEncodingFromScriptInfo()
*
* Summary:
* Converts any combination of a Mac OS script code, a language
* code, and a region code to a text encoding.
*
* Discussion:
* This function is almost identical to
* UpgradeScriptInfoToTextEncoding except it doesn't take a font
* name and it is available in CoreServices.
*
* Parameters:
*
* iTextScriptID:
* A valid Script Manager script code. The Mac OS Script Manager
* defines constants for script codes using this format: smXxx. To
* designate the system script, specify the meta-value of
* smSystemScript. To indicate that you do not want to provide a
* script code for this parameter, specify the constant
* kTextScriptDontCare.
*
* iTextLanguageID:
* A valid Script Manager language code. The Mac OS Script Manager
* defines constants for language codes using this format:
* langXxx. To indicate that you do not want to provide a language
* code for this parameter, specify the constant
* kTextLanguageDontCare.
*
* iTextRegionID:
* A valid Script Manager region code. The Mac OS Script Manager
* defines constants for region codes using this format: verXxx.
* To indicate that you do not want to provide a region code for
* this parameter, specify the constant kTextRegionDontCare.
*
* oEncoding:
* A pointer to a value of type TextEncoding. On return, this
* value holds the text encoding specification that the function
* created from the other values you provided.
*
* Availability:
* Mac OS X: in version 10.2 and later in CoreServices.framework
* CarbonLib: not available in CarbonLib 1.x, is available on Mac OS X version 10.2 and later
* Non-Carbon CFM: not available
*/
extern OSStatus
GetTextEncodingFromScriptInfo(
ScriptCode iTextScriptID,
LangCode iTextLanguageID,
RegionCode iTextRegionID,
TextEncoding * oEncoding) AVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER;
/*
* GetScriptInfoFromTextEncoding()
*
* Summary:
* Converts the given Mac OS text encoding specification to the
* corresponding script code and, if possible, language code.
*
* Discussion:
* This function is almost identical to
* RevertTextEncodingToScriptInfo except it doesn't return a font
* name and it is available in CoreServices.
*
* Parameters:
*
* iEncoding: