1 /***************************************************************************/ |
|
2 /* */ |
|
3 /* ftcid.h */ |
|
4 /* */ |
|
5 /* FreeType API for accessing CID font information (specification). */ |
|
6 /* */ |
|
7 /* Copyright 2007, 2009 by Dereg Clegg, Michael Toftdal. */ |
|
8 /* */ |
|
9 /* This file is part of the FreeType project, and may only be used, */ |
|
10 /* modified, and distributed under the terms of the FreeType project */ |
|
11 /* license, LICENSE.TXT. By continuing to use, modify, or distribute */ |
|
12 /* this file you indicate that you have read the license and */ |
|
13 /* understand and accept it fully. */ |
|
14 /* */ |
|
15 /***************************************************************************/ |
|
16 |
|
17 |
|
18 #ifndef __FTCID_H__ |
|
19 #define __FTCID_H__ |
|
20 |
|
21 #include <ft2build.h> |
|
22 #include FT_FREETYPE_H |
|
23 |
|
24 #ifdef FREETYPE_H |
|
25 #error "freetype.h of FreeType 1 has been loaded!" |
|
26 #error "Please fix the directory search order for header files" |
|
27 #error "so that freetype.h of FreeType 2 is found first." |
|
28 #endif |
|
29 |
|
30 |
|
31 FT_BEGIN_HEADER |
|
32 |
|
33 |
|
34 /*************************************************************************/ |
|
35 /* */ |
|
36 /* <Section> */ |
|
37 /* cid_fonts */ |
|
38 /* */ |
|
39 /* <Title> */ |
|
40 /* CID Fonts */ |
|
41 /* */ |
|
42 /* <Abstract> */ |
|
43 /* CID-keyed font specific API. */ |
|
44 /* */ |
|
45 /* <Description> */ |
|
46 /* This section contains the declaration of CID-keyed font specific */ |
|
47 /* functions. */ |
|
48 /* */ |
|
49 /*************************************************************************/ |
|
50 |
|
51 |
|
52 /********************************************************************** |
|
53 * |
|
54 * @function: |
|
55 * FT_Get_CID_Registry_Ordering_Supplement |
|
56 * |
|
57 * @description: |
|
58 * Retrieve the Registry/Ordering/Supplement triple (also known as the |
|
59 * "R/O/S") from a CID-keyed font. |
|
60 * |
|
61 * @input: |
|
62 * face :: |
|
63 * A handle to the input face. |
|
64 * |
|
65 * @output: |
|
66 * registry :: |
|
67 * The registry, as a C~string, owned by the face. |
|
68 * |
|
69 * ordering :: |
|
70 * The ordering, as a C~string, owned by the face. |
|
71 * |
|
72 * supplement :: |
|
73 * The supplement. |
|
74 * |
|
75 * @return: |
|
76 * FreeType error code. 0~means success. |
|
77 * |
|
78 * @note: |
|
79 * This function only works with CID faces, returning an error |
|
80 * otherwise. |
|
81 * |
|
82 * @since: |
|
83 * 2.3.6 |
|
84 */ |
|
85 FT_EXPORT( FT_Error ) |
|
86 FT_Get_CID_Registry_Ordering_Supplement( FT_Face face, |
|
87 const char* *registry, |
|
88 const char* *ordering, |
|
89 FT_Int *supplement); |
|
90 |
|
91 |
|
92 /********************************************************************** |
|
93 * |
|
94 * @function: |
|
95 * FT_Get_CID_Is_Internally_CID_Keyed |
|
96 * |
|
97 * @description: |
|
98 * Retrieve the type of the input face, CID keyed or not. In |
|
99 * constrast to the @FT_IS_CID_KEYED macro this function returns |
|
100 * successfully also for CID-keyed fonts in an SNFT wrapper. |
|
101 * |
|
102 * @input: |
|
103 * face :: |
|
104 * A handle to the input face. |
|
105 * |
|
106 * @output: |
|
107 * is_cid :: |
|
108 * The type of the face as an @FT_Bool. |
|
109 * |
|
110 * @return: |
|
111 * FreeType error code. 0~means success. |
|
112 * |
|
113 * @note: |
|
114 * This function only works with CID faces and OpenType fonts, |
|
115 * returning an error otherwise. |
|
116 * |
|
117 * @since: |
|
118 * 2.3.9 |
|
119 */ |
|
120 FT_EXPORT( FT_Error ) |
|
121 FT_Get_CID_Is_Internally_CID_Keyed( FT_Face face, |
|
122 FT_Bool *is_cid ); |
|
123 |
|
124 |
|
125 /********************************************************************** |
|
126 * |
|
127 * @function: |
|
128 * FT_Get_CID_From_Glyph_Index |
|
129 * |
|
130 * @description: |
|
131 * Retrieve the CID of the input glyph index. |
|
132 * |
|
133 * @input: |
|
134 * face :: |
|
135 * A handle to the input face. |
|
136 * |
|
137 * glyph_index :: |
|
138 * The input glyph index. |
|
139 * |
|
140 * @output: |
|
141 * cid :: |
|
142 * The CID as an @FT_UInt. |
|
143 * |
|
144 * @return: |
|
145 * FreeType error code. 0~means success. |
|
146 * |
|
147 * @note: |
|
148 * This function only works with CID faces and OpenType fonts, |
|
149 * returning an error otherwise. |
|
150 * |
|
151 * @since: |
|
152 * 2.3.9 |
|
153 */ |
|
154 FT_EXPORT( FT_Error ) |
|
155 FT_Get_CID_From_Glyph_Index( FT_Face face, |
|
156 FT_UInt glyph_index, |
|
157 FT_UInt *cid ); |
|
158 |
|
159 /* */ |
|
160 |
|
161 FT_END_HEADER |
|
162 |
|
163 #endif /* __FTCID_H__ */ |
|
164 |
|
165 |
|
166 /* END */ |
|