Go to most recent revision | Details | Last modification | View Log | RSS feed
Rev | Author | Line No. | Line |
---|---|---|---|
4759 | right-hear | 1 | /***************************************************************************/ |
2 | /* */ |
||
3 | /* ftmac.h */ |
||
4 | /* */ |
||
5 | /* Additional Mac-specific API. */ |
||
6 | /* */ |
||
7 | /* Copyright 1996-2001, 2004, 2006, 2007 by */ |
||
8 | /* Just van Rossum, David Turner, Robert Wilhelm, and Werner Lemberg. */ |
||
9 | /* */ |
||
10 | /* This file is part of the FreeType project, and may only be used, */ |
||
11 | /* modified, and distributed under the terms of the FreeType project */ |
||
12 | /* license, LICENSE.TXT. By continuing to use, modify, or distribute */ |
||
13 | /* this file you indicate that you have read the license and */ |
||
14 | /* understand and accept it fully. */ |
||
15 | /* */ |
||
16 | /***************************************************************************/ |
||
17 | |||
18 | |||
19 | /***************************************************************************/ |
||
20 | /* */ |
||
21 | /* NOTE: Include this file after |
||
22 | /* Mac-specific headers (because this header uses Mac types such as */ |
||
23 | /* Handle, FSSpec, FSRef, etc.) */ |
||
24 | /* */ |
||
25 | /***************************************************************************/ |
||
26 | |||
27 | |||
28 | #ifndef __FTMAC_H__ |
||
29 | #define __FTMAC_H__ |
||
30 | |||
31 | |||
32 | #include |
||
33 | |||
34 | |||
35 | FT_BEGIN_HEADER |
||
36 | |||
37 | |||
38 | /* gcc-3.4.1 and later can warn about functions tagged as deprecated */ |
||
39 | #ifndef FT_DEPRECATED_ATTRIBUTE |
||
40 | #if defined(__GNUC__) && \ |
||
41 | ((__GNUC__ >= 4) || ((__GNUC__ == 3) && (__GNUC_MINOR__ >= 1))) |
||
42 | #define FT_DEPRECATED_ATTRIBUTE __attribute__((deprecated)) |
||
43 | #else |
||
44 | #define FT_DEPRECATED_ATTRIBUTE |
||
45 | #endif |
||
46 | #endif |
||
47 | |||
48 | |||
49 | /*************************************************************************/ |
||
50 | /* */ |
||
51 | /* |
||
52 | /* mac_specific */ |
||
53 | /* */ |
||
54 | /* |
||
55 | /* Mac Specific Interface */ |
||
56 | /* */ |
||
57 | /* |
||
58 | /* Only available on the Macintosh. */ |
||
59 | /* */ |
||
60 | /* |
||
61 | /* The following definitions are only available if FreeType is */ |
||
62 | /* compiled on a Macintosh. */ |
||
63 | /* */ |
||
64 | /*************************************************************************/ |
||
65 | |||
66 | |||
67 | /*************************************************************************/ |
||
68 | /* */ |
||
69 | /* |
||
70 | /* FT_New_Face_From_FOND */ |
||
71 | /* */ |
||
72 | /* |
||
73 | /* Create a new face object from a FOND resource. */ |
||
74 | /* */ |
||
75 | /* |
||
76 | /* library :: A handle to the library resource. */ |
||
77 | /* */ |
||
78 | /* */ |
||
79 | /* fond :: A FOND resource. */ |
||
80 | /* */ |
||
81 | /* face_index :: Only supported for the -1 `sanity check' special */ |
||
82 | /* case. */ |
||
83 | /* */ |
||
84 | /* |
||
85 | /* aface :: A handle to a new face object. */ |
||
86 | /* */ |
||
87 | /* |
||
88 | /* FreeType error code. 0~means success. */ |
||
89 | /* */ |
||
90 | /* |
||
91 | /* This function can be used to create @FT_Face objects from fonts */ |
||
92 | /* that are installed in the system as follows. */ |
||
93 | /* */ |
||
94 | /* { */ |
||
95 | /* fond = GetResource( 'FOND', fontName ); */ |
||
96 | /* error = FT_New_Face_From_FOND( library, fond, 0, &face ); */ |
||
97 | /* } */ |
||
98 | /* */ |
||
99 | FT_EXPORT( FT_Error ) |
||
100 | FT_New_Face_From_FOND( FT_Library library, |
||
101 | Handle fond, |
||
102 | FT_Long face_index, |
||
103 | FT_Face *aface ) |
||
104 | FT_DEPRECATED_ATTRIBUTE; |
||
105 | |||
106 | |||
107 | /*************************************************************************/ |
||
108 | /* */ |
||
109 | /* |
||
110 | /* FT_GetFile_From_Mac_Name */ |
||
111 | /* */ |
||
112 | /* |
||
113 | /* Return an FSSpec for the disk file containing the named font. */ |
||
114 | /* */ |
||
115 | /* */ |
||
116 | /* fontName :: Mac OS name of the font (e.g., Times New Roman */ |
||
117 | /* Bold). */ |
||
118 | /* */ |
||
119 | /* |
||
120 | /* pathSpec :: FSSpec to the file. For passing to */ |
||
121 | /* @FT_New_Face_From_FSSpec. */ |
||
122 | /* */ |
||
123 | /* face_index :: Index of the face. For passing to */ |
||
124 | /* @FT_New_Face_From_FSSpec. */ |
||
125 | /* */ |
||
126 | /* |
||
127 | /* FreeType error code. 0~means success. */ |
||
128 | /* */ |
||
129 | FT_EXPORT( FT_Error ) |
||
130 | FT_GetFile_From_Mac_Name( const char* fontName, |
||
131 | FSSpec* pathSpec, |
||
132 | FT_Long* face_index ) |
||
133 | FT_DEPRECATED_ATTRIBUTE; |
||
134 | |||
135 | |||
136 | /*************************************************************************/ |
||
137 | /* */ |
||
138 | /* |
||
139 | /* FT_GetFile_From_Mac_ATS_Name */ |
||
140 | /* */ |
||
141 | /* |
||
142 | /* Return an FSSpec for the disk file containing the named font. */ |
||
143 | /* */ |
||
144 | /* */ |
||
145 | /* fontName :: Mac OS name of the font in ATS framework. */ |
||
146 | /* */ |
||
147 | /* |
||
148 | /* pathSpec :: FSSpec to the file. For passing to */ |
||
149 | /* @FT_New_Face_From_FSSpec. */ |
||
150 | /* */ |
||
151 | /* face_index :: Index of the face. For passing to */ |
||
152 | /* @FT_New_Face_From_FSSpec. */ |
||
153 | /* */ |
||
154 | /* |
||
155 | /* FreeType error code. 0~means success. */ |
||
156 | /* */ |
||
157 | FT_EXPORT( FT_Error ) |
||
158 | FT_GetFile_From_Mac_ATS_Name( const char* fontName, |
||
159 | FSSpec* pathSpec, |
||
160 | FT_Long* face_index ) |
||
161 | FT_DEPRECATED_ATTRIBUTE; |
||
162 | |||
163 | |||
164 | /*************************************************************************/ |
||
165 | /* */ |
||
166 | /* |
||
167 | /* FT_GetFilePath_From_Mac_ATS_Name */ |
||
168 | /* */ |
||
169 | /* |
||
170 | /* Return a pathname of the disk file and face index for given font */ |
||
171 | /* name which is handled by ATS framework. */ |
||
172 | /* */ |
||
173 | /* */ |
||
174 | /* fontName :: Mac OS name of the font in ATS framework. */ |
||
175 | /* */ |
||
176 | /* |
||
177 | /* path :: Buffer to store pathname of the file. For passing */ |
||
178 | /* to @FT_New_Face. The client must allocate this */ |
||
179 | /* buffer before calling this function. */ |
||
180 | /* */ |
||
181 | /* maxPathSize :: Lengths of the buffer `path' that client allocated. */ |
||
182 | /* */ |
||
183 | /* face_index :: Index of the face. For passing to @FT_New_Face. */ |
||
184 | /* */ |
||
185 | /* |
||
186 | /* FreeType error code. 0~means success. */ |
||
187 | /* */ |
||
188 | FT_EXPORT( FT_Error ) |
||
189 | FT_GetFilePath_From_Mac_ATS_Name( const char* fontName, |
||
190 | UInt8* path, |
||
191 | UInt32 maxPathSize, |
||
192 | FT_Long* face_index ) |
||
193 | FT_DEPRECATED_ATTRIBUTE; |
||
194 | |||
195 | |||
196 | /*************************************************************************/ |
||
197 | /* */ |
||
198 | /* |
||
199 | /* FT_New_Face_From_FSSpec */ |
||
200 | /* */ |
||
201 | /* |
||
202 | /* Create a new face object from a given resource and typeface index */ |
||
203 | /* using an FSSpec to the font file. */ |
||
204 | /* */ |
||
205 | /* |
||
206 | /* library :: A handle to the library resource. */ |
||
207 | /* */ |
||
208 | /* */ |
||
209 | /* spec :: FSSpec to the font file. */ |
||
210 | /* */ |
||
211 | /* face_index :: The index of the face within the resource. The */ |
||
212 | /* first face has index~0. */ |
||
213 | /* |
||
214 | /* aface :: A handle to a new face object. */ |
||
215 | /* */ |
||
216 | /* |
||
217 | /* FreeType error code. 0~means success. */ |
||
218 | /* */ |
||
219 | /* |
||
220 | /* @FT_New_Face_From_FSSpec is identical to @FT_New_Face except */ |
||
221 | /* it accepts an FSSpec instead of a path. */ |
||
222 | /* */ |
||
223 | FT_EXPORT( FT_Error ) |
||
224 | FT_New_Face_From_FSSpec( FT_Library library, |
||
225 | const FSSpec *spec, |
||
226 | FT_Long face_index, |
||
227 | FT_Face *aface ) |
||
228 | FT_DEPRECATED_ATTRIBUTE; |
||
229 | |||
230 | |||
231 | /*************************************************************************/ |
||
232 | /* */ |
||
233 | /* |
||
234 | /* FT_New_Face_From_FSRef */ |
||
235 | /* */ |
||
236 | /* |
||
237 | /* Create a new face object from a given resource and typeface index */ |
||
238 | /* using an FSRef to the font file. */ |
||
239 | /* */ |
||
240 | /* |
||
241 | /* library :: A handle to the library resource. */ |
||
242 | /* */ |
||
243 | /* */ |
||
244 | /* spec :: FSRef to the font file. */ |
||
245 | /* */ |
||
246 | /* face_index :: The index of the face within the resource. The */ |
||
247 | /* first face has index~0. */ |
||
248 | /* |
||
249 | /* aface :: A handle to a new face object. */ |
||
250 | /* */ |
||
251 | /* |
||
252 | /* FreeType error code. 0~means success. */ |
||
253 | /* */ |
||
254 | /* |
||
255 | /* @FT_New_Face_From_FSRef is identical to @FT_New_Face except */ |
||
256 | /* it accepts an FSRef instead of a path. */ |
||
257 | /* */ |
||
258 | FT_EXPORT( FT_Error ) |
||
259 | FT_New_Face_From_FSRef( FT_Library library, |
||
260 | const FSRef *ref, |
||
261 | FT_Long face_index, |
||
262 | FT_Face *aface ) |
||
263 | FT_DEPRECATED_ATTRIBUTE; |
||
264 | |||
265 | /* */ |
||
266 | |||
267 | |||
268 | FT_END_HEADER |
||
269 | |||
270 | |||
271 | #endif /* __FTMAC_H__ */ |
||
272 | |||
273 | |||
274 | /* END */ |