Clutter Engine 0.0.1
Loading...
Searching...
No Matches
ftmac.h
1/***************************************************************************/
2/* */
3/* ftmac.h */
4/* */
5/* Additional Mac-specific API. */
6/* */
7/* Copyright 1996-2016 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 FT_FREETYPE_H and after any */
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 <ft2build.h>
33
34
35FT_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 /* <Section> */
52 /* mac_specific */
53 /* */
54 /* <Title> */
55 /* Mac Specific Interface */
56 /* */
57 /* <Abstract> */
58 /* Only available on the Macintosh. */
59 /* */
60 /* <Description> */
61 /* The following definitions are only available if FreeType is */
62 /* compiled on a Macintosh. */
63 /* */
64 /*************************************************************************/
65
66
67 /*************************************************************************/
68 /* */
69 /* <Function> */
70 /* FT_New_Face_From_FOND */
71 /* */
72 /* <Description> */
73 /* Create a new face object from a FOND resource. */
74 /* */
75 /* <InOut> */
76 /* library :: A handle to the library resource. */
77 /* */
78 /* <Input> */
79 /* fond :: A FOND resource. */
80 /* */
81 /* face_index :: Only supported for the -1 `sanity check' special */
82 /* case. */
83 /* */
84 /* <Output> */
85 /* aface :: A handle to a new face object. */
86 /* */
87 /* <Return> */
88 /* FreeType error code. 0~means success. */
89 /* */
90 /* <Notes> */
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 /* <Function> */
110 /* FT_GetFile_From_Mac_Name */
111 /* */
112 /* <Description> */
113 /* Return an FSSpec for the disk file containing the named font. */
114 /* */
115 /* <Input> */
116 /* fontName :: Mac OS name of the font (e.g., Times New Roman */
117 /* Bold). */
118 /* */
119 /* <Output> */
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 /* <Return> */
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 /* <Function> */
139 /* FT_GetFile_From_Mac_ATS_Name */
140 /* */
141 /* <Description> */
142 /* Return an FSSpec for the disk file containing the named font. */
143 /* */
144 /* <Input> */
145 /* fontName :: Mac OS name of the font in ATS framework. */
146 /* */
147 /* <Output> */
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 /* <Return> */
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 /* <Function> */
167 /* FT_GetFilePath_From_Mac_ATS_Name */
168 /* */
169 /* <Description> */
170 /* Return a pathname of the disk file and face index for given font */
171 /* name that is handled by ATS framework. */
172 /* */
173 /* <Input> */
174 /* fontName :: Mac OS name of the font in ATS framework. */
175 /* */
176 /* <Output> */
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 /* <Return> */
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 /* <Function> */
199 /* FT_New_Face_From_FSSpec */
200 /* */
201 /* <Description> */
202 /* Create a new face object from a given resource and typeface index */
203 /* using an FSSpec to the font file. */
204 /* */
205 /* <InOut> */
206 /* library :: A handle to the library resource. */
207 /* */
208 /* <Input> */
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 /* <Output> */
214 /* aface :: A handle to a new face object. */
215 /* */
216 /* <Return> */
217 /* FreeType error code. 0~means success. */
218 /* */
219 /* <Note> */
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 /* <Function> */
234 /* FT_New_Face_From_FSRef */
235 /* */
236 /* <Description> */
237 /* Create a new face object from a given resource and typeface index */
238 /* using an FSRef to the font file. */
239 /* */
240 /* <InOut> */
241 /* library :: A handle to the library resource. */
242 /* */
243 /* <Input> */
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 /* <Output> */
249 /* aface :: A handle to a new face object. */
250 /* */
251 /* <Return> */
252 /* FreeType error code. 0~means success. */
253 /* */
254 /* <Note> */
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
268FT_END_HEADER
269
270
271#endif /* FTMAC_H_ */
272
273
274/* END */
FT_FaceRec_
Definition freetype.h:1034
Generated by doxygen 1.12.0