David Turner | d2b1f35 | 1999-12-16 23:11:37 +0000 | [diff] [blame] | 1 | /***************************************************************************/ |
| 2 | /* */ |
| 3 | /* ftobjs.c */ |
| 4 | /* */ |
Werner Lemberg | a3b6c6c | 2000-05-31 06:55:12 +0000 | [diff] [blame] | 5 | /* The FreeType private base classes (base). */ |
David Turner | d2b1f35 | 1999-12-16 23:11:37 +0000 | [diff] [blame] | 6 | /* */ |
Werner Lemberg | 7880dd6 | 2000-01-10 17:19:45 +0000 | [diff] [blame] | 7 | /* Copyright 1996-2000 by */ |
Werner Lemberg | 4e6dd85 | 2000-06-05 05:26:15 +0000 | [diff] [blame] | 8 | /* David Turner, Robert Wilhelm, and Werner Lemberg. */ |
David Turner | d2b1f35 | 1999-12-16 23:11:37 +0000 | [diff] [blame] | 9 | /* */ |
Werner Lemberg | 4e6dd85 | 2000-06-05 05:26:15 +0000 | [diff] [blame] | 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 */ |
David Turner | d2b1f35 | 1999-12-16 23:11:37 +0000 | [diff] [blame] | 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 | |
Werner Lemberg | a3b6c6c | 2000-05-31 06:55:12 +0000 | [diff] [blame] | 18 | |
David Turner | efce08d | 2000-05-11 18:23:52 +0000 | [diff] [blame] | 19 | #include <freetype/internal/ftobjs.h> |
| 20 | #include <freetype/internal/ftlist.h> |
| 21 | #include <freetype/internal/ftdebug.h> |
| 22 | #include <freetype/internal/ftstream.h> |
David Turner | d2b1f35 | 1999-12-16 23:11:37 +0000 | [diff] [blame] | 23 | |
David Turner | efce08d | 2000-05-11 18:23:52 +0000 | [diff] [blame] | 24 | #include <freetype/tttables.h> |
Werner Lemberg | 7880dd6 | 2000-01-10 17:19:45 +0000 | [diff] [blame] | 25 | |
Werner Lemberg | a929ba9 | 2000-06-25 06:47:11 +0000 | [diff] [blame] | 26 | #include <string.h> /* for strcmp() */ |
| 27 | |
Werner Lemberg | a3b6c6c | 2000-05-31 06:55:12 +0000 | [diff] [blame] | 28 | |
David Turner | d2b1f35 | 1999-12-16 23:11:37 +0000 | [diff] [blame] | 29 | /*************************************************************************/ |
| 30 | /*************************************************************************/ |
| 31 | /*************************************************************************/ |
| 32 | /**** ****/ |
| 33 | /**** ****/ |
| 34 | /**** M E M O R Y ****/ |
| 35 | /**** ****/ |
| 36 | /**** ****/ |
| 37 | /*************************************************************************/ |
| 38 | /*************************************************************************/ |
| 39 | /*************************************************************************/ |
| 40 | |
| 41 | /*************************************************************************/ |
| 42 | /* */ |
| 43 | /* The macro FT_COMPONENT is used in trace mode. It is an implicit */ |
Werner Lemberg | 7880dd6 | 2000-01-10 17:19:45 +0000 | [diff] [blame] | 44 | /* parameter of the FT_TRACE() and FT_ERROR() macros, used to print/log */ |
David Turner | d2b1f35 | 1999-12-16 23:11:37 +0000 | [diff] [blame] | 45 | /* messages during execution. */ |
| 46 | /* */ |
| 47 | #undef FT_COMPONENT |
| 48 | #define FT_COMPONENT trace_memory |
| 49 | |
| 50 | |
| 51 | /*************************************************************************/ |
| 52 | /* */ |
| 53 | /* <Function> */ |
| 54 | /* FT_Alloc */ |
| 55 | /* */ |
| 56 | /* <Description> */ |
| 57 | /* Allocates a new block of memory. The returned area is always */ |
Werner Lemberg | 547a252 | 2000-02-16 08:23:58 +0000 | [diff] [blame] | 58 | /* zero-filled; this is a strong convention in many FreeType parts. */ |
David Turner | d2b1f35 | 1999-12-16 23:11:37 +0000 | [diff] [blame] | 59 | /* */ |
| 60 | /* <Input> */ |
Werner Lemberg | a3b6c6c | 2000-05-31 06:55:12 +0000 | [diff] [blame] | 61 | /* memory :: A handle to a given `memory object' which handles */ |
| 62 | /* allocation. */ |
David Turner | d2b1f35 | 1999-12-16 23:11:37 +0000 | [diff] [blame] | 63 | /* */ |
| 64 | /* size :: The size in bytes of the block to allocate. */ |
| 65 | /* */ |
| 66 | /* <Output> */ |
| 67 | /* P :: A pointer to the fresh new block. It should be set to */ |
| 68 | /* NULL if `size' is 0, or in case of error. */ |
| 69 | /* */ |
| 70 | /* <Return> */ |
| 71 | /* FreeType error code. 0 means success. */ |
| 72 | /* */ |
Werner Lemberg | a3b6c6c | 2000-05-31 06:55:12 +0000 | [diff] [blame] | 73 | BASE_FUNC( FT_Error ) FT_Alloc( FT_Memory memory, |
| 74 | FT_Long size, |
| 75 | void** P ) |
David Turner | d2b1f35 | 1999-12-16 23:11:37 +0000 | [diff] [blame] | 76 | { |
| 77 | FT_Assert( P != 0 ); |
| 78 | |
Werner Lemberg | 7880dd6 | 2000-01-10 17:19:45 +0000 | [diff] [blame] | 79 | if ( size > 0 ) |
David Turner | d2b1f35 | 1999-12-16 23:11:37 +0000 | [diff] [blame] | 80 | { |
| 81 | *P = memory->alloc( memory, size ); |
Werner Lemberg | 7880dd6 | 2000-01-10 17:19:45 +0000 | [diff] [blame] | 82 | if ( !*P ) |
David Turner | d2b1f35 | 1999-12-16 23:11:37 +0000 | [diff] [blame] | 83 | { |
Werner Lemberg | a3b6c6c | 2000-05-31 06:55:12 +0000 | [diff] [blame] | 84 | FT_ERROR(( "FT_Alloc:" )); |
Werner Lemberg | 7880dd6 | 2000-01-10 17:19:45 +0000 | [diff] [blame] | 85 | FT_ERROR(( " Out of memory? (%ld requested)\n", |
David Turner | d2b1f35 | 1999-12-16 23:11:37 +0000 | [diff] [blame] | 86 | size )); |
| 87 | |
| 88 | return FT_Err_Out_Of_Memory; |
| 89 | } |
| 90 | MEM_Set( *P, 0, size ); |
| 91 | } |
| 92 | else |
| 93 | *P = NULL; |
| 94 | |
Werner Lemberg | 5617726 | 2000-06-03 21:59:44 +0000 | [diff] [blame] | 95 | FT_TRACE7(( "FT_Alloc:" )); |
| 96 | FT_TRACE7(( " size = %ld, block = 0x%08p, ref = 0x%08p\n", |
David Turner | 51179f0 | 2000-05-18 16:18:05 +0000 | [diff] [blame] | 97 | size, *P, P )); |
David Turner | d2b1f35 | 1999-12-16 23:11:37 +0000 | [diff] [blame] | 98 | |
| 99 | return FT_Err_Ok; |
| 100 | } |
| 101 | |
| 102 | |
| 103 | /*************************************************************************/ |
| 104 | /* */ |
| 105 | /* <Function> */ |
| 106 | /* FT_Realloc */ |
| 107 | /* */ |
| 108 | /* <Description> */ |
| 109 | /* Reallocates a block of memory pointed to by `*P' to `Size' bytes */ |
| 110 | /* from the heap, possibly changing `*P'. */ |
| 111 | /* */ |
| 112 | /* <Input> */ |
Werner Lemberg | a3b6c6c | 2000-05-31 06:55:12 +0000 | [diff] [blame] | 113 | /* memory :: A handle to a given `memory object' which handles */ |
| 114 | /* reallocation. */ |
David Turner | d2b1f35 | 1999-12-16 23:11:37 +0000 | [diff] [blame] | 115 | /* */ |
Werner Lemberg | 547a252 | 2000-02-16 08:23:58 +0000 | [diff] [blame] | 116 | /* current :: The current block size in bytes. */ |
Werner Lemberg | a3b6c6c | 2000-05-31 06:55:12 +0000 | [diff] [blame] | 117 | /* */ |
Werner Lemberg | 547a252 | 2000-02-16 08:23:58 +0000 | [diff] [blame] | 118 | /* size :: The new block size in bytes. */ |
David Turner | d2b1f35 | 1999-12-16 23:11:37 +0000 | [diff] [blame] | 119 | /* */ |
| 120 | /* <InOut> */ |
Werner Lemberg | 547a252 | 2000-02-16 08:23:58 +0000 | [diff] [blame] | 121 | /* P :: A pointer to the fresh new block. It should be set to */ |
| 122 | /* NULL if `size' is 0, or in case of error. */ |
David Turner | d2b1f35 | 1999-12-16 23:11:37 +0000 | [diff] [blame] | 123 | /* */ |
| 124 | /* <Return> */ |
| 125 | /* FreeType error code. 0 means success. */ |
| 126 | /* */ |
| 127 | /* <Note> */ |
Werner Lemberg | 547a252 | 2000-02-16 08:23:58 +0000 | [diff] [blame] | 128 | /* All callers of FT_Realloc() _must_ provide the current block size */ |
David Turner | d2b1f35 | 1999-12-16 23:11:37 +0000 | [diff] [blame] | 129 | /* as well as the new one. */ |
| 130 | /* */ |
Werner Lemberg | a3b6c6c | 2000-05-31 06:55:12 +0000 | [diff] [blame] | 131 | BASE_FUNC( FT_Error ) FT_Realloc( FT_Memory memory, |
| 132 | FT_Long current, |
| 133 | FT_Long size, |
| 134 | void** P ) |
David Turner | d2b1f35 | 1999-12-16 23:11:37 +0000 | [diff] [blame] | 135 | { |
| 136 | void* Q; |
| 137 | |
Werner Lemberg | 7880dd6 | 2000-01-10 17:19:45 +0000 | [diff] [blame] | 138 | |
David Turner | d2b1f35 | 1999-12-16 23:11:37 +0000 | [diff] [blame] | 139 | FT_Assert( P != 0 ); |
| 140 | |
| 141 | /* if the original pointer is NULL, call FT_Alloc() */ |
| 142 | if ( !*P ) |
| 143 | return FT_Alloc( memory, size, P ); |
| 144 | |
| 145 | /* if the new block if zero-sized, clear the current one */ |
| 146 | if ( size <= 0 ) |
| 147 | { |
| 148 | FT_Free( memory, P ); |
| 149 | return FT_Err_Ok; |
| 150 | } |
| 151 | |
| 152 | Q = memory->realloc( memory, current, size, *P ); |
Werner Lemberg | 7880dd6 | 2000-01-10 17:19:45 +0000 | [diff] [blame] | 153 | if ( !Q ) |
| 154 | goto Fail; |
David Turner | d2b1f35 | 1999-12-16 23:11:37 +0000 | [diff] [blame] | 155 | |
| 156 | *P = Q; |
| 157 | return FT_Err_Ok; |
| 158 | |
| 159 | Fail: |
Werner Lemberg | a3b6c6c | 2000-05-31 06:55:12 +0000 | [diff] [blame] | 160 | FT_ERROR(( "FT_Realloc:" )); |
Werner Lemberg | 7880dd6 | 2000-01-10 17:19:45 +0000 | [diff] [blame] | 161 | FT_ERROR(( " Failed (current %ld, requested %ld)\n", |
David Turner | d2b1f35 | 1999-12-16 23:11:37 +0000 | [diff] [blame] | 162 | current, size )); |
| 163 | return FT_Err_Out_Of_Memory; |
| 164 | } |
| 165 | |
| 166 | |
| 167 | /*************************************************************************/ |
| 168 | /* */ |
| 169 | /* <Function> */ |
| 170 | /* FT_Free */ |
| 171 | /* */ |
| 172 | /* <Description> */ |
| 173 | /* Releases a given block of memory allocated through FT_Alloc(). */ |
| 174 | /* */ |
| 175 | /* <Input> */ |
Werner Lemberg | a3b6c6c | 2000-05-31 06:55:12 +0000 | [diff] [blame] | 176 | /* memory :: A handle to a given `memory object' which handles */ |
| 177 | /* memory deallocation */ |
David Turner | d2b1f35 | 1999-12-16 23:11:37 +0000 | [diff] [blame] | 178 | /* */ |
| 179 | /* P :: This is the _address_ of a _pointer_ which points to the */ |
| 180 | /* allocated block. It is always set to NULL on exit. */ |
| 181 | /* */ |
| 182 | /* <Return> */ |
| 183 | /* FreeType error code. 0 means success. */ |
| 184 | /* */ |
| 185 | /* <Note> */ |
| 186 | /* If P or *P are NULL, this function should return successfully. */ |
| 187 | /* This is a strong convention within all of FreeType and its */ |
| 188 | /* drivers. */ |
| 189 | /* */ |
Werner Lemberg | a3b6c6c | 2000-05-31 06:55:12 +0000 | [diff] [blame] | 190 | BASE_FUNC( void ) FT_Free( FT_Memory memory, |
| 191 | void** P ) |
David Turner | d2b1f35 | 1999-12-16 23:11:37 +0000 | [diff] [blame] | 192 | { |
Werner Lemberg | 5617726 | 2000-06-03 21:59:44 +0000 | [diff] [blame] | 193 | FT_TRACE7(( "FT_Free:" )); |
| 194 | FT_TRACE7(( " Freeing block 0x%08p, ref 0x%08p\n", |
Werner Lemberg | a3b6c6c | 2000-05-31 06:55:12 +0000 | [diff] [blame] | 195 | P, P ? *P : (void*)0 )); |
David Turner | d2b1f35 | 1999-12-16 23:11:37 +0000 | [diff] [blame] | 196 | |
Werner Lemberg | e35cac6 | 2000-06-11 03:46:57 +0000 | [diff] [blame] | 197 | if ( P && *P ) |
David Turner | d2b1f35 | 1999-12-16 23:11:37 +0000 | [diff] [blame] | 198 | { |
| 199 | memory->free( memory, *P ); |
| 200 | *P = 0; |
| 201 | } |
| 202 | } |
| 203 | |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 204 | /*************************************************************************/ |
| 205 | /*************************************************************************/ |
| 206 | /*************************************************************************/ |
| 207 | /**** ****/ |
| 208 | /**** ****/ |
| 209 | /**** S T R E A M ****/ |
| 210 | /**** ****/ |
| 211 | /**** ****/ |
| 212 | /*************************************************************************/ |
| 213 | /*************************************************************************/ |
| 214 | /*************************************************************************/ |
| 215 | |
Werner Lemberg | 7880dd6 | 2000-01-10 17:19:45 +0000 | [diff] [blame] | 216 | |
Werner Lemberg | 547a252 | 2000-02-16 08:23:58 +0000 | [diff] [blame] | 217 | /*************************************************************************/ |
| 218 | /* */ |
| 219 | /* <Function> */ |
| 220 | /* ft_new_input_stream */ |
| 221 | /* */ |
| 222 | /* <Description> */ |
| 223 | /* Creates a new input stream object from an FT_Open_Args structure. */ |
| 224 | /* */ |
Werner Lemberg | 2fbf7e4 | 2000-06-02 00:01:14 +0000 | [diff] [blame] | 225 | /* <Note> */ |
| 226 | /* The function expects a valid `astream' parameter. */ |
David Turner | 7663f22 | 2000-02-13 13:37:38 +0000 | [diff] [blame] | 227 | static |
Werner Lemberg | 547a252 | 2000-02-16 08:23:58 +0000 | [diff] [blame] | 228 | FT_Error ft_new_input_stream( FT_Library library, |
| 229 | FT_Open_Args* args, |
Werner Lemberg | a3b6c6c | 2000-05-31 06:55:12 +0000 | [diff] [blame] | 230 | FT_Stream* astream ) |
David Turner | 7663f22 | 2000-02-13 13:37:38 +0000 | [diff] [blame] | 231 | { |
Werner Lemberg | 547a252 | 2000-02-16 08:23:58 +0000 | [diff] [blame] | 232 | FT_Error error; |
| 233 | FT_Memory memory; |
| 234 | FT_Stream stream; |
| 235 | |
Werner Lemberg | a3b6c6c | 2000-05-31 06:55:12 +0000 | [diff] [blame] | 236 | |
Werner Lemberg | 2fbf7e4 | 2000-06-02 00:01:14 +0000 | [diff] [blame] | 237 | if ( !library ) |
| 238 | return FT_Err_Invalid_Library_Handle; |
| 239 | |
| 240 | if ( !args ) |
| 241 | return FT_Err_Invalid_Argument; |
| 242 | |
David Turner | 37379e2 | 2000-03-28 11:22:31 +0000 | [diff] [blame] | 243 | *astream = 0; |
| 244 | memory = library->memory; |
Werner Lemberg | 547a252 | 2000-02-16 08:23:58 +0000 | [diff] [blame] | 245 | if ( ALLOC( stream, sizeof ( *stream ) ) ) |
David Turner | 37379e2 | 2000-03-28 11:22:31 +0000 | [diff] [blame] | 246 | goto Exit; |
David Turner | e49ab25 | 2000-05-16 23:44:38 +0000 | [diff] [blame] | 247 | |
David Turner | 7663f22 | 2000-02-13 13:37:38 +0000 | [diff] [blame] | 248 | stream->memory = memory; |
David Turner | e49ab25 | 2000-05-16 23:44:38 +0000 | [diff] [blame] | 249 | |
David Turner | 4f2c554 | 2000-05-12 10:19:41 +0000 | [diff] [blame] | 250 | /* now, look at the stream flags */ |
| 251 | if ( args->flags & ft_open_memory ) |
Just van Rossum | d35aea7 | 2000-03-02 01:07:50 +0000 | [diff] [blame] | 252 | { |
David Turner | 4f2c554 | 2000-05-12 10:19:41 +0000 | [diff] [blame] | 253 | error = 0; |
| 254 | FT_New_Memory_Stream( library, |
| 255 | args->memory_base, |
| 256 | args->memory_size, |
| 257 | stream ); |
| 258 | } |
Werner Lemberg | a3b6c6c | 2000-05-31 06:55:12 +0000 | [diff] [blame] | 259 | else if ( args->flags & ft_open_pathname ) |
David Turner | 4f2c554 | 2000-05-12 10:19:41 +0000 | [diff] [blame] | 260 | { |
| 261 | error = FT_New_Stream( args->pathname, stream ); |
| 262 | stream->pathname.pointer = args->pathname; |
| 263 | } |
Werner Lemberg | a3b6c6c | 2000-05-31 06:55:12 +0000 | [diff] [blame] | 264 | else if ( args->flags & ft_open_stream && args->stream ) |
David Turner | 4f2c554 | 2000-05-12 10:19:41 +0000 | [diff] [blame] | 265 | { |
| 266 | *stream = *(args->stream); |
| 267 | stream->memory = memory; |
| 268 | } |
| 269 | else |
David Turner | 4f2c554 | 2000-05-12 10:19:41 +0000 | [diff] [blame] | 270 | error = FT_Err_Invalid_Argument; |
David Turner | e49ab25 | 2000-05-16 23:44:38 +0000 | [diff] [blame] | 271 | |
Werner Lemberg | 547a252 | 2000-02-16 08:23:58 +0000 | [diff] [blame] | 272 | if ( error ) |
| 273 | FREE( stream ); |
David Turner | e49ab25 | 2000-05-16 23:44:38 +0000 | [diff] [blame] | 274 | |
David Turner | 7663f22 | 2000-02-13 13:37:38 +0000 | [diff] [blame] | 275 | *astream = stream; |
Werner Lemberg | a3b6c6c | 2000-05-31 06:55:12 +0000 | [diff] [blame] | 276 | |
David Turner | 37379e2 | 2000-03-28 11:22:31 +0000 | [diff] [blame] | 277 | Exit: |
David Turner | 7663f22 | 2000-02-13 13:37:38 +0000 | [diff] [blame] | 278 | return error; |
| 279 | } |
| 280 | |
| 281 | |
Werner Lemberg | 547a252 | 2000-02-16 08:23:58 +0000 | [diff] [blame] | 282 | /*************************************************************************/ |
| 283 | /* */ |
| 284 | /* <Function> */ |
David Turner | a8bcdf8 | 2000-05-02 10:51:41 +0000 | [diff] [blame] | 285 | /* FT_Done_Stream */ |
Werner Lemberg | 547a252 | 2000-02-16 08:23:58 +0000 | [diff] [blame] | 286 | /* */ |
| 287 | /* <Description> */ |
| 288 | /* Closes and destroys a stream object. */ |
| 289 | /* */ |
Werner Lemberg | a3b6c6c | 2000-05-31 06:55:12 +0000 | [diff] [blame] | 290 | /* <Input> */ |
| 291 | /* stream :: The stream to be closed and destroyed. */ |
| 292 | /* */ |
| 293 | FT_EXPORT_FUNC( void ) FT_Done_Stream( FT_Stream stream ) |
David Turner | a8bcdf8 | 2000-05-02 10:51:41 +0000 | [diff] [blame] | 294 | { |
Werner Lemberg | 2fbf7e4 | 2000-06-02 00:01:14 +0000 | [diff] [blame] | 295 | if ( stream && stream->close ) |
David Turner | a8bcdf8 | 2000-05-02 10:51:41 +0000 | [diff] [blame] | 296 | stream->close( stream ); |
| 297 | } |
| 298 | |
| 299 | |
David Turner | 7663f22 | 2000-02-13 13:37:38 +0000 | [diff] [blame] | 300 | static |
Werner Lemberg | 547a252 | 2000-02-16 08:23:58 +0000 | [diff] [blame] | 301 | void ft_done_stream( FT_Stream* astream ) |
David Turner | 7663f22 | 2000-02-13 13:37:38 +0000 | [diff] [blame] | 302 | { |
| 303 | FT_Stream stream = *astream; |
| 304 | FT_Memory memory = stream->memory; |
Werner Lemberg | 547a252 | 2000-02-16 08:23:58 +0000 | [diff] [blame] | 305 | |
Werner Lemberg | a3b6c6c | 2000-05-31 06:55:12 +0000 | [diff] [blame] | 306 | |
Werner Lemberg | 547a252 | 2000-02-16 08:23:58 +0000 | [diff] [blame] | 307 | if ( stream->close ) |
David Turner | 7663f22 | 2000-02-13 13:37:38 +0000 | [diff] [blame] | 308 | stream->close( stream ); |
Just van Rossum | 7eef536 | 2000-03-05 16:07:58 +0000 | [diff] [blame] | 309 | |
David Turner | 7663f22 | 2000-02-13 13:37:38 +0000 | [diff] [blame] | 310 | FREE( stream ); |
| 311 | *astream = 0; |
| 312 | } |
| 313 | |
Werner Lemberg | a3b6c6c | 2000-05-31 06:55:12 +0000 | [diff] [blame] | 314 | |
Werner Lemberg | eb81e37 | 2000-06-03 06:03:11 +0000 | [diff] [blame] | 315 | #undef FT_COMPONENT |
| 316 | #define FT_COMPONENT trace_objs |
| 317 | |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 318 | /*************************************************************************/ |
| 319 | /*************************************************************************/ |
| 320 | /*************************************************************************/ |
| 321 | /**** ****/ |
| 322 | /**** ****/ |
| 323 | /**** G L Y P H L O A D E R ****/ |
| 324 | /**** ****/ |
| 325 | /**** ****/ |
| 326 | /*************************************************************************/ |
| 327 | /*************************************************************************/ |
| 328 | /*************************************************************************/ |
| 329 | |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 330 | |
Werner Lemberg | a929ba9 | 2000-06-25 06:47:11 +0000 | [diff] [blame] | 331 | /*************************************************************************/ |
| 332 | /* */ |
| 333 | /* The glyph loader is a simple object which is used to load a set of */ |
| 334 | /* glyphs easily. It is critical for the correct loading of composites. */ |
| 335 | /* */ |
| 336 | /* Ideally, one can see it as a stack of abstract `glyph' objects. */ |
| 337 | /* */ |
| 338 | /* loader.base Is really the bottom of the stack. It describes a */ |
| 339 | /* single glyph image made of the juxtaposition of */ |
| 340 | /* several glyphs (those `in the stack'). */ |
| 341 | /* */ |
| 342 | /* loader.current Describes the top of the stack, on which a new */ |
| 343 | /* glyph can be loaded. */ |
| 344 | /* */ |
| 345 | /* Rewind Clears the stack. */ |
| 346 | /* Prepare Set up `loader.current' for addition of a new glyph */ |
| 347 | /* image. */ |
| 348 | /* Add Add the `current' glyph image to the `base' one, */ |
| 349 | /* and prepare for another one. */ |
| 350 | /* */ |
| 351 | /* The glyph loader is now a base object. Each driver used to */ |
| 352 | /* re-implement it in one way or the other, which wasted code and */ |
| 353 | /* energy. */ |
| 354 | /* */ |
| 355 | /*************************************************************************/ |
| 356 | |
| 357 | |
| 358 | /* create a new glyph loader */ |
| 359 | BASE_FUNC( FT_Error ) FT_GlyphLoader_New( FT_Memory memory, |
| 360 | FT_GlyphLoader** aloader ) |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 361 | { |
| 362 | FT_GlyphLoader* loader; |
| 363 | FT_Error error; |
| 364 | |
Werner Lemberg | a929ba9 | 2000-06-25 06:47:11 +0000 | [diff] [blame] | 365 | |
| 366 | if ( !ALLOC( loader, sizeof ( *loader ) ) ) |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 367 | { |
| 368 | loader->memory = memory; |
| 369 | *aloader = loader; |
| 370 | } |
| 371 | return error; |
| 372 | } |
| 373 | |
| 374 | |
Werner Lemberg | a929ba9 | 2000-06-25 06:47:11 +0000 | [diff] [blame] | 375 | /* rewind the glyph loader - reset counters to 0 */ |
| 376 | BASE_FUNC( void ) FT_GlyphLoader_Rewind( FT_GlyphLoader* loader ) |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 377 | { |
| 378 | FT_GlyphLoad* base = &loader->base; |
| 379 | FT_GlyphLoad* current = &loader->current; |
| 380 | |
Werner Lemberg | a929ba9 | 2000-06-25 06:47:11 +0000 | [diff] [blame] | 381 | |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 382 | base->outline.n_points = 0; |
| 383 | base->outline.n_contours = 0; |
| 384 | base->num_subglyphs = 0; |
| 385 | |
| 386 | *current = *base; |
| 387 | } |
| 388 | |
| 389 | |
Werner Lemberg | a929ba9 | 2000-06-25 06:47:11 +0000 | [diff] [blame] | 390 | /* reset the glyph loader, frees all allocated tables */ |
| 391 | /* and starts from zero */ |
| 392 | BASE_FUNC( void ) FT_GlyphLoader_Reset( FT_GlyphLoader* loader ) |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 393 | { |
| 394 | FT_Memory memory = loader->memory; |
| 395 | |
Werner Lemberg | a929ba9 | 2000-06-25 06:47:11 +0000 | [diff] [blame] | 396 | |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 397 | FREE( loader->base.outline.points ); |
| 398 | FREE( loader->base.outline.tags ); |
| 399 | FREE( loader->base.outline.contours ); |
| 400 | FREE( loader->base.extra_points ); |
| 401 | FREE( loader->base.subglyphs ); |
| 402 | |
| 403 | loader->max_points = 0; |
| 404 | loader->max_contours = 0; |
| 405 | loader->max_subglyphs = 0; |
| 406 | |
| 407 | FT_GlyphLoader_Rewind( loader ); |
| 408 | } |
| 409 | |
| 410 | |
Werner Lemberg | a929ba9 | 2000-06-25 06:47:11 +0000 | [diff] [blame] | 411 | /* delete a glyph loader */ |
| 412 | BASE_FUNC( void ) FT_GlyphLoader_Done( FT_GlyphLoader* loader ) |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 413 | { |
Werner Lemberg | a929ba9 | 2000-06-25 06:47:11 +0000 | [diff] [blame] | 414 | if ( loader ) |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 415 | { |
| 416 | FT_Memory memory = loader->memory; |
| 417 | |
Werner Lemberg | a929ba9 | 2000-06-25 06:47:11 +0000 | [diff] [blame] | 418 | |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 419 | FT_GlyphLoader_Reset(loader); |
| 420 | FREE( loader ); |
| 421 | } |
| 422 | } |
| 423 | |
| 424 | |
Werner Lemberg | a929ba9 | 2000-06-25 06:47:11 +0000 | [diff] [blame] | 425 | /* re-adjust the `current' outline fields */ |
| 426 | static void FT_GlyphLoader_Adjust_Points( FT_GlyphLoader* loader ) |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 427 | { |
| 428 | FT_Outline* base = &loader->base.outline; |
| 429 | FT_Outline* current = &loader->current.outline; |
| 430 | |
Werner Lemberg | a929ba9 | 2000-06-25 06:47:11 +0000 | [diff] [blame] | 431 | |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 432 | current->points = base->points + base->n_points; |
| 433 | current->tags = base->tags + base->n_points; |
| 434 | current->contours = base->contours + base->n_contours; |
| 435 | |
| 436 | /* handle extra points table - if any */ |
Werner Lemberg | a929ba9 | 2000-06-25 06:47:11 +0000 | [diff] [blame] | 437 | if ( loader->use_extra ) |
| 438 | loader->current.extra_points = |
| 439 | loader->base.extra_points + base->n_points; |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 440 | } |
| 441 | |
| 442 | |
David Turner | 74abee8 | 2000-06-27 23:31:53 +0000 | [diff] [blame] | 443 | |
| 444 | BASE_FUNC(FT_Error) FT_GlyphLoader_Create_Extra( FT_GlyphLoader* loader ) |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 445 | { |
| 446 | FT_Error error; |
| 447 | FT_Memory memory = loader->memory; |
Werner Lemberg | a929ba9 | 2000-06-25 06:47:11 +0000 | [diff] [blame] | 448 | |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 449 | |
| 450 | if ( !ALLOC_ARRAY( loader->base.extra_points, |
| 451 | loader->max_points, FT_Vector ) ) |
| 452 | { |
| 453 | loader->use_extra = 1; |
Werner Lemberg | a929ba9 | 2000-06-25 06:47:11 +0000 | [diff] [blame] | 454 | FT_GlyphLoader_Adjust_Points( loader ); |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 455 | } |
| 456 | return error; |
| 457 | } |
| 458 | |
| 459 | |
Werner Lemberg | a929ba9 | 2000-06-25 06:47:11 +0000 | [diff] [blame] | 460 | /* re-adjust the `current' subglyphs field */ |
| 461 | static void FT_GlyphLoader_Adjust_Subglyphs( FT_GlyphLoader* loader ) |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 462 | { |
| 463 | FT_GlyphLoad* base = &loader->base; |
| 464 | FT_GlyphLoad* current = &loader->current; |
| 465 | |
Werner Lemberg | a929ba9 | 2000-06-25 06:47:11 +0000 | [diff] [blame] | 466 | |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 467 | current->subglyphs = base->subglyphs + base->num_subglyphs; |
| 468 | } |
| 469 | |
| 470 | |
Werner Lemberg | a929ba9 | 2000-06-25 06:47:11 +0000 | [diff] [blame] | 471 | /* Ensure that we can add `n_points' and `n_contours' to our glyph. this */ |
| 472 | /* function reallocates its outline tables if necessary. Note that it */ |
| 473 | /* DOESN'T change the number of points within the loader! */ |
| 474 | BASE_FUNC( FT_Error ) FT_GlyphLoader_Check_Points( |
| 475 | FT_GlyphLoader* loader, |
| 476 | FT_UInt n_points, |
| 477 | FT_UInt n_contours ) |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 478 | { |
| 479 | FT_Memory memory = loader->memory; |
| 480 | FT_Error error = FT_Err_Ok; |
| 481 | FT_Outline* base = &loader->base.outline; |
| 482 | FT_Outline* current = &loader->current.outline; |
| 483 | FT_Bool adjust = 1; |
| 484 | |
| 485 | FT_UInt new_max; |
| 486 | |
Werner Lemberg | a929ba9 | 2000-06-25 06:47:11 +0000 | [diff] [blame] | 487 | |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 488 | /* check points & tags */ |
| 489 | new_max = base->n_points + current->n_points + n_points; |
Werner Lemberg | a929ba9 | 2000-06-25 06:47:11 +0000 | [diff] [blame] | 490 | if ( new_max > loader->max_points ) |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 491 | { |
Werner Lemberg | a929ba9 | 2000-06-25 06:47:11 +0000 | [diff] [blame] | 492 | new_max = ( new_max + 7 ) & -8; |
| 493 | if ( REALLOC_ARRAY( base->points, base->n_points, |
| 494 | new_max, FT_Vector ) || |
| 495 | REALLOC_ARRAY( base->tags, base->n_points, |
| 496 | new_max, FT_Byte ) ) |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 497 | goto Exit; |
| 498 | |
| 499 | if ( loader->use_extra && |
Werner Lemberg | a929ba9 | 2000-06-25 06:47:11 +0000 | [diff] [blame] | 500 | REALLOC_ARRAY( loader->base.extra_points, base->n_points, |
| 501 | new_max, FT_Vector ) ) |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 502 | goto Exit; |
| 503 | |
| 504 | adjust = 1; |
| 505 | loader->max_points = new_max; |
| 506 | } |
| 507 | |
| 508 | /* check contours */ |
| 509 | new_max = base->n_contours + current->n_contours + |
| 510 | n_contours; |
Werner Lemberg | a929ba9 | 2000-06-25 06:47:11 +0000 | [diff] [blame] | 511 | if ( new_max > loader->max_contours ) |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 512 | { |
Werner Lemberg | a929ba9 | 2000-06-25 06:47:11 +0000 | [diff] [blame] | 513 | new_max = ( new_max + 3 ) & -4; |
| 514 | if ( REALLOC_ARRAY( base->contours, base->n_contours, |
| 515 | new_max, FT_Short ) ) |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 516 | goto Exit; |
| 517 | |
| 518 | adjust = 1; |
| 519 | loader->max_contours = new_max; |
| 520 | } |
| 521 | |
Werner Lemberg | a929ba9 | 2000-06-25 06:47:11 +0000 | [diff] [blame] | 522 | if ( adjust ) |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 523 | FT_GlyphLoader_Adjust_Points( loader ); |
| 524 | |
| 525 | Exit: |
| 526 | return error; |
| 527 | } |
| 528 | |
| 529 | |
Werner Lemberg | a929ba9 | 2000-06-25 06:47:11 +0000 | [diff] [blame] | 530 | /* Ensure that we can add `n_subglyphs' to our glyph. this function */ |
| 531 | /* reallocates its subglyphs table if necessary. Note that it DOES */ |
| 532 | /* NOT change the number of subglyphs within the loader! */ |
| 533 | BASE_FUNC( FT_Error ) FT_GlyphLoader_Check_Subglyphs( |
| 534 | FT_GlyphLoader* loader, |
| 535 | FT_UInt n_subs ) |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 536 | { |
| 537 | FT_Memory memory = loader->memory; |
| 538 | FT_Error error = FT_Err_Ok; |
| 539 | FT_UInt new_max; |
| 540 | |
| 541 | FT_GlyphLoad* base = &loader->base; |
| 542 | FT_GlyphLoad* current = &loader->current; |
| 543 | |
Werner Lemberg | a929ba9 | 2000-06-25 06:47:11 +0000 | [diff] [blame] | 544 | |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 545 | new_max = base->num_subglyphs + current->num_subglyphs + n_subs; |
Werner Lemberg | a929ba9 | 2000-06-25 06:47:11 +0000 | [diff] [blame] | 546 | if ( new_max > loader->max_subglyphs ) |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 547 | { |
Werner Lemberg | a929ba9 | 2000-06-25 06:47:11 +0000 | [diff] [blame] | 548 | new_max = ( new_max + 1 ) & -2; |
| 549 | if ( REALLOC_ARRAY( base->subglyphs, base->num_subglyphs, |
| 550 | new_max, FT_SubGlyph ) ) |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 551 | goto Exit; |
| 552 | |
| 553 | loader->max_subglyphs = new_max; |
| 554 | |
| 555 | FT_GlyphLoader_Adjust_Subglyphs( loader ); |
| 556 | } |
| 557 | |
| 558 | Exit: |
| 559 | return error; |
| 560 | } |
| 561 | |
| 562 | |
Werner Lemberg | a929ba9 | 2000-06-25 06:47:11 +0000 | [diff] [blame] | 563 | /* prepare loader for the addition of a new glyph on top of the base one */ |
| 564 | BASE_FUNC( void ) FT_GlyphLoader_Prepare( FT_GlyphLoader* loader ) |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 565 | { |
| 566 | FT_GlyphLoad* current = &loader->current; |
| 567 | |
Werner Lemberg | a929ba9 | 2000-06-25 06:47:11 +0000 | [diff] [blame] | 568 | |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 569 | current->outline.n_points = 0; |
| 570 | current->outline.n_contours = 0; |
| 571 | current->num_subglyphs = 0; |
| 572 | |
| 573 | FT_GlyphLoader_Adjust_Points ( loader ); |
| 574 | FT_GlyphLoader_Adjust_Subglyphs( loader ); |
| 575 | } |
| 576 | |
| 577 | |
Werner Lemberg | a929ba9 | 2000-06-25 06:47:11 +0000 | [diff] [blame] | 578 | /* add current glyph to the base image - and prepare for another */ |
| 579 | BASE_FUNC( void ) FT_GlyphLoader_Add( FT_GlyphLoader* loader ) |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 580 | { |
| 581 | FT_GlyphLoad* base = &loader->base; |
| 582 | FT_GlyphLoad* current = &loader->current; |
| 583 | |
| 584 | FT_UInt n_curr_contours = current->outline.n_contours; |
| 585 | FT_UInt n_base_points = base->outline.n_points; |
| 586 | FT_UInt n; |
| 587 | |
Werner Lemberg | a929ba9 | 2000-06-25 06:47:11 +0000 | [diff] [blame] | 588 | |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 589 | base->outline.n_points += current->outline.n_points; |
| 590 | base->outline.n_contours += current->outline.n_contours; |
| 591 | base->num_subglyphs += current->num_subglyphs; |
| 592 | |
| 593 | /* adjust contours count in newest outline */ |
| 594 | for ( n = 0; n < n_curr_contours; n++ ) |
| 595 | current->outline.contours[n] += n_base_points; |
| 596 | |
| 597 | /* prepare for another new glyph image */ |
| 598 | FT_GlyphLoader_Prepare( loader ); |
| 599 | } |
| 600 | |
| 601 | |
Werner Lemberg | a929ba9 | 2000-06-25 06:47:11 +0000 | [diff] [blame] | 602 | BASE_FUNC( FT_Error ) FT_GlyphLoader_Copy_Points( |
| 603 | FT_GlyphLoader* target, |
| 604 | FT_GlyphLoader* source ) |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 605 | { |
| 606 | FT_Error error; |
| 607 | FT_UInt num_points = source->base.outline.n_points; |
| 608 | FT_UInt num_contours = source->base.outline.n_contours; |
Werner Lemberg | a929ba9 | 2000-06-25 06:47:11 +0000 | [diff] [blame] | 609 | |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 610 | |
| 611 | error = FT_GlyphLoader_Check_Points( target, num_points, num_contours ); |
Werner Lemberg | a929ba9 | 2000-06-25 06:47:11 +0000 | [diff] [blame] | 612 | if ( !error ) |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 613 | { |
| 614 | FT_Outline* out = &target->base.outline; |
| 615 | FT_Outline* in = &source->base.outline; |
Werner Lemberg | a929ba9 | 2000-06-25 06:47:11 +0000 | [diff] [blame] | 616 | |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 617 | |
Werner Lemberg | a929ba9 | 2000-06-25 06:47:11 +0000 | [diff] [blame] | 618 | MEM_Copy( out->points, in->points, |
| 619 | num_points * sizeof ( FT_Vector ) ); |
| 620 | MEM_Copy( out->tags, in->tags, |
| 621 | num_points * sizeof ( char ) ); |
| 622 | MEM_Copy( out->contours, in->contours, |
| 623 | num_contours * sizeof ( short ) ); |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 624 | |
Werner Lemberg | a929ba9 | 2000-06-25 06:47:11 +0000 | [diff] [blame] | 625 | /* do we need to copy the extra points? */ |
| 626 | if ( target->use_extra && source->use_extra ) |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 627 | MEM_Copy( target->base.extra_points, source->base.extra_points, |
Werner Lemberg | a929ba9 | 2000-06-25 06:47:11 +0000 | [diff] [blame] | 628 | num_points * sizeof ( FT_Vector ) ); |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 629 | |
| 630 | out->n_points = num_points; |
| 631 | out->n_contours = num_contours; |
| 632 | |
| 633 | FT_GlyphLoader_Adjust_Points( target ); |
| 634 | } |
Werner Lemberg | a929ba9 | 2000-06-25 06:47:11 +0000 | [diff] [blame] | 635 | |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 636 | return error; |
| 637 | } |
| 638 | |
| 639 | |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 640 | /*************************************************************************/ |
| 641 | /*************************************************************************/ |
| 642 | /*************************************************************************/ |
| 643 | /**** ****/ |
| 644 | /**** ****/ |
| 645 | /**** FACE, SIZE & GLYPH SLOT OBJECTS ****/ |
| 646 | /**** ****/ |
| 647 | /**** ****/ |
| 648 | /*************************************************************************/ |
| 649 | /*************************************************************************/ |
| 650 | /*************************************************************************/ |
| 651 | |
| 652 | static FT_Error ft_glyphslot_init( FT_GlyphSlot slot ) |
| 653 | { |
| 654 | FT_Driver driver = slot->face->driver; |
| 655 | FT_Driver_Class* clazz = driver->clazz; |
| 656 | FT_Memory memory = driver->root.memory; |
| 657 | FT_Error error = FT_Err_Ok; |
| 658 | |
Werner Lemberg | a929ba9 | 2000-06-25 06:47:11 +0000 | [diff] [blame] | 659 | |
| 660 | if ( FT_DRIVER_USES_OUTLINES( driver ) ) |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 661 | error = FT_GlyphLoader_New( memory, &slot->loader ); |
| 662 | |
Werner Lemberg | a929ba9 | 2000-06-25 06:47:11 +0000 | [diff] [blame] | 663 | if ( !error && clazz->init_slot ) |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 664 | error = clazz->init_slot( slot ); |
| 665 | |
| 666 | return error; |
| 667 | } |
| 668 | |
| 669 | |
Werner Lemberg | a929ba9 | 2000-06-25 06:47:11 +0000 | [diff] [blame] | 670 | static void ft_glyphslot_clear( FT_GlyphSlot slot ) |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 671 | { |
| 672 | /* clear all public fields in the glyph slot */ |
Werner Lemberg | a929ba9 | 2000-06-25 06:47:11 +0000 | [diff] [blame] | 673 | MEM_Set( &slot->metrics, 0, sizeof ( slot->metrics ) ); |
| 674 | MEM_Set( &slot->outline, 0, sizeof ( slot->outline ) ); |
| 675 | MEM_Set( &slot->bitmap, 0, sizeof ( slot->bitmap ) ); |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 676 | |
| 677 | slot->bitmap_left = 0; |
| 678 | slot->bitmap_top = 0; |
| 679 | slot->num_subglyphs = 0; |
| 680 | slot->subglyphs = 0; |
| 681 | slot->control_data = 0; |
| 682 | slot->control_len = 0; |
| 683 | slot->other = 0; |
| 684 | slot->format = 0; |
| 685 | |
| 686 | slot->linearHoriAdvance = 0; |
| 687 | slot->linearVertAdvance = 0; |
| 688 | } |
| 689 | |
| 690 | |
Werner Lemberg | a929ba9 | 2000-06-25 06:47:11 +0000 | [diff] [blame] | 691 | static void ft_glyphslot_done( FT_GlyphSlot slot ) |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 692 | { |
| 693 | FT_Driver driver = slot->face->driver; |
| 694 | FT_Driver_Class* clazz = driver->clazz; |
| 695 | FT_Memory memory = driver->root.memory; |
| 696 | |
Werner Lemberg | a929ba9 | 2000-06-25 06:47:11 +0000 | [diff] [blame] | 697 | |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 698 | /* free bitmap buffer if needed */ |
| 699 | if ( slot->flags & ft_glyph_own_bitmap ) |
| 700 | FREE( slot->bitmap.buffer ); |
| 701 | |
| 702 | /* free glyph loader */ |
Werner Lemberg | a929ba9 | 2000-06-25 06:47:11 +0000 | [diff] [blame] | 703 | if ( FT_DRIVER_USES_OUTLINES( driver ) ) |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 704 | { |
| 705 | FT_GlyphLoader_Done( slot->loader ); |
| 706 | slot->loader = 0; |
| 707 | } |
| 708 | |
Werner Lemberg | a929ba9 | 2000-06-25 06:47:11 +0000 | [diff] [blame] | 709 | if ( clazz->done_slot ) |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 710 | clazz->done_slot( slot ); |
| 711 | } |
| 712 | |
| 713 | |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 714 | /*************************************************************************/ |
| 715 | /* */ |
| 716 | /* <Function> */ |
| 717 | /* FT_New_GlyphSlot */ |
| 718 | /* */ |
| 719 | /* <Description> */ |
| 720 | /* It is sometimes useful to have more than one glyph slot for a */ |
| 721 | /* given face object. This function is used to create additional */ |
| 722 | /* slots. All of them are automatically discarded when the face is */ |
| 723 | /* destroyed. */ |
| 724 | /* */ |
| 725 | /* <Input> */ |
| 726 | /* face :: A handle to a parent face object. */ |
| 727 | /* */ |
| 728 | /* <Output> */ |
| 729 | /* aslot :: A handle to a new glyph slot object. */ |
| 730 | /* */ |
| 731 | /* <Return> */ |
| 732 | /* FreeType error code. 0 means success. */ |
| 733 | /* */ |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 734 | FT_EXPORT_FUNC( FT_Error ) FT_New_GlyphSlot( FT_Face face, |
| 735 | FT_GlyphSlot* aslot ) |
| 736 | { |
Werner Lemberg | a929ba9 | 2000-06-25 06:47:11 +0000 | [diff] [blame] | 737 | FT_Error error; |
| 738 | FT_Driver driver; |
| 739 | FT_Driver_Class* clazz; |
| 740 | FT_Memory memory; |
| 741 | FT_GlyphSlot slot; |
| 742 | |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 743 | |
| 744 | *aslot = 0; |
| 745 | |
| 746 | if ( !face || !aslot || !face->driver ) |
| 747 | return FT_Err_Invalid_Argument; |
| 748 | |
| 749 | driver = face->driver; |
| 750 | clazz = driver->clazz; |
| 751 | memory = driver->root.memory; |
| 752 | |
| 753 | FT_TRACE4(( "FT_New_GlyphSlot: Creating new slot object\n" )); |
| 754 | if ( !ALLOC( slot, clazz->slot_object_size ) ) |
| 755 | { |
| 756 | slot->face = face; |
| 757 | |
| 758 | error = ft_glyphslot_init( slot ); |
Werner Lemberg | a929ba9 | 2000-06-25 06:47:11 +0000 | [diff] [blame] | 759 | if ( error ) |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 760 | { |
| 761 | ft_glyphslot_done( slot ); |
| 762 | FREE( slot ); |
| 763 | goto Exit; |
| 764 | } |
| 765 | |
| 766 | *aslot = slot; |
| 767 | } |
| 768 | |
| 769 | Exit: |
| 770 | FT_TRACE4(( "FT_New_GlyphSlot: Return %d\n", error )); |
| 771 | return error; |
| 772 | } |
| 773 | |
| 774 | |
| 775 | /*************************************************************************/ |
| 776 | /* */ |
| 777 | /* <Function> */ |
| 778 | /* FT_Done_GlyphSlot */ |
| 779 | /* */ |
| 780 | /* <Description> */ |
| 781 | /* Destroys a given glyph slot. Remember however that all slots are */ |
| 782 | /* automatically destroyed with its parent. Using this function is */ |
| 783 | /* not always mandatory. */ |
| 784 | /* */ |
| 785 | /* <Input> */ |
| 786 | /* slot :: A handle to a target glyph slot. */ |
| 787 | /* */ |
| 788 | FT_EXPORT_FUNC( void ) FT_Done_GlyphSlot( FT_GlyphSlot slot ) |
| 789 | { |
| 790 | if ( slot ) |
| 791 | { |
| 792 | FT_Driver driver = slot->face->driver; |
| 793 | FT_Memory memory = driver->root.memory; |
| 794 | FT_GlyphSlot* parent; |
| 795 | FT_GlyphSlot cur; |
| 796 | |
Werner Lemberg | a929ba9 | 2000-06-25 06:47:11 +0000 | [diff] [blame] | 797 | |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 798 | /* Remove slot from its parent face's list */ |
| 799 | parent = &slot->face->glyph; |
| 800 | cur = *parent; |
Werner Lemberg | a929ba9 | 2000-06-25 06:47:11 +0000 | [diff] [blame] | 801 | |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 802 | while ( cur ) |
| 803 | { |
| 804 | if ( cur == slot ) |
| 805 | { |
| 806 | *parent = cur->next; |
Werner Lemberg | a929ba9 | 2000-06-25 06:47:11 +0000 | [diff] [blame] | 807 | ft_glyphslot_done( slot ); |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 808 | FREE( slot ); |
| 809 | break; |
| 810 | } |
| 811 | cur = cur->next; |
| 812 | } |
| 813 | } |
| 814 | } |
| 815 | |
| 816 | |
Werner Lemberg | a929ba9 | 2000-06-25 06:47:11 +0000 | [diff] [blame] | 817 | /* forward declaration */ |
| 818 | static FT_Renderer ft_lookup_glyph_renderer( FT_GlyphSlot slot ); |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 819 | |
| 820 | |
| 821 | /*************************************************************************/ |
| 822 | /* */ |
| 823 | /* <Function> */ |
| 824 | /* FT_Set_Transform */ |
| 825 | /* */ |
| 826 | /* <Description> */ |
| 827 | /* A function used to set the transformation that is applied to glyph */ |
Werner Lemberg | a929ba9 | 2000-06-25 06:47:11 +0000 | [diff] [blame] | 828 | /* images just before they are converted to bitmaps in a glyph slot */ |
| 829 | /* when FT_Render_Glyph() is called. */ |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 830 | /* */ |
| 831 | /* <InOut> */ |
| 832 | /* face :: A handle to the source face object. */ |
| 833 | /* */ |
| 834 | /* <Input> */ |
| 835 | /* matrix :: A pointer to the transformation's 2x2 matrix. Use 0 for */ |
| 836 | /* the identity matrix. */ |
| 837 | /* delta :: A pointer to the translation vector. Use 0 for the null */ |
| 838 | /* vector. */ |
| 839 | /* */ |
| 840 | /* <Note> */ |
| 841 | /* The transformation is only applied to scalable image formats. */ |
| 842 | /* */ |
| 843 | FT_EXPORT_FUNC( void ) FT_Set_Transform( FT_Face face, |
| 844 | FT_Matrix* matrix, |
| 845 | FT_Vector* delta ) |
| 846 | { |
| 847 | if ( !face ) |
| 848 | return; |
| 849 | |
| 850 | face->transform_flags = 0; |
| 851 | |
| 852 | if ( !matrix ) |
| 853 | { |
| 854 | face->transform_matrix.xx = 0x10000L; |
| 855 | face->transform_matrix.xy = 0L; |
| 856 | face->transform_matrix.yx = 0L; |
| 857 | face->transform_matrix.yy = 0x10000L; |
| 858 | matrix = &face->transform_matrix; |
| 859 | } |
| 860 | else |
| 861 | face->transform_matrix = *matrix; |
| 862 | |
| 863 | /* set transform_flags bit flag 0 if `matrix' isn't the identity */ |
| 864 | if ( ( matrix->xy | matrix->yx ) || |
| 865 | matrix->xx != 0x10000L || |
| 866 | matrix->yy != 0x10000L ) |
| 867 | face->transform_flags |= 1; |
| 868 | |
| 869 | if ( !delta ) |
| 870 | { |
| 871 | face->transform_delta.x = 0; |
| 872 | face->transform_delta.y = 0; |
| 873 | delta = &face->transform_delta; |
| 874 | } |
| 875 | else |
| 876 | face->transform_delta = *delta; |
| 877 | |
| 878 | /* set transform_flags bit flag 1 if `delta' isn't the null vector */ |
| 879 | if ( delta->x | delta->y ) |
| 880 | face->transform_flags |= 2; |
| 881 | } |
| 882 | |
| 883 | |
David Turner | 74abee8 | 2000-06-27 23:31:53 +0000 | [diff] [blame] | 884 | static FT_Renderer ft_lookup_glyph_renderer( FT_GlyphSlot slot ); |
| 885 | |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 886 | /*************************************************************************/ |
| 887 | /* */ |
| 888 | /* <Function> */ |
| 889 | /* FT_Load_Glyph */ |
| 890 | /* */ |
| 891 | /* <Description> */ |
| 892 | /* A function used to load a single glyph within a given glyph slot, */ |
| 893 | /* for a given size. */ |
| 894 | /* */ |
| 895 | /* <Input> */ |
| 896 | /* face :: A handle to the target face object where the glyph */ |
| 897 | /* will be loaded. */ |
| 898 | /* */ |
| 899 | /* glyph_index :: The index of the glyph in the font file. */ |
| 900 | /* */ |
| 901 | /* load_flags :: A flag indicating what to load for this glyph. The */ |
| 902 | /* FT_LOAD_XXX constants can be used to control the */ |
| 903 | /* glyph loading process (e.g., whether the outline */ |
| 904 | /* should be scaled, whether to load bitmaps or not, */ |
| 905 | /* whether to hint the outline, etc). */ |
| 906 | /* */ |
| 907 | /* <Return> */ |
| 908 | /* FreeType error code. 0 means success. */ |
| 909 | /* */ |
| 910 | /* <Note> */ |
| 911 | /* If the glyph image is not a bitmap, and if the bit flag */ |
| 912 | /* FT_LOAD_IGNORE_TRANSFORM is unset, the glyph image will be */ |
| 913 | /* transformed with the information passed to a previous call to */ |
| 914 | /* FT_Set_Transform. */ |
| 915 | /* */ |
Werner Lemberg | a929ba9 | 2000-06-25 06:47:11 +0000 | [diff] [blame] | 916 | /* Note that this also transforms the `face.glyph.advance' field, but */ |
| 917 | /* *not* the values in `face.glyph.metrics'. */ |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 918 | /* */ |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 919 | FT_EXPORT_FUNC( FT_Error ) FT_Load_Glyph( FT_Face face, |
| 920 | FT_UInt glyph_index, |
| 921 | FT_Int load_flags ) |
| 922 | { |
| 923 | FT_Error error; |
| 924 | FT_Driver driver; |
| 925 | FT_GlyphSlot slot; |
| 926 | |
Werner Lemberg | a929ba9 | 2000-06-25 06:47:11 +0000 | [diff] [blame] | 927 | |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 928 | if ( !face || !face->size || !face->glyph ) |
| 929 | return FT_Err_Invalid_Face_Handle; |
| 930 | |
David Turner | 74abee8 | 2000-06-27 23:31:53 +0000 | [diff] [blame] | 931 | if ( glyph_index >= (FT_UInt)face->num_glyphs ) |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 932 | return FT_Err_Invalid_Argument; |
| 933 | |
| 934 | slot = face->glyph; |
| 935 | ft_glyphslot_clear( slot ); |
| 936 | |
| 937 | driver = face->driver; |
| 938 | |
| 939 | /* when the flag NO_RECURSE is set, we disable hinting and scaling */ |
| 940 | if ( load_flags & FT_LOAD_NO_RECURSE ) |
| 941 | load_flags |= FT_LOAD_NO_SCALE | FT_LOAD_NO_HINTING; |
| 942 | |
| 943 | error = driver->clazz->load_glyph( slot, |
| 944 | face->size, |
| 945 | glyph_index, |
| 946 | load_flags ); |
Werner Lemberg | a929ba9 | 2000-06-25 06:47:11 +0000 | [diff] [blame] | 947 | if ( error ) |
| 948 | goto Exit; |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 949 | |
| 950 | /* compute the advance */ |
Werner Lemberg | a929ba9 | 2000-06-25 06:47:11 +0000 | [diff] [blame] | 951 | if ( load_flags & FT_LOAD_VERTICAL_LAYOUT ) |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 952 | { |
| 953 | slot->advance.x = 0; |
| 954 | slot->advance.y = slot->metrics.vertAdvance; |
| 955 | } |
| 956 | else |
| 957 | { |
| 958 | slot->advance.x = slot->metrics.horiAdvance; |
| 959 | slot->advance.y = 0; |
| 960 | } |
| 961 | |
| 962 | /* now, transform the glyph image when needed */ |
Werner Lemberg | a929ba9 | 2000-06-25 06:47:11 +0000 | [diff] [blame] | 963 | if ( face->transform_flags ) |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 964 | { |
| 965 | /* get renderer */ |
| 966 | FT_Renderer renderer = ft_lookup_glyph_renderer( slot ); |
| 967 | |
Werner Lemberg | a929ba9 | 2000-06-25 06:47:11 +0000 | [diff] [blame] | 968 | |
| 969 | if ( renderer ) |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 970 | error = renderer->clazz->transform_glyph( renderer, slot, |
| 971 | &face->transform_matrix, |
| 972 | &face->transform_delta ); |
| 973 | /* transform advance */ |
| 974 | FT_Vector_Transform( &slot->advance, &face->transform_matrix ); |
| 975 | } |
| 976 | |
| 977 | Exit: |
| 978 | return error; |
| 979 | } |
| 980 | |
| 981 | |
| 982 | /*************************************************************************/ |
| 983 | /* */ |
| 984 | /* <Function> */ |
| 985 | /* FT_Load_Char */ |
| 986 | /* */ |
| 987 | /* <Description> */ |
| 988 | /* A function used to load a single glyph within a given glyph slot, */ |
Werner Lemberg | a929ba9 | 2000-06-25 06:47:11 +0000 | [diff] [blame] | 989 | /* for a given size, according to its character code. */ |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 990 | /* */ |
| 991 | /* <Input> */ |
| 992 | /* face :: A handle to a target face object where the glyph */ |
| 993 | /* will be loaded. */ |
| 994 | /* */ |
| 995 | /* char_code :: The glyph's character code, according to the */ |
| 996 | /* current charmap used in the face. */ |
| 997 | /* */ |
| 998 | /* load_flags :: A flag indicating what to load for this glyph. The */ |
| 999 | /* FT_LOAD_XXX constants can be used to control the */ |
| 1000 | /* glyph loading process (e.g., whether the outline */ |
| 1001 | /* should be scaled, whether to load bitmaps or not, */ |
| 1002 | /* whether to hint the outline, etc). */ |
Werner Lemberg | a929ba9 | 2000-06-25 06:47:11 +0000 | [diff] [blame] | 1003 | /* */ |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 1004 | /* <Return> */ |
| 1005 | /* FreeType error code. 0 means success. */ |
| 1006 | /* */ |
| 1007 | /* <Note> */ |
| 1008 | /* If the face has no current charmap, or if the character code */ |
| 1009 | /* is not defined in the charmap, this function will return an */ |
Werner Lemberg | a929ba9 | 2000-06-25 06:47:11 +0000 | [diff] [blame] | 1010 | /* error. */ |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 1011 | /* */ |
| 1012 | /* If the glyph image is not a bitmap, and if the bit flag */ |
| 1013 | /* FT_LOAD_IGNORE_TRANSFORM is unset, the glyph image will be */ |
| 1014 | /* transformed with the information passed to a previous call to */ |
Werner Lemberg | a929ba9 | 2000-06-25 06:47:11 +0000 | [diff] [blame] | 1015 | /* FT_Set_Transform(). */ |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 1016 | /* */ |
Werner Lemberg | a929ba9 | 2000-06-25 06:47:11 +0000 | [diff] [blame] | 1017 | /* Note that this also transforms the `face.glyph.advance' field, but */ |
| 1018 | /* *not* the values in `face.glyph.metrics'. */ |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 1019 | /* */ |
| 1020 | FT_EXPORT_FUNC( FT_Error ) FT_Load_Char( FT_Face face, |
| 1021 | FT_ULong char_code, |
| 1022 | FT_Int load_flags ) |
| 1023 | { |
| 1024 | FT_UInt glyph_index; |
| 1025 | |
Werner Lemberg | a929ba9 | 2000-06-25 06:47:11 +0000 | [diff] [blame] | 1026 | |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 1027 | if ( !face ) |
| 1028 | return FT_Err_Invalid_Face_Handle; |
| 1029 | |
| 1030 | glyph_index = (FT_UInt)char_code; |
Werner Lemberg | a929ba9 | 2000-06-25 06:47:11 +0000 | [diff] [blame] | 1031 | if ( face->charmap ) |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 1032 | glyph_index = FT_Get_Char_Index( face, char_code ); |
| 1033 | |
| 1034 | return glyph_index ? FT_Load_Glyph( face, glyph_index, load_flags ) |
| 1035 | : FT_Err_Invalid_Character_Code; |
| 1036 | } |
| 1037 | |
| 1038 | |
Werner Lemberg | 7880dd6 | 2000-01-10 17:19:45 +0000 | [diff] [blame] | 1039 | /* destructor for sizes list */ |
| 1040 | static |
| 1041 | void destroy_size( FT_Memory memory, |
| 1042 | FT_Size size, |
| 1043 | FT_Driver driver ) |
| 1044 | { |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 1045 | /* finalize client-specific data */ |
Werner Lemberg | a929ba9 | 2000-06-25 06:47:11 +0000 | [diff] [blame] | 1046 | if ( size->generic.finalizer ) |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 1047 | size->generic.finalizer( size ); |
| 1048 | |
Werner Lemberg | 7880dd6 | 2000-01-10 17:19:45 +0000 | [diff] [blame] | 1049 | /* finalize format-specific stuff */ |
Werner Lemberg | a929ba9 | 2000-06-25 06:47:11 +0000 | [diff] [blame] | 1050 | if ( driver->clazz->done_size ) |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 1051 | driver->clazz->done_size( size ); |
| 1052 | |
Werner Lemberg | 7880dd6 | 2000-01-10 17:19:45 +0000 | [diff] [blame] | 1053 | FREE( size ); |
| 1054 | } |
David Turner | d2b1f35 | 1999-12-16 23:11:37 +0000 | [diff] [blame] | 1055 | |
| 1056 | |
Werner Lemberg | 7880dd6 | 2000-01-10 17:19:45 +0000 | [diff] [blame] | 1057 | /* destructor for faces list */ |
| 1058 | static |
| 1059 | void destroy_face( FT_Memory memory, |
| 1060 | FT_Face face, |
| 1061 | FT_Driver driver ) |
| 1062 | { |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 1063 | FT_Driver_Class* clazz = driver->clazz; |
| 1064 | |
Werner Lemberg | a929ba9 | 2000-06-25 06:47:11 +0000 | [diff] [blame] | 1065 | |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 1066 | /* Discard glyph slots for this face */ |
| 1067 | /* Beware! FT_Done_GlyphSlot() changes the field `face->slot' */ |
Werner Lemberg | 7880dd6 | 2000-01-10 17:19:45 +0000 | [diff] [blame] | 1068 | while ( face->glyph ) |
| 1069 | FT_Done_GlyphSlot( face->glyph ); |
| 1070 | |
| 1071 | /* Discard all sizes for this face */ |
| 1072 | FT_List_Finalize( &face->sizes_list, |
| 1073 | (FT_List_Destructor)destroy_size, |
| 1074 | memory, |
| 1075 | driver ); |
| 1076 | face->size = 0; |
| 1077 | |
Werner Lemberg | 7880dd6 | 2000-01-10 17:19:45 +0000 | [diff] [blame] | 1078 | /* Now discard client data */ |
| 1079 | if ( face->generic.finalizer ) |
| 1080 | face->generic.finalizer( face ); |
| 1081 | |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 1082 | /* finalize format-specific stuff */ |
Werner Lemberg | a929ba9 | 2000-06-25 06:47:11 +0000 | [diff] [blame] | 1083 | if ( clazz->done_face ) |
| 1084 | clazz->done_face( face ); |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 1085 | |
| 1086 | /* close the stream for this face if needed */ |
Werner Lemberg | a929ba9 | 2000-06-25 06:47:11 +0000 | [diff] [blame] | 1087 | if ( ( face->face_flags & FT_FACE_FLAG_EXTERNAL_STREAM ) == 0 ) |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 1088 | ft_done_stream( &face->stream ); |
David Turner | 7663f22 | 2000-02-13 13:37:38 +0000 | [diff] [blame] | 1089 | |
Werner Lemberg | 7880dd6 | 2000-01-10 17:19:45 +0000 | [diff] [blame] | 1090 | /* get rid of it */ |
| 1091 | FREE( face ); |
| 1092 | } |
David Turner | d2b1f35 | 1999-12-16 23:11:37 +0000 | [diff] [blame] | 1093 | |
| 1094 | |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 1095 | static void Destroy_Driver( FT_Driver driver ) |
David Turner | d2b1f35 | 1999-12-16 23:11:37 +0000 | [diff] [blame] | 1096 | { |
David Turner | d2b1f35 | 1999-12-16 23:11:37 +0000 | [diff] [blame] | 1097 | FT_List_Finalize( &driver->faces_list, |
| 1098 | (FT_List_Destructor)destroy_face, |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 1099 | driver->root.memory, |
David Turner | d2b1f35 | 1999-12-16 23:11:37 +0000 | [diff] [blame] | 1100 | driver ); |
| 1101 | |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 1102 | /* see if we need to drop the driver's glyph loader */ |
Werner Lemberg | a929ba9 | 2000-06-25 06:47:11 +0000 | [diff] [blame] | 1103 | if ( FT_DRIVER_USES_OUTLINES( driver ) ) |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 1104 | FT_GlyphLoader_Done( driver->glyph_loader ); |
David Turner | d2b1f35 | 1999-12-16 23:11:37 +0000 | [diff] [blame] | 1105 | } |
| 1106 | |
| 1107 | |
Werner Lemberg | 547a252 | 2000-02-16 08:23:58 +0000 | [diff] [blame] | 1108 | /*************************************************************************/ |
| 1109 | /* */ |
| 1110 | /* <Function> */ |
| 1111 | /* open_face */ |
| 1112 | /* */ |
| 1113 | /* <Description> */ |
| 1114 | /* This function does some work for FT_Open_Face(). */ |
| 1115 | /* */ |
David Turner | d2b1f35 | 1999-12-16 23:11:37 +0000 | [diff] [blame] | 1116 | static |
David Turner | 4f2c554 | 2000-05-12 10:19:41 +0000 | [diff] [blame] | 1117 | FT_Error open_face( FT_Driver driver, |
| 1118 | FT_Stream stream, |
| 1119 | FT_Long face_index, |
| 1120 | FT_Int num_params, |
| 1121 | FT_Parameter* params, |
| 1122 | FT_Face* aface ) |
David Turner | d2b1f35 | 1999-12-16 23:11:37 +0000 | [diff] [blame] | 1123 | { |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 1124 | FT_Memory memory; |
| 1125 | FT_Driver_Class* clazz; |
| 1126 | FT_Face face = 0; |
| 1127 | FT_Error error; |
David Turner | d2b1f35 | 1999-12-16 23:11:37 +0000 | [diff] [blame] | 1128 | |
Werner Lemberg | a929ba9 | 2000-06-25 06:47:11 +0000 | [diff] [blame] | 1129 | |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 1130 | clazz = driver->clazz; |
| 1131 | memory = driver->root.memory; |
David Turner | d2b1f35 | 1999-12-16 23:11:37 +0000 | [diff] [blame] | 1132 | |
Werner Lemberg | 547a252 | 2000-02-16 08:23:58 +0000 | [diff] [blame] | 1133 | /* allocate the face object, and perform basic initialization */ |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 1134 | if ( ALLOC( face, clazz->face_object_size ) ) |
David Turner | d2b1f35 | 1999-12-16 23:11:37 +0000 | [diff] [blame] | 1135 | goto Fail; |
| 1136 | |
| 1137 | face->driver = driver; |
| 1138 | face->memory = memory; |
| 1139 | face->stream = stream; |
| 1140 | |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 1141 | error = clazz->init_face( stream, |
| 1142 | face, |
| 1143 | face_index, |
| 1144 | num_params, |
| 1145 | params ); |
David Turner | d2b1f35 | 1999-12-16 23:11:37 +0000 | [diff] [blame] | 1146 | if ( error ) |
| 1147 | goto Fail; |
| 1148 | |
| 1149 | *aface = face; |
| 1150 | |
| 1151 | Fail: |
| 1152 | if ( error ) |
| 1153 | { |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 1154 | clazz->done_face( face ); |
David Turner | d2b1f35 | 1999-12-16 23:11:37 +0000 | [diff] [blame] | 1155 | FREE( face ); |
| 1156 | *aface = 0; |
| 1157 | } |
| 1158 | |
| 1159 | return error; |
| 1160 | } |
| 1161 | |
| 1162 | |
| 1163 | /*************************************************************************/ |
| 1164 | /* */ |
| 1165 | /* <Function> */ |
| 1166 | /* FT_New_Face */ |
| 1167 | /* */ |
| 1168 | /* <Description> */ |
Werner Lemberg | 547a252 | 2000-02-16 08:23:58 +0000 | [diff] [blame] | 1169 | /* Creates a new face object from a given resource and typeface index */ |
| 1170 | /* using a pathname to the font file. */ |
| 1171 | /* */ |
| 1172 | /* <InOut> */ |
| 1173 | /* library :: A handle to the library resource. */ |
David Turner | d2b1f35 | 1999-12-16 23:11:37 +0000 | [diff] [blame] | 1174 | /* */ |
| 1175 | /* <Input> */ |
Werner Lemberg | 547a252 | 2000-02-16 08:23:58 +0000 | [diff] [blame] | 1176 | /* pathname :: A path to the font file. */ |
Werner Lemberg | a3b6c6c | 2000-05-31 06:55:12 +0000 | [diff] [blame] | 1177 | /* */ |
David Turner | d2b1f35 | 1999-12-16 23:11:37 +0000 | [diff] [blame] | 1178 | /* face_index :: The index of the face within the resource. The */ |
| 1179 | /* first face has index 0. */ |
| 1180 | /* <Output> */ |
Werner Lemberg | a3b6c6c | 2000-05-31 06:55:12 +0000 | [diff] [blame] | 1181 | /* aface :: A handle to a new face object. */ |
David Turner | d2b1f35 | 1999-12-16 23:11:37 +0000 | [diff] [blame] | 1182 | /* */ |
| 1183 | /* <Return> */ |
Werner Lemberg | 7880dd6 | 2000-01-10 17:19:45 +0000 | [diff] [blame] | 1184 | /* FreeType error code. 0 means success. */ |
David Turner | d2b1f35 | 1999-12-16 23:11:37 +0000 | [diff] [blame] | 1185 | /* */ |
| 1186 | /* <Note> */ |
Werner Lemberg | 547a252 | 2000-02-16 08:23:58 +0000 | [diff] [blame] | 1187 | /* Unlike FreeType 1.x, this function automatically creates a glyph */ |
David Turner | d2b1f35 | 1999-12-16 23:11:37 +0000 | [diff] [blame] | 1188 | /* slot for the face object which can be accessed directly through */ |
| 1189 | /* `face->glyph'. */ |
| 1190 | /* */ |
Werner Lemberg | 547a252 | 2000-02-16 08:23:58 +0000 | [diff] [blame] | 1191 | /* Note that additional slots can be added to each face with the */ |
David Turner | d2b1f35 | 1999-12-16 23:11:37 +0000 | [diff] [blame] | 1192 | /* FT_New_GlyphSlot() API function. Slots are linked in a single */ |
| 1193 | /* list through their `next' field. */ |
| 1194 | /* */ |
| 1195 | /* FT_New_Face() can be used to determine and/or check the font */ |
| 1196 | /* format of a given font resource. If the `face_index' field is */ |
| 1197 | /* negative, the function will _not_ return any face handle in */ |
| 1198 | /* `*face'. Its return value should be 0 if the resource is */ |
| 1199 | /* recognized, or non-zero if not. */ |
| 1200 | /* */ |
Werner Lemberg | a3b6c6c | 2000-05-31 06:55:12 +0000 | [diff] [blame] | 1201 | FT_EXPORT_FUNC( FT_Error ) FT_New_Face( FT_Library library, |
| 1202 | const char* pathname, |
| 1203 | FT_Long face_index, |
| 1204 | FT_Face* aface ) |
David Turner | d2b1f35 | 1999-12-16 23:11:37 +0000 | [diff] [blame] | 1205 | { |
David Turner | 37379e2 | 2000-03-28 11:22:31 +0000 | [diff] [blame] | 1206 | FT_Open_Args args; |
Werner Lemberg | 547a252 | 2000-02-16 08:23:58 +0000 | [diff] [blame] | 1207 | |
Werner Lemberg | a929ba9 | 2000-06-25 06:47:11 +0000 | [diff] [blame] | 1208 | |
Werner Lemberg | 2fbf7e4 | 2000-06-02 00:01:14 +0000 | [diff] [blame] | 1209 | /* test for valid `library' and `aface' delayed to FT_Open_Face() */ |
Werner Lemberg | 2fbf7e4 | 2000-06-02 00:01:14 +0000 | [diff] [blame] | 1210 | if ( !pathname ) |
| 1211 | return FT_Err_Invalid_Argument; |
| 1212 | |
David Turner | 4f2c554 | 2000-05-12 10:19:41 +0000 | [diff] [blame] | 1213 | args.flags = ft_open_pathname; |
| 1214 | args.pathname = (char*)pathname; |
Werner Lemberg | a3b6c6c | 2000-05-31 06:55:12 +0000 | [diff] [blame] | 1215 | |
David Turner | cda32b7 | 2000-02-10 16:14:35 +0000 | [diff] [blame] | 1216 | return FT_Open_Face( library, &args, face_index, aface ); |
David Turner | d2b1f35 | 1999-12-16 23:11:37 +0000 | [diff] [blame] | 1217 | } |
| 1218 | |
Werner Lemberg | 7880dd6 | 2000-01-10 17:19:45 +0000 | [diff] [blame] | 1219 | |
Werner Lemberg | 547a252 | 2000-02-16 08:23:58 +0000 | [diff] [blame] | 1220 | /*************************************************************************/ |
| 1221 | /* */ |
| 1222 | /* <Function> */ |
| 1223 | /* FT_New_Memory_Face */ |
| 1224 | /* */ |
| 1225 | /* <Description> */ |
| 1226 | /* Creates a new face object from a given resource and typeface index */ |
| 1227 | /* using a font file already loaded into memory. */ |
| 1228 | /* */ |
| 1229 | /* <InOut> */ |
| 1230 | /* library :: A handle to the library resource. */ |
| 1231 | /* */ |
| 1232 | /* <Input> */ |
| 1233 | /* file_base :: A pointer to the beginning of the font data. */ |
Werner Lemberg | a3b6c6c | 2000-05-31 06:55:12 +0000 | [diff] [blame] | 1234 | /* */ |
Werner Lemberg | 547a252 | 2000-02-16 08:23:58 +0000 | [diff] [blame] | 1235 | /* file_size :: The size of the memory chunk used by the font data. */ |
Werner Lemberg | a3b6c6c | 2000-05-31 06:55:12 +0000 | [diff] [blame] | 1236 | /* */ |
Werner Lemberg | 547a252 | 2000-02-16 08:23:58 +0000 | [diff] [blame] | 1237 | /* face_index :: The index of the face within the resource. The */ |
| 1238 | /* first face has index 0. */ |
| 1239 | /* <Output> */ |
| 1240 | /* face :: A handle to a new face object. */ |
| 1241 | /* */ |
| 1242 | /* <Return> */ |
| 1243 | /* FreeType error code. 0 means success. */ |
| 1244 | /* */ |
| 1245 | /* <Note> */ |
| 1246 | /* Unlike FreeType 1.x, this function automatically creates a glyph */ |
| 1247 | /* slot for the face object which can be accessed directly through */ |
| 1248 | /* `face->glyph'. */ |
| 1249 | /* */ |
| 1250 | /* Note that additional slots can be added to each face with the */ |
| 1251 | /* FT_New_GlyphSlot() API function. Slots are linked in a single */ |
| 1252 | /* list through their `next' field. */ |
| 1253 | /* */ |
| 1254 | /* FT_New_Memory_Face() can be used to determine and/or check the */ |
| 1255 | /* font format of a given font resource. If the `face_index' field */ |
| 1256 | /* is negative, the function will _not_ return any face handle in */ |
| 1257 | /* `*face'. Its return value should be 0 if the resource is */ |
| 1258 | /* recognized, or non-zero if not. */ |
| 1259 | /* */ |
Werner Lemberg | a3b6c6c | 2000-05-31 06:55:12 +0000 | [diff] [blame] | 1260 | FT_EXPORT_FUNC( FT_Error ) FT_New_Memory_Face( FT_Library library, |
| 1261 | void* file_base, |
| 1262 | FT_Long file_size, |
| 1263 | FT_Long face_index, |
| 1264 | FT_Face* face ) |
David Turner | d2b1f35 | 1999-12-16 23:11:37 +0000 | [diff] [blame] | 1265 | { |
David Turner | 37379e2 | 2000-03-28 11:22:31 +0000 | [diff] [blame] | 1266 | FT_Open_Args args; |
Werner Lemberg | 7880dd6 | 2000-01-10 17:19:45 +0000 | [diff] [blame] | 1267 | |
Werner Lemberg | a929ba9 | 2000-06-25 06:47:11 +0000 | [diff] [blame] | 1268 | |
Werner Lemberg | 2fbf7e4 | 2000-06-02 00:01:14 +0000 | [diff] [blame] | 1269 | /* test for valid `library' and `face' delayed to FT_Open_Face() */ |
Werner Lemberg | 2fbf7e4 | 2000-06-02 00:01:14 +0000 | [diff] [blame] | 1270 | if ( !file_base ) |
| 1271 | return FT_Err_Invalid_Argument; |
| 1272 | |
David Turner | 4f2c554 | 2000-05-12 10:19:41 +0000 | [diff] [blame] | 1273 | args.flags = ft_open_memory; |
David Turner | cda32b7 | 2000-02-10 16:14:35 +0000 | [diff] [blame] | 1274 | args.memory_base = file_base; |
| 1275 | args.memory_size = file_size; |
Werner Lemberg | a3b6c6c | 2000-05-31 06:55:12 +0000 | [diff] [blame] | 1276 | |
David Turner | cda32b7 | 2000-02-10 16:14:35 +0000 | [diff] [blame] | 1277 | return FT_Open_Face( library, &args, face_index, face ); |
David Turner | d2b1f35 | 1999-12-16 23:11:37 +0000 | [diff] [blame] | 1278 | } |
| 1279 | |
Werner Lemberg | 7880dd6 | 2000-01-10 17:19:45 +0000 | [diff] [blame] | 1280 | |
Werner Lemberg | 547a252 | 2000-02-16 08:23:58 +0000 | [diff] [blame] | 1281 | /*************************************************************************/ |
| 1282 | /* */ |
| 1283 | /* <Function> */ |
| 1284 | /* FT_Open_Face */ |
| 1285 | /* */ |
| 1286 | /* <Description> */ |
| 1287 | /* Opens a face object from a given resource and typeface index using */ |
| 1288 | /* an `FT_Open_Args' structure. If the face object doesn't exist, it */ |
| 1289 | /* will be created. */ |
| 1290 | /* */ |
| 1291 | /* <InOut> */ |
| 1292 | /* library :: A handle to the library resource. */ |
| 1293 | /* */ |
| 1294 | /* <Input> */ |
| 1295 | /* args :: A pointer to an `FT_Open_Args' structure which must */ |
| 1296 | /* be filled by the caller. */ |
Werner Lemberg | a3b6c6c | 2000-05-31 06:55:12 +0000 | [diff] [blame] | 1297 | /* */ |
Werner Lemberg | 547a252 | 2000-02-16 08:23:58 +0000 | [diff] [blame] | 1298 | /* face_index :: The index of the face within the resource. The */ |
| 1299 | /* first face has index 0. */ |
| 1300 | /* <Output> */ |
Werner Lemberg | a3b6c6c | 2000-05-31 06:55:12 +0000 | [diff] [blame] | 1301 | /* aface :: A handle to a new face object. */ |
Werner Lemberg | 547a252 | 2000-02-16 08:23:58 +0000 | [diff] [blame] | 1302 | /* */ |
| 1303 | /* <Return> */ |
| 1304 | /* FreeType error code. 0 means success. */ |
| 1305 | /* */ |
| 1306 | /* <Note> */ |
| 1307 | /* Unlike FreeType 1.x, this function automatically creates a glyph */ |
| 1308 | /* slot for the face object which can be accessed directly through */ |
| 1309 | /* `face->glyph'. */ |
| 1310 | /* */ |
| 1311 | /* Note that additional slots can be added to each face with the */ |
| 1312 | /* FT_New_GlyphSlot() API function. Slots are linked in a single */ |
| 1313 | /* list through their `next' field. */ |
| 1314 | /* */ |
| 1315 | /* FT_Open_Face() can be used to determine and/or check the font */ |
| 1316 | /* format of a given font resource. If the `face_index' field is */ |
| 1317 | /* negative, the function will _not_ return any face handle in */ |
| 1318 | /* `*face'. Its return value should be 0 if the resource is */ |
| 1319 | /* recognized, or non-zero if not. */ |
| 1320 | /* */ |
Werner Lemberg | a3b6c6c | 2000-05-31 06:55:12 +0000 | [diff] [blame] | 1321 | FT_EXPORT_FUNC( FT_Error ) FT_Open_Face( FT_Library library, |
| 1322 | FT_Open_Args* args, |
| 1323 | FT_Long face_index, |
| 1324 | FT_Face* aface ) |
David Turner | d2b1f35 | 1999-12-16 23:11:37 +0000 | [diff] [blame] | 1325 | { |
| 1326 | FT_Error error; |
| 1327 | FT_Driver driver; |
| 1328 | FT_Memory memory; |
David Turner | cda32b7 | 2000-02-10 16:14:35 +0000 | [diff] [blame] | 1329 | FT_Stream stream; |
David Turner | d2b1f35 | 1999-12-16 23:11:37 +0000 | [diff] [blame] | 1330 | FT_Face face = 0; |
| 1331 | FT_ListNode node = 0; |
| 1332 | |
Werner Lemberg | 547a252 | 2000-02-16 08:23:58 +0000 | [diff] [blame] | 1333 | |
Werner Lemberg | 2fbf7e4 | 2000-06-02 00:01:14 +0000 | [diff] [blame] | 1334 | /* test for valid `library' and `args' delayed to */ |
| 1335 | /* ft_new_input_stream() */ |
David Turner | d2b1f35 | 1999-12-16 23:11:37 +0000 | [diff] [blame] | 1336 | |
Werner Lemberg | 2fbf7e4 | 2000-06-02 00:01:14 +0000 | [diff] [blame] | 1337 | if ( !aface ) |
| 1338 | return FT_Err_Invalid_Argument; |
| 1339 | |
| 1340 | *aface = 0; |
David Turner | d2b1f35 | 1999-12-16 23:11:37 +0000 | [diff] [blame] | 1341 | |
David Turner | cda32b7 | 2000-02-10 16:14:35 +0000 | [diff] [blame] | 1342 | /* create input stream */ |
| 1343 | error = ft_new_input_stream( library, args, &stream ); |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 1344 | if ( error ) goto Exit; |
David Turner | cda32b7 | 2000-02-10 16:14:35 +0000 | [diff] [blame] | 1345 | |
David Turner | d2b1f35 | 1999-12-16 23:11:37 +0000 | [diff] [blame] | 1346 | memory = library->memory; |
| 1347 | |
Werner Lemberg | a3b6c6c | 2000-05-31 06:55:12 +0000 | [diff] [blame] | 1348 | /* If the font driver is specified in the `args' structure, use */ |
Werner Lemberg | 547a252 | 2000-02-16 08:23:58 +0000 | [diff] [blame] | 1349 | /* it. Otherwise, we'll scan the list of registered drivers. */ |
David Turner | 4f2c554 | 2000-05-12 10:19:41 +0000 | [diff] [blame] | 1350 | if ( args->flags & ft_open_driver && args->driver ) |
David Turner | 7663f22 | 2000-02-13 13:37:38 +0000 | [diff] [blame] | 1351 | { |
Werner Lemberg | a929ba9 | 2000-06-25 06:47:11 +0000 | [diff] [blame] | 1352 | driver = FT_DRIVER( args->driver ); |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 1353 | |
| 1354 | /* not all modules are drivers, so check... */ |
Werner Lemberg | a929ba9 | 2000-06-25 06:47:11 +0000 | [diff] [blame] | 1355 | if ( FT_MODULE_IS_DRIVER( driver ) ) |
David Turner | 7663f22 | 2000-02-13 13:37:38 +0000 | [diff] [blame] | 1356 | { |
David Turner | 4f2c554 | 2000-05-12 10:19:41 +0000 | [diff] [blame] | 1357 | FT_Int num_params = 0; |
| 1358 | FT_Parameter* params = 0; |
David Turner | e49ab25 | 2000-05-16 23:44:38 +0000 | [diff] [blame] | 1359 | |
Werner Lemberg | a929ba9 | 2000-06-25 06:47:11 +0000 | [diff] [blame] | 1360 | |
David Turner | 4f2c554 | 2000-05-12 10:19:41 +0000 | [diff] [blame] | 1361 | if ( args->flags & ft_open_params ) |
| 1362 | { |
| 1363 | num_params = args->num_params; |
| 1364 | params = args->params; |
| 1365 | } |
David Turner | e49ab25 | 2000-05-16 23:44:38 +0000 | [diff] [blame] | 1366 | |
David Turner | 4f2c554 | 2000-05-12 10:19:41 +0000 | [diff] [blame] | 1367 | error = open_face( driver, stream, face_index, |
| 1368 | num_params, params, &face ); |
Werner Lemberg | 547a252 | 2000-02-16 08:23:58 +0000 | [diff] [blame] | 1369 | if ( !error ) |
| 1370 | goto Success; |
David Turner | 7663f22 | 2000-02-13 13:37:38 +0000 | [diff] [blame] | 1371 | } |
| 1372 | else |
| 1373 | error = FT_Err_Invalid_Handle; |
| 1374 | |
David Turner | 2a98b3c | 2000-06-23 13:47:55 +0000 | [diff] [blame] | 1375 | ft_done_stream( &stream ); |
David Turner | 7663f22 | 2000-02-13 13:37:38 +0000 | [diff] [blame] | 1376 | goto Fail; |
| 1377 | } |
Just van Rossum | 1e5754f | 2000-03-02 10:52:57 +0000 | [diff] [blame] | 1378 | else |
David Turner | d2b1f35 | 1999-12-16 23:11:37 +0000 | [diff] [blame] | 1379 | { |
| 1380 | /* check each font driver for an appropriate format */ |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 1381 | FT_Module* cur = library->modules; |
| 1382 | FT_Module* limit = cur + library->num_modules; |
David Turner | d2b1f35 | 1999-12-16 23:11:37 +0000 | [diff] [blame] | 1383 | |
Werner Lemberg | a929ba9 | 2000-06-25 06:47:11 +0000 | [diff] [blame] | 1384 | |
David Turner | d2b1f35 | 1999-12-16 23:11:37 +0000 | [diff] [blame] | 1385 | for ( ; cur < limit; cur++ ) |
| 1386 | { |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 1387 | /* not all modules are font drivers, so check... */ |
Werner Lemberg | a929ba9 | 2000-06-25 06:47:11 +0000 | [diff] [blame] | 1388 | if ( FT_MODULE_IS_DRIVER( cur[0] ) ) |
David Turner | d2b1f35 | 1999-12-16 23:11:37 +0000 | [diff] [blame] | 1389 | { |
David Turner | 4f2c554 | 2000-05-12 10:19:41 +0000 | [diff] [blame] | 1390 | FT_Int num_params = 0; |
| 1391 | FT_Parameter* params = 0; |
David Turner | e49ab25 | 2000-05-16 23:44:38 +0000 | [diff] [blame] | 1392 | |
Werner Lemberg | a929ba9 | 2000-06-25 06:47:11 +0000 | [diff] [blame] | 1393 | driver = FT_DRIVER( cur[0] ); |
Werner Lemberg | a3b6c6c | 2000-05-31 06:55:12 +0000 | [diff] [blame] | 1394 | |
David Turner | 4f2c554 | 2000-05-12 10:19:41 +0000 | [diff] [blame] | 1395 | if ( args->flags & ft_open_params ) |
| 1396 | { |
| 1397 | num_params = args->num_params; |
| 1398 | params = args->params; |
| 1399 | } |
David Turner | e49ab25 | 2000-05-16 23:44:38 +0000 | [diff] [blame] | 1400 | |
David Turner | 4f2c554 | 2000-05-12 10:19:41 +0000 | [diff] [blame] | 1401 | error = open_face( driver, stream, face_index, |
| 1402 | num_params, params, &face ); |
David Turner | d2b1f35 | 1999-12-16 23:11:37 +0000 | [diff] [blame] | 1403 | if ( !error ) |
| 1404 | goto Success; |
| 1405 | |
| 1406 | if ( error != FT_Err_Unknown_File_Format ) |
David Turner | cda32b7 | 2000-02-10 16:14:35 +0000 | [diff] [blame] | 1407 | goto Fail; |
David Turner | d2b1f35 | 1999-12-16 23:11:37 +0000 | [diff] [blame] | 1408 | } |
| 1409 | } |
| 1410 | |
David Turner | 2a98b3c | 2000-06-23 13:47:55 +0000 | [diff] [blame] | 1411 | ft_done_stream( &stream ); |
| 1412 | |
David Turner | d2b1f35 | 1999-12-16 23:11:37 +0000 | [diff] [blame] | 1413 | /* no driver is able to handle this format */ |
| 1414 | error = FT_Err_Unknown_File_Format; |
David Turner | cda32b7 | 2000-02-10 16:14:35 +0000 | [diff] [blame] | 1415 | goto Fail; |
David Turner | d2b1f35 | 1999-12-16 23:11:37 +0000 | [diff] [blame] | 1416 | } |
| 1417 | |
| 1418 | Success: |
David Turner | d2b1f35 | 1999-12-16 23:11:37 +0000 | [diff] [blame] | 1419 | FT_TRACE4(( "FT_New_Face: New face object, adding to list\n" )); |
| 1420 | |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 1421 | /* set the EXTERNAL_STREAM bit for FT_Done_Face */ |
| 1422 | if ( args->flags & ft_open_stream && args->stream ) |
| 1423 | face->face_flags |= FT_FACE_FLAG_EXTERNAL_STREAM; |
| 1424 | |
Werner Lemberg | 547a252 | 2000-02-16 08:23:58 +0000 | [diff] [blame] | 1425 | /* add the face object to its driver's list */ |
David Turner | d2b1f35 | 1999-12-16 23:11:37 +0000 | [diff] [blame] | 1426 | if ( ALLOC( node, sizeof ( *node ) ) ) |
| 1427 | goto Fail; |
| 1428 | |
| 1429 | node->data = face; |
Werner Lemberg | a3b6c6c | 2000-05-31 06:55:12 +0000 | [diff] [blame] | 1430 | /* don't assume driver is the same as face->driver, so use */ |
| 1431 | /* face->driver instead. */ |
Just van Rossum | 7eef536 | 2000-03-05 16:07:58 +0000 | [diff] [blame] | 1432 | FT_List_Add( &face->driver->faces_list, node ); |
David Turner | d2b1f35 | 1999-12-16 23:11:37 +0000 | [diff] [blame] | 1433 | |
Werner Lemberg | 547a252 | 2000-02-16 08:23:58 +0000 | [diff] [blame] | 1434 | /* now allocate a glyph slot object for the face */ |
David Turner | d2b1f35 | 1999-12-16 23:11:37 +0000 | [diff] [blame] | 1435 | { |
| 1436 | FT_GlyphSlot slot; |
| 1437 | |
Werner Lemberg | 547a252 | 2000-02-16 08:23:58 +0000 | [diff] [blame] | 1438 | |
David Turner | d2b1f35 | 1999-12-16 23:11:37 +0000 | [diff] [blame] | 1439 | FT_TRACE4(( "FT_Open_Face: Creating glyph slot\n" )); |
| 1440 | error = FT_New_GlyphSlot( face, &slot ); |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 1441 | if ( error ) goto Fail; |
| 1442 | |
| 1443 | face->glyph = slot; |
David Turner | d2b1f35 | 1999-12-16 23:11:37 +0000 | [diff] [blame] | 1444 | } |
Werner Lemberg | 7880dd6 | 2000-01-10 17:19:45 +0000 | [diff] [blame] | 1445 | |
Werner Lemberg | a3b6c6c | 2000-05-31 06:55:12 +0000 | [diff] [blame] | 1446 | /* finally, allocate a size object for the face */ |
David Turner | d2b1f35 | 1999-12-16 23:11:37 +0000 | [diff] [blame] | 1447 | { |
| 1448 | FT_Size size; |
| 1449 | |
Werner Lemberg | 547a252 | 2000-02-16 08:23:58 +0000 | [diff] [blame] | 1450 | |
David Turner | d2b1f35 | 1999-12-16 23:11:37 +0000 | [diff] [blame] | 1451 | FT_TRACE4(( "FT_Open_Face: Creating size object\n" )); |
| 1452 | error = FT_New_Size( face, &size ); |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 1453 | if ( error ) goto Fail; |
| 1454 | |
| 1455 | face->size = size; |
David Turner | d2b1f35 | 1999-12-16 23:11:37 +0000 | [diff] [blame] | 1456 | } |
Werner Lemberg | 7880dd6 | 2000-01-10 17:19:45 +0000 | [diff] [blame] | 1457 | |
Werner Lemberg | a3b6c6c | 2000-05-31 06:55:12 +0000 | [diff] [blame] | 1458 | /* initialize transformation for convenience functions */ |
David Turner | 37379e2 | 2000-03-28 11:22:31 +0000 | [diff] [blame] | 1459 | face->transform_matrix.xx = 0x10000L; |
| 1460 | face->transform_matrix.xy = 0; |
| 1461 | face->transform_matrix.yx = 0; |
| 1462 | face->transform_matrix.yy = 0x10000L; |
| 1463 | |
| 1464 | face->transform_delta.x = 0; |
| 1465 | face->transform_delta.y = 0; |
| 1466 | |
David Turner | d2b1f35 | 1999-12-16 23:11:37 +0000 | [diff] [blame] | 1467 | *aface = face; |
| 1468 | goto Exit; |
| 1469 | |
| 1470 | Fail: |
| 1471 | FT_Done_Face( face ); |
| 1472 | |
David Turner | d2b1f35 | 1999-12-16 23:11:37 +0000 | [diff] [blame] | 1473 | Exit: |
| 1474 | FT_TRACE4(( "FT_Open_Face: Return %d\n", error )); |
| 1475 | return error; |
| 1476 | } |
| 1477 | |
| 1478 | |
| 1479 | /*************************************************************************/ |
| 1480 | /* */ |
| 1481 | /* <Function> */ |
David Turner | 7663f22 | 2000-02-13 13:37:38 +0000 | [diff] [blame] | 1482 | /* FT_Attach_File */ |
| 1483 | /* */ |
| 1484 | /* <Description> */ |
Werner Lemberg | 547a252 | 2000-02-16 08:23:58 +0000 | [diff] [blame] | 1485 | /* `Attaches' a given font file to an existing face. This is usually */ |
| 1486 | /* to read additional information for a single face object. For */ |
David Turner | 7663f22 | 2000-02-13 13:37:38 +0000 | [diff] [blame] | 1487 | /* example, it is used to read the AFM files that come with Type 1 */ |
Werner Lemberg | 547a252 | 2000-02-16 08:23:58 +0000 | [diff] [blame] | 1488 | /* fonts in order to add kerning data and other metrics. */ |
| 1489 | /* */ |
| 1490 | /* <InOut> */ |
| 1491 | /* face :: The target face object. */ |
David Turner | 7663f22 | 2000-02-13 13:37:38 +0000 | [diff] [blame] | 1492 | /* */ |
| 1493 | /* <Input> */ |
Werner Lemberg | 547a252 | 2000-02-16 08:23:58 +0000 | [diff] [blame] | 1494 | /* filepathname :: An 8-bit pathname naming the `metrics' file. */ |
David Turner | 7663f22 | 2000-02-13 13:37:38 +0000 | [diff] [blame] | 1495 | /* */ |
| 1496 | /* <Return> */ |
Werner Lemberg | 547a252 | 2000-02-16 08:23:58 +0000 | [diff] [blame] | 1497 | /* FreeType error code. 0 means success. */ |
David Turner | 7663f22 | 2000-02-13 13:37:38 +0000 | [diff] [blame] | 1498 | /* */ |
| 1499 | /* <Note> */ |
| 1500 | /* If your font file is in memory, or if you want to provide your */ |
Werner Lemberg | 547a252 | 2000-02-16 08:23:58 +0000 | [diff] [blame] | 1501 | /* own input stream object, use FT_Attach_Stream(). */ |
David Turner | 7663f22 | 2000-02-13 13:37:38 +0000 | [diff] [blame] | 1502 | /* */ |
Werner Lemberg | 547a252 | 2000-02-16 08:23:58 +0000 | [diff] [blame] | 1503 | /* The meaning of the `attach' action (i.e., what really happens when */ |
| 1504 | /* the new file is read) is not fixed by FreeType itself. It really */ |
David Turner | 7663f22 | 2000-02-13 13:37:38 +0000 | [diff] [blame] | 1505 | /* depends on the font format (and thus the font driver). */ |
| 1506 | /* */ |
Werner Lemberg | 547a252 | 2000-02-16 08:23:58 +0000 | [diff] [blame] | 1507 | /* Client applications are expected to know what they are doing */ |
Werner Lemberg | a3b6c6c | 2000-05-31 06:55:12 +0000 | [diff] [blame] | 1508 | /* when invoking this function. Most drivers simply do not implement */ |
Werner Lemberg | 547a252 | 2000-02-16 08:23:58 +0000 | [diff] [blame] | 1509 | /* file attachments. */ |
David Turner | 7663f22 | 2000-02-13 13:37:38 +0000 | [diff] [blame] | 1510 | /* */ |
Werner Lemberg | a3b6c6c | 2000-05-31 06:55:12 +0000 | [diff] [blame] | 1511 | FT_EXPORT_FUNC( FT_Error ) FT_Attach_File( FT_Face face, |
| 1512 | const char* filepathname ) |
David Turner | 7663f22 | 2000-02-13 13:37:38 +0000 | [diff] [blame] | 1513 | { |
David Turner | 37379e2 | 2000-03-28 11:22:31 +0000 | [diff] [blame] | 1514 | FT_Open_Args open; |
David Turner | 7663f22 | 2000-02-13 13:37:38 +0000 | [diff] [blame] | 1515 | |
Werner Lemberg | a3b6c6c | 2000-05-31 06:55:12 +0000 | [diff] [blame] | 1516 | |
Werner Lemberg | 2fbf7e4 | 2000-06-02 00:01:14 +0000 | [diff] [blame] | 1517 | /* test for valid `face' delayed to FT_Attach_Stream() */ |
| 1518 | |
| 1519 | if ( !filepathname ) |
| 1520 | return FT_Err_Invalid_Argument; |
| 1521 | |
David Turner | 4f2c554 | 2000-05-12 10:19:41 +0000 | [diff] [blame] | 1522 | open.flags = ft_open_pathname; |
| 1523 | open.pathname = (char*)filepathname; |
Werner Lemberg | a3b6c6c | 2000-05-31 06:55:12 +0000 | [diff] [blame] | 1524 | |
David Turner | 7663f22 | 2000-02-13 13:37:38 +0000 | [diff] [blame] | 1525 | return FT_Attach_Stream( face, &open ); |
| 1526 | } |
Werner Lemberg | 547a252 | 2000-02-16 08:23:58 +0000 | [diff] [blame] | 1527 | |
David Turner | e49ab25 | 2000-05-16 23:44:38 +0000 | [diff] [blame] | 1528 | |
David Turner | 7663f22 | 2000-02-13 13:37:38 +0000 | [diff] [blame] | 1529 | /*************************************************************************/ |
| 1530 | /* */ |
| 1531 | /* <Function> */ |
| 1532 | /* FT_Attach_Stream */ |
| 1533 | /* */ |
| 1534 | /* <Description> */ |
Werner Lemberg | a3b6c6c | 2000-05-31 06:55:12 +0000 | [diff] [blame] | 1535 | /* This function is similar to FT_Attach_File() with the exception */ |
David Turner | 7663f22 | 2000-02-13 13:37:38 +0000 | [diff] [blame] | 1536 | /* that it reads the attachment from an arbitrary stream. */ |
| 1537 | /* */ |
| 1538 | /* <Input> */ |
Werner Lemberg | a3b6c6c | 2000-05-31 06:55:12 +0000 | [diff] [blame] | 1539 | /* face :: The target face object. */ |
David Turner | 7663f22 | 2000-02-13 13:37:38 +0000 | [diff] [blame] | 1540 | /* */ |
Werner Lemberg | a3b6c6c | 2000-05-31 06:55:12 +0000 | [diff] [blame] | 1541 | /* parameters :: A pointer to an FT_Open_Args structure used to */ |
| 1542 | /* describe the input stream to FreeType. */ |
David Turner | 7663f22 | 2000-02-13 13:37:38 +0000 | [diff] [blame] | 1543 | /* <Return> */ |
Werner Lemberg | a3b6c6c | 2000-05-31 06:55:12 +0000 | [diff] [blame] | 1544 | /* FreeType error code. 0 means success. */ |
David Turner | 7663f22 | 2000-02-13 13:37:38 +0000 | [diff] [blame] | 1545 | /* */ |
Werner Lemberg | a3b6c6c | 2000-05-31 06:55:12 +0000 | [diff] [blame] | 1546 | /* <Note> */ |
| 1547 | /* The meaning of the `attach' (i.e. what really happens when the */ |
| 1548 | /* new file is read) is not fixed by FreeType itself. It really */ |
David Turner | 7663f22 | 2000-02-13 13:37:38 +0000 | [diff] [blame] | 1549 | /* depends on the font format (and thus the font driver). */ |
| 1550 | /* */ |
Werner Lemberg | a3b6c6c | 2000-05-31 06:55:12 +0000 | [diff] [blame] | 1551 | /* Client applications are expected to know what they are doing */ |
| 1552 | /* when invoking this function. Most drivers simply do not implement */ |
| 1553 | /* file attachments. */ |
David Turner | 7663f22 | 2000-02-13 13:37:38 +0000 | [diff] [blame] | 1554 | /* */ |
Werner Lemberg | a3b6c6c | 2000-05-31 06:55:12 +0000 | [diff] [blame] | 1555 | FT_EXPORT_FUNC( FT_Error ) FT_Attach_Stream( FT_Face face, |
| 1556 | FT_Open_Args* parameters ) |
David Turner | 7663f22 | 2000-02-13 13:37:38 +0000 | [diff] [blame] | 1557 | { |
| 1558 | FT_Stream stream; |
| 1559 | FT_Error error; |
| 1560 | FT_Driver driver; |
David Turner | e49ab25 | 2000-05-16 23:44:38 +0000 | [diff] [blame] | 1561 | |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 1562 | FT_Driver_Class* clazz; |
Werner Lemberg | a3b6c6c | 2000-05-31 06:55:12 +0000 | [diff] [blame] | 1563 | |
Werner Lemberg | a929ba9 | 2000-06-25 06:47:11 +0000 | [diff] [blame] | 1564 | |
Werner Lemberg | 2fbf7e4 | 2000-06-02 00:01:14 +0000 | [diff] [blame] | 1565 | /* test for valid `parameters' delayed to ft_new_input_stream() */ |
| 1566 | |
| 1567 | if ( !face ) |
| 1568 | return FT_Err_Invalid_Face_Handle; |
David Turner | e49ab25 | 2000-05-16 23:44:38 +0000 | [diff] [blame] | 1569 | |
David Turner | 7663f22 | 2000-02-13 13:37:38 +0000 | [diff] [blame] | 1570 | driver = face->driver; |
Werner Lemberg | 2fbf7e4 | 2000-06-02 00:01:14 +0000 | [diff] [blame] | 1571 | if ( !driver ) |
| 1572 | return FT_Err_Invalid_Driver_Handle; |
| 1573 | |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 1574 | error = ft_new_input_stream( driver->root.library, parameters, &stream ); |
Werner Lemberg | a3b6c6c | 2000-05-31 06:55:12 +0000 | [diff] [blame] | 1575 | if ( error ) |
| 1576 | goto Exit; |
David Turner | e49ab25 | 2000-05-16 23:44:38 +0000 | [diff] [blame] | 1577 | |
David Turner | 7663f22 | 2000-02-13 13:37:38 +0000 | [diff] [blame] | 1578 | /* we implement FT_Attach_Stream in each driver through the */ |
Werner Lemberg | a3b6c6c | 2000-05-31 06:55:12 +0000 | [diff] [blame] | 1579 | /* `attach_file' interface */ |
| 1580 | |
David Turner | 7663f22 | 2000-02-13 13:37:38 +0000 | [diff] [blame] | 1581 | error = FT_Err_Unimplemented_Feature; |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 1582 | clazz = driver->clazz; |
Werner Lemberg | a929ba9 | 2000-06-25 06:47:11 +0000 | [diff] [blame] | 1583 | if ( clazz->attach_file ) |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 1584 | error = clazz->attach_file( face, stream ); |
David Turner | e49ab25 | 2000-05-16 23:44:38 +0000 | [diff] [blame] | 1585 | |
David Turner | 7663f22 | 2000-02-13 13:37:38 +0000 | [diff] [blame] | 1586 | /* close the attached stream */ |
Werner Lemberg | a929ba9 | 2000-06-25 06:47:11 +0000 | [diff] [blame] | 1587 | if ( !parameters->stream || ( parameters->flags & ft_open_stream ) ) |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 1588 | ft_done_stream( &stream ); |
David Turner | e49ab25 | 2000-05-16 23:44:38 +0000 | [diff] [blame] | 1589 | |
David Turner | 7663f22 | 2000-02-13 13:37:38 +0000 | [diff] [blame] | 1590 | Exit: |
| 1591 | return error; |
| 1592 | } |
| 1593 | |
| 1594 | |
David Turner | 7663f22 | 2000-02-13 13:37:38 +0000 | [diff] [blame] | 1595 | /*************************************************************************/ |
| 1596 | /* */ |
| 1597 | /* <Function> */ |
David Turner | d2b1f35 | 1999-12-16 23:11:37 +0000 | [diff] [blame] | 1598 | /* FT_Done_Face */ |
| 1599 | /* */ |
| 1600 | /* <Description> */ |
| 1601 | /* Discards a given face object, as well as all of its child slots */ |
| 1602 | /* and sizes. */ |
| 1603 | /* */ |
| 1604 | /* <Input> */ |
| 1605 | /* face :: A handle to a target face object. */ |
| 1606 | /* */ |
| 1607 | /* <Return> */ |
Werner Lemberg | a3b6c6c | 2000-05-31 06:55:12 +0000 | [diff] [blame] | 1608 | /* FreeType error code. 0 means success. */ |
David Turner | d2b1f35 | 1999-12-16 23:11:37 +0000 | [diff] [blame] | 1609 | /* */ |
Werner Lemberg | a3b6c6c | 2000-05-31 06:55:12 +0000 | [diff] [blame] | 1610 | FT_EXPORT_FUNC( FT_Error ) FT_Done_Face( FT_Face face ) |
David Turner | d2b1f35 | 1999-12-16 23:11:37 +0000 | [diff] [blame] | 1611 | { |
Werner Lemberg | a929ba9 | 2000-06-25 06:47:11 +0000 | [diff] [blame] | 1612 | FT_Error error; |
| 1613 | FT_Driver driver; |
| 1614 | FT_Memory memory; |
| 1615 | FT_ListNode node; |
| 1616 | |
David Turner | d2b1f35 | 1999-12-16 23:11:37 +0000 | [diff] [blame] | 1617 | |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 1618 | error = FT_Err_Invalid_Face_Handle; |
| 1619 | if ( face && face->driver ) |
David Turner | d2b1f35 | 1999-12-16 23:11:37 +0000 | [diff] [blame] | 1620 | { |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 1621 | driver = face->driver; |
| 1622 | memory = driver->root.memory; |
| 1623 | |
| 1624 | /* find face in driver's list */ |
| 1625 | node = FT_List_Find( &driver->faces_list, face ); |
| 1626 | if ( node ) |
| 1627 | { |
| 1628 | /* remove face object from the driver's list */ |
| 1629 | FT_List_Remove( &driver->faces_list, node ); |
| 1630 | FREE( node ); |
| 1631 | |
| 1632 | /* now destroy the object proper */ |
| 1633 | destroy_face( memory, face, driver ); |
| 1634 | error = FT_Err_Ok; |
| 1635 | } |
David Turner | d2b1f35 | 1999-12-16 23:11:37 +0000 | [diff] [blame] | 1636 | } |
David Turner | d2b1f35 | 1999-12-16 23:11:37 +0000 | [diff] [blame] | 1637 | return error; |
| 1638 | } |
| 1639 | |
| 1640 | |
| 1641 | /*************************************************************************/ |
| 1642 | /* */ |
| 1643 | /* <Function> */ |
| 1644 | /* FT_New_Size */ |
| 1645 | /* */ |
| 1646 | /* <Description> */ |
| 1647 | /* Creates a new size object from a given face object. */ |
| 1648 | /* */ |
| 1649 | /* <Input> */ |
| 1650 | /* face :: A handle to a parent face object. */ |
| 1651 | /* */ |
| 1652 | /* <Output> */ |
Werner Lemberg | a3b6c6c | 2000-05-31 06:55:12 +0000 | [diff] [blame] | 1653 | /* asize :: A handle to a new size object. */ |
David Turner | d2b1f35 | 1999-12-16 23:11:37 +0000 | [diff] [blame] | 1654 | /* */ |
| 1655 | /* <Return> */ |
Werner Lemberg | a3b6c6c | 2000-05-31 06:55:12 +0000 | [diff] [blame] | 1656 | /* FreeType error code. 0 means success. */ |
David Turner | d2b1f35 | 1999-12-16 23:11:37 +0000 | [diff] [blame] | 1657 | /* */ |
Werner Lemberg | a3b6c6c | 2000-05-31 06:55:12 +0000 | [diff] [blame] | 1658 | FT_EXPORT_FUNC( FT_Error ) FT_New_Size( FT_Face face, |
| 1659 | FT_Size* asize ) |
David Turner | d2b1f35 | 1999-12-16 23:11:37 +0000 | [diff] [blame] | 1660 | { |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 1661 | FT_Error error; |
| 1662 | FT_Memory memory; |
| 1663 | FT_Driver driver; |
| 1664 | FT_Driver_Class* clazz; |
David Turner | d2b1f35 | 1999-12-16 23:11:37 +0000 | [diff] [blame] | 1665 | |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 1666 | FT_Size size = 0; |
| 1667 | FT_ListNode node = 0; |
Werner Lemberg | 2fbf7e4 | 2000-06-02 00:01:14 +0000 | [diff] [blame] | 1668 | |
Werner Lemberg | a929ba9 | 2000-06-25 06:47:11 +0000 | [diff] [blame] | 1669 | |
Werner Lemberg | 2fbf7e4 | 2000-06-02 00:01:14 +0000 | [diff] [blame] | 1670 | *asize = 0; |
| 1671 | |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 1672 | if ( !face || !asize || !face->driver ) |
| 1673 | return FT_Err_Invalid_Handle; |
Werner Lemberg | 2fbf7e4 | 2000-06-02 00:01:14 +0000 | [diff] [blame] | 1674 | |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 1675 | driver = face->driver; |
| 1676 | clazz = driver->clazz; |
| 1677 | memory = face->memory; |
David Turner | d2b1f35 | 1999-12-16 23:11:37 +0000 | [diff] [blame] | 1678 | |
| 1679 | /* Allocate new size object and perform basic initialisation */ |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 1680 | if ( ALLOC( size, clazz->size_object_size ) || |
| 1681 | ALLOC( node, sizeof ( FT_ListNodeRec ) ) ) |
David Turner | d2b1f35 | 1999-12-16 23:11:37 +0000 | [diff] [blame] | 1682 | goto Exit; |
| 1683 | |
| 1684 | size->face = face; |
| 1685 | |
Werner Lemberg | a929ba9 | 2000-06-25 06:47:11 +0000 | [diff] [blame] | 1686 | if ( clazz->init_size ) |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 1687 | error = clazz->init_size( size ); |
David Turner | d2b1f35 | 1999-12-16 23:11:37 +0000 | [diff] [blame] | 1688 | |
| 1689 | /* in case of success, add to the face's list */ |
| 1690 | if ( !error ) |
| 1691 | { |
| 1692 | *asize = size; |
| 1693 | node->data = size; |
| 1694 | FT_List_Add( &face->sizes_list, node ); |
David Turner | d2b1f35 | 1999-12-16 23:11:37 +0000 | [diff] [blame] | 1695 | } |
| 1696 | |
| 1697 | Exit: |
| 1698 | if ( error ) |
| 1699 | { |
| 1700 | FREE( node ); |
| 1701 | FREE( size ); |
| 1702 | } |
| 1703 | |
| 1704 | return error; |
| 1705 | } |
| 1706 | |
| 1707 | |
| 1708 | /*************************************************************************/ |
| 1709 | /* */ |
| 1710 | /* <Function> */ |
| 1711 | /* FT_Done_Size */ |
| 1712 | /* */ |
| 1713 | /* <Description> */ |
| 1714 | /* Discards a given size object. */ |
| 1715 | /* */ |
| 1716 | /* <Input> */ |
Werner Lemberg | a3b6c6c | 2000-05-31 06:55:12 +0000 | [diff] [blame] | 1717 | /* size :: A handle to a target size object. */ |
David Turner | d2b1f35 | 1999-12-16 23:11:37 +0000 | [diff] [blame] | 1718 | /* */ |
| 1719 | /* <Return> */ |
Werner Lemberg | a3b6c6c | 2000-05-31 06:55:12 +0000 | [diff] [blame] | 1720 | /* FreeType error code. 0 means success. */ |
David Turner | d2b1f35 | 1999-12-16 23:11:37 +0000 | [diff] [blame] | 1721 | /* */ |
Werner Lemberg | a3b6c6c | 2000-05-31 06:55:12 +0000 | [diff] [blame] | 1722 | FT_EXPORT_FUNC( FT_Error ) FT_Done_Size( FT_Size size ) |
David Turner | d2b1f35 | 1999-12-16 23:11:37 +0000 | [diff] [blame] | 1723 | { |
| 1724 | FT_Error error; |
| 1725 | FT_Driver driver; |
| 1726 | FT_Memory memory; |
| 1727 | FT_Face face; |
| 1728 | FT_ListNode node; |
| 1729 | |
| 1730 | |
Werner Lemberg | 2fbf7e4 | 2000-06-02 00:01:14 +0000 | [diff] [blame] | 1731 | if ( !size ) |
David Turner | d2b1f35 | 1999-12-16 23:11:37 +0000 | [diff] [blame] | 1732 | return FT_Err_Invalid_Size_Handle; |
| 1733 | |
Werner Lemberg | 2fbf7e4 | 2000-06-02 00:01:14 +0000 | [diff] [blame] | 1734 | face = size->face; |
| 1735 | if ( !face ) |
| 1736 | return FT_Err_Invalid_Face_Handle; |
| 1737 | |
| 1738 | driver = face->driver; |
David Turner | d2b1f35 | 1999-12-16 23:11:37 +0000 | [diff] [blame] | 1739 | if ( !driver ) |
| 1740 | return FT_Err_Invalid_Driver_Handle; |
| 1741 | |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 1742 | memory = driver->root.memory; |
David Turner | d2b1f35 | 1999-12-16 23:11:37 +0000 | [diff] [blame] | 1743 | |
| 1744 | error = FT_Err_Ok; |
David Turner | d2b1f35 | 1999-12-16 23:11:37 +0000 | [diff] [blame] | 1745 | node = FT_List_Find( &face->sizes_list, size ); |
| 1746 | if ( node ) |
| 1747 | { |
| 1748 | FT_List_Remove( &face->sizes_list, node ); |
| 1749 | FREE( node ); |
| 1750 | |
Werner Lemberg | a3b6c6c | 2000-05-31 06:55:12 +0000 | [diff] [blame] | 1751 | if ( face->size == size ) |
David Turner | d2b1f35 | 1999-12-16 23:11:37 +0000 | [diff] [blame] | 1752 | { |
| 1753 | face->size = 0; |
Werner Lemberg | a3b6c6c | 2000-05-31 06:55:12 +0000 | [diff] [blame] | 1754 | if ( face->sizes_list.head ) |
David Turner | d2b1f35 | 1999-12-16 23:11:37 +0000 | [diff] [blame] | 1755 | face->size = (FT_Size)(face->sizes_list.head->data); |
| 1756 | } |
| 1757 | |
| 1758 | destroy_size( memory, size, driver ); |
| 1759 | } |
| 1760 | else |
| 1761 | error = FT_Err_Invalid_Size_Handle; |
| 1762 | |
| 1763 | return FT_Err_Ok; |
| 1764 | } |
| 1765 | |
| 1766 | |
Werner Lemberg | a929ba9 | 2000-06-25 06:47:11 +0000 | [diff] [blame] | 1767 | static void ft_recompute_scaled_metrics( FT_Face face, |
| 1768 | FT_Size_Metrics* metrics ) |
| 1769 | { |
| 1770 | /* Compute root ascender, descender, test height, and max_advance */ |
| 1771 | metrics->ascender = ( FT_MulFix( face->ascender, |
| 1772 | metrics->y_scale ) + 32 ) & -64; |
| 1773 | |
| 1774 | metrics->descender = ( FT_MulFix( face->descender, |
| 1775 | metrics->y_scale ) + 32 ) & -64; |
| 1776 | |
| 1777 | metrics->height = ( FT_MulFix( face->height, |
| 1778 | metrics->y_scale ) + 32 ) & -64; |
| 1779 | |
| 1780 | metrics->max_advance = ( FT_MulFix( face->max_advance_width, |
| 1781 | metrics->x_scale ) + 32 ) & -64; |
| 1782 | } |
| 1783 | |
| 1784 | |
David Turner | d2b1f35 | 1999-12-16 23:11:37 +0000 | [diff] [blame] | 1785 | /*************************************************************************/ |
| 1786 | /* */ |
| 1787 | /* <Function> */ |
| 1788 | /* FT_Set_Char_Size */ |
| 1789 | /* */ |
| 1790 | /* <Description> */ |
Werner Lemberg | a3b6c6c | 2000-05-31 06:55:12 +0000 | [diff] [blame] | 1791 | /* Sets the character dimensions of a given face object. The */ |
| 1792 | /* `char_width' and `char_height' values are used for the width and */ |
| 1793 | /* height, respectively, expressed in 26.6 fractional points. */ |
| 1794 | /* */ |
| 1795 | /* If the horizontal or vertical resolution values are zero, a */ |
| 1796 | /* default value of 72dpi is used. Similarly, if one of the */ |
| 1797 | /* character dimensions is zero, its value is set equal to the other. */ |
| 1798 | /* */ |
| 1799 | /* <InOut> */ |
| 1800 | /* size :: A handle to a target size object. */ |
David Turner | d2b1f35 | 1999-12-16 23:11:37 +0000 | [diff] [blame] | 1801 | /* */ |
| 1802 | /* <Input> */ |
Werner Lemberg | a3b6c6c | 2000-05-31 06:55:12 +0000 | [diff] [blame] | 1803 | /* char_width :: The character width, in 26.6 fractional points. */ |
| 1804 | /* */ |
| 1805 | /* char_height :: The character height, in 26.6 fractional */ |
| 1806 | /* points. */ |
| 1807 | /* */ |
| 1808 | /* horz_resolution :: The horizontal resolution. */ |
| 1809 | /* */ |
| 1810 | /* vert_resolution :: The vertical resolution. */ |
David Turner | d2b1f35 | 1999-12-16 23:11:37 +0000 | [diff] [blame] | 1811 | /* */ |
| 1812 | /* <Return> */ |
Werner Lemberg | a3b6c6c | 2000-05-31 06:55:12 +0000 | [diff] [blame] | 1813 | /* FreeType error code. 0 means success. */ |
David Turner | d2b1f35 | 1999-12-16 23:11:37 +0000 | [diff] [blame] | 1814 | /* */ |
| 1815 | /* <Note> */ |
| 1816 | /* When dealing with fixed-size faces (i.e., non-scalable formats), */ |
| 1817 | /* use the function FT_Set_Pixel_Sizes(). */ |
| 1818 | /* */ |
Werner Lemberg | a3b6c6c | 2000-05-31 06:55:12 +0000 | [diff] [blame] | 1819 | FT_EXPORT_FUNC( FT_Error ) FT_Set_Char_Size( FT_Face face, |
| 1820 | FT_F26Dot6 char_width, |
| 1821 | FT_F26Dot6 char_height, |
| 1822 | FT_UInt horz_resolution, |
| 1823 | FT_UInt vert_resolution ) |
David Turner | d2b1f35 | 1999-12-16 23:11:37 +0000 | [diff] [blame] | 1824 | { |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 1825 | FT_Error error = FT_Err_Ok; |
| 1826 | FT_Driver driver; |
| 1827 | FT_Memory memory; |
| 1828 | FT_Driver_Class* clazz; |
| 1829 | FT_Size_Metrics* metrics; |
| 1830 | FT_Long dim_x, dim_y; |
David Turner | d2b1f35 | 1999-12-16 23:11:37 +0000 | [diff] [blame] | 1831 | |
Werner Lemberg | a3b6c6c | 2000-05-31 06:55:12 +0000 | [diff] [blame] | 1832 | |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 1833 | if ( !face || !face->size || !face->driver ) |
David Turner | d2b1f35 | 1999-12-16 23:11:37 +0000 | [diff] [blame] | 1834 | return FT_Err_Invalid_Face_Handle; |
| 1835 | |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 1836 | driver = face->driver; |
Werner Lemberg | 2fbf7e4 | 2000-06-02 00:01:14 +0000 | [diff] [blame] | 1837 | metrics = &face->size->metrics; |
| 1838 | |
Werner Lemberg | a3b6c6c | 2000-05-31 06:55:12 +0000 | [diff] [blame] | 1839 | if ( !char_width ) |
David Turner | d2b1f35 | 1999-12-16 23:11:37 +0000 | [diff] [blame] | 1840 | char_width = char_height; |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 1841 | |
Werner Lemberg | a3b6c6c | 2000-05-31 06:55:12 +0000 | [diff] [blame] | 1842 | else if ( !char_height ) |
David Turner | d2b1f35 | 1999-12-16 23:11:37 +0000 | [diff] [blame] | 1843 | char_height = char_width; |
Werner Lemberg | 7880dd6 | 2000-01-10 17:19:45 +0000 | [diff] [blame] | 1844 | |
Werner Lemberg | a3b6c6c | 2000-05-31 06:55:12 +0000 | [diff] [blame] | 1845 | if ( !horz_resolution ) |
David Turner | d2b1f35 | 1999-12-16 23:11:37 +0000 | [diff] [blame] | 1846 | horz_resolution = 72; |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 1847 | |
Werner Lemberg | a3b6c6c | 2000-05-31 06:55:12 +0000 | [diff] [blame] | 1848 | if ( !vert_resolution ) |
David Turner | d2b1f35 | 1999-12-16 23:11:37 +0000 | [diff] [blame] | 1849 | vert_resolution = 72; |
| 1850 | |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 1851 | driver = face->driver; |
| 1852 | clazz = driver->clazz; |
| 1853 | memory = driver->root.memory; |
David Turner | d2b1f35 | 1999-12-16 23:11:37 +0000 | [diff] [blame] | 1854 | |
Werner Lemberg | a3b6c6c | 2000-05-31 06:55:12 +0000 | [diff] [blame] | 1855 | /* default processing -- this can be overridden by the driver */ |
| 1856 | if ( char_width < 1 * 64 ) char_width = 1 * 64; |
| 1857 | if ( char_height < 1 * 64 ) char_height = 1 * 64; |
David Turner | d42c68e | 2000-01-27 13:56:02 +0000 | [diff] [blame] | 1858 | |
| 1859 | /* Compute pixel sizes in 26.6 units */ |
Werner Lemberg | a3b6c6c | 2000-05-31 06:55:12 +0000 | [diff] [blame] | 1860 | dim_x = ( ( ( char_width * horz_resolution ) / 72 ) + 32 ) & -64; |
| 1861 | dim_y = ( ( ( char_height * vert_resolution ) / 72 ) + 32 ) & -64; |
David Turner | d42c68e | 2000-01-27 13:56:02 +0000 | [diff] [blame] | 1862 | |
Werner Lemberg | a3b6c6c | 2000-05-31 06:55:12 +0000 | [diff] [blame] | 1863 | metrics->x_ppem = (FT_UShort)(dim_x >> 6); |
| 1864 | metrics->y_ppem = (FT_UShort)(dim_y >> 6); |
David Turner | d42c68e | 2000-01-27 13:56:02 +0000 | [diff] [blame] | 1865 | |
Werner Lemberg | a3b6c6c | 2000-05-31 06:55:12 +0000 | [diff] [blame] | 1866 | metrics->x_scale = 0x10000L; |
| 1867 | metrics->y_scale = 0x10000L; |
| 1868 | |
| 1869 | if ( face->face_flags & FT_FACE_FLAG_SCALABLE ) |
David Turner | d42c68e | 2000-01-27 13:56:02 +0000 | [diff] [blame] | 1870 | { |
| 1871 | metrics->x_scale = FT_DivFix( dim_x, face->units_per_EM ); |
| 1872 | metrics->y_scale = FT_DivFix( dim_y, face->units_per_EM ); |
| 1873 | } |
| 1874 | |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 1875 | ft_recompute_scaled_metrics( face, metrics ); |
| 1876 | |
Werner Lemberg | a929ba9 | 2000-06-25 06:47:11 +0000 | [diff] [blame] | 1877 | if ( clazz->set_char_sizes ) |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 1878 | error = clazz->set_char_sizes( face->size, |
| 1879 | char_width, |
| 1880 | char_height, |
| 1881 | horz_resolution, |
| 1882 | vert_resolution ); |
David Turner | d2b1f35 | 1999-12-16 23:11:37 +0000 | [diff] [blame] | 1883 | return error; |
| 1884 | } |
| 1885 | |
| 1886 | |
| 1887 | /*************************************************************************/ |
| 1888 | /* */ |
| 1889 | /* <Function> */ |
| 1890 | /* FT_Set_Pixel_Sizes */ |
| 1891 | /* */ |
| 1892 | /* <Description> */ |
Werner Lemberg | a3b6c6c | 2000-05-31 06:55:12 +0000 | [diff] [blame] | 1893 | /* Sets the character dimensions of a given face object. The width */ |
David Turner | d2b1f35 | 1999-12-16 23:11:37 +0000 | [diff] [blame] | 1894 | /* and height are expressed in integer pixels. */ |
| 1895 | /* */ |
Werner Lemberg | a3b6c6c | 2000-05-31 06:55:12 +0000 | [diff] [blame] | 1896 | /* If one of the character dimensions is zero, its value is set equal */ |
| 1897 | /* to the other. */ |
| 1898 | /* */ |
| 1899 | /* <InOut> */ |
| 1900 | /* face :: A handle to the target face object. */ |
| 1901 | /* */ |
David Turner | d2b1f35 | 1999-12-16 23:11:37 +0000 | [diff] [blame] | 1902 | /* <Input> */ |
David Turner | d2b1f35 | 1999-12-16 23:11:37 +0000 | [diff] [blame] | 1903 | /* pixel_width :: The character width, in integer pixels. */ |
Werner Lemberg | a3b6c6c | 2000-05-31 06:55:12 +0000 | [diff] [blame] | 1904 | /* */ |
David Turner | d2b1f35 | 1999-12-16 23:11:37 +0000 | [diff] [blame] | 1905 | /* pixel_height :: The character height, in integer pixels. */ |
| 1906 | /* */ |
| 1907 | /* <Return> */ |
Werner Lemberg | a3b6c6c | 2000-05-31 06:55:12 +0000 | [diff] [blame] | 1908 | /* FreeType error code. 0 means success. */ |
David Turner | d2b1f35 | 1999-12-16 23:11:37 +0000 | [diff] [blame] | 1909 | /* */ |
Werner Lemberg | a3b6c6c | 2000-05-31 06:55:12 +0000 | [diff] [blame] | 1910 | FT_EXPORT_FUNC( FT_Error ) FT_Set_Pixel_Sizes( FT_Face face, |
| 1911 | FT_UInt pixel_width, |
| 1912 | FT_UInt pixel_height ) |
David Turner | d2b1f35 | 1999-12-16 23:11:37 +0000 | [diff] [blame] | 1913 | { |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 1914 | FT_Error error = FT_Err_Ok; |
| 1915 | FT_Driver driver; |
| 1916 | FT_Memory memory; |
| 1917 | FT_Driver_Class* clazz; |
| 1918 | FT_Size_Metrics* metrics = &face->size->metrics; |
David Turner | d2b1f35 | 1999-12-16 23:11:37 +0000 | [diff] [blame] | 1919 | |
Werner Lemberg | a3b6c6c | 2000-05-31 06:55:12 +0000 | [diff] [blame] | 1920 | |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 1921 | if ( !face || !face->size || !face->driver ) |
David Turner | d2b1f35 | 1999-12-16 23:11:37 +0000 | [diff] [blame] | 1922 | return FT_Err_Invalid_Face_Handle; |
| 1923 | |
Werner Lemberg | 2fbf7e4 | 2000-06-02 00:01:14 +0000 | [diff] [blame] | 1924 | driver = face->driver; |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 1925 | clazz = driver->clazz; |
| 1926 | memory = driver->root.memory; |
David Turner | d2b1f35 | 1999-12-16 23:11:37 +0000 | [diff] [blame] | 1927 | |
Werner Lemberg | a3b6c6c | 2000-05-31 06:55:12 +0000 | [diff] [blame] | 1928 | /* default processing -- this can be overridden by the driver */ |
| 1929 | if ( pixel_width == 0 ) |
David Turner | 1118720 | 2000-05-26 17:13:23 +0000 | [diff] [blame] | 1930 | pixel_width = pixel_height; |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 1931 | |
Werner Lemberg | a3b6c6c | 2000-05-31 06:55:12 +0000 | [diff] [blame] | 1932 | else if ( pixel_height == 0 ) |
David Turner | 1118720 | 2000-05-26 17:13:23 +0000 | [diff] [blame] | 1933 | pixel_height = pixel_width; |
Werner Lemberg | eb81e37 | 2000-06-03 06:03:11 +0000 | [diff] [blame] | 1934 | |
David Turner | d42c68e | 2000-01-27 13:56:02 +0000 | [diff] [blame] | 1935 | if ( pixel_width < 1 ) pixel_width = 1; |
| 1936 | if ( pixel_height < 1 ) pixel_height = 1; |
David Turner | d2b1f35 | 1999-12-16 23:11:37 +0000 | [diff] [blame] | 1937 | |
David Turner | d42c68e | 2000-01-27 13:56:02 +0000 | [diff] [blame] | 1938 | metrics->x_ppem = pixel_width; |
| 1939 | metrics->y_ppem = pixel_height; |
| 1940 | |
| 1941 | if ( face->face_flags & FT_FACE_FLAG_SCALABLE ) |
| 1942 | { |
| 1943 | metrics->x_scale = FT_DivFix( metrics->x_ppem << 6, |
| 1944 | face->units_per_EM ); |
| 1945 | |
| 1946 | metrics->y_scale = FT_DivFix( metrics->y_ppem << 6, |
| 1947 | face->units_per_EM ); |
| 1948 | } |
| 1949 | |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 1950 | ft_recompute_scaled_metrics( face, metrics ); |
David Turner | d2b1f35 | 1999-12-16 23:11:37 +0000 | [diff] [blame] | 1951 | |
Werner Lemberg | a929ba9 | 2000-06-25 06:47:11 +0000 | [diff] [blame] | 1952 | if ( clazz->set_pixel_sizes ) |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 1953 | error = clazz->set_pixel_sizes( face->size, |
| 1954 | pixel_width, |
| 1955 | pixel_height ); |
David Turner | d2b1f35 | 1999-12-16 23:11:37 +0000 | [diff] [blame] | 1956 | return error; |
| 1957 | } |
| 1958 | |
Werner Lemberg | a3b6c6c | 2000-05-31 06:55:12 +0000 | [diff] [blame] | 1959 | |
David Turner | d2b1f35 | 1999-12-16 23:11:37 +0000 | [diff] [blame] | 1960 | /*************************************************************************/ |
| 1961 | /* */ |
| 1962 | /* <Function> */ |
| 1963 | /* FT_Get_Kerning */ |
| 1964 | /* */ |
| 1965 | /* <Description> */ |
| 1966 | /* Returns the kerning vector between two glyphs of a same face. */ |
| 1967 | /* */ |
| 1968 | /* <Input> */ |
| 1969 | /* face :: A handle to a source face object. */ |
| 1970 | /* */ |
| 1971 | /* left_glyph :: The index of the left glyph in the kern pair. */ |
| 1972 | /* */ |
| 1973 | /* right_glyph :: The index of the right glyph in the kern pair. */ |
| 1974 | /* */ |
| 1975 | /* <Output> */ |
| 1976 | /* kerning :: The kerning vector. This is in font units for */ |
| 1977 | /* scalable formats, and in pixels for fixed-sizes */ |
| 1978 | /* formats. */ |
| 1979 | /* */ |
| 1980 | /* <Return> */ |
| 1981 | /* FreeType error code. 0 means success. */ |
| 1982 | /* */ |
| 1983 | /* <Note> */ |
| 1984 | /* Only horizontal layouts (left-to-right & right-to-left) are */ |
| 1985 | /* supported by this method. Other layouts, or more sophisticated */ |
| 1986 | /* kernings, are out of the scope of this API function -- they can be */ |
| 1987 | /* implemented through format-specific interfaces. */ |
| 1988 | /* */ |
Werner Lemberg | a3b6c6c | 2000-05-31 06:55:12 +0000 | [diff] [blame] | 1989 | FT_EXPORT_FUNC( FT_Error ) FT_Get_Kerning( FT_Face face, |
| 1990 | FT_UInt left_glyph, |
| 1991 | FT_UInt right_glyph, |
| 1992 | FT_Vector* kerning ) |
David Turner | d2b1f35 | 1999-12-16 23:11:37 +0000 | [diff] [blame] | 1993 | { |
Werner Lemberg | 2fbf7e4 | 2000-06-02 00:01:14 +0000 | [diff] [blame] | 1994 | FT_Error error = FT_Err_Ok; |
David Turner | d2b1f35 | 1999-12-16 23:11:37 +0000 | [diff] [blame] | 1995 | FT_Driver driver; |
| 1996 | FT_Memory memory; |
| 1997 | |
| 1998 | |
| 1999 | if ( !face ) |
Werner Lemberg | 2fbf7e4 | 2000-06-02 00:01:14 +0000 | [diff] [blame] | 2000 | return FT_Err_Invalid_Face_Handle; |
| 2001 | |
| 2002 | if ( !kerning ) |
| 2003 | return FT_Err_Invalid_Argument; |
David Turner | d2b1f35 | 1999-12-16 23:11:37 +0000 | [diff] [blame] | 2004 | |
| 2005 | driver = face->driver; |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 2006 | memory = driver->root.memory; |
David Turner | d2b1f35 | 1999-12-16 23:11:37 +0000 | [diff] [blame] | 2007 | |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 2008 | if ( driver->clazz->get_kerning ) |
David Turner | d2b1f35 | 1999-12-16 23:11:37 +0000 | [diff] [blame] | 2009 | { |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 2010 | error = driver->clazz->get_kerning( face, |
Werner Lemberg | a929ba9 | 2000-06-25 06:47:11 +0000 | [diff] [blame] | 2011 | left_glyph, |
| 2012 | right_glyph, |
| 2013 | kerning ); |
David Turner | d2b1f35 | 1999-12-16 23:11:37 +0000 | [diff] [blame] | 2014 | } |
| 2015 | else |
| 2016 | { |
| 2017 | kerning->x = 0; |
| 2018 | kerning->y = 0; |
David Turner | d2b1f35 | 1999-12-16 23:11:37 +0000 | [diff] [blame] | 2019 | } |
| 2020 | |
David Turner | d2b1f35 | 1999-12-16 23:11:37 +0000 | [diff] [blame] | 2021 | return error; |
| 2022 | } |
| 2023 | |
Werner Lemberg | a3b6c6c | 2000-05-31 06:55:12 +0000 | [diff] [blame] | 2024 | |
David Turner | 0a29c69 | 2000-05-12 17:09:38 +0000 | [diff] [blame] | 2025 | /*************************************************************************/ |
| 2026 | /* */ |
| 2027 | /* <Function> */ |
| 2028 | /* FT_Select_Charmap */ |
| 2029 | /* */ |
| 2030 | /* <Description> */ |
Werner Lemberg | a3b6c6c | 2000-05-31 06:55:12 +0000 | [diff] [blame] | 2031 | /* Selects a given charmap by its encoding tag (as listed in */ |
| 2032 | /* `freetype.h'). */ |
David Turner | 0a29c69 | 2000-05-12 17:09:38 +0000 | [diff] [blame] | 2033 | /* */ |
| 2034 | /* <Input> */ |
| 2035 | /* face :: A handle to the source face object. */ |
Werner Lemberg | a3b6c6c | 2000-05-31 06:55:12 +0000 | [diff] [blame] | 2036 | /* */ |
| 2037 | /* encoding :: A handle to the selected charmap. */ |
David Turner | 0a29c69 | 2000-05-12 17:09:38 +0000 | [diff] [blame] | 2038 | /* */ |
| 2039 | /* <Return> */ |
Werner Lemberg | a3b6c6c | 2000-05-31 06:55:12 +0000 | [diff] [blame] | 2040 | /* FreeType error code. 0 means success. */ |
David Turner | 0a29c69 | 2000-05-12 17:09:38 +0000 | [diff] [blame] | 2041 | /* */ |
| 2042 | /* <Note> */ |
| 2043 | /* This function will return an error if no charmap in the face */ |
Werner Lemberg | a3b6c6c | 2000-05-31 06:55:12 +0000 | [diff] [blame] | 2044 | /* corresponds to the encoding queried here. */ |
David Turner | 0a29c69 | 2000-05-12 17:09:38 +0000 | [diff] [blame] | 2045 | /* */ |
Werner Lemberg | a3b6c6c | 2000-05-31 06:55:12 +0000 | [diff] [blame] | 2046 | FT_EXPORT_FUNC( FT_Error ) FT_Select_Charmap( FT_Face face, |
| 2047 | FT_Encoding encoding ) |
David Turner | 0a29c69 | 2000-05-12 17:09:38 +0000 | [diff] [blame] | 2048 | { |
Werner Lemberg | 2fbf7e4 | 2000-06-02 00:01:14 +0000 | [diff] [blame] | 2049 | FT_CharMap* cur; |
| 2050 | FT_CharMap* limit; |
David Turner | e49ab25 | 2000-05-16 23:44:38 +0000 | [diff] [blame] | 2051 | |
Werner Lemberg | a3b6c6c | 2000-05-31 06:55:12 +0000 | [diff] [blame] | 2052 | |
Werner Lemberg | 2fbf7e4 | 2000-06-02 00:01:14 +0000 | [diff] [blame] | 2053 | if ( !face ) |
| 2054 | return FT_Err_Invalid_Face_Handle; |
| 2055 | |
| 2056 | cur = face->charmaps; |
| 2057 | if ( !cur ) |
| 2058 | return FT_Err_Invalid_CharMap_Handle; |
| 2059 | |
| 2060 | limit = cur + face->num_charmaps; |
| 2061 | |
David Turner | 0a29c69 | 2000-05-12 17:09:38 +0000 | [diff] [blame] | 2062 | for ( ; cur < limit; cur++ ) |
| 2063 | { |
| 2064 | if ( cur[0]->encoding == encoding ) |
| 2065 | { |
| 2066 | face->charmap = cur[0]; |
| 2067 | return 0; |
| 2068 | } |
| 2069 | } |
| 2070 | return FT_Err_Invalid_Argument; |
| 2071 | } |
| 2072 | |
| 2073 | |
| 2074 | /*************************************************************************/ |
| 2075 | /* */ |
| 2076 | /* <Function> */ |
| 2077 | /* FT_Set_Charmap */ |
| 2078 | /* */ |
| 2079 | /* <Description> */ |
| 2080 | /* Selects a given charmap for character code to glyph index */ |
| 2081 | /* decoding. */ |
| 2082 | /* */ |
| 2083 | /* <Input> */ |
| 2084 | /* face :: A handle to the source face object. */ |
Werner Lemberg | a3b6c6c | 2000-05-31 06:55:12 +0000 | [diff] [blame] | 2085 | /* charmap :: A handle to the selected charmap. */ |
David Turner | 0a29c69 | 2000-05-12 17:09:38 +0000 | [diff] [blame] | 2086 | /* */ |
| 2087 | /* <Return> */ |
Werner Lemberg | a3b6c6c | 2000-05-31 06:55:12 +0000 | [diff] [blame] | 2088 | /* FreeType error code. 0 means success. */ |
David Turner | 0a29c69 | 2000-05-12 17:09:38 +0000 | [diff] [blame] | 2089 | /* */ |
| 2090 | /* <Note> */ |
Werner Lemberg | a3b6c6c | 2000-05-31 06:55:12 +0000 | [diff] [blame] | 2091 | /* This function will return an error when the charmap is not part */ |
| 2092 | /* of the face (i.e., if it is not listed in the face->charmaps[] */ |
David Turner | 0a29c69 | 2000-05-12 17:09:38 +0000 | [diff] [blame] | 2093 | /* table). */ |
| 2094 | /* */ |
Werner Lemberg | a3b6c6c | 2000-05-31 06:55:12 +0000 | [diff] [blame] | 2095 | FT_EXPORT_FUNC( FT_Error ) FT_Set_Charmap( FT_Face face, |
| 2096 | FT_CharMap charmap ) |
David Turner | 0a29c69 | 2000-05-12 17:09:38 +0000 | [diff] [blame] | 2097 | { |
Werner Lemberg | 2fbf7e4 | 2000-06-02 00:01:14 +0000 | [diff] [blame] | 2098 | FT_CharMap* cur; |
| 2099 | FT_CharMap* limit; |
David Turner | e49ab25 | 2000-05-16 23:44:38 +0000 | [diff] [blame] | 2100 | |
Werner Lemberg | a3b6c6c | 2000-05-31 06:55:12 +0000 | [diff] [blame] | 2101 | |
Werner Lemberg | 2fbf7e4 | 2000-06-02 00:01:14 +0000 | [diff] [blame] | 2102 | if ( !face ) |
| 2103 | return FT_Err_Invalid_Face_Handle; |
| 2104 | |
| 2105 | cur = face->charmaps; |
| 2106 | if ( !cur ) |
| 2107 | return FT_Err_Invalid_CharMap_Handle; |
| 2108 | |
| 2109 | limit = cur + face->num_charmaps; |
| 2110 | |
David Turner | 0a29c69 | 2000-05-12 17:09:38 +0000 | [diff] [blame] | 2111 | for ( ; cur < limit; cur++ ) |
| 2112 | { |
| 2113 | if ( cur[0] == charmap ) |
| 2114 | { |
| 2115 | face->charmap = cur[0]; |
| 2116 | return 0; |
| 2117 | } |
| 2118 | } |
| 2119 | return FT_Err_Invalid_Argument; |
| 2120 | } |
David Turner | d2b1f35 | 1999-12-16 23:11:37 +0000 | [diff] [blame] | 2121 | |
Werner Lemberg | a3b6c6c | 2000-05-31 06:55:12 +0000 | [diff] [blame] | 2122 | |
David Turner | d2b1f35 | 1999-12-16 23:11:37 +0000 | [diff] [blame] | 2123 | /*************************************************************************/ |
| 2124 | /* */ |
| 2125 | /* <Function> */ |
| 2126 | /* FT_Get_Char_Index */ |
| 2127 | /* */ |
| 2128 | /* <Description> */ |
| 2129 | /* Returns the glyph index of a given character code. This function */ |
| 2130 | /* uses a charmap object to do the translation. */ |
| 2131 | /* */ |
| 2132 | /* <Input> */ |
Werner Lemberg | a3b6c6c | 2000-05-31 06:55:12 +0000 | [diff] [blame] | 2133 | /* face :: A handle to the source face object. */ |
David Turner | d2b1f35 | 1999-12-16 23:11:37 +0000 | [diff] [blame] | 2134 | /* charcode :: The character code. */ |
| 2135 | /* */ |
| 2136 | /* <Return> */ |
| 2137 | /* The glyph index. 0 means `undefined character code'. */ |
| 2138 | /* */ |
Werner Lemberg | 2fbf7e4 | 2000-06-02 00:01:14 +0000 | [diff] [blame] | 2139 | FT_EXPORT_FUNC( FT_UInt ) FT_Get_Char_Index( FT_Face face, |
| 2140 | FT_ULong charcode ) |
David Turner | d2b1f35 | 1999-12-16 23:11:37 +0000 | [diff] [blame] | 2141 | { |
| 2142 | FT_UInt result; |
| 2143 | FT_Driver driver; |
| 2144 | |
Werner Lemberg | a3b6c6c | 2000-05-31 06:55:12 +0000 | [diff] [blame] | 2145 | |
David Turner | d2b1f35 | 1999-12-16 23:11:37 +0000 | [diff] [blame] | 2146 | result = 0; |
| 2147 | if ( face && face->charmap ) |
| 2148 | { |
| 2149 | driver = face->driver; |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 2150 | result = driver->clazz->get_char_index( face->charmap, charcode ); |
David Turner | d2b1f35 | 1999-12-16 23:11:37 +0000 | [diff] [blame] | 2151 | } |
| 2152 | return result; |
| 2153 | } |
| 2154 | |
David Turner | d2b1f35 | 1999-12-16 23:11:37 +0000 | [diff] [blame] | 2155 | |
Werner Lemberg | a3b6c6c | 2000-05-31 06:55:12 +0000 | [diff] [blame] | 2156 | /*************************************************************************/ |
| 2157 | /* */ |
| 2158 | /* <Function> */ |
| 2159 | /* FT_Get_Sfnt_Table */ |
| 2160 | /* */ |
| 2161 | /* <Description> */ |
| 2162 | /* Returns a pointer to a given SFNT table within a face. */ |
| 2163 | /* */ |
| 2164 | /* <Input> */ |
| 2165 | /* face :: A handle to the source face object. */ |
| 2166 | /* tag :: An index of an SFNT table. */ |
| 2167 | /* */ |
| 2168 | /* <Return> */ |
| 2169 | /* A type-less pointer to the table. This will be 0 in case of */ |
| 2170 | /* error, or if the corresponding table was not found *OR* loaded */ |
| 2171 | /* from the file. */ |
| 2172 | /* */ |
| 2173 | /* <Note> */ |
| 2174 | /* The table is owned by the face object, and disappears with it. */ |
| 2175 | /* */ |
| 2176 | /* This function is only useful to access SFNT tables that are loaded */ |
| 2177 | /* by the sfnt/truetype/opentype drivers. See the FT_Sfnt_Tag */ |
| 2178 | /* enumeration in `tttables.h' for a list. */ |
| 2179 | /* */ |
| 2180 | /* You can load any table with a different function.. XXX */ |
| 2181 | /* */ |
| 2182 | FT_EXPORT_FUNC( void* ) FT_Get_Sfnt_Table( FT_Face face, |
| 2183 | FT_Sfnt_Tag tag ) |
David Turner | 99a4d93 | 2000-04-25 16:10:50 +0000 | [diff] [blame] | 2184 | { |
| 2185 | void* table = 0; |
| 2186 | FT_Get_Sfnt_Table_Func func; |
| 2187 | FT_Driver driver; |
David Turner | e49ab25 | 2000-05-16 23:44:38 +0000 | [diff] [blame] | 2188 | |
Werner Lemberg | a3b6c6c | 2000-05-31 06:55:12 +0000 | [diff] [blame] | 2189 | |
| 2190 | if ( !face || !FT_IS_SFNT( face ) ) |
David Turner | 99a4d93 | 2000-04-25 16:10:50 +0000 | [diff] [blame] | 2191 | goto Exit; |
David Turner | e49ab25 | 2000-05-16 23:44:38 +0000 | [diff] [blame] | 2192 | |
David Turner | 99a4d93 | 2000-04-25 16:10:50 +0000 | [diff] [blame] | 2193 | driver = face->driver; |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 2194 | func = (FT_Get_Sfnt_Table_Func)driver->root.clazz->get_interface( |
Werner Lemberg | a929ba9 | 2000-06-25 06:47:11 +0000 | [diff] [blame] | 2195 | FT_MODULE( driver ), "get_sfnt" ); |
Werner Lemberg | a3b6c6c | 2000-05-31 06:55:12 +0000 | [diff] [blame] | 2196 | if ( func ) |
| 2197 | table = func( face, tag ); |
David Turner | e49ab25 | 2000-05-16 23:44:38 +0000 | [diff] [blame] | 2198 | |
David Turner | 99a4d93 | 2000-04-25 16:10:50 +0000 | [diff] [blame] | 2199 | Exit: |
| 2200 | return table; |
David Turner | e49ab25 | 2000-05-16 23:44:38 +0000 | [diff] [blame] | 2201 | } |
David Turner | 99a4d93 | 2000-04-25 16:10:50 +0000 | [diff] [blame] | 2202 | |
| 2203 | |
David Turner | d2b1f35 | 1999-12-16 23:11:37 +0000 | [diff] [blame] | 2204 | /*************************************************************************/ |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 2205 | /*************************************************************************/ |
| 2206 | /*************************************************************************/ |
| 2207 | /**** ****/ |
| 2208 | /**** ****/ |
| 2209 | /**** R E N D E R E R S ****/ |
| 2210 | /**** ****/ |
| 2211 | /**** ****/ |
| 2212 | /*************************************************************************/ |
| 2213 | /*************************************************************************/ |
| 2214 | /*************************************************************************/ |
| 2215 | |
| 2216 | /* lookup a renderer by glyph format in the library's list */ |
David Turner | 74abee8 | 2000-06-27 23:31:53 +0000 | [diff] [blame] | 2217 | BASE_FUNC(FT_Renderer) FT_Lookup_Renderer( FT_Library library, |
| 2218 | FT_Glyph_Format format, |
| 2219 | FT_ListNode *node ) |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 2220 | { |
| 2221 | FT_ListNode cur = library->renderers.head; |
| 2222 | FT_Renderer result = 0; |
Werner Lemberg | a929ba9 | 2000-06-25 06:47:11 +0000 | [diff] [blame] | 2223 | |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 2224 | |
David Turner | 74abee8 | 2000-06-27 23:31:53 +0000 | [diff] [blame] | 2225 | if (node) |
| 2226 | { |
| 2227 | if (*node) |
| 2228 | cur = (*node)->next; |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 2229 | *node = 0; |
David Turner | 74abee8 | 2000-06-27 23:31:53 +0000 | [diff] [blame] | 2230 | } |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 2231 | |
Werner Lemberg | a929ba9 | 2000-06-25 06:47:11 +0000 | [diff] [blame] | 2232 | while ( cur ) |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 2233 | { |
Werner Lemberg | a929ba9 | 2000-06-25 06:47:11 +0000 | [diff] [blame] | 2234 | FT_Renderer renderer = FT_RENDERER( cur->data ); |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 2235 | |
Werner Lemberg | a929ba9 | 2000-06-25 06:47:11 +0000 | [diff] [blame] | 2236 | |
| 2237 | if ( renderer->glyph_format == format ) |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 2238 | { |
Werner Lemberg | a929ba9 | 2000-06-25 06:47:11 +0000 | [diff] [blame] | 2239 | if ( node ) |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 2240 | *node = cur; |
| 2241 | |
| 2242 | result = renderer; |
| 2243 | break; |
| 2244 | } |
David Turner | 74abee8 | 2000-06-27 23:31:53 +0000 | [diff] [blame] | 2245 | cur = cur->next; |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 2246 | } |
Werner Lemberg | a929ba9 | 2000-06-25 06:47:11 +0000 | [diff] [blame] | 2247 | |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 2248 | return result; |
| 2249 | } |
| 2250 | |
| 2251 | |
David Turner | 74abee8 | 2000-06-27 23:31:53 +0000 | [diff] [blame] | 2252 | static FT_Renderer ft_lookup_glyph_renderer( FT_GlyphSlot slot ) |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 2253 | { |
| 2254 | FT_Face face = slot->face; |
Werner Lemberg | a929ba9 | 2000-06-25 06:47:11 +0000 | [diff] [blame] | 2255 | FT_Library library = FT_FACE_LIBRARY( face ); |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 2256 | FT_Renderer result = library->cur_renderer; |
Werner Lemberg | a929ba9 | 2000-06-25 06:47:11 +0000 | [diff] [blame] | 2257 | |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 2258 | |
Werner Lemberg | a929ba9 | 2000-06-25 06:47:11 +0000 | [diff] [blame] | 2259 | if ( !result || result->glyph_format != slot->format ) |
David Turner | 81bb4ad | 2000-06-28 04:19:49 +0000 | [diff] [blame^] | 2260 | result = FT_Lookup_Renderer( library, slot->format, 0 ); |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 2261 | |
| 2262 | return result; |
| 2263 | } |
| 2264 | |
| 2265 | |
| 2266 | static void ft_set_current_renderer( FT_Library library ) |
| 2267 | { |
| 2268 | FT_Renderer renderer; |
| 2269 | |
David Turner | 74abee8 | 2000-06-27 23:31:53 +0000 | [diff] [blame] | 2270 | renderer = FT_Lookup_Renderer( library, ft_glyph_format_outline, 0 ); |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 2271 | library->cur_renderer = renderer; |
| 2272 | } |
| 2273 | |
| 2274 | |
| 2275 | static FT_Error ft_add_renderer( FT_Module module ) |
| 2276 | { |
| 2277 | FT_Library library = module->library; |
| 2278 | FT_Memory memory = library->memory; |
| 2279 | FT_Error error; |
| 2280 | FT_ListNode node; |
| 2281 | |
Werner Lemberg | a929ba9 | 2000-06-25 06:47:11 +0000 | [diff] [blame] | 2282 | if ( ALLOC( node, sizeof ( *node ) ) ) |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 2283 | goto Exit; |
| 2284 | |
| 2285 | { |
Werner Lemberg | a929ba9 | 2000-06-25 06:47:11 +0000 | [diff] [blame] | 2286 | FT_Renderer render = FT_RENDERER( module ); |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 2287 | FT_Renderer_Class* clazz = (FT_Renderer_Class*)module->clazz; |
| 2288 | |
Werner Lemberg | a929ba9 | 2000-06-25 06:47:11 +0000 | [diff] [blame] | 2289 | |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 2290 | render->clazz = clazz; |
| 2291 | render->glyph_format = clazz->glyph_format; |
| 2292 | |
| 2293 | /* allocate raster object if needed */ |
| 2294 | if ( clazz->glyph_format == ft_glyph_format_outline && |
| 2295 | clazz->raster_class->raster_new ) |
| 2296 | { |
| 2297 | error = clazz->raster_class->raster_new( memory, &render->raster ); |
Werner Lemberg | a929ba9 | 2000-06-25 06:47:11 +0000 | [diff] [blame] | 2298 | if ( error ) |
| 2299 | goto Fail; |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 2300 | |
| 2301 | render->raster_render = clazz->raster_class->raster_render; |
| 2302 | render->render = clazz->render_glyph; |
| 2303 | } |
| 2304 | |
| 2305 | /* add to list */ |
| 2306 | node->data = module; |
| 2307 | FT_List_Add( &library->renderers, node ); |
| 2308 | |
| 2309 | ft_set_current_renderer( library ); |
| 2310 | } |
| 2311 | |
| 2312 | Fail: |
Werner Lemberg | a929ba9 | 2000-06-25 06:47:11 +0000 | [diff] [blame] | 2313 | if ( error ) |
| 2314 | FREE( node ); |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 2315 | |
| 2316 | Exit: |
| 2317 | return error; |
| 2318 | } |
| 2319 | |
| 2320 | |
| 2321 | static void ft_remove_renderer( FT_Module module ) |
| 2322 | { |
| 2323 | FT_Library library = module->library; |
| 2324 | FT_Memory memory = library->memory; |
| 2325 | FT_ListNode node; |
| 2326 | |
Werner Lemberg | a929ba9 | 2000-06-25 06:47:11 +0000 | [diff] [blame] | 2327 | |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 2328 | node = FT_List_Find( &library->renderers, module ); |
Werner Lemberg | a929ba9 | 2000-06-25 06:47:11 +0000 | [diff] [blame] | 2329 | if ( node ) |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 2330 | { |
Werner Lemberg | a929ba9 | 2000-06-25 06:47:11 +0000 | [diff] [blame] | 2331 | FT_Renderer render = FT_RENDERER( module ); |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 2332 | |
Werner Lemberg | a929ba9 | 2000-06-25 06:47:11 +0000 | [diff] [blame] | 2333 | |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 2334 | /* release raster object, if any */ |
Werner Lemberg | a929ba9 | 2000-06-25 06:47:11 +0000 | [diff] [blame] | 2335 | if ( render->raster ) |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 2336 | render->clazz->raster_class->raster_done( render->raster ); |
| 2337 | |
| 2338 | /* remove from list */ |
| 2339 | FT_List_Remove( &library->renderers, node ); |
| 2340 | FREE( node ); |
| 2341 | |
| 2342 | ft_set_current_renderer( library ); |
| 2343 | } |
| 2344 | } |
| 2345 | |
| 2346 | |
Werner Lemberg | a929ba9 | 2000-06-25 06:47:11 +0000 | [diff] [blame] | 2347 | /*************************************************************************/ |
| 2348 | /* */ |
| 2349 | /* <Function> */ |
| 2350 | /* FT_Get_Renderer */ |
| 2351 | /* */ |
| 2352 | /* <Description> */ |
| 2353 | /* Retrieves the current renderer for a given glyph format. */ |
| 2354 | /* */ |
| 2355 | /* <Input> */ |
| 2356 | /* library :: A handle to the library object. */ |
| 2357 | /* */ |
| 2358 | /* format :: The glyph format. */ |
| 2359 | /* */ |
| 2360 | /* <Return> */ |
| 2361 | /* A renderer handle. 0 if none found. */ |
| 2362 | /* */ |
| 2363 | /* <Note> */ |
| 2364 | /* An error will be returned if a module already exists by that name, */ |
| 2365 | /* or if the module requires a version of FreeType that is too great. */ |
| 2366 | /* */ |
| 2367 | /* To add a new renderer, simply use FT_Add_Module(). To retrieve a */ |
| 2368 | /* renderer by its name, use FT_Get_Module(). */ |
Werner Lemberg | dcd2e14 | 2000-06-25 07:43:15 +0000 | [diff] [blame] | 2369 | /* */ |
Werner Lemberg | a929ba9 | 2000-06-25 06:47:11 +0000 | [diff] [blame] | 2370 | FT_EXPORT_FUNC( FT_Renderer ) FT_Get_Renderer( FT_Library library, |
| 2371 | FT_Glyph_Format format ) |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 2372 | { |
David Turner | 74abee8 | 2000-06-27 23:31:53 +0000 | [diff] [blame] | 2373 | return FT_Lookup_Renderer( library, format, 0 ); |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 2374 | } |
| 2375 | |
| 2376 | |
Werner Lemberg | a929ba9 | 2000-06-25 06:47:11 +0000 | [diff] [blame] | 2377 | /*************************************************************************/ |
| 2378 | /* */ |
| 2379 | /* <Function> */ |
| 2380 | /* FT_Set_Renderer */ |
| 2381 | /* */ |
| 2382 | /* <Description> */ |
| 2383 | /* Sets the current renderer to use, and set additional mode. */ |
| 2384 | /* */ |
| 2385 | /* <Input> */ |
| 2386 | /* library :: A handle to the library object. */ |
| 2387 | /* */ |
| 2388 | /* renderer :: A handle to the renderer object. */ |
| 2389 | /* */ |
| 2390 | /* num_params :: The number of additional parameters. */ |
| 2391 | /* */ |
| 2392 | /* params :: Additional parameters. */ |
| 2393 | /* */ |
| 2394 | /* <Return> */ |
| 2395 | /* FreeType error code. 0 means success. */ |
| 2396 | /* */ |
| 2397 | /* <Note> */ |
| 2398 | /* In case of success, the renderer will be used to convert glyph */ |
| 2399 | /* images in the renderer's known format into bitmaps. */ |
| 2400 | /* */ |
| 2401 | /* This doesn't change the current renderer for other formats. */ |
| 2402 | /* */ |
| 2403 | FT_EXPORT_DEF( FT_Error ) FT_Set_Renderer( FT_Library library, |
| 2404 | FT_Renderer renderer, |
| 2405 | FT_UInt num_params, |
| 2406 | FT_Parameter* parameters ) |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 2407 | { |
| 2408 | FT_ListNode node; |
| 2409 | FT_Error error = FT_Err_Ok; |
| 2410 | |
Werner Lemberg | a929ba9 | 2000-06-25 06:47:11 +0000 | [diff] [blame] | 2411 | |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 2412 | node = FT_List_Find( &library->renderers, renderer ); |
Werner Lemberg | a929ba9 | 2000-06-25 06:47:11 +0000 | [diff] [blame] | 2413 | if ( !node ) |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 2414 | { |
| 2415 | error = FT_Err_Invalid_Argument; |
| 2416 | goto Exit; |
| 2417 | } |
David Turner | 74abee8 | 2000-06-27 23:31:53 +0000 | [diff] [blame] | 2418 | |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 2419 | FT_List_Up( &library->renderers, node ); |
| 2420 | |
Werner Lemberg | a929ba9 | 2000-06-25 06:47:11 +0000 | [diff] [blame] | 2421 | if ( renderer->glyph_format == ft_glyph_format_outline ) |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 2422 | library->cur_renderer = renderer; |
| 2423 | |
Werner Lemberg | a929ba9 | 2000-06-25 06:47:11 +0000 | [diff] [blame] | 2424 | if ( num_params > 0 ) |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 2425 | { |
| 2426 | FTRenderer_setMode set_mode = renderer->clazz->set_mode; |
| 2427 | |
Werner Lemberg | a929ba9 | 2000-06-25 06:47:11 +0000 | [diff] [blame] | 2428 | |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 2429 | for ( ; num_params > 0; num_params-- ) |
| 2430 | { |
| 2431 | error = set_mode( renderer, parameters->tag, parameters->data ); |
Werner Lemberg | a929ba9 | 2000-06-25 06:47:11 +0000 | [diff] [blame] | 2432 | if ( error ) |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 2433 | break; |
| 2434 | } |
| 2435 | } |
| 2436 | |
| 2437 | Exit: |
| 2438 | return error; |
| 2439 | } |
| 2440 | |
| 2441 | |
David Turner | 74abee8 | 2000-06-27 23:31:53 +0000 | [diff] [blame] | 2442 | /************************************************************************* |
| 2443 | * |
| 2444 | * <Function> |
| 2445 | * FT_Render_Glyph |
| 2446 | * |
| 2447 | * <Description> |
| 2448 | * Converts a given glyph image to a bitmap. It does so by inspecting |
| 2449 | * the glyph image format, find the relevant renderer, and invoke it |
| 2450 | * |
| 2451 | * <Input> |
| 2452 | * slot :: handle to the glyph slot containing the image to |
| 2453 | * convert |
| 2454 | * |
| 2455 | * render_mode :: a set of bit flags indicating which kind of bitmap |
| 2456 | * to render. For now, only 'ft_render_mode_anti_alias' |
| 2457 | * is supported by the available renderers, but others |
| 2458 | * could appear later (e.g. LCD or TV optimised) |
| 2459 | * |
| 2460 | * <Return> |
| 2461 | * Error code. 0 means success. |
| 2462 | * |
| 2463 | * <Note> |
| 2464 | * in case of success, the renderer will be used to convert glyph |
| 2465 | * images in the renderer's known format into bitmaps. |
| 2466 | * |
| 2467 | * This doesn't change the current renderer for other formats.. |
| 2468 | * |
| 2469 | * The slot's native image should be considered lost after the |
| 2470 | * conversion.. |
| 2471 | * |
| 2472 | *************************************************************************/ |
| 2473 | |
| 2474 | LOCAL_FUNC |
| 2475 | FT_Error FT_Render_Glyph_Internal( FT_Library library, |
| 2476 | FT_GlyphSlot slot, |
| 2477 | FT_UInt render_mode ) |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 2478 | { |
| 2479 | FT_Error error = FT_Err_Ok; |
| 2480 | FT_Renderer renderer; |
Werner Lemberg | a929ba9 | 2000-06-25 06:47:11 +0000 | [diff] [blame] | 2481 | |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 2482 | |
David Turner | 74abee8 | 2000-06-27 23:31:53 +0000 | [diff] [blame] | 2483 | /* if it's already a bitmap, no need to do anything */ |
| 2484 | switch (slot->format) |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 2485 | { |
David Turner | 74abee8 | 2000-06-27 23:31:53 +0000 | [diff] [blame] | 2486 | case ft_glyph_format_bitmap: /* already a bitmap, don't do anything */ |
Werner Lemberg | a929ba9 | 2000-06-25 06:47:11 +0000 | [diff] [blame] | 2487 | break; |
David Turner | 74abee8 | 2000-06-27 23:31:53 +0000 | [diff] [blame] | 2488 | |
Werner Lemberg | a929ba9 | 2000-06-25 06:47:11 +0000 | [diff] [blame] | 2489 | default: |
David Turner | 74abee8 | 2000-06-27 23:31:53 +0000 | [diff] [blame] | 2490 | { |
| 2491 | FT_ListNode node = 0; |
| 2492 | FT_Bool update = 0; |
| 2493 | |
Werner Lemberg | a929ba9 | 2000-06-25 06:47:11 +0000 | [diff] [blame] | 2494 | /* small shortcut for the very common case */ |
David Turner | 74abee8 | 2000-06-27 23:31:53 +0000 | [diff] [blame] | 2495 | if (slot->format == ft_glyph_format_outline) |
| 2496 | { |
Werner Lemberg | a929ba9 | 2000-06-25 06:47:11 +0000 | [diff] [blame] | 2497 | renderer = library->cur_renderer; |
David Turner | 74abee8 | 2000-06-27 23:31:53 +0000 | [diff] [blame] | 2498 | node = library->renderers.head; |
| 2499 | } |
Werner Lemberg | a929ba9 | 2000-06-25 06:47:11 +0000 | [diff] [blame] | 2500 | else |
David Turner | 74abee8 | 2000-06-27 23:31:53 +0000 | [diff] [blame] | 2501 | renderer = FT_Lookup_Renderer( library, slot->format, &node ); |
| 2502 | |
Werner Lemberg | a929ba9 | 2000-06-25 06:47:11 +0000 | [diff] [blame] | 2503 | error = FT_Err_Unimplemented_Feature; |
David Turner | 74abee8 | 2000-06-27 23:31:53 +0000 | [diff] [blame] | 2504 | while (renderer) |
| 2505 | { |
| 2506 | error = renderer->render( renderer, slot, render_mode, 0 ); |
| 2507 | if (!error || error != FT_Err_Cannot_Render_Glyph) break; |
| 2508 | |
| 2509 | /* FT_Err_Cannot_Render_Glyph is returned when the render mode */ |
| 2510 | /* is unsupported by the current renderer for this glyph image */ |
| 2511 | /* format.. */ |
| 2512 | |
| 2513 | /* now, look for another renderer that supports the same */ |
| 2514 | /* format.. */ |
| 2515 | renderer = FT_Lookup_Renderer( library, slot->format, &node ); |
| 2516 | update = 1; |
| 2517 | } |
| 2518 | |
| 2519 | /* if we changed the current renderer for the glyph image format */ |
| 2520 | /* we need to select it as the next current one.. */ |
| 2521 | if (!error && update && renderer) |
| 2522 | FT_Set_Renderer( library, renderer, 0, 0 ); |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 2523 | } |
| 2524 | } |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 2525 | |
| 2526 | return error; |
| 2527 | } |
Werner Lemberg | a929ba9 | 2000-06-25 06:47:11 +0000 | [diff] [blame] | 2528 | |
David Turner | 74abee8 | 2000-06-27 23:31:53 +0000 | [diff] [blame] | 2529 | |
| 2530 | |
| 2531 | FT_EXPORT_FUNC(FT_Error) FT_Render_Glyph( FT_GlyphSlot slot, |
| 2532 | FT_UInt render_mode ) |
| 2533 | { |
| 2534 | FT_Library library; |
| 2535 | |
| 2536 | if (!slot) |
| 2537 | return FT_Err_Invalid_Argument; |
| 2538 | |
| 2539 | library = FT_FACE_LIBRARY(slot->face); |
| 2540 | return FT_Render_Glyph_Internal( library, slot, render_mode ); |
| 2541 | } |
| 2542 | |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 2543 | |
| 2544 | /*************************************************************************/ |
| 2545 | /*************************************************************************/ |
| 2546 | /*************************************************************************/ |
| 2547 | /**** ****/ |
| 2548 | /**** ****/ |
| 2549 | /**** M O D U L E S ****/ |
| 2550 | /**** ****/ |
| 2551 | /**** ****/ |
| 2552 | /*************************************************************************/ |
| 2553 | /*************************************************************************/ |
| 2554 | /*************************************************************************/ |
| 2555 | |
Werner Lemberg | a929ba9 | 2000-06-25 06:47:11 +0000 | [diff] [blame] | 2556 | |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 2557 | /*************************************************************************/ |
| 2558 | /* */ |
| 2559 | /* <Function> */ |
| 2560 | /* Destroy_Module */ |
| 2561 | /* */ |
| 2562 | /* <Description> */ |
| 2563 | /* Destroys a given module object. For drivers, this also destroys */ |
Werner Lemberg | a929ba9 | 2000-06-25 06:47:11 +0000 | [diff] [blame] | 2564 | /* all child faces. */ |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 2565 | /* */ |
| 2566 | /* <InOut> */ |
| 2567 | /* module :: A handle to the target driver object. */ |
| 2568 | /* */ |
| 2569 | /* <Note> */ |
| 2570 | /* The driver _must_ be LOCKED! */ |
| 2571 | /* */ |
| 2572 | static |
| 2573 | void Destroy_Module( FT_Module module ) |
| 2574 | { |
| 2575 | FT_Memory memory = module->memory; |
| 2576 | FT_Module_Class* clazz = module->clazz; |
| 2577 | |
Werner Lemberg | a929ba9 | 2000-06-25 06:47:11 +0000 | [diff] [blame] | 2578 | |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 2579 | /* finalize client-data - before anything else */ |
| 2580 | if ( module->generic.finalizer ) |
| 2581 | module->generic.finalizer( module ); |
| 2582 | |
| 2583 | /* if the module is a renderer */ |
Werner Lemberg | a929ba9 | 2000-06-25 06:47:11 +0000 | [diff] [blame] | 2584 | if ( FT_MODULE_IS_RENDERER( module ) ) |
| 2585 | ft_remove_renderer( module ); |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 2586 | |
| 2587 | /* if the module is a font driver, add some steps */ |
Werner Lemberg | a929ba9 | 2000-06-25 06:47:11 +0000 | [diff] [blame] | 2588 | if ( FT_MODULE_IS_DRIVER( module ) ) |
| 2589 | Destroy_Driver( FT_DRIVER( module ) ); |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 2590 | |
| 2591 | /* finalize the module object */ |
Werner Lemberg | a929ba9 | 2000-06-25 06:47:11 +0000 | [diff] [blame] | 2592 | if ( clazz->module_done ) |
| 2593 | clazz->module_done( module ); |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 2594 | |
| 2595 | /* discard it */ |
| 2596 | FREE( module ); |
| 2597 | } |
| 2598 | |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 2599 | |
Werner Lemberg | a929ba9 | 2000-06-25 06:47:11 +0000 | [diff] [blame] | 2600 | /*************************************************************************/ |
| 2601 | /* */ |
| 2602 | /* <Function> */ |
| 2603 | /* FT_Add_Module */ |
| 2604 | /* */ |
| 2605 | /* <Description> */ |
| 2606 | /* Adds a new module to a given library instance. */ |
| 2607 | /* */ |
| 2608 | /* <Input> */ |
| 2609 | /* library :: A handle to the library object. */ |
| 2610 | /* clazz :: A pointer to class descriptor for the module. */ |
| 2611 | /* */ |
| 2612 | /* <Return> */ |
| 2613 | /* FreeType error code. 0 means success. */ |
| 2614 | /* */ |
| 2615 | /* <Note> */ |
| 2616 | /* An error will be returned if a module already exists by that name, */ |
| 2617 | /* or if the module requires a version of FreeType that is too great. */ |
| 2618 | /* */ |
| 2619 | FT_EXPORT_FUNC( FT_Error ) FT_Add_Module( FT_Library library, |
| 2620 | const FT_Module_Class* clazz ) |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 2621 | { |
| 2622 | FT_Error error; |
| 2623 | FT_Memory memory; |
| 2624 | FT_Module module; |
| 2625 | FT_UInt nn; |
| 2626 | |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 2627 | |
Werner Lemberg | dcd2e14 | 2000-06-25 07:43:15 +0000 | [diff] [blame] | 2628 | #define FREETYPE_VER_FIXED ( ( (FT_Long)FREETYPE_MAJOR << 16 ) | \ |
Werner Lemberg | a929ba9 | 2000-06-25 06:47:11 +0000 | [diff] [blame] | 2629 | FREETYPE_MINOR ) |
| 2630 | |
| 2631 | if ( !library || !clazz ) |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 2632 | return FT_Err_Invalid_Argument; |
| 2633 | |
| 2634 | /* check freetype version */ |
| 2635 | if ( clazz->module_requires > FREETYPE_VER_FIXED ) |
| 2636 | return FT_Err_Invalid_Version; |
| 2637 | |
| 2638 | /* look for a module with the same name in the library's table */ |
| 2639 | for ( nn = 0; nn < library->num_modules; nn++ ) |
| 2640 | { |
| 2641 | module = library->modules[nn]; |
| 2642 | if ( strcmp( module->clazz->module_name, clazz->module_name ) == 0 ) |
| 2643 | { |
| 2644 | /* this installed module has the same name, compare their versions */ |
| 2645 | if ( clazz->module_version <= module->clazz->module_version ) |
| 2646 | return FT_Err_Lower_Module_Version; |
| 2647 | |
| 2648 | /* remove the module from our list, then exit the loop to replace */ |
| 2649 | /* it by our new version.. */ |
| 2650 | FT_Remove_Module( library, module ); |
| 2651 | break; |
| 2652 | } |
| 2653 | } |
| 2654 | |
| 2655 | memory = library->memory; |
| 2656 | error = FT_Err_Ok; |
| 2657 | |
| 2658 | if ( library->num_modules >= FT_MAX_MODULES ) |
| 2659 | { |
| 2660 | error = FT_Err_Too_Many_Drivers; |
| 2661 | goto Exit; |
| 2662 | } |
| 2663 | |
| 2664 | /* allocate module object */ |
Werner Lemberg | a929ba9 | 2000-06-25 06:47:11 +0000 | [diff] [blame] | 2665 | if ( ALLOC( module,clazz->module_size ) ) |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 2666 | goto Exit; |
| 2667 | |
| 2668 | /* base initialisation */ |
| 2669 | module->library = library; |
| 2670 | module->memory = memory; |
| 2671 | module->clazz = (FT_Module_Class*)clazz; |
| 2672 | |
| 2673 | /* if the module is a renderer - this must be performed before */ |
Werner Lemberg | a929ba9 | 2000-06-25 06:47:11 +0000 | [diff] [blame] | 2674 | /* the normal module initialization. */ |
| 2675 | if ( FT_MODULE_IS_RENDERER( module ) ) |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 2676 | { |
| 2677 | /* add to the renderers list */ |
Werner Lemberg | a929ba9 | 2000-06-25 06:47:11 +0000 | [diff] [blame] | 2678 | error = ft_add_renderer( module ); |
| 2679 | if ( error ) |
| 2680 | goto Fail; |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 2681 | } |
| 2682 | |
| 2683 | /* if the module is a font driver */ |
Werner Lemberg | a929ba9 | 2000-06-25 06:47:11 +0000 | [diff] [blame] | 2684 | if ( FT_MODULE_IS_DRIVER( module ) ) |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 2685 | { |
| 2686 | /* allocate glyph loader if needed */ |
Werner Lemberg | a929ba9 | 2000-06-25 06:47:11 +0000 | [diff] [blame] | 2687 | FT_Driver driver = FT_DRIVER( module ); |
| 2688 | |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 2689 | |
| 2690 | driver->clazz = (FT_Driver_Class*)module->clazz; |
Werner Lemberg | a929ba9 | 2000-06-25 06:47:11 +0000 | [diff] [blame] | 2691 | if ( FT_DRIVER_USES_OUTLINES( driver ) ) |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 2692 | { |
| 2693 | error = FT_GlyphLoader_New( memory, &driver->glyph_loader ); |
Werner Lemberg | a929ba9 | 2000-06-25 06:47:11 +0000 | [diff] [blame] | 2694 | if ( error ) |
| 2695 | goto Fail; |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 2696 | } |
| 2697 | } |
| 2698 | |
Werner Lemberg | a929ba9 | 2000-06-25 06:47:11 +0000 | [diff] [blame] | 2699 | if ( clazz->module_init ) |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 2700 | { |
Werner Lemberg | a929ba9 | 2000-06-25 06:47:11 +0000 | [diff] [blame] | 2701 | error = clazz->module_init( module ); |
| 2702 | if ( error ) |
| 2703 | goto Fail; |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 2704 | } |
| 2705 | |
| 2706 | /* add module to the library's table */ |
Werner Lemberg | a929ba9 | 2000-06-25 06:47:11 +0000 | [diff] [blame] | 2707 | library->modules[library->num_modules++] = module; |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 2708 | |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 2709 | Exit: |
| 2710 | return error; |
| 2711 | |
| 2712 | Fail: |
Werner Lemberg | a929ba9 | 2000-06-25 06:47:11 +0000 | [diff] [blame] | 2713 | if ( FT_MODULE_IS_DRIVER( module ) ) |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 2714 | { |
Werner Lemberg | a929ba9 | 2000-06-25 06:47:11 +0000 | [diff] [blame] | 2715 | FT_Driver driver = FT_DRIVER( module ); |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 2716 | |
Werner Lemberg | a929ba9 | 2000-06-25 06:47:11 +0000 | [diff] [blame] | 2717 | |
| 2718 | if ( FT_DRIVER_USES_OUTLINES( driver ) ) |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 2719 | FT_GlyphLoader_Done( driver->glyph_loader ); |
| 2720 | } |
| 2721 | |
Werner Lemberg | a929ba9 | 2000-06-25 06:47:11 +0000 | [diff] [blame] | 2722 | if ( FT_MODULE_IS_RENDERER( module ) ) |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 2723 | { |
Werner Lemberg | a929ba9 | 2000-06-25 06:47:11 +0000 | [diff] [blame] | 2724 | FT_Renderer renderer = FT_RENDERER( module ); |
| 2725 | |
| 2726 | |
| 2727 | if ( renderer->raster ) |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 2728 | renderer->clazz->raster_class->raster_done( renderer->raster ); |
| 2729 | } |
Werner Lemberg | a929ba9 | 2000-06-25 06:47:11 +0000 | [diff] [blame] | 2730 | |
| 2731 | FREE( module ); |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 2732 | goto Exit; |
| 2733 | } |
| 2734 | |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 2735 | |
Werner Lemberg | a929ba9 | 2000-06-25 06:47:11 +0000 | [diff] [blame] | 2736 | /*************************************************************************/ |
| 2737 | /* */ |
| 2738 | /* <Function> */ |
| 2739 | /* FT_Get_Module */ |
| 2740 | /* */ |
| 2741 | /* <Description> */ |
| 2742 | /* Finds a module by its name. */ |
| 2743 | /* */ |
| 2744 | /* <Input> */ |
| 2745 | /* library :: A handle to the library object. */ |
| 2746 | /* */ |
| 2747 | /* module_name :: The module's name (as an ASCII string). */ |
| 2748 | /* */ |
| 2749 | /* <Return> */ |
| 2750 | /* A module handle. 0 if none was found. */ |
| 2751 | /* */ |
| 2752 | /* <Note> */ |
| 2753 | /* You should better be familiar with FreeType internals to know */ |
| 2754 | /* which module to look for :-) */ |
| 2755 | /* */ |
| 2756 | FT_EXPORT_FUNC( FT_Module ) FT_Get_Module( FT_Library library, |
| 2757 | const char* module_name ) |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 2758 | { |
| 2759 | FT_Module result = 0; |
| 2760 | FT_Module* cur = library->modules; |
| 2761 | FT_Module* limit = cur + library->num_modules; |
| 2762 | |
Werner Lemberg | a929ba9 | 2000-06-25 06:47:11 +0000 | [diff] [blame] | 2763 | |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 2764 | for ( ; cur < limit; cur++ ) |
| 2765 | if ( strcmp( cur[0]->clazz->module_name, module_name ) == 0 ) |
| 2766 | { |
| 2767 | result = cur[0]; |
| 2768 | break; |
| 2769 | } |
| 2770 | |
| 2771 | return result; |
| 2772 | } |
| 2773 | |
Werner Lemberg | a929ba9 | 2000-06-25 06:47:11 +0000 | [diff] [blame] | 2774 | |
| 2775 | /*************************************************************************/ |
| 2776 | /* */ |
| 2777 | /* <Function> */ |
| 2778 | /* FT_Get_Module_Interface */ |
| 2779 | /* */ |
| 2780 | /* <Description> */ |
| 2781 | /* Finds a module and returns its specific interface as a typeless */ |
| 2782 | /* pointer. */ |
| 2783 | /* */ |
| 2784 | /* <Input> */ |
| 2785 | /* library :: A handle to the library object. */ |
| 2786 | /* */ |
| 2787 | /* module_name :: The module's name (as an ASCII string). */ |
| 2788 | /* */ |
| 2789 | /* <Return> */ |
| 2790 | /* A module-specific interface if available, 0 otherwise. */ |
| 2791 | /* */ |
| 2792 | /* <Note> */ |
| 2793 | /* You should better be familiar with FreeType internals to know */ |
| 2794 | /* which module to look for, and what its interface is :-) */ |
| 2795 | /* */ |
| 2796 | FT_EXPORT_FUNC(const void*) FT_Get_Module_Interface( |
| 2797 | FT_Library library, |
| 2798 | const char* mod_name ) |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 2799 | { |
| 2800 | FT_Module module; |
| 2801 | |
Werner Lemberg | a929ba9 | 2000-06-25 06:47:11 +0000 | [diff] [blame] | 2802 | |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 2803 | module = FT_Get_Module( library, mod_name ); |
Werner Lemberg | a929ba9 | 2000-06-25 06:47:11 +0000 | [diff] [blame] | 2804 | |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 2805 | return module ? module->clazz->module_interface : 0; |
| 2806 | } |
| 2807 | |
| 2808 | |
Werner Lemberg | a929ba9 | 2000-06-25 06:47:11 +0000 | [diff] [blame] | 2809 | /*************************************************************************/ |
| 2810 | /* */ |
| 2811 | /* <Function> */ |
| 2812 | /* FT_Remove_Module */ |
| 2813 | /* */ |
| 2814 | /* <Description> */ |
| 2815 | /* Removes a given module from a library instance. */ |
| 2816 | /* */ |
| 2817 | /* <Input> */ |
| 2818 | /* library :: A handle to a library object. */ |
| 2819 | /* */ |
| 2820 | /* module :: A handle to a module object. */ |
| 2821 | /* */ |
| 2822 | /* <Return> */ |
| 2823 | /* FreeType error code. 0 means success. */ |
| 2824 | /* */ |
| 2825 | /* <Note> */ |
| 2826 | /* The module object is destroyed by the function in case of success. */ |
Werner Lemberg | dcd2e14 | 2000-06-25 07:43:15 +0000 | [diff] [blame] | 2827 | /* */ |
Werner Lemberg | a929ba9 | 2000-06-25 06:47:11 +0000 | [diff] [blame] | 2828 | FT_EXPORT_FUNC( FT_Error ) FT_Remove_Module( FT_Library library, |
| 2829 | FT_Module module ) |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 2830 | { |
| 2831 | /* try to find the module from the table, then remove it from there */ |
Werner Lemberg | a929ba9 | 2000-06-25 06:47:11 +0000 | [diff] [blame] | 2832 | if ( library && module ) |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 2833 | { |
| 2834 | FT_Module* cur = library->modules; |
| 2835 | FT_Module* limit = cur + library->num_modules; |
| 2836 | |
Werner Lemberg | a929ba9 | 2000-06-25 06:47:11 +0000 | [diff] [blame] | 2837 | |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 2838 | for ( ; cur < limit; cur++ ) |
| 2839 | { |
| 2840 | if (cur[0] == module) |
| 2841 | { |
| 2842 | /* remove it from the table */ |
| 2843 | library->num_modules--; |
| 2844 | limit--; |
Werner Lemberg | a929ba9 | 2000-06-25 06:47:11 +0000 | [diff] [blame] | 2845 | while ( cur < limit ) |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 2846 | { |
| 2847 | cur[0] = cur[1]; |
| 2848 | cur++; |
| 2849 | } |
| 2850 | limit[0] = 0; |
| 2851 | |
| 2852 | /* destroy the module */ |
Werner Lemberg | a929ba9 | 2000-06-25 06:47:11 +0000 | [diff] [blame] | 2853 | Destroy_Module( module ); |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 2854 | |
| 2855 | return FT_Err_Ok; |
| 2856 | } |
| 2857 | } |
| 2858 | } |
| 2859 | return FT_Err_Invalid_Handle; |
| 2860 | } |
| 2861 | |
| 2862 | |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 2863 | /*************************************************************************/ |
| 2864 | /*************************************************************************/ |
| 2865 | /*************************************************************************/ |
| 2866 | /**** ****/ |
| 2867 | /**** ****/ |
| 2868 | /**** L I B R A R Y ****/ |
| 2869 | /**** ****/ |
| 2870 | /**** ****/ |
| 2871 | /*************************************************************************/ |
| 2872 | /*************************************************************************/ |
| 2873 | /*************************************************************************/ |
| 2874 | |
Werner Lemberg | a929ba9 | 2000-06-25 06:47:11 +0000 | [diff] [blame] | 2875 | |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 2876 | /*************************************************************************/ |
| 2877 | /* */ |
| 2878 | /* <Function> */ |
| 2879 | /* FT_New_Library */ |
| 2880 | /* */ |
| 2881 | /* <Description> */ |
| 2882 | /* This function is used to create a new FreeType library instance */ |
| 2883 | /* from a given memory object. It is thus possible to use libraries */ |
| 2884 | /* with distinct memory allocators within the same program. */ |
| 2885 | /* */ |
| 2886 | /* <Input> */ |
| 2887 | /* memory :: A handle to the original memory object. */ |
| 2888 | /* */ |
| 2889 | /* <Output> */ |
| 2890 | /* alibrary :: A pointer to handle of a new library object. */ |
| 2891 | /* */ |
| 2892 | /* <Return> */ |
| 2893 | /* FreeType error code. 0 means success. */ |
| 2894 | /* */ |
| 2895 | FT_EXPORT_FUNC( FT_Error ) FT_New_Library( FT_Memory memory, |
| 2896 | FT_Library* alibrary ) |
| 2897 | { |
| 2898 | FT_Library library = 0; |
| 2899 | FT_Error error; |
| 2900 | |
| 2901 | |
| 2902 | if ( !memory ) |
| 2903 | return FT_Err_Invalid_Argument; |
| 2904 | |
| 2905 | /* first of all, allocate the library object */ |
| 2906 | if ( ALLOC( library, sizeof ( *library ) ) ) |
| 2907 | return error; |
| 2908 | |
| 2909 | library->memory = memory; |
| 2910 | |
| 2911 | /* allocate the render pool */ |
| 2912 | library->raster_pool_size = FT_RENDER_POOL_SIZE; |
| 2913 | if ( ALLOC( library->raster_pool, FT_RENDER_POOL_SIZE ) ) |
| 2914 | goto Fail; |
| 2915 | |
| 2916 | /* That's ok now */ |
| 2917 | *alibrary = library; |
| 2918 | |
| 2919 | return FT_Err_Ok; |
| 2920 | |
| 2921 | Fail: |
| 2922 | FREE( library ); |
| 2923 | return error; |
| 2924 | } |
| 2925 | |
| 2926 | |
| 2927 | /*************************************************************************/ |
| 2928 | /* */ |
| 2929 | /* <Function> */ |
| 2930 | /* FT_Done_Library */ |
| 2931 | /* */ |
| 2932 | /* <Description> */ |
| 2933 | /* Discards a given library object. This closes all drivers and */ |
| 2934 | /* discards all resource objects. */ |
| 2935 | /* */ |
| 2936 | /* <Input> */ |
| 2937 | /* library :: A handle to the target library. */ |
| 2938 | /* */ |
| 2939 | /* <Return> */ |
| 2940 | /* FreeType error code. 0 means success. */ |
| 2941 | /* */ |
| 2942 | FT_EXPORT_FUNC( FT_Error ) FT_Done_Library( FT_Library library ) |
| 2943 | { |
| 2944 | FT_Memory memory; |
David Turner | 74abee8 | 2000-06-27 23:31:53 +0000 | [diff] [blame] | 2945 | FT_UInt n; |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 2946 | |
| 2947 | |
| 2948 | if ( !library ) |
| 2949 | return FT_Err_Invalid_Library_Handle; |
| 2950 | |
| 2951 | memory = library->memory; |
| 2952 | |
| 2953 | /* Discard client-data */ |
| 2954 | if ( library->generic.finalizer ) |
| 2955 | library->generic.finalizer( library ); |
| 2956 | |
| 2957 | /* Close all modules in the library */ |
| 2958 | for ( n = 0; n < library->num_modules; n++ ) |
| 2959 | { |
| 2960 | FT_Module module = library->modules[n]; |
| 2961 | |
Werner Lemberg | a929ba9 | 2000-06-25 06:47:11 +0000 | [diff] [blame] | 2962 | |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 2963 | if ( module ) |
| 2964 | { |
| 2965 | Destroy_Module( module ); |
| 2966 | library->modules[n] = 0; |
| 2967 | } |
| 2968 | } |
| 2969 | |
| 2970 | /* Destroy raster objects */ |
| 2971 | FREE( library->raster_pool ); |
| 2972 | library->raster_pool_size = 0; |
| 2973 | |
| 2974 | FREE( library ); |
| 2975 | return FT_Err_Ok; |
| 2976 | } |
| 2977 | |
| 2978 | |
| 2979 | /*************************************************************************/ |
| 2980 | /* */ |
| 2981 | /* <Function> */ |
| 2982 | /* FT_Set_Debug_Hook */ |
| 2983 | /* */ |
| 2984 | /* <Description> */ |
Werner Lemberg | a929ba9 | 2000-06-25 06:47:11 +0000 | [diff] [blame] | 2985 | /* Sets a debug hook function for debugging the interpreter of a font */ |
| 2986 | /* format. */ |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 2987 | /* */ |
| 2988 | /* <Input> */ |
| 2989 | /* library :: A handle to the library object. */ |
| 2990 | /* */ |
| 2991 | /* hook_index :: The index of the debug hook. You should use the */ |
| 2992 | /* values defined in ftobjs.h, e.g. */ |
| 2993 | /* FT_DEBUG_HOOK_TRUETYPE */ |
| 2994 | /* */ |
| 2995 | /* debug_hook :: The function used to debug the interpreter. */ |
| 2996 | /* */ |
| 2997 | /* <Note> */ |
| 2998 | /* Currently, four debug hook slots are available, but only two (for */ |
| 2999 | /* the TrueType and the Type 1 interpreter) are defined. */ |
| 3000 | /* */ |
| 3001 | FT_EXPORT_FUNC( void ) FT_Set_Debug_Hook( FT_Library library, |
| 3002 | FT_UInt hook_index, |
| 3003 | FT_DebugHook_Func debug_hook ) |
| 3004 | { |
| 3005 | if ( library && debug_hook && |
| 3006 | hook_index < |
| 3007 | ( sizeof ( library->debug_hooks ) / sizeof ( void* ) ) ) |
| 3008 | library->debug_hooks[hook_index] = debug_hook; |
| 3009 | } |
| 3010 | |
| 3011 | |
David Turner | f0df85b | 2000-06-22 00:17:42 +0000 | [diff] [blame] | 3012 | /*************************************************************************/ |
David Turner | d2b1f35 | 1999-12-16 23:11:37 +0000 | [diff] [blame] | 3013 | /* */ |
| 3014 | /* <Function> */ |
| 3015 | /* FT_Done_FreeType */ |
| 3016 | /* */ |
| 3017 | /* <Description> */ |
| 3018 | /* Destroys a given FreeType library object and all of its childs, */ |
| 3019 | /* including resources, drivers, faces, sizes, etc. */ |
| 3020 | /* */ |
| 3021 | /* <Input> */ |
| 3022 | /* library :: A handle to the target library object. */ |
| 3023 | /* */ |
| 3024 | /* <Return> */ |
Werner Lemberg | a3b6c6c | 2000-05-31 06:55:12 +0000 | [diff] [blame] | 3025 | /* FreeType error code. 0 means success. */ |
David Turner | d2b1f35 | 1999-12-16 23:11:37 +0000 | [diff] [blame] | 3026 | /* */ |
Werner Lemberg | a3b6c6c | 2000-05-31 06:55:12 +0000 | [diff] [blame] | 3027 | FT_EXPORT_FUNC( FT_Error ) FT_Done_FreeType( FT_Library library ) |
David Turner | d2b1f35 | 1999-12-16 23:11:37 +0000 | [diff] [blame] | 3028 | { |
Werner Lemberg | 2fbf7e4 | 2000-06-02 00:01:14 +0000 | [diff] [blame] | 3029 | /* test for valid `library' delayed to FT_Done_Library() */ |
| 3030 | |
David Turner | d2b1f35 | 1999-12-16 23:11:37 +0000 | [diff] [blame] | 3031 | /* Discard the library object */ |
| 3032 | FT_Done_Library( library ); |
| 3033 | |
| 3034 | return FT_Err_Ok; |
| 3035 | } |
| 3036 | |
Werner Lemberg | a3b6c6c | 2000-05-31 06:55:12 +0000 | [diff] [blame] | 3037 | |
David Turner | d2b1f35 | 1999-12-16 23:11:37 +0000 | [diff] [blame] | 3038 | /* END */ |