| OLD | NEW |
| (Empty) |
| 1 /***************************************************************************/ | |
| 2 /* */ | |
| 3 /* ftmac.h */ | |
| 4 /* */ | |
| 5 /* Additional Mac-specific API. */ | |
| 6 /* */ | |
| 7 /* Copyright 1996-2001, 2004, 2006, 2007, 2013 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 | |
| 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 /* <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 | |
| 268 FT_END_HEADER | |
| 269 | |
| 270 | |
| 271 #endif /* __FTMAC_H__ */ | |
| 272 | |
| 273 | |
| 274 /* END */ | |
| OLD | NEW |