docs/reference/ft2-multiple_masters.html

   1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
   2 "http://www.w3.org/TR/html4/loose.dtd">
   3 <html>
   4 <head>
   5 <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
   6 <title>FreeType-2.4.9 API Reference</title>
   7 <style type="text/css">
   8   body { font-family: Verdana, Geneva, Arial, Helvetica, serif;
   9          color: #000000;
  10          background: #FFFFFF; }
  11
  12   p { text-align: justify; }
  13   h1 { text-align: center; }
  14   li { text-align: justify; }
  15   td { padding: 0 0.5em 0 0.5em; }
  16   td.left { padding: 0 0.5em 0 0.5em;
  17             text-align: left; }
  18
  19   a:link { color: #0000EF; }
  20   a:visited { color: #51188E; }
  21   a:hover { color: #FF0000; }
  22
  23   span.keyword { font-family: monospace;
  24                  text-align: left;
  25                  white-space: pre;
  26                  color: darkblue; }
  27
  28   pre.colored { color: blue; }
  29
  30   ul.empty { list-style-type: none; }
  31 </style>
  32 </head>
  33 <body>
  34
  35 <table align=center><tr><td><font size=-1>[<a href="ft2-index.html">Index</a>]</font></td>
  36 <td width="100%"></td>
  37 <td><font size=-1>[<a href="ft2-toc.html">TOC</a>]</font></td></tr></table>
  38 <center><h1>FreeType-2.4.9 API Reference</h1></center>
  39
  40 <center><h1>
  41 Multiple Masters
  42 </h1></center>
  43 <h2>Synopsis</h2>
  44 <table align=center cellspacing=5 cellpadding=0 border=0>
  45 <tr><td></td><td><a href="#FT_MM_Axis">FT_MM_Axis</a></td><td></td><td><a href="#FT_Get_MM_Var">FT_Get_MM_Var</a></td></tr>
  46 <tr><td></td><td><a href="#FT_Multi_Master">FT_Multi_Master</a></td><td></td><td><a href="#FT_Set_MM_Design_Coordinates">FT_Set_MM_Design_Coordinates</a></td></tr>
  47 <tr><td></td><td><a href="#FT_Var_Axis">FT_Var_Axis</a></td><td></td><td><a href="#FT_Set_Var_Design_Coordinates">FT_Set_Var_Design_Coordinates</a></td></tr>
  48 <tr><td></td><td><a href="#FT_Var_Named_Style">FT_Var_Named_Style</a></td><td></td><td><a href="#FT_Set_MM_Blend_Coordinates">FT_Set_MM_Blend_Coordinates</a></td></tr>
  49 <tr><td></td><td><a href="#FT_MM_Var">FT_MM_Var</a></td><td></td><td><a href="#FT_Set_Var_Blend_Coordinates">FT_Set_Var_Blend_Coordinates</a></td></tr>
  50 <tr><td></td><td><a href="#FT_Get_Multi_Master">FT_Get_Multi_Master</a></td><td></td><td></td></tr>
  51 </table><br><br>
  52
  53 <table align=center width="87%"><tr><td>
  54 <p>The following types and functions are used to manage Multiple Master fonts, i.e., the selection of specific design instances by setting design axis coordinates.</p>
  55 <p>George Williams has extended this interface to make it work with both Type&nbsp;1 Multiple Masters fonts and GX distortable (var) fonts. Some of these routines only work with MM fonts, others will work with both types. They are similar enough that a consistent interface makes sense.</p>
  56 </td></tr></table><br>
  57 <table align=center width="75%"><tr><td>
  58 <h4><a name="FT_MM_Axis">FT_MM_Axis</a></h4>
  59 <table align=center width="87%"><tr><td>
  60 Defined in FT_MULTIPLE_MASTERS_H (freetype/ftmm.h).
  61 </td></tr></table><br>
  62 <table align=center width="87%"><tr bgcolor="#D6E8FF"><td><pre>
  63
  64   <span class="keyword">typedef</span> <span class="keyword">struct</span>  FT_MM_Axis_
  65   {
  66     <a href="ft2-basic_types.html#FT_String">FT_String</a>*  name;
  67     <a href="ft2-basic_types.html#FT_Long">FT_Long</a>     minimum;
  68     <a href="ft2-basic_types.html#FT_Long">FT_Long</a>     maximum;
  69
  70   } <b>FT_MM_Axis</b>;
  71
  72 </pre></table><br>
  73 <table align=center width="87%"><tr><td>
  74 <p>A simple structure used to model a given axis in design space for Multiple Masters fonts.</p>
  75 <p>This structure can't be used for GX var fonts.</p>
  76 </td></tr></table><br>
  77 <table align=center width="87%" cellpadding=5><tr bgcolor="#EEEEFF"><td><em><b>fields</b></em></td></tr><tr><td>
  78 <p></p>
  79 <table cellpadding=3 border=0>
  80 <tr valign=top><td><b>name</b></td><td>
  81 <p>The axis's name.</p>
  82 </td></tr>
  83 <tr valign=top><td><b>minimum</b></td><td>
  84 <p>The axis's minimum design coordinate.</p>
  85 </td></tr>
  86 <tr valign=top><td><b>maximum</b></td><td>
  87 <p>The axis's maximum design coordinate.</p>
  88 </td></tr>
  89 </table>
  90 </td></tr></table>
  91 </td></tr></table>
  92 <hr width="75%">
  93 <table align=center width="75%"><tr><td><font size=-2>[<a href="ft2-index.html">Index</a>]</font></td>
  94 <td width="100%"></td>
  95 <td><font size=-2>[<a href="ft2-toc.html">TOC</a>]</font></td></tr></table>
  96
  97 <table align=center width="75%"><tr><td>
  98 <h4><a name="FT_Multi_Master">FT_Multi_Master</a></h4>
  99 <table align=center width="87%"><tr><td>
 100 Defined in FT_MULTIPLE_MASTERS_H (freetype/ftmm.h).
 101 </td></tr></table><br>
 102 <table align=center width="87%"><tr bgcolor="#D6E8FF"><td><pre>
 103
 104   <span class="keyword">typedef</span> <span class="keyword">struct</span>  FT_Multi_Master_
 105   {
 106     <a href="ft2-basic_types.html#FT_UInt">FT_UInt</a>     num_axis;
 107     <a href="ft2-basic_types.html#FT_UInt">FT_UInt</a>     num_designs;
 108     <a href="ft2-multiple_masters.html#FT_MM_Axis">FT_MM_Axis</a>  axis[T1_MAX_MM_AXIS];
 109
 110   } <b>FT_Multi_Master</b>;
 111
 112 </pre></table><br>
 113 <table align=center width="87%"><tr><td>
 114 <p>A structure used to model the axes and space of a Multiple Masters font.</p>
 115 <p>This structure can't be used for GX var fonts.</p>
 116 </td></tr></table><br>
 117 <table align=center width="87%" cellpadding=5><tr bgcolor="#EEEEFF"><td><em><b>fields</b></em></td></tr><tr><td>
 118 <p></p>
 119 <table cellpadding=3 border=0>
 120 <tr valign=top><td><b>num_axis</b></td><td>
 121 <p>Number of axes. Cannot exceed&nbsp;4.</p>
 122 </td></tr>
 123 <tr valign=top><td><b>num_designs</b></td><td>
 124 <p>Number of designs; should be normally 2^num_axis even though the Type&nbsp;1 specification strangely allows for intermediate designs to be present. This number cannot exceed&nbsp;16.</p>
 125 </td></tr>
 126 <tr valign=top><td><b>axis</b></td><td>
 127 <p>A table of axis descriptors.</p>
 128 </td></tr>
 129 </table>
 130 </td></tr></table>
 131 </td></tr></table>
 132 <hr width="75%">
 133 <table align=center width="75%"><tr><td><font size=-2>[<a href="ft2-index.html">Index</a>]</font></td>
 134 <td width="100%"></td>
 135 <td><font size=-2>[<a href="ft2-toc.html">TOC</a>]</font></td></tr></table>
 136
 137 <table align=center width="75%"><tr><td>
 138 <h4><a name="FT_Var_Axis">FT_Var_Axis</a></h4>
 139 <table align=center width="87%"><tr><td>
 140 Defined in FT_MULTIPLE_MASTERS_H (freetype/ftmm.h).
 141 </td></tr></table><br>
 142 <table align=center width="87%"><tr bgcolor="#D6E8FF"><td><pre>
 143
 144   <span class="keyword">typedef</span> <span class="keyword">struct</span>  FT_Var_Axis_
 145   {
 146     <a href="ft2-basic_types.html#FT_String">FT_String</a>*  name;
 147
 148     <a href="ft2-basic_types.html#FT_Fixed">FT_Fixed</a>    minimum;
 149     <a href="ft2-basic_types.html#FT_Fixed">FT_Fixed</a>    def;
 150     <a href="ft2-basic_types.html#FT_Fixed">FT_Fixed</a>    maximum;
 151
 152     <a href="ft2-basic_types.html#FT_ULong">FT_ULong</a>    tag;
 153     <a href="ft2-basic_types.html#FT_UInt">FT_UInt</a>     strid;
 154
 155   } <b>FT_Var_Axis</b>;
 156
 157 </pre></table><br>
 158 <table align=center width="87%"><tr><td>
 159 <p>A simple structure used to model a given axis in design space for Multiple Masters and GX var fonts.</p>
 160 </td></tr></table><br>
 161 <table align=center width="87%" cellpadding=5><tr bgcolor="#EEEEFF"><td><em><b>fields</b></em></td></tr><tr><td>
 162 <p></p>
 163 <table cellpadding=3 border=0>
 164 <tr valign=top><td><b>name</b></td><td>
 165 <p>The axis's name. Not always meaningful for GX.</p>
 166 </td></tr>
 167 <tr valign=top><td><b>minimum</b></td><td>
 168 <p>The axis's minimum design coordinate.</p>
 169 </td></tr>
 170 <tr valign=top><td><b>def</b></td><td>
 171 <p>The axis's default design coordinate. FreeType computes meaningful default values for MM; it is then an integer value, not in 16.16 format.</p>
 172 </td></tr>
 173 <tr valign=top><td><b>maximum</b></td><td>
 174 <p>The axis's maximum design coordinate.</p>
 175 </td></tr>
 176 <tr valign=top><td><b>tag</b></td><td>
 177 <p>The axis's tag (the GX equivalent to &lsquo;name&rsquo;). FreeType provides default values for MM if possible.</p>
 178 </td></tr>
 179 <tr valign=top><td><b>strid</b></td><td>
 180 <p>The entry in &lsquo;name&rsquo; table (another GX version of &lsquo;name&rsquo;). Not meaningful for MM.</p>
 181 </td></tr>
 182 </table>
 183 </td></tr></table>
 184 </td></tr></table>
 185 <hr width="75%">
 186 <table align=center width="75%"><tr><td><font size=-2>[<a href="ft2-index.html">Index</a>]</font></td>
 187 <td width="100%"></td>
 188 <td><font size=-2>[<a href="ft2-toc.html">TOC</a>]</font></td></tr></table>
 189
 190 <table align=center width="75%"><tr><td>
 191 <h4><a name="FT_Var_Named_Style">FT_Var_Named_Style</a></h4>
 192 <table align=center width="87%"><tr><td>
 193 Defined in FT_MULTIPLE_MASTERS_H (freetype/ftmm.h).
 194 </td></tr></table><br>
 195 <table align=center width="87%"><tr bgcolor="#D6E8FF"><td><pre>
 196
 197   <span class="keyword">typedef</span> <span class="keyword">struct</span>  FT_Var_Named_Style_
 198   {
 199     <a href="ft2-basic_types.html#FT_Fixed">FT_Fixed</a>*  coords;
 200     <a href="ft2-basic_types.html#FT_UInt">FT_UInt</a>    strid;
 201
 202   } <b>FT_Var_Named_Style</b>;
 203
 204 </pre></table><br>
 205 <table align=center width="87%"><tr><td>
 206 <p>A simple structure used to model a named style in a GX var font.</p>
 207 <p>This structure can't be used for MM fonts.</p>
 208 </td></tr></table><br>
 209 <table align=center width="87%" cellpadding=5><tr bgcolor="#EEEEFF"><td><em><b>fields</b></em></td></tr><tr><td>
 210 <p></p>
 211 <table cellpadding=3 border=0>
 212 <tr valign=top><td><b>coords</b></td><td>
 213 <p>The design coordinates for this style. This is an array with one entry for each axis.</p>
 214 </td></tr>
 215 <tr valign=top><td><b>strid</b></td><td>
 216 <p>The entry in &lsquo;name&rsquo; table identifying this style.</p>
 217 </td></tr>
 218 </table>
 219 </td></tr></table>
 220 </td></tr></table>
 221 <hr width="75%">
 222 <table align=center width="75%"><tr><td><font size=-2>[<a href="ft2-index.html">Index</a>]</font></td>
 223 <td width="100%"></td>
 224 <td><font size=-2>[<a href="ft2-toc.html">TOC</a>]</font></td></tr></table>
 225
 226 <table align=center width="75%"><tr><td>
 227 <h4><a name="FT_MM_Var">FT_MM_Var</a></h4>
 228 <table align=center width="87%"><tr><td>
 229 Defined in FT_MULTIPLE_MASTERS_H (freetype/ftmm.h).
 230 </td></tr></table><br>
 231 <table align=center width="87%"><tr bgcolor="#D6E8FF"><td><pre>
 232
 233   <span class="keyword">typedef</span> <span class="keyword">struct</span>  FT_MM_Var_
 234   {
 235     <a href="ft2-basic_types.html#FT_UInt">FT_UInt</a>              num_axis;
 236     <a href="ft2-basic_types.html#FT_UInt">FT_UInt</a>              num_designs;
 237     <a href="ft2-basic_types.html#FT_UInt">FT_UInt</a>              num_namedstyles;
 238     <a href="ft2-multiple_masters.html#FT_Var_Axis">FT_Var_Axis</a>*         axis;
 239     <a href="ft2-multiple_masters.html#FT_Var_Named_Style">FT_Var_Named_Style</a>*  namedstyle;
 240
 241   } <b>FT_MM_Var</b>;
 242
 243 </pre></table><br>
 244 <table align=center width="87%"><tr><td>
 245 <p>A structure used to model the axes and space of a Multiple Masters or GX var distortable font.</p>
 246 <p>Some fields are specific to one format and not to the other.</p>
 247 </td></tr></table><br>
 248 <table align=center width="87%" cellpadding=5><tr bgcolor="#EEEEFF"><td><em><b>fields</b></em></td></tr><tr><td>
 249 <p></p>
 250 <table cellpadding=3 border=0>
 251 <tr valign=top><td><b>num_axis</b></td><td>
 252 <p>The number of axes. The maximum value is&nbsp;4 for MM; no limit in GX.</p>
 253 </td></tr>
 254 <tr valign=top><td><b>num_designs</b></td><td>
 255 <p>The number of designs; should be normally 2^num_axis for MM fonts. Not meaningful for GX (where every glyph could have a different number of designs).</p>
 256 </td></tr>
 257 <tr valign=top><td><b>num_namedstyles</b></td><td>
 258 <p>The number of named styles; only meaningful for GX which allows certain design coordinates to have a string ID (in the &lsquo;name&rsquo; table) associated with them. The font can tell the user that, for example, Weight=1.5 is &lsquo;Bold&rsquo;.</p>
 259 </td></tr>
 260 <tr valign=top><td><b>axis</b></td><td>
 261 <p>A table of axis descriptors. GX fonts contain slightly more data than MM.</p>
 262 </td></tr>
 263 <tr valign=top><td><b>namedstyles</b></td><td>
 264 <p>A table of named styles. Only meaningful with GX.</p>
 265 </td></tr>
 266 </table>
 267 </td></tr></table>
 268 </td></tr></table>
 269 <hr width="75%">
 270 <table align=center width="75%"><tr><td><font size=-2>[<a href="ft2-index.html">Index</a>]</font></td>
 271 <td width="100%"></td>
 272 <td><font size=-2>[<a href="ft2-toc.html">TOC</a>]</font></td></tr></table>
 273
 274 <table align=center width="75%"><tr><td>
 275 <h4><a name="FT_Get_Multi_Master">FT_Get_Multi_Master</a></h4>
 276 <table align=center width="87%"><tr><td>
 277 Defined in FT_MULTIPLE_MASTERS_H (freetype/ftmm.h).
 278 </td></tr></table><br>
 279 <table align=center width="87%"><tr bgcolor="#D6E8FF"><td><pre>
 280
 281   FT_EXPORT( <a href="ft2-basic_types.html#FT_Error">FT_Error</a> )
 282   <b>FT_Get_Multi_Master</b>( <a href="ft2-base_interface.html#FT_Face">FT_Face</a>           face,
 283                        <a href="ft2-multiple_masters.html#FT_Multi_Master">FT_Multi_Master</a>  *amaster );
 284
 285 </pre></table><br>
 286 <table align=center width="87%"><tr><td>
 287 <p>Retrieve the Multiple Master descriptor of a given font.</p>
 288 <p>This function can't be used with GX fonts.</p>
 289 </td></tr></table><br>
 290 <table align=center width="87%" cellpadding=5><tr bgcolor="#EEEEFF"><td><em><b>input</b></em></td></tr><tr><td>
 291 <p></p>
 292 <table cellpadding=3 border=0>
 293 <tr valign=top><td><b>face</b></td><td>
 294 <p>A handle to the source face.</p>
 295 </td></tr>
 296 </table>
 297 </td></tr></table>
 298 <table align=center width="87%" cellpadding=5><tr bgcolor="#EEEEFF"><td><em><b>output</b></em></td></tr><tr><td>
 299 <p></p>
 300 <table cellpadding=3 border=0>
 301 <tr valign=top><td><b>amaster</b></td><td>
 302 <p>The Multiple Masters descriptor.</p>
 303 </td></tr>
 304 </table>
 305 </td></tr></table>
 306 <table align=center width="87%" cellpadding=5><tr bgcolor="#EEEEFF"><td><em><b>return</b></em></td></tr><tr><td>
 307 <p>FreeType error code. 0&nbsp;means success.</p>
 308 </td></tr></table>
 309 </td></tr></table>
 310 <hr width="75%">
 311 <table align=center width="75%"><tr><td><font size=-2>[<a href="ft2-index.html">Index</a>]</font></td>
 312 <td width="100%"></td>
 313 <td><font size=-2>[<a href="ft2-toc.html">TOC</a>]</font></td></tr></table>
 314
 315 <table align=center width="75%"><tr><td>
 316 <h4><a name="FT_Get_MM_Var">FT_Get_MM_Var</a></h4>
 317 <table align=center width="87%"><tr><td>
 318 Defined in FT_MULTIPLE_MASTERS_H (freetype/ftmm.h).
 319 </td></tr></table><br>
 320 <table align=center width="87%"><tr bgcolor="#D6E8FF"><td><pre>
 321
 322   FT_EXPORT( <a href="ft2-basic_types.html#FT_Error">FT_Error</a> )
 323   <b>FT_Get_MM_Var</b>( <a href="ft2-base_interface.html#FT_Face">FT_Face</a>      face,
 324                  <a href="ft2-multiple_masters.html#FT_MM_Var">FT_MM_Var</a>*  *amaster );
 325
 326 </pre></table><br>
 327 <table align=center width="87%"><tr><td>
 328 <p>Retrieve the Multiple Master/GX var descriptor of a given font.</p>
 329 </td></tr></table><br>
 330 <table align=center width="87%" cellpadding=5><tr bgcolor="#EEEEFF"><td><em><b>input</b></em></td></tr><tr><td>
 331 <p></p>
 332 <table cellpadding=3 border=0>
 333 <tr valign=top><td><b>face</b></td><td>
 334 <p>A handle to the source face.</p>
 335 </td></tr>
 336 </table>
 337 </td></tr></table>
 338 <table align=center width="87%" cellpadding=5><tr bgcolor="#EEEEFF"><td><em><b>output</b></em></td></tr><tr><td>
 339 <p></p>
 340 <table cellpadding=3 border=0>
 341 <tr valign=top><td><b>amaster</b></td><td>
 342 <p>The Multiple Masters/GX var descriptor. Allocates a data structure, which the user must free (a single call to FT_FREE will do it).</p>
 343 </td></tr>
 344 </table>
 345 </td></tr></table>
 346 <table align=center width="87%" cellpadding=5><tr bgcolor="#EEEEFF"><td><em><b>return</b></em></td></tr><tr><td>
 347 <p>FreeType error code. 0&nbsp;means success.</p>
 348 </td></tr></table>
 349 </td></tr></table>
 350 <hr width="75%">
 351 <table align=center width="75%"><tr><td><font size=-2>[<a href="ft2-index.html">Index</a>]</font></td>
 352 <td width="100%"></td>
 353 <td><font size=-2>[<a href="ft2-toc.html">TOC</a>]</font></td></tr></table>
 354
 355 <table align=center width="75%"><tr><td>
 356 <h4><a name="FT_Set_MM_Design_Coordinates">FT_Set_MM_Design_Coordinates</a></h4>
 357 <table align=center width="87%"><tr><td>
 358 Defined in FT_MULTIPLE_MASTERS_H (freetype/ftmm.h).
 359 </td></tr></table><br>
 360 <table align=center width="87%"><tr bgcolor="#D6E8FF"><td><pre>
 361
 362   FT_EXPORT( <a href="ft2-basic_types.html#FT_Error">FT_Error</a> )
 363   <b>FT_Set_MM_Design_Coordinates</b>( <a href="ft2-base_interface.html#FT_Face">FT_Face</a>   face,
 364                                 <a href="ft2-basic_types.html#FT_UInt">FT_UInt</a>   num_coords,
 365                                 <a href="ft2-basic_types.html#FT_Long">FT_Long</a>*  coords );
 366
 367 </pre></table><br>
 368 <table align=center width="87%"><tr><td>
 369 <p>For Multiple Masters fonts, choose an interpolated font design through design coordinates.</p>
 370 <p>This function can't be used with GX fonts.</p>
 371 </td></tr></table><br>
 372 <table align=center width="87%" cellpadding=5><tr bgcolor="#EEEEFF"><td><em><b>inout</b></em></td></tr><tr><td>
 373 <p></p>
 374 <table cellpadding=3 border=0>
 375 <tr valign=top><td><b>face</b></td><td>
 376 <p>A handle to the source face.</p>
 377 </td></tr>
 378 </table>
 379 </td></tr></table>
 380 <table align=center width="87%" cellpadding=5><tr bgcolor="#EEEEFF"><td><em><b>input</b></em></td></tr><tr><td>
 381 <p></p>
 382 <table cellpadding=3 border=0>
 383 <tr valign=top><td><b>num_coords</b></td><td>
 384 <p>The number of design coordinates (must be equal to the number of axes in the font).</p>
 385 </td></tr>
 386 <tr valign=top><td><b>coords</b></td><td>
 387 <p>An array of design coordinates.</p>
 388 </td></tr>
 389 </table>
 390 </td></tr></table>
 391 <table align=center width="87%" cellpadding=5><tr bgcolor="#EEEEFF"><td><em><b>return</b></em></td></tr><tr><td>
 392 <p>FreeType error code. 0&nbsp;means success.</p>
 393 </td></tr></table>
 394 </td></tr></table>
 395 <hr width="75%">
 396 <table align=center width="75%"><tr><td><font size=-2>[<a href="ft2-index.html">Index</a>]</font></td>
 397 <td width="100%"></td>
 398 <td><font size=-2>[<a href="ft2-toc.html">TOC</a>]</font></td></tr></table>
 399
 400 <table align=center width="75%"><tr><td>
 401 <h4><a name="FT_Set_Var_Design_Coordinates">FT_Set_Var_Design_Coordinates</a></h4>
 402 <table align=center width="87%"><tr><td>
 403 Defined in FT_MULTIPLE_MASTERS_H (freetype/ftmm.h).
 404 </td></tr></table><br>
 405 <table align=center width="87%"><tr bgcolor="#D6E8FF"><td><pre>
 406
 407   FT_EXPORT( <a href="ft2-basic_types.html#FT_Error">FT_Error</a> )
 408   <b>FT_Set_Var_Design_Coordinates</b>( <a href="ft2-base_interface.html#FT_Face">FT_Face</a>    face,
 409                                  <a href="ft2-basic_types.html#FT_UInt">FT_UInt</a>    num_coords,
 410                                  <a href="ft2-basic_types.html#FT_Fixed">FT_Fixed</a>*  coords );
 411
 412 </pre></table><br>
 413 <table align=center width="87%"><tr><td>
 414 <p>For Multiple Master or GX Var fonts, choose an interpolated font design through design coordinates.</p>
 415 </td></tr></table><br>
 416 <table align=center width="87%" cellpadding=5><tr bgcolor="#EEEEFF"><td><em><b>inout</b></em></td></tr><tr><td>
 417 <p></p>
 418 <table cellpadding=3 border=0>
 419 <tr valign=top><td><b>face</b></td><td>
 420 <p>A handle to the source face.</p>
 421 </td></tr>
 422 </table>
 423 </td></tr></table>
 424 <table align=center width="87%" cellpadding=5><tr bgcolor="#EEEEFF"><td><em><b>input</b></em></td></tr><tr><td>
 425 <p></p>
 426 <table cellpadding=3 border=0>
 427 <tr valign=top><td><b>num_coords</b></td><td>
 428 <p>The number of design coordinates (must be equal to the number of axes in the font).</p>
 429 </td></tr>
 430 <tr valign=top><td><b>coords</b></td><td>
 431 <p>An array of design coordinates.</p>
 432 </td></tr>
 433 </table>
 434 </td></tr></table>
 435 <table align=center width="87%" cellpadding=5><tr bgcolor="#EEEEFF"><td><em><b>return</b></em></td></tr><tr><td>
 436 <p>FreeType error code. 0&nbsp;means success.</p>
 437 </td></tr></table>
 438 </td></tr></table>
 439 <hr width="75%">
 440 <table align=center width="75%"><tr><td><font size=-2>[<a href="ft2-index.html">Index</a>]</font></td>
 441 <td width="100%"></td>
 442 <td><font size=-2>[<a href="ft2-toc.html">TOC</a>]</font></td></tr></table>
 443
 444 <table align=center width="75%"><tr><td>
 445 <h4><a name="FT_Set_MM_Blend_Coordinates">FT_Set_MM_Blend_Coordinates</a></h4>
 446 <table align=center width="87%"><tr><td>
 447 Defined in FT_MULTIPLE_MASTERS_H (freetype/ftmm.h).
 448 </td></tr></table><br>
 449 <table align=center width="87%"><tr bgcolor="#D6E8FF"><td><pre>
 450
 451   FT_EXPORT( <a href="ft2-basic_types.html#FT_Error">FT_Error</a> )
 452   <b>FT_Set_MM_Blend_Coordinates</b>( <a href="ft2-base_interface.html#FT_Face">FT_Face</a>    face,
 453                                <a href="ft2-basic_types.html#FT_UInt">FT_UInt</a>    num_coords,
 454                                <a href="ft2-basic_types.html#FT_Fixed">FT_Fixed</a>*  coords );
 455
 456 </pre></table><br>
 457 <table align=center width="87%"><tr><td>
 458 <p>For Multiple Masters and GX var fonts, choose an interpolated font design through normalized blend coordinates.</p>
 459 </td></tr></table><br>
 460 <table align=center width="87%" cellpadding=5><tr bgcolor="#EEEEFF"><td><em><b>inout</b></em></td></tr><tr><td>
 461 <p></p>
 462 <table cellpadding=3 border=0>
 463 <tr valign=top><td><b>face</b></td><td>
 464 <p>A handle to the source face.</p>
 465 </td></tr>
 466 </table>
 467 </td></tr></table>
 468 <table align=center width="87%" cellpadding=5><tr bgcolor="#EEEEFF"><td><em><b>input</b></em></td></tr><tr><td>
 469 <p></p>
 470 <table cellpadding=3 border=0>
 471 <tr valign=top><td><b>num_coords</b></td><td>
 472 <p>The number of design coordinates (must be equal to the number of axes in the font).</p>
 473 </td></tr>
 474 <tr valign=top><td><b>coords</b></td><td>
 475 <p>The design coordinates array (each element must be between 0 and 1.0).</p>
 476 </td></tr>
 477 </table>
 478 </td></tr></table>
 479 <table align=center width="87%" cellpadding=5><tr bgcolor="#EEEEFF"><td><em><b>return</b></em></td></tr><tr><td>
 480 <p>FreeType error code. 0&nbsp;means success.</p>
 481 </td></tr></table>
 482 </td></tr></table>
 483 <hr width="75%">
 484 <table align=center width="75%"><tr><td><font size=-2>[<a href="ft2-index.html">Index</a>]</font></td>
 485 <td width="100%"></td>
 486 <td><font size=-2>[<a href="ft2-toc.html">TOC</a>]</font></td></tr></table>
 487
 488 <table align=center width="75%"><tr><td>
 489 <h4><a name="FT_Set_Var_Blend_Coordinates">FT_Set_Var_Blend_Coordinates</a></h4>
 490 <table align=center width="87%"><tr><td>
 491 Defined in FT_MULTIPLE_MASTERS_H (freetype/ftmm.h).
 492 </td></tr></table><br>
 493 <table align=center width="87%"><tr bgcolor="#D6E8FF"><td><pre>
 494
 495   FT_EXPORT( <a href="ft2-basic_types.html#FT_Error">FT_Error</a> )
 496   <b>FT_Set_Var_Blend_Coordinates</b>( <a href="ft2-base_interface.html#FT_Face">FT_Face</a>    face,
 497                                 <a href="ft2-basic_types.html#FT_UInt">FT_UInt</a>    num_coords,
 498                                 <a href="ft2-basic_types.html#FT_Fixed">FT_Fixed</a>*  coords );
 499
 500 </pre></table><br>
 501 <table align=center width="87%"><tr><td>
 502 <p>This is another name of <a href="ft2-multiple_masters.html#FT_Set_MM_Blend_Coordinates">FT_Set_MM_Blend_Coordinates</a>.</p>
 503 </td></tr></table><br>
 504 </td></tr></table>
 505 <hr width="75%">
 506 <table align=center width="75%"><tr><td><font size=-2>[<a href="ft2-index.html">Index</a>]</font></td>
 507 <td width="100%"></td>
 508 <td><font size=-2>[<a href="ft2-toc.html">TOC</a>]</font></td></tr></table>
 509
 510 </body>
 511 </html>