uboot/drivers/video/stb_truetype.h
<<
>>
Prefs
   1// stb_truetype.h - v1.08 - public domain
   2// authored from 2009-2015 by Sean Barrett / RAD Game Tools
   3//
   4//   This library processes TrueType files:
   5//        parse files
   6//        extract glyph metrics
   7//        extract glyph shapes
   8//        render glyphs to one-channel bitmaps with antialiasing (box filter)
   9//
  10//   Todo:
  11//        non-MS cmaps
  12//        crashproof on bad data
  13//        hinting? (no longer patented)
  14//        cleartype-style AA?
  15//        optimize: use simple memory allocator for intermediates
  16//        optimize: build edge-list directly from curves
  17//        optimize: rasterize directly from curves?
  18//
  19// ADDITIONAL CONTRIBUTORS
  20//
  21//   Mikko Mononen: compound shape support, more cmap formats
  22//   Tor Andersson: kerning, subpixel rendering
  23//
  24//   Bug/warning reports/fixes:
  25//       "Zer" on mollyrocket (with fix)
  26//       Cass Everitt
  27//       stoiko (Haemimont Games)
  28//       Brian Hook 
  29//       Walter van Niftrik
  30//       David Gow
  31//       David Given
  32//       Ivan-Assen Ivanov
  33//       Anthony Pesch
  34//       Johan Duparc
  35//       Hou Qiming
  36//       Fabian "ryg" Giesen
  37//       Martins Mozeiko
  38//       Cap Petschulat
  39//       Omar Cornut
  40//       github:aloucks
  41//       Peter LaValle
  42//       Sergey Popov
  43//       Giumo X. Clanjor
  44//       Higor Euripedes
  45//
  46//   Misc other:
  47//       Ryan Gordon
  48//
  49// VERSION HISTORY
  50//
  51//   1.08 (2015-09-13) document stbtt_Rasterize(); fixes for vertical & horizontal edges
  52//   1.07 (2015-08-01) allow PackFontRanges to accept arrays of sparse codepoints;
  53//                     variant PackFontRanges to pack and render in separate phases;
  54//                     fix stbtt_GetFontOFfsetForIndex (never worked for non-0 input?);
  55//                     fixed an assert() bug in the new rasterizer
  56//                     replace assert() with STBTT_assert() in new rasterizer
  57//   1.06 (2015-07-14) performance improvements (~35% faster on x86 and x64 on test machine)
  58//                     also more precise AA rasterizer, except if shapes overlap
  59//                     remove need for STBTT_sort
  60//   1.05 (2015-04-15) fix misplaced definitions for STBTT_STATIC
  61//   1.04 (2015-04-15) typo in example
  62//   1.03 (2015-04-12) STBTT_STATIC, fix memory leak in new packing, various fixes
  63//
  64//   Full history can be found at the end of this file.
  65//
  66// LICENSE
  67//
  68//   This software is in the public domain. Where that dedication is not
  69//   recognized, you are granted a perpetual, irrevocable license to copy,
  70//   distribute, and modify this file as you see fit.
  71//
  72// USAGE
  73//
  74//   Include this file in whatever places neeed to refer to it. In ONE C/C++
  75//   file, write:
  76//      #define STB_TRUETYPE_IMPLEMENTATION
  77//   before the #include of this file. This expands out the actual
  78//   implementation into that C/C++ file.
  79//
  80//   To make the implementation private to the file that generates the implementation,
  81//      #define STBTT_STATIC
  82//
  83//   Simple 3D API (don't ship this, but it's fine for tools and quick start)
  84//           stbtt_BakeFontBitmap()               -- bake a font to a bitmap for use as texture
  85//           stbtt_GetBakedQuad()                 -- compute quad to draw for a given char
  86//
  87//   Improved 3D API (more shippable):
  88//           #include "stb_rect_pack.h"           -- optional, but you really want it
  89//           stbtt_PackBegin()
  90//           stbtt_PackSetOversample()            -- for improved quality on small fonts
  91//           stbtt_PackFontRanges()               -- pack and renders
  92//           stbtt_PackEnd()
  93//           stbtt_GetPackedQuad()
  94//
  95//   "Load" a font file from a memory buffer (you have to keep the buffer loaded)
  96//           stbtt_InitFont()
  97//           stbtt_GetFontOffsetForIndex()        -- use for TTC font collections
  98//
  99//   Render a unicode codepoint to a bitmap
 100//           stbtt_GetCodepointBitmap()           -- allocates and returns a bitmap
 101//           stbtt_MakeCodepointBitmap()          -- renders into bitmap you provide
 102//           stbtt_GetCodepointBitmapBox()        -- how big the bitmap must be
 103//
 104//   Character advance/positioning
 105//           stbtt_GetCodepointHMetrics()
 106//           stbtt_GetFontVMetrics()
 107//           stbtt_GetCodepointKernAdvance()
 108//
 109//   Starting with version 1.06, the rasterizer was replaced with a new,
 110//   faster and generally-more-precise rasterizer. The new rasterizer more
 111//   accurately measures pixel coverage for anti-aliasing, except in the case
 112//   where multiple shapes overlap, in which case it overestimates the AA pixel
 113//   coverage. Thus, anti-aliasing of intersecting shapes may look wrong. If
 114//   this turns out to be a problem, you can re-enable the old rasterizer with
 115//        #define STBTT_RASTERIZER_VERSION 1
 116//   which will incur about a 15% speed hit.
 117//
 118// ADDITIONAL DOCUMENTATION
 119//
 120//   Immediately after this block comment are a series of sample programs.
 121//
 122//   After the sample programs is the "header file" section. This section
 123//   includes documentation for each API function.
 124//
 125//   Some important concepts to understand to use this library:
 126//
 127//      Codepoint
 128//         Characters are defined by unicode codepoints, e.g. 65 is
 129//         uppercase A, 231 is lowercase c with a cedilla, 0x7e30 is
 130//         the hiragana for "ma".
 131//
 132//      Glyph
 133//         A visual character shape (every codepoint is rendered as
 134//         some glyph)
 135//
 136//      Glyph index
 137//         A font-specific integer ID representing a glyph
 138//
 139//      Baseline
 140//         Glyph shapes are defined relative to a baseline, which is the
 141//         bottom of uppercase characters. Characters extend both above
 142//         and below the baseline.
 143//
 144//      Current Point
 145//         As you draw text to the screen, you keep track of a "current point"
 146//         which is the origin of each character. The current point's vertical
 147//         position is the baseline. Even "baked fonts" use this model.
 148//
 149//      Vertical Font Metrics
 150//         The vertical qualities of the font, used to vertically position
 151//         and space the characters. See docs for stbtt_GetFontVMetrics.
 152//
 153//      Font Size in Pixels or Points
 154//         The preferred interface for specifying font sizes in stb_truetype
 155//         is to specify how tall the font's vertical extent should be in pixels.
 156//         If that sounds good enough, skip the next paragraph.
 157//
 158//         Most font APIs instead use "points", which are a common typographic
 159//         measurement for describing font size, defined as 72 points per inch.
 160//         stb_truetype provides a point API for compatibility. However, true
 161//         "per inch" conventions don't make much sense on computer displays
 162//         since they different monitors have different number of pixels per
 163//         inch. For example, Windows traditionally uses a convention that
 164//         there are 96 pixels per inch, thus making 'inch' measurements have
 165//         nothing to do with inches, and thus effectively defining a point to
 166//         be 1.333 pixels. Additionally, the TrueType font data provides
 167//         an explicit scale factor to scale a given font's glyphs to points,
 168//         but the author has observed that this scale factor is often wrong
 169//         for non-commercial fonts, thus making fonts scaled in points
 170//         according to the TrueType spec incoherently sized in practice.
 171//
 172// ADVANCED USAGE
 173//
 174//   Quality:
 175//
 176//    - Use the functions with Subpixel at the end to allow your characters
 177//      to have subpixel positioning. Since the font is anti-aliased, not
 178//      hinted, this is very import for quality. (This is not possible with
 179//      baked fonts.)
 180//
 181//    - Kerning is now supported, and if you're supporting subpixel rendering
 182//      then kerning is worth using to give your text a polished look.
 183//
 184//   Performance:
 185//
 186//    - Convert Unicode codepoints to glyph indexes and operate on the glyphs;
 187//      if you don't do this, stb_truetype is forced to do the conversion on
 188//      every call.
 189//
 190//    - There are a lot of memory allocations. We should modify it to take
 191//      a temp buffer and allocate from the temp buffer (without freeing),
 192//      should help performance a lot.
 193//
 194// NOTES
 195//
 196//   The system uses the raw data found in the .ttf file without changing it
 197//   and without building auxiliary data structures. This is a bit inefficient
 198//   on little-endian systems (the data is big-endian), but assuming you're
 199//   caching the bitmaps or glyph shapes this shouldn't be a big deal.
 200//
 201//   It appears to be very hard to programmatically determine what font a
 202//   given file is in a general way. I provide an API for this, but I don't
 203//   recommend it.
 204//
 205//
 206// SOURCE STATISTICS (based on v0.6c, 2050 LOC)
 207//
 208//   Documentation & header file        520 LOC  \___ 660 LOC documentation
 209//   Sample code                        140 LOC  /
 210//   Truetype parsing                   620 LOC  ---- 620 LOC TrueType
 211//   Software rasterization             240 LOC  \                           .
 212//   Curve tesselation                  120 LOC   \__ 550 LOC Bitmap creation
 213//   Bitmap management                  100 LOC   /
 214//   Baked bitmap interface              70 LOC  /
 215//   Font name matching & access        150 LOC  ---- 150 
 216//   C runtime library abstraction       60 LOC  ----  60
 217//
 218//
 219// PERFORMANCE MEASUREMENTS FOR 1.06:
 220//
 221//                      32-bit     64-bit
 222//   Previous release:  8.83 s     7.68 s
 223//   Pool allocations:  7.72 s     6.34 s
 224//   Inline sort     :  6.54 s     5.65 s
 225//   New rasterizer  :  5.63 s     5.00 s
 226
 227//////////////////////////////////////////////////////////////////////////////
 228//////////////////////////////////////////////////////////////////////////////
 229////
 230////  SAMPLE PROGRAMS
 231////
 232//
 233//  Incomplete text-in-3d-api example, which draws quads properly aligned to be lossless
 234//
 235#if 0
 236#define STB_TRUETYPE_IMPLEMENTATION  // force following include to generate implementation
 237#include "stb_truetype.h"
 238
 239unsigned char ttf_buffer[1<<20];
 240unsigned char temp_bitmap[512*512];
 241
 242stbtt_bakedchar cdata[96]; // ASCII 32..126 is 95 glyphs
 243GLuint ftex;
 244
 245void my_stbtt_initfont(void)
 246{
 247   fread(ttf_buffer, 1, 1<<20, fopen("c:/windows/fonts/times.ttf", "rb"));
 248   stbtt_BakeFontBitmap(ttf_buffer,0, 32.0, temp_bitmap,512,512, 32,96, cdata); // no guarantee this fits!
 249   // can free ttf_buffer at this point
 250   glGenTextures(1, &ftex);
 251   glBindTexture(GL_TEXTURE_2D, ftex);
 252   glTexImage2D(GL_TEXTURE_2D, 0, GL_ALPHA, 512,512, 0, GL_ALPHA, GL_UNSIGNED_BYTE, temp_bitmap);
 253   // can free temp_bitmap at this point
 254   glTexParameteri(GL_TEXTURE_2D, GL_TEXTURE_MIN_FILTER, GL_LINEAR);
 255}
 256
 257void my_stbtt_print(float x, float y, char *text)
 258{
 259   // assume orthographic projection with units = screen pixels, origin at top left
 260   glEnable(GL_TEXTURE_2D);
 261   glBindTexture(GL_TEXTURE_2D, ftex);
 262   glBegin(GL_QUADS);
 263   while (*text) {
 264      if (*text >= 32 && *text < 128) {
 265         stbtt_aligned_quad q;
 266         stbtt_GetBakedQuad(cdata, 512,512, *text-32, &x,&y,&q,1);//1=opengl & d3d10+,0=d3d9
 267         glTexCoord2f(q.s0,q.t1); glVertex2f(q.x0,q.y0);
 268         glTexCoord2f(q.s1,q.t1); glVertex2f(q.x1,q.y0);
 269         glTexCoord2f(q.s1,q.t0); glVertex2f(q.x1,q.y1);
 270         glTexCoord2f(q.s0,q.t0); glVertex2f(q.x0,q.y1);
 271      }
 272      ++text;
 273   }
 274   glEnd();
 275}
 276#endif
 277//
 278//
 279//////////////////////////////////////////////////////////////////////////////
 280//
 281// Complete program (this compiles): get a single bitmap, print as ASCII art
 282//
 283#if 0
 284#include <stdio.h>
 285#define STB_TRUETYPE_IMPLEMENTATION  // force following include to generate implementation
 286#include "stb_truetype.h"
 287
 288char ttf_buffer[1<<25];
 289
 290int main(int argc, char **argv)
 291{
 292   stbtt_fontinfo font;
 293   unsigned char *bitmap;
 294   int w,h,i,j,c = (argc > 1 ? atoi(argv[1]) : 'a'), s = (argc > 2 ? atoi(argv[2]) : 20);
 295
 296   fread(ttf_buffer, 1, 1<<25, fopen(argc > 3 ? argv[3] : "c:/windows/fonts/arialbd.ttf", "rb"));
 297
 298   stbtt_InitFont(&font, ttf_buffer, stbtt_GetFontOffsetForIndex(ttf_buffer,0));
 299   bitmap = stbtt_GetCodepointBitmap(&font, 0,stbtt_ScaleForPixelHeight(&font, s), c, &w, &h, 0,0);
 300
 301   for (j=0; j < h; ++j) {
 302      for (i=0; i < w; ++i)
 303         putchar(" .:ioVM@"[bitmap[j*w+i]>>5]);
 304      putchar('\n');
 305   }
 306   return 0;
 307}
 308#endif 
 309//
 310// Output:
 311//
 312//     .ii.
 313//    @@@@@@.
 314//   V@Mio@@o
 315//   :i.  V@V
 316//     :oM@@M
 317//   :@@@MM@M
 318//   @@o  o@M
 319//  :@@.  M@M
 320//   @@@o@@@@
 321//   :M@@V:@@.
 322//  
 323//////////////////////////////////////////////////////////////////////////////
 324// 
 325// Complete program: print "Hello World!" banner, with bugs
 326//
 327#if 0
 328char buffer[24<<20];
 329unsigned char screen[20][79];
 330
 331int main(int arg, char **argv)
 332{
 333   stbtt_fontinfo font;
 334   int i,j,ascent,baseline,ch=0;
 335   float scale, xpos=2; // leave a little padding in case the character extends left
 336   char *text = "Heljo World!"; // intentionally misspelled to show 'lj' brokenness
 337
 338   fread(buffer, 1, 1000000, fopen("c:/windows/fonts/arialbd.ttf", "rb"));
 339   stbtt_InitFont(&font, buffer, 0);
 340
 341   scale = stbtt_ScaleForPixelHeight(&font, 15);
 342   stbtt_GetFontVMetrics(&font, &ascent,0,0);
 343   baseline = (int) (ascent*scale);
 344
 345   while (text[ch]) {
 346      int advance,lsb,x0,y0,x1,y1;
 347      float x_shift = xpos - (float) floor(xpos);
 348      stbtt_GetCodepointHMetrics(&font, text[ch], &advance, &lsb);
 349      stbtt_GetCodepointBitmapBoxSubpixel(&font, text[ch], scale,scale,x_shift,0, &x0,&y0,&x1,&y1);
 350      stbtt_MakeCodepointBitmapSubpixel(&font, &screen[baseline + y0][(int) xpos + x0], x1-x0,y1-y0, 79, scale,scale,x_shift,0, text[ch]);
 351      // note that this stomps the old data, so where character boxes overlap (e.g. 'lj') it's wrong
 352      // because this API is really for baking character bitmaps into textures. if you want to render
 353      // a sequence of characters, you really need to render each bitmap to a temp buffer, then
 354      // "alpha blend" that into the working buffer
 355      xpos += (advance * scale);
 356      if (text[ch+1])
 357         xpos += scale*stbtt_GetCodepointKernAdvance(&font, text[ch],text[ch+1]);
 358      ++ch;
 359   }
 360
 361   for (j=0; j < 20; ++j) {
 362      for (i=0; i < 78; ++i)
 363         putchar(" .:ioVM@"[screen[j][i]>>5]);
 364      putchar('\n');
 365   }
 366
 367   return 0;
 368}
 369#endif
 370
 371
 372//////////////////////////////////////////////////////////////////////////////
 373//////////////////////////////////////////////////////////////////////////////
 374////
 375////   INTEGRATION WITH YOUR CODEBASE
 376////
 377////   The following sections allow you to supply alternate definitions
 378////   of C library functions used by stb_truetype.
 379
 380#ifdef STB_TRUETYPE_IMPLEMENTATION
 381   // #define your own (u)stbtt_int8/16/32 before including to override this
 382   #ifndef stbtt_uint8
 383   typedef unsigned char   stbtt_uint8;
 384   typedef signed   char   stbtt_int8;
 385   typedef unsigned short  stbtt_uint16;
 386   typedef signed   short  stbtt_int16;
 387   typedef unsigned int    stbtt_uint32;
 388   typedef signed   int    stbtt_int32;
 389   #endif
 390
 391   typedef char stbtt__check_size32[sizeof(stbtt_int32)==4 ? 1 : -1];
 392   typedef char stbtt__check_size16[sizeof(stbtt_int16)==2 ? 1 : -1];
 393
 394   // #define your own STBTT_ifloor/STBTT_iceil() to avoid math.h
 395   #ifndef STBTT_ifloor
 396   #include <math.h>
 397   #define STBTT_ifloor(x)   ((int) floor(x))
 398   #define STBTT_iceil(x)    ((int) ceil(x))
 399   #endif
 400
 401   #ifndef STBTT_sqrt
 402   #include <math.h>
 403   #define STBTT_sqrt(x)      sqrt(x)
 404   #endif
 405
 406   #ifndef STBTT_fabs
 407   #include <math.h>
 408   #define STBTT_fabs(x)      fabs(x)
 409   #endif
 410
 411   // #define your own functions "STBTT_malloc" / "STBTT_free" to avoid malloc.h
 412   #ifndef STBTT_malloc
 413   #include <stdlib.h>
 414   #define STBTT_malloc(x,u)  ((void)(u),malloc(x))
 415   #define STBTT_free(x,u)    ((void)(u),free(x))
 416   #endif
 417
 418   #ifndef STBTT_assert
 419   #include <assert.h>
 420   #define STBTT_assert(x)    assert(x)
 421   #endif
 422
 423   #ifndef STBTT_strlen
 424   #include <string.h>
 425   #define STBTT_strlen(x)    strlen(x)
 426   #endif
 427
 428   #ifndef STBTT_memcpy
 429   #include <memory.h>
 430   #define STBTT_memcpy       memcpy
 431   #define STBTT_memset       memset
 432   #endif
 433#endif
 434
 435///////////////////////////////////////////////////////////////////////////////
 436///////////////////////////////////////////////////////////////////////////////
 437////
 438////   INTERFACE
 439////
 440////
 441
 442#ifndef __STB_INCLUDE_STB_TRUETYPE_H__
 443#define __STB_INCLUDE_STB_TRUETYPE_H__
 444
 445#ifdef STBTT_STATIC
 446#define STBTT_DEF static
 447#else
 448#define STBTT_DEF extern
 449#endif
 450
 451#ifdef __cplusplus
 452extern "C" {
 453#endif
 454
 455//////////////////////////////////////////////////////////////////////////////
 456//
 457// TEXTURE BAKING API
 458//
 459// If you use this API, you only have to call two functions ever.
 460//
 461
 462typedef struct
 463{
 464   unsigned short x0,y0,x1,y1; // coordinates of bbox in bitmap
 465   float xoff,yoff,xadvance;
 466} stbtt_bakedchar;
 467
 468STBTT_DEF int stbtt_BakeFontBitmap(const unsigned char *data, int offset,  // font location (use offset=0 for plain .ttf)
 469                                float pixel_height,                     // height of font in pixels
 470                                unsigned char *pixels, int pw, int ph,  // bitmap to be filled in
 471                                int first_char, int num_chars,          // characters to bake
 472                                stbtt_bakedchar *chardata);             // you allocate this, it's num_chars long
 473// if return is positive, the first unused row of the bitmap
 474// if return is negative, returns the negative of the number of characters that fit
 475// if return is 0, no characters fit and no rows were used
 476// This uses a very crappy packing.
 477
 478typedef struct
 479{
 480   float x0,y0,s0,t0; // top-left
 481   float x1,y1,s1,t1; // bottom-right
 482} stbtt_aligned_quad;
 483
 484STBTT_DEF void stbtt_GetBakedQuad(stbtt_bakedchar *chardata, int pw, int ph,  // same data as above
 485                               int char_index,             // character to display
 486                               float *xpos, float *ypos,   // pointers to current position in screen pixel space
 487                               stbtt_aligned_quad *q,      // output: quad to draw
 488                               int opengl_fillrule);       // true if opengl fill rule; false if DX9 or earlier
 489// Call GetBakedQuad with char_index = 'character - first_char', and it
 490// creates the quad you need to draw and advances the current position.
 491//
 492// The coordinate system used assumes y increases downwards.
 493//
 494// Characters will extend both above and below the current position;
 495// see discussion of "BASELINE" above.
 496//
 497// It's inefficient; you might want to c&p it and optimize it.
 498
 499
 500//////////////////////////////////////////////////////////////////////////////
 501//
 502// NEW TEXTURE BAKING API
 503//
 504// This provides options for packing multiple fonts into one atlas, not
 505// perfectly but better than nothing.
 506
 507typedef struct
 508{
 509   unsigned short x0,y0,x1,y1; // coordinates of bbox in bitmap
 510   float xoff,yoff,xadvance;
 511   float xoff2,yoff2;
 512} stbtt_packedchar;
 513
 514typedef struct stbtt_pack_context stbtt_pack_context;
 515typedef struct stbtt_fontinfo stbtt_fontinfo;
 516#ifndef STB_RECT_PACK_VERSION
 517typedef struct stbrp_rect stbrp_rect;
 518#endif
 519
 520STBTT_DEF int  stbtt_PackBegin(stbtt_pack_context *spc, unsigned char *pixels, int width, int height, int stride_in_bytes, int padding, void *alloc_context);
 521// Initializes a packing context stored in the passed-in stbtt_pack_context.
 522// Future calls using this context will pack characters into the bitmap passed
 523// in here: a 1-channel bitmap that is weight x height. stride_in_bytes is
 524// the distance from one row to the next (or 0 to mean they are packed tightly
 525// together). "padding" is the amount of padding to leave between each
 526// character (normally you want '1' for bitmaps you'll use as textures with
 527// bilinear filtering).
 528//
 529// Returns 0 on failure, 1 on success.
 530
 531STBTT_DEF void stbtt_PackEnd  (stbtt_pack_context *spc);
 532// Cleans up the packing context and frees all memory.
 533
 534#define STBTT_POINT_SIZE(x)   (-(x))
 535
 536STBTT_DEF int  stbtt_PackFontRange(stbtt_pack_context *spc, unsigned char *fontdata, int font_index, float font_size,
 537                                int first_unicode_char_in_range, int num_chars_in_range, stbtt_packedchar *chardata_for_range);
 538// Creates character bitmaps from the font_index'th font found in fontdata (use
 539// font_index=0 if you don't know what that is). It creates num_chars_in_range
 540// bitmaps for characters with unicode values starting at first_unicode_char_in_range
 541// and increasing. Data for how to render them is stored in chardata_for_range;
 542// pass these to stbtt_GetPackedQuad to get back renderable quads.
 543//
 544// font_size is the full height of the character from ascender to descender,
 545// as computed by stbtt_ScaleForPixelHeight. To use a point size as computed
 546// by stbtt_ScaleForMappingEmToPixels, wrap the point size in STBTT_POINT_SIZE()
 547// and pass that result as 'font_size':
 548//       ...,                  20 , ... // font max minus min y is 20 pixels tall
 549//       ..., STBTT_POINT_SIZE(20), ... // 'M' is 20 pixels tall
 550
 551typedef struct
 552{
 553   float font_size;
 554   int first_unicode_codepoint_in_range;  // if non-zero, then the chars are continuous, and this is the first codepoint
 555   int *array_of_unicode_codepoints;       // if non-zero, then this is an array of unicode codepoints
 556   int num_chars;
 557   stbtt_packedchar *chardata_for_range; // output
 558   unsigned char h_oversample, v_oversample; // don't set these, they're used internally
 559} stbtt_pack_range;
 560
 561STBTT_DEF int  stbtt_PackFontRanges(stbtt_pack_context *spc, unsigned char *fontdata, int font_index, stbtt_pack_range *ranges, int num_ranges);
 562// Creates character bitmaps from multiple ranges of characters stored in
 563// ranges. This will usually create a better-packed bitmap than multiple
 564// calls to stbtt_PackFontRange. Note that you can call this multiple
 565// times within a single PackBegin/PackEnd.
 566
 567STBTT_DEF void stbtt_PackSetOversampling(stbtt_pack_context *spc, unsigned int h_oversample, unsigned int v_oversample);
 568// Oversampling a font increases the quality by allowing higher-quality subpixel
 569// positioning, and is especially valuable at smaller text sizes.
 570//
 571// This function sets the amount of oversampling for all following calls to
 572// stbtt_PackFontRange(s) or stbtt_PackFontRangesGatherRects for a given
 573// pack context. The default (no oversampling) is achieved by h_oversample=1
 574// and v_oversample=1. The total number of pixels required is
 575// h_oversample*v_oversample larger than the default; for example, 2x2
 576// oversampling requires 4x the storage of 1x1. For best results, render
 577// oversampled textures with bilinear filtering. Look at the readme in
 578// stb/tests/oversample for information about oversampled fonts
 579//
 580// To use with PackFontRangesGather etc., you must set it before calls
 581// call to PackFontRangesGatherRects.
 582
 583STBTT_DEF void stbtt_GetPackedQuad(stbtt_packedchar *chardata, int pw, int ph,  // same data as above
 584                               int char_index,             // character to display
 585                               float *xpos, float *ypos,   // pointers to current position in screen pixel space
 586                               stbtt_aligned_quad *q,      // output: quad to draw
 587                               int align_to_integer);
 588
 589STBTT_DEF int  stbtt_PackFontRangesGatherRects(stbtt_pack_context *spc, stbtt_fontinfo *info, stbtt_pack_range *ranges, int num_ranges, stbrp_rect *rects);
 590STBTT_DEF void stbtt_PackFontRangesPackRects(stbtt_pack_context *spc, stbrp_rect *rects, int num_rects);
 591STBTT_DEF int  stbtt_PackFontRangesRenderIntoRects(stbtt_pack_context *spc, stbtt_fontinfo *info, stbtt_pack_range *ranges, int num_ranges, stbrp_rect *rects);
 592// Calling these functions in sequence is roughly equivalent to calling
 593// stbtt_PackFontRanges(). If you more control over the packing of multiple
 594// fonts, or if you want to pack custom data into a font texture, take a look
 595// at the source to of stbtt_PackFontRanges() and create a custom version 
 596// using these functions, e.g. call GatherRects multiple times,
 597// building up a single array of rects, then call PackRects once,
 598// then call RenderIntoRects repeatedly. This may result in a
 599// better packing than calling PackFontRanges multiple times
 600// (or it may not).
 601
 602// this is an opaque structure that you shouldn't mess with which holds
 603// all the context needed from PackBegin to PackEnd.
 604struct stbtt_pack_context {
 605   void *user_allocator_context;
 606   void *pack_info;
 607   int   width;
 608   int   height;
 609   int   stride_in_bytes;
 610   int   padding;
 611   unsigned int   h_oversample, v_oversample;
 612   unsigned char *pixels;
 613   void  *nodes;
 614};
 615
 616//////////////////////////////////////////////////////////////////////////////
 617//
 618// FONT LOADING
 619//
 620//
 621
 622STBTT_DEF int stbtt_GetFontOffsetForIndex(const unsigned char *data, int index);
 623// Each .ttf/.ttc file may have more than one font. Each font has a sequential
 624// index number starting from 0. Call this function to get the font offset for
 625// a given index; it returns -1 if the index is out of range. A regular .ttf
 626// file will only define one font and it always be at offset 0, so it will
 627// return '0' for index 0, and -1 for all other indices. You can just skip
 628// this step if you know it's that kind of font.
 629
 630
 631// The following structure is defined publically so you can declare one on
 632// the stack or as a global or etc, but you should treat it as opaque.
 633typedef struct stbtt_fontinfo
 634{
 635   void           * userdata;
 636   unsigned char  * data;              // pointer to .ttf file
 637   int              fontstart;         // offset of start of font
 638
 639   int numGlyphs;                     // number of glyphs, needed for range checking
 640
 641   int loca,head,glyf,hhea,hmtx,kern; // table locations as offset from start of .ttf
 642   int index_map;                     // a cmap mapping for our chosen character encoding
 643   int indexToLocFormat;              // format needed to map from glyph index to glyph
 644} stbtt_fontinfo;
 645
 646STBTT_DEF int stbtt_InitFont(stbtt_fontinfo *info, const unsigned char *data, int offset);
 647// Given an offset into the file that defines a font, this function builds
 648// the necessary cached info for the rest of the system. You must allocate
 649// the stbtt_fontinfo yourself, and stbtt_InitFont will fill it out. You don't
 650// need to do anything special to free it, because the contents are pure
 651// value data with no additional data structures. Returns 0 on failure.
 652
 653
 654//////////////////////////////////////////////////////////////////////////////
 655//
 656// CHARACTER TO GLYPH-INDEX CONVERSIOn
 657
 658STBTT_DEF int stbtt_FindGlyphIndex(const stbtt_fontinfo *info, int unicode_codepoint);
 659// If you're going to perform multiple operations on the same character
 660// and you want a speed-up, call this function with the character you're
 661// going to process, then use glyph-based functions instead of the
 662// codepoint-based functions.
 663
 664
 665//////////////////////////////////////////////////////////////////////////////
 666//
 667// CHARACTER PROPERTIES
 668//
 669
 670STBTT_DEF float stbtt_ScaleForPixelHeight(const stbtt_fontinfo *info, float pixels);
 671// computes a scale factor to produce a font whose "height" is 'pixels' tall.
 672// Height is measured as the distance from the highest ascender to the lowest
 673// descender; in other words, it's equivalent to calling stbtt_GetFontVMetrics
 674// and computing:
 675//       scale = pixels / (ascent - descent)
 676// so if you prefer to measure height by the ascent only, use a similar calculation.
 677
 678STBTT_DEF float stbtt_ScaleForMappingEmToPixels(const stbtt_fontinfo *info, float pixels);
 679// computes a scale factor to produce a font whose EM size is mapped to
 680// 'pixels' tall. This is probably what traditional APIs compute, but
 681// I'm not positive.
 682
 683STBTT_DEF void stbtt_GetFontVMetrics(const stbtt_fontinfo *info, int *ascent, int *descent, int *lineGap);
 684// ascent is the coordinate above the baseline the font extends; descent
 685// is the coordinate below the baseline the font extends (i.e. it is typically negative)
 686// lineGap is the spacing between one row's descent and the next row's ascent...
 687// so you should advance the vertical position by "*ascent - *descent + *lineGap"
 688//   these are expressed in unscaled coordinates, so you must multiply by
 689//   the scale factor for a given size
 690
 691STBTT_DEF void stbtt_GetFontBoundingBox(const stbtt_fontinfo *info, int *x0, int *y0, int *x1, int *y1);
 692// the bounding box around all possible characters
 693
 694STBTT_DEF void stbtt_GetCodepointHMetrics(const stbtt_fontinfo *info, int codepoint, int *advanceWidth, int *leftSideBearing);
 695// leftSideBearing is the offset from the current horizontal position to the left edge of the character
 696// advanceWidth is the offset from the current horizontal position to the next horizontal position
 697//   these are expressed in unscaled coordinates
 698
 699STBTT_DEF int  stbtt_GetCodepointKernAdvance(const stbtt_fontinfo *info, int ch1, int ch2);
 700// an additional amount to add to the 'advance' value between ch1 and ch2
 701
 702STBTT_DEF int stbtt_GetCodepointBox(const stbtt_fontinfo *info, int codepoint, int *x0, int *y0, int *x1, int *y1);
 703// Gets the bounding box of the visible part of the glyph, in unscaled coordinates
 704
 705STBTT_DEF void stbtt_GetGlyphHMetrics(const stbtt_fontinfo *info, int glyph_index, int *advanceWidth, int *leftSideBearing);
 706STBTT_DEF int  stbtt_GetGlyphKernAdvance(const stbtt_fontinfo *info, int glyph1, int glyph2);
 707STBTT_DEF int  stbtt_GetGlyphBox(const stbtt_fontinfo *info, int glyph_index, int *x0, int *y0, int *x1, int *y1);
 708// as above, but takes one or more glyph indices for greater efficiency
 709
 710
 711//////////////////////////////////////////////////////////////////////////////
 712//
 713// GLYPH SHAPES (you probably don't need these, but they have to go before
 714// the bitmaps for C declaration-order reasons)
 715//
 716
 717#ifndef STBTT_vmove // you can predefine these to use different values (but why?)
 718   enum {
 719      STBTT_vmove=1,
 720      STBTT_vline,
 721      STBTT_vcurve
 722   };
 723#endif
 724
 725#ifndef stbtt_vertex // you can predefine this to use different values
 726                   // (we share this with other code at RAD)
 727   #define stbtt_vertex_type short // can't use stbtt_int16 because that's not visible in the header file
 728   typedef struct
 729   {
 730      stbtt_vertex_type x,y,cx,cy;
 731      unsigned char type,padding;
 732   } stbtt_vertex;
 733#endif
 734
 735STBTT_DEF int stbtt_IsGlyphEmpty(const stbtt_fontinfo *info, int glyph_index);
 736// returns non-zero if nothing is drawn for this glyph
 737
 738STBTT_DEF int stbtt_GetCodepointShape(const stbtt_fontinfo *info, int unicode_codepoint, stbtt_vertex **vertices);
 739STBTT_DEF int stbtt_GetGlyphShape(const stbtt_fontinfo *info, int glyph_index, stbtt_vertex **vertices);
 740// returns # of vertices and fills *vertices with the pointer to them
 741//   these are expressed in "unscaled" coordinates
 742//
 743// The shape is a series of countours. Each one starts with
 744// a STBTT_moveto, then consists of a series of mixed
 745// STBTT_lineto and STBTT_curveto segments. A lineto
 746// draws a line from previous endpoint to its x,y; a curveto
 747// draws a quadratic bezier from previous endpoint to
 748// its x,y, using cx,cy as the bezier control point.
 749
 750STBTT_DEF void stbtt_FreeShape(const stbtt_fontinfo *info, stbtt_vertex *vertices);
 751// frees the data allocated above
 752
 753//////////////////////////////////////////////////////////////////////////////
 754//
 755// BITMAP RENDERING
 756//
 757
 758STBTT_DEF void stbtt_FreeBitmap(unsigned char *bitmap, void *userdata);
 759// frees the bitmap allocated below
 760
 761STBTT_DEF unsigned char *stbtt_GetCodepointBitmap(const stbtt_fontinfo *info, float scale_x, float scale_y, int codepoint, int *width, int *height, int *xoff, int *yoff);
 762// allocates a large-enough single-channel 8bpp bitmap and renders the
 763// specified character/glyph at the specified scale into it, with
 764// antialiasing. 0 is no coverage (transparent), 255 is fully covered (opaque).
 765// *width & *height are filled out with the width & height of the bitmap,
 766// which is stored left-to-right, top-to-bottom.
 767//
 768// xoff/yoff are the offset it pixel space from the glyph origin to the top-left of the bitmap
 769
 770STBTT_DEF unsigned char *stbtt_GetCodepointBitmapSubpixel(const stbtt_fontinfo *info, float scale_x, float scale_y, float shift_x, float shift_y, int codepoint, int *width, int *height, int *xoff, int *yoff);
 771// the same as stbtt_GetCodepoitnBitmap, but you can specify a subpixel
 772// shift for the character
 773
 774STBTT_DEF void stbtt_MakeCodepointBitmap(const stbtt_fontinfo *info, unsigned char *output, int out_w, int out_h, int out_stride, float scale_x, float scale_y, int codepoint);
 775// the same as stbtt_GetCodepointBitmap, but you pass in storage for the bitmap
 776// in the form of 'output', with row spacing of 'out_stride' bytes. the bitmap
 777// is clipped to out_w/out_h bytes. Call stbtt_GetCodepointBitmapBox to get the
 778// width and height and positioning info for it first.
 779
 780STBTT_DEF void stbtt_MakeCodepointBitmapSubpixel(const stbtt_fontinfo *info, unsigned char *output, int out_w, int out_h, int out_stride, float scale_x, float scale_y, float shift_x, float shift_y, int codepoint);
 781// same as stbtt_MakeCodepointBitmap, but you can specify a subpixel
 782// shift for the character
 783
 784STBTT_DEF void stbtt_GetCodepointBitmapBox(const stbtt_fontinfo *font, int codepoint, float scale_x, float scale_y, int *ix0, int *iy0, int *ix1, int *iy1);
 785// get the bbox of the bitmap centered around the glyph origin; so the
 786// bitmap width is ix1-ix0, height is iy1-iy0, and location to place
 787// the bitmap top left is (leftSideBearing*scale,iy0).
 788// (Note that the bitmap uses y-increases-down, but the shape uses
 789// y-increases-up, so CodepointBitmapBox and CodepointBox are inverted.)
 790
 791STBTT_DEF void stbtt_GetCodepointBitmapBoxSubpixel(const stbtt_fontinfo *font, int codepoint, float scale_x, float scale_y, float shift_x, float shift_y, int *ix0, int *iy0, int *ix1, int *iy1);
 792// same as stbtt_GetCodepointBitmapBox, but you can specify a subpixel
 793// shift for the character
 794
 795// the following functions are equivalent to the above functions, but operate
 796// on glyph indices instead of Unicode codepoints (for efficiency)
 797STBTT_DEF unsigned char *stbtt_GetGlyphBitmap(const stbtt_fontinfo *info, float scale_x, float scale_y, int glyph, int *width, int *height, int *xoff, int *yoff);
 798STBTT_DEF unsigned char *stbtt_GetGlyphBitmapSubpixel(const stbtt_fontinfo *info, float scale_x, float scale_y, float shift_x, float shift_y, int glyph, int *width, int *height, int *xoff, int *yoff);
 799STBTT_DEF void stbtt_MakeGlyphBitmap(const stbtt_fontinfo *info, unsigned char *output, int out_w, int out_h, int out_stride, float scale_x, float scale_y, int glyph);
 800STBTT_DEF void stbtt_MakeGlyphBitmapSubpixel(const stbtt_fontinfo *info, unsigned char *output, int out_w, int out_h, int out_stride, float scale_x, float scale_y, float shift_x, float shift_y, int glyph);
 801STBTT_DEF void stbtt_GetGlyphBitmapBox(const stbtt_fontinfo *font, int glyph, float scale_x, float scale_y, int *ix0, int *iy0, int *ix1, int *iy1);
 802STBTT_DEF void stbtt_GetGlyphBitmapBoxSubpixel(const stbtt_fontinfo *font, int glyph, float scale_x, float scale_y,float shift_x, float shift_y, int *ix0, int *iy0, int *ix1, int *iy1);
 803
 804
 805// @TODO: don't expose this structure
 806typedef struct
 807{
 808   int w,h,stride;
 809   unsigned char *pixels;
 810} stbtt__bitmap;
 811
 812// rasterize a shape with quadratic beziers into a bitmap
 813STBTT_DEF void stbtt_Rasterize(stbtt__bitmap *result,        // 1-channel bitmap to draw into
 814                               float flatness_in_pixels,     // allowable error of curve in pixels
 815                               stbtt_vertex *vertices,       // array of vertices defining shape
 816                               int num_verts,                // number of vertices in above array
 817                               float scale_x, float scale_y, // scale applied to input vertices
 818                               float shift_x, float shift_y, // translation applied to input vertices
 819                               int x_off, int y_off,         // another translation applied to input
 820                               int invert,                   // if non-zero, vertically flip shape
 821                               void *userdata);              // context for to STBTT_MALLOC
 822
 823//////////////////////////////////////////////////////////////////////////////
 824//
 825// Finding the right font...
 826//
 827// You should really just solve this offline, keep your own tables
 828// of what font is what, and don't try to get it out of the .ttf file.
 829// That's because getting it out of the .ttf file is really hard, because
 830// the names in the file can appear in many possible encodings, in many
 831// possible languages, and e.g. if you need a case-insensitive comparison,
 832// the details of that depend on the encoding & language in a complex way
 833// (actually underspecified in truetype, but also gigantic).
 834//
 835// But you can use the provided functions in two possible ways:
 836//     stbtt_FindMatchingFont() will use *case-sensitive* comparisons on
 837//             unicode-encoded names to try to find the font you want;
 838//             you can run this before calling stbtt_InitFont()
 839//
 840//     stbtt_GetFontNameString() lets you get any of the various strings
 841//             from the file yourself and do your own comparisons on them.
 842//             You have to have called stbtt_InitFont() first.
 843
 844
 845STBTT_DEF int stbtt_FindMatchingFont(const unsigned char *fontdata, const char *name, int flags);
 846// returns the offset (not index) of the font that matches, or -1 if none
 847//   if you use STBTT_MACSTYLE_DONTCARE, use a font name like "Arial Bold".
 848//   if you use any other flag, use a font name like "Arial"; this checks
 849//     the 'macStyle' header field; i don't know if fonts set this consistently
 850#define STBTT_MACSTYLE_DONTCARE     0
 851#define STBTT_MACSTYLE_BOLD         1
 852#define STBTT_MACSTYLE_ITALIC       2
 853#define STBTT_MACSTYLE_UNDERSCORE   4
 854#define STBTT_MACSTYLE_NONE         8   // <= not same as 0, this makes us check the bitfield is 0
 855
 856STBTT_DEF int stbtt_CompareUTF8toUTF16_bigendian(const char *s1, int len1, const char *s2, int len2);
 857// returns 1/0 whether the first string interpreted as utf8 is identical to
 858// the second string interpreted as big-endian utf16... useful for strings from next func
 859
 860STBTT_DEF const char *stbtt_GetFontNameString(const stbtt_fontinfo *font, int *length, int platformID, int encodingID, int languageID, int nameID);
 861// returns the string (which may be big-endian double byte, e.g. for unicode)
 862// and puts the length in bytes in *length.
 863//
 864// some of the values for the IDs are below; for more see the truetype spec:
 865//     http://developer.apple.com/textfonts/TTRefMan/RM06/Chap6name.html
 866//     http://www.microsoft.com/typography/otspec/name.htm
 867
 868enum { // platformID
 869   STBTT_PLATFORM_ID_UNICODE   =0,
 870   STBTT_PLATFORM_ID_MAC       =1,
 871   STBTT_PLATFORM_ID_ISO       =2,
 872   STBTT_PLATFORM_ID_MICROSOFT =3
 873};
 874
 875enum { // encodingID for STBTT_PLATFORM_ID_UNICODE
 876   STBTT_UNICODE_EID_UNICODE_1_0    =0,
 877   STBTT_UNICODE_EID_UNICODE_1_1    =1,
 878   STBTT_UNICODE_EID_ISO_10646      =2,
 879   STBTT_UNICODE_EID_UNICODE_2_0_BMP=3,
 880   STBTT_UNICODE_EID_UNICODE_2_0_FULL=4
 881};
 882
 883enum { // encodingID for STBTT_PLATFORM_ID_MICROSOFT
 884   STBTT_MS_EID_SYMBOL        =0,
 885   STBTT_MS_EID_UNICODE_BMP   =1,
 886   STBTT_MS_EID_SHIFTJIS      =2,
 887   STBTT_MS_EID_UNICODE_FULL  =10
 888};
 889
 890enum { // encodingID for STBTT_PLATFORM_ID_MAC; same as Script Manager codes
 891   STBTT_MAC_EID_ROMAN        =0,   STBTT_MAC_EID_ARABIC       =4,
 892   STBTT_MAC_EID_JAPANESE     =1,   STBTT_MAC_EID_HEBREW       =5,
 893   STBTT_MAC_EID_CHINESE_TRAD =2,   STBTT_MAC_EID_GREEK        =6,
 894   STBTT_MAC_EID_KOREAN       =3,   STBTT_MAC_EID_RUSSIAN      =7
 895};
 896
 897enum { // languageID for STBTT_PLATFORM_ID_MICROSOFT; same as LCID...
 898       // problematic because there are e.g. 16 english LCIDs and 16 arabic LCIDs
 899   STBTT_MS_LANG_ENGLISH     =0x0409,   STBTT_MS_LANG_ITALIAN     =0x0410,
 900   STBTT_MS_LANG_CHINESE     =0x0804,   STBTT_MS_LANG_JAPANESE    =0x0411,
 901   STBTT_MS_LANG_DUTCH       =0x0413,   STBTT_MS_LANG_KOREAN      =0x0412,
 902   STBTT_MS_LANG_FRENCH      =0x040c,   STBTT_MS_LANG_RUSSIAN     =0x0419,
 903   STBTT_MS_LANG_GERMAN      =0x0407,   STBTT_MS_LANG_SPANISH     =0x0409,
 904   STBTT_MS_LANG_HEBREW      =0x040d,   STBTT_MS_LANG_SWEDISH     =0x041D
 905};
 906
 907enum { // languageID for STBTT_PLATFORM_ID_MAC
 908   STBTT_MAC_LANG_ENGLISH      =0 ,   STBTT_MAC_LANG_JAPANESE     =11,
 909   STBTT_MAC_LANG_ARABIC       =12,   STBTT_MAC_LANG_KOREAN       =23,
 910   STBTT_MAC_LANG_DUTCH        =4 ,   STBTT_MAC_LANG_RUSSIAN      =32,
 911   STBTT_MAC_LANG_FRENCH       =1 ,   STBTT_MAC_LANG_SPANISH      =6 ,
 912   STBTT_MAC_LANG_GERMAN       =2 ,   STBTT_MAC_LANG_SWEDISH      =5 ,
 913   STBTT_MAC_LANG_HEBREW       =10,   STBTT_MAC_LANG_CHINESE_SIMPLIFIED =33,
 914   STBTT_MAC_LANG_ITALIAN      =3 ,   STBTT_MAC_LANG_CHINESE_TRAD =19
 915};
 916
 917#ifdef __cplusplus
 918}
 919#endif
 920
 921#endif // __STB_INCLUDE_STB_TRUETYPE_H__
 922
 923///////////////////////////////////////////////////////////////////////////////
 924///////////////////////////////////////////////////////////////////////////////
 925////
 926////   IMPLEMENTATION
 927////
 928////
 929
 930#ifdef STB_TRUETYPE_IMPLEMENTATION
 931
 932#ifndef STBTT_MAX_OVERSAMPLE
 933#define STBTT_MAX_OVERSAMPLE   8
 934#endif
 935
 936#if STBTT_MAX_OVERSAMPLE > 255
 937#error "STBTT_MAX_OVERSAMPLE cannot be > 255"
 938#endif
 939
 940typedef int stbtt__test_oversample_pow2[(STBTT_MAX_OVERSAMPLE & (STBTT_MAX_OVERSAMPLE-1)) == 0 ? 1 : -1];
 941
 942#ifndef STBTT_RASTERIZER_VERSION
 943#define STBTT_RASTERIZER_VERSION 2
 944#endif
 945
 946//////////////////////////////////////////////////////////////////////////
 947//
 948// accessors to parse data from file
 949//
 950
 951// on platforms that don't allow misaligned reads, if we want to allow
 952// truetype fonts that aren't padded to alignment, define ALLOW_UNALIGNED_TRUETYPE
 953
 954#define ttBYTE(p)     (* (stbtt_uint8 *) (p))
 955#define ttCHAR(p)     (* (stbtt_int8 *) (p))
 956#define ttFixed(p)    ttLONG(p)
 957
 958#if defined(STB_TRUETYPE_BIGENDIAN) && !defined(ALLOW_UNALIGNED_TRUETYPE)
 959
 960   #define ttUSHORT(p)   (* (stbtt_uint16 *) (p))
 961   #define ttSHORT(p)    (* (stbtt_int16 *) (p))
 962   #define ttULONG(p)    (* (stbtt_uint32 *) (p))
 963   #define ttLONG(p)     (* (stbtt_int32 *) (p))
 964
 965#else
 966
 967   static stbtt_uint16 ttUSHORT(const stbtt_uint8 *p) { return p[0]*256 + p[1]; }
 968   static stbtt_int16 ttSHORT(const stbtt_uint8 *p)   { return p[0]*256 + p[1]; }
 969   static stbtt_uint32 ttULONG(const stbtt_uint8 *p)  { return (p[0]<<24) + (p[1]<<16) + (p[2]<<8) + p[3]; }
 970   static stbtt_int32 ttLONG(const stbtt_uint8 *p)    { return (p[0]<<24) + (p[1]<<16) + (p[2]<<8) + p[3]; }
 971
 972#endif
 973
 974#define stbtt_tag4(p,c0,c1,c2,c3) ((p)[0] == (c0) && (p)[1] == (c1) && (p)[2] == (c2) && (p)[3] == (c3))
 975#define stbtt_tag(p,str)           stbtt_tag4(p,str[0],str[1],str[2],str[3])
 976
 977static int stbtt__isfont(const stbtt_uint8 *font)
 978{
 979   // check the version number
 980   if (stbtt_tag4(font, '1',0,0,0))  return 1; // TrueType 1
 981   if (stbtt_tag(font, "typ1"))   return 1; // TrueType with type 1 font -- we don't support this!
 982   if (stbtt_tag(font, "OTTO"))   return 1; // OpenType with CFF
 983   if (stbtt_tag4(font, 0,1,0,0)) return 1; // OpenType 1.0
 984   return 0;
 985}
 986
 987// @OPTIMIZE: binary search
 988static stbtt_uint32 stbtt__find_table(stbtt_uint8 *data, stbtt_uint32 fontstart, const char *tag)
 989{
 990   stbtt_int32 num_tables = ttUSHORT(data+fontstart+4);
 991   stbtt_uint32 tabledir = fontstart + 12;
 992   stbtt_int32 i;
 993   for (i=0; i < num_tables; ++i) {
 994      stbtt_uint32 loc = tabledir + 16*i;
 995      if (stbtt_tag(data+loc+0, tag))
 996         return ttULONG(data+loc+8);
 997   }
 998   return 0;
 999}
1000
1001STBTT_DEF int stbtt_GetFontOffsetForIndex(const unsigned char *font_collection, int index)
1002{
1003   // if it's just a font, there's only one valid index
1004   if (stbtt__isfont(font_collection))
1005      return index == 0 ? 0 : -1;
1006
1007   // check if it's a TTC
1008   if (stbtt_tag(font_collection, "ttcf")) {
1009      // version 1?
1010      if (ttULONG(font_collection+4) == 0x00010000 || ttULONG(font_collection+4) == 0x00020000) {
1011         stbtt_int32 n = ttLONG(font_collection+8);
1012         if (index >= n)
1013            return -1;
1014         return ttULONG(font_collection+12+index*4);
1015      }
1016   }
1017   return -1;
1018}
1019
1020STBTT_DEF int stbtt_InitFont(stbtt_fontinfo *info, const unsigned char *data2, int fontstart)
1021{
1022   stbtt_uint8 *data = (stbtt_uint8 *) data2;
1023   stbtt_uint32 cmap, t;
1024   stbtt_int32 i,numTables;
1025
1026   info->data = data;
1027   info->fontstart = fontstart;
1028
1029   cmap = stbtt__find_table(data, fontstart, "cmap");       // required
1030   info->loca = stbtt__find_table(data, fontstart, "loca"); // required
1031   info->head = stbtt__find_table(data, fontstart, "head"); // required
1032   info->glyf = stbtt__find_table(data, fontstart, "glyf"); // required
1033   info->hhea = stbtt__find_table(data, fontstart, "hhea"); // required
1034   info->hmtx = stbtt__find_table(data, fontstart, "hmtx"); // required
1035   info->kern = stbtt__find_table(data, fontstart, "kern"); // not required
1036   if (!cmap || !info->loca || !info->head || !info->glyf || !info->hhea || !info->hmtx)
1037      return 0;
1038
1039   t = stbtt__find_table(data, fontstart, "maxp");
1040   if (t)
1041      info->numGlyphs = ttUSHORT(data+t+4);
1042   else
1043      info->numGlyphs = 0xffff;
1044
1045   // find a cmap encoding table we understand *now* to avoid searching
1046   // later. (todo: could make this installable)
1047   // the same regardless of glyph.
1048   numTables = ttUSHORT(data + cmap + 2);
1049   info->index_map = 0;
1050   for (i=0; i < numTables; ++i) {
1051      stbtt_uint32 encoding_record = cmap + 4 + 8 * i;
1052      // find an encoding we understand:
1053      switch(ttUSHORT(data+encoding_record)) {
1054         case STBTT_PLATFORM_ID_MICROSOFT:
1055            switch (ttUSHORT(data+encoding_record+2)) {
1056               case STBTT_MS_EID_UNICODE_BMP:
1057               case STBTT_MS_EID_UNICODE_FULL:
1058                  // MS/Unicode
1059                  info->index_map = cmap + ttULONG(data+encoding_record+4);
1060                  break;
1061            }
1062            break;
1063        case STBTT_PLATFORM_ID_UNICODE:
1064            // Mac/iOS has these
1065            // all the encodingIDs are unicode, so we don't bother to check it
1066            info->index_map = cmap + ttULONG(data+encoding_record+4);
1067            break;
1068      }
1069   }
1070   if (info->index_map == 0)
1071      return 0;
1072
1073   info->indexToLocFormat = ttUSHORT(data+info->head + 50);
1074   return 1;
1075}
1076
1077STBTT_DEF int stbtt_FindGlyphIndex(const stbtt_fontinfo *info, int unicode_codepoint)
1078{
1079   stbtt_uint8 *data = info->data;
1080   stbtt_uint32 index_map = info->index_map;
1081
1082   stbtt_uint16 format = ttUSHORT(data + index_map + 0);
1083   if (format == 0) { // apple byte encoding
1084      stbtt_int32 bytes = ttUSHORT(data + index_map + 2);
1085      if (unicode_codepoint < bytes-6)
1086         return ttBYTE(data + index_map + 6 + unicode_codepoint);
1087      return 0;
1088   } else if (format == 6) {
1089      stbtt_uint32 first = ttUSHORT(data + index_map + 6);
1090      stbtt_uint32 count = ttUSHORT(data + index_map + 8);
1091      if ((stbtt_uint32) unicode_codepoint >= first && (stbtt_uint32) unicode_codepoint < first+count)
1092         return ttUSHORT(data + index_map + 10 + (unicode_codepoint - first)*2);
1093      return 0;
1094   } else if (format == 2) {
1095      STBTT_assert(0); // @TODO: high-byte mapping for japanese/chinese/korean
1096      return 0;
1097   } else if (format == 4) { // standard mapping for windows fonts: binary search collection of ranges
1098      stbtt_uint16 segcount = ttUSHORT(data+index_map+6) >> 1;
1099      stbtt_uint16 searchRange = ttUSHORT(data+index_map+8) >> 1;
1100      stbtt_uint16 entrySelector = ttUSHORT(data+index_map+10);
1101      stbtt_uint16 rangeShift = ttUSHORT(data+index_map+12) >> 1;
1102
1103      // do a binary search of the segments
1104      stbtt_uint32 endCount = index_map + 14;
1105      stbtt_uint32 search = endCount;
1106
1107      if (unicode_codepoint > 0xffff)
1108         return 0;
1109
1110      // they lie from endCount .. endCount + segCount
1111      // but searchRange is the nearest power of two, so...
1112      if (unicode_codepoint >= ttUSHORT(data + search + rangeShift*2))
1113         search += rangeShift*2;
1114
1115      // now decrement to bias correctly to find smallest
1116      search -= 2;
1117      while (entrySelector) {
1118         stbtt_uint16 end;
1119         searchRange >>= 1;
1120         end = ttUSHORT(data + search + searchRange*2);
1121         if (unicode_codepoint > end)
1122            search += searchRange*2;
1123         --entrySelector;
1124      }
1125      search += 2;
1126
1127      {
1128         stbtt_uint16 offset, start;
1129         stbtt_uint16 item = (stbtt_uint16) ((search - endCount) >> 1);
1130
1131         STBTT_assert(unicode_codepoint <= ttUSHORT(data + endCount + 2*item));
1132         start = ttUSHORT(data + index_map + 14 + segcount*2 + 2 + 2*item);
1133         if (unicode_codepoint < start)
1134            return 0;
1135
1136         offset = ttUSHORT(data + index_map + 14 + segcount*6 + 2 + 2*item);
1137         if (offset == 0)
1138            return (stbtt_uint16) (unicode_codepoint + ttSHORT(data + index_map + 14 + segcount*4 + 2 + 2*item));
1139
1140         return ttUSHORT(data + offset + (unicode_codepoint-start)*2 + index_map + 14 + segcount*6 + 2 + 2*item);
1141      }
1142   } else if (format == 12 || format == 13) {
1143      stbtt_uint32 ngroups = ttULONG(data+index_map+12);
1144      stbtt_int32 low,high;
1145      low = 0; high = (stbtt_int32)ngroups;
1146      // Binary search the right group.
1147      while (low < high) {
1148         stbtt_int32 mid = low + ((high-low) >> 1); // rounds down, so low <= mid < high
1149         stbtt_uint32 start_char = ttULONG(data+index_map+16+mid*12);
1150         stbtt_uint32 end_char = ttULONG(data+index_map+16+mid*12+4);
1151         if ((stbtt_uint32) unicode_codepoint < start_char)
1152            high = mid;
1153         else if ((stbtt_uint32) unicode_codepoint > end_char)
1154            low = mid+1;
1155         else {
1156            stbtt_uint32 start_glyph = ttULONG(data+index_map+16+mid*12+8);
1157            if (format == 12)
1158               return start_glyph + unicode_codepoint-start_char;
1159            else // format == 13
1160               return start_glyph;
1161         }
1162      }
1163      return 0; // not found
1164   }
1165   // @TODO
1166   STBTT_assert(0);
1167   return 0;
1168}
1169
1170STBTT_DEF int stbtt_GetCodepointShape(const stbtt_fontinfo *info, int unicode_codepoint, stbtt_vertex **vertices)
1171{
1172   return stbtt_GetGlyphShape(info, stbtt_FindGlyphIndex(info, unicode_codepoint), vertices);
1173}
1174
1175static void stbtt_setvertex(stbtt_vertex *v, stbtt_uint8 type, stbtt_int32 x, stbtt_int32 y, stbtt_int32 cx, stbtt_int32 cy)
1176{
1177   v->type = type;
1178   v->x = (stbtt_int16) x;
1179   v->y = (stbtt_int16) y;
1180   v->cx = (stbtt_int16) cx;
1181   v->cy = (stbtt_int16) cy;
1182}
1183
1184static int stbtt__GetGlyfOffset(const stbtt_fontinfo *info, int glyph_index)
1185{
1186   int g1,g2;
1187
1188   if (glyph_index >= info->numGlyphs) return -1; // glyph index out of range
1189   if (info->indexToLocFormat >= 2)    return -1; // unknown index->glyph map format
1190
1191   if (info->indexToLocFormat == 0) {
1192      g1 = info->glyf + ttUSHORT(info->data + info->loca + glyph_index * 2) * 2;
1193      g2 = info->glyf + ttUSHORT(info->data + info->loca + glyph_index * 2 + 2) * 2;
1194   } else {
1195      g1 = info->glyf + ttULONG (info->data + info->loca + glyph_index * 4);
1196      g2 = info->glyf + ttULONG (info->data + info->loca + glyph_index * 4 + 4);
1197   }
1198
1199   return g1==g2 ? -1 : g1; // if length is 0, return -1
1200}
1201
1202STBTT_DEF int stbtt_GetGlyphBox(const stbtt_fontinfo *info, int glyph_index, int *x0, int *y0, int *x1, int *y1)
1203{
1204   int g = stbtt__GetGlyfOffset(info, glyph_index);
1205   if (g < 0) return 0;
1206
1207   if (x0) *x0 = ttSHORT(info->data + g + 2);
1208   if (y0) *y0 = ttSHORT(info->data + g + 4);
1209   if (x1) *x1 = ttSHORT(info->data + g + 6);
1210   if (y1) *y1 = ttSHORT(info->data + g + 8);
1211   return 1;
1212}
1213
1214STBTT_DEF int stbtt_GetCodepointBox(const stbtt_fontinfo *info, int codepoint, int *x0, int *y0, int *x1, int *y1)
1215{
1216   return stbtt_GetGlyphBox(info, stbtt_FindGlyphIndex(info,codepoint), x0,y0,x1,y1);
1217}
1218
1219STBTT_DEF int stbtt_IsGlyphEmpty(const stbtt_fontinfo *info, int glyph_index)
1220{
1221   stbtt_int16 numberOfContours;
1222   int g = stbtt__GetGlyfOffset(info, glyph_index);
1223   if (g < 0) return 1;
1224   numberOfContours = ttSHORT(info->data + g);
1225   return numberOfContours == 0;
1226}
1227
1228static int stbtt__close_shape(stbtt_vertex *vertices, int num_vertices, int was_off, int start_off,
1229    stbtt_int32 sx, stbtt_int32 sy, stbtt_int32 scx, stbtt_int32 scy, stbtt_int32 cx, stbtt_int32 cy)
1230{
1231   if (start_off) {
1232      if (was_off)
1233         stbtt_setvertex(&vertices[num_vertices++], STBTT_vcurve, (cx+scx)>>1, (cy+scy)>>1, cx,cy);
1234      stbtt_setvertex(&vertices[num_vertices++], STBTT_vcurve, sx,sy,scx,scy);
1235   } else {
1236      if (was_off)
1237         stbtt_setvertex(&vertices[num_vertices++], STBTT_vcurve,sx,sy,cx,cy);
1238      else
1239         stbtt_setvertex(&vertices[num_vertices++], STBTT_vline,sx,sy,0,0);
1240   }
1241   return num_vertices;
1242}
1243
1244STBTT_DEF int stbtt_GetGlyphShape(const stbtt_fontinfo *info, int glyph_index, stbtt_vertex **pvertices)
1245{
1246   stbtt_int16 numberOfContours;
1247   stbtt_uint8 *endPtsOfContours;
1248   stbtt_uint8 *data = info->data;
1249   stbtt_vertex *vertices=0;
1250   int num_vertices=0;
1251   int g = stbtt__GetGlyfOffset(info, glyph_index);
1252
1253   *pvertices = NULL;
1254
1255   if (g < 0) return 0;
1256
1257   numberOfContours = ttSHORT(data + g);
1258
1259   if (numberOfContours > 0) {
1260      stbtt_uint8 flags=0,flagcount;
1261      stbtt_int32 ins, i,j=0,m,n, next_move, was_off=0, off, start_off=0;
1262      stbtt_int32 x,y,cx,cy,sx,sy, scx,scy;
1263      stbtt_uint8 *points;
1264      endPtsOfContours = (data + g + 10);
1265      ins = ttUSHORT(data + g + 10 + numberOfContours * 2);
1266      points = data + g + 10 + numberOfContours * 2 + 2 + ins;
1267
1268      n = 1+ttUSHORT(endPtsOfContours + numberOfContours*2-2);
1269
1270      m = n + 2*numberOfContours;  // a loose bound on how many vertices we might need
1271      vertices = (stbtt_vertex *) STBTT_malloc(m * sizeof(vertices[0]), info->userdata);
1272      if (vertices == 0)
1273         return 0;
1274
1275      next_move = 0;
1276      flagcount=0;
1277
1278      // in first pass, we load uninterpreted data into the allocated array
1279      // above, shifted to the end of the array so we won't overwrite it when
1280      // we create our final data starting from the front
1281
1282      off = m - n; // starting offset for uninterpreted data, regardless of how m ends up being calculated
1283
1284      // first load flags
1285
1286      for (i=0; i < n; ++i) {
1287         if (flagcount == 0) {
1288            flags = *points++;
1289            if (flags & 8)
1290               flagcount = *points++;
1291         } else
1292            --flagcount;
1293         vertices[off+i].type = flags;
1294      }
1295
1296      // now load x coordinates
1297      x=0;
1298      for (i=0; i < n; ++i) {
1299         flags = vertices[off+i].type;
1300         if (flags & 2) {
1301            stbtt_int16 dx = *points++;
1302            x += (flags & 16) ? dx : -dx; // ???
1303         } else {
1304            if (!(flags & 16)) {
1305               x = x + (stbtt_int16) (points[0]*256 + points[1]);
1306               points += 2;
1307            }
1308         }
1309         vertices[off+i].x = (stbtt_int16) x;
1310      }
1311
1312      // now load y coordinates
1313      y=0;
1314      for (i=0; i < n; ++i) {
1315         flags = vertices[off+i].type;
1316         if (flags & 4) {
1317            stbtt_int16 dy = *points++;
1318            y += (flags & 32) ? dy : -dy; // ???
1319         } else {
1320            if (!(flags & 32)) {
1321               y = y + (stbtt_int16) (points[0]*256 + points[1]);
1322               points += 2;
1323            }
1324         }
1325         vertices[off+i].y = (stbtt_int16) y;
1326      }
1327
1328      // now convert them to our format
1329      num_vertices=0;
1330      sx = sy = cx = cy = scx = scy = 0;
1331      for (i=0; i < n; ++i) {
1332         flags = vertices[off+i].type;
1333         x     = (stbtt_int16) vertices[off+i].x;
1334         y     = (stbtt_int16) vertices[off+i].y;
1335
1336         if (next_move == i) {
1337            if (i != 0)
1338               num_vertices = stbtt__close_shape(vertices, num_vertices, was_off, start_off, sx,sy,scx,scy,cx,cy);
1339
1340            // now start the new one               
1341            start_off = !(flags & 1);
1342            if (start_off) {
1343               // if we start off with an off-curve point, then when we need to find a point on the curve
1344               // where we can start, and we need to save some state for when we wraparound.
1345               scx = x;
1346               scy = y;
1347               if (!(vertices[off+i+1].type & 1)) {
1348                  // next point is also a curve point, so interpolate an on-point curve
1349                  sx = (x + (stbtt_int32) vertices[off+i+1].x) >> 1;
1350                  sy = (y + (stbtt_int32) vertices[off+i+1].y) >> 1;
1351               } else {
1352                  // otherwise just use the next point as our start point
1353                  sx = (stbtt_int32) vertices[off+i+1].x;
1354                  sy = (stbtt_int32) vertices[off+i+1].y;
1355                  ++i; // we're using point i+1 as the starting point, so skip it
1356               }
1357            } else {
1358               sx = x;
1359               sy = y;
1360            }
1361            stbtt_setvertex(&vertices[num_vertices++], STBTT_vmove,sx,sy,0,0);
1362            was_off = 0;
1363            next_move = 1 + ttUSHORT(endPtsOfContours+j*2);
1364            ++j;
1365         } else {
1366            if (!(flags & 1)) { // if it's a curve
1367               if (was_off) // two off-curve control points in a row means interpolate an on-curve midpoint
1368                  stbtt_setvertex(&vertices[num_vertices++], STBTT_vcurve, (cx+x)>>1, (cy+y)>>1, cx, cy);
1369               cx = x;
1370               cy = y;
1371               was_off = 1;
1372            } else {
1373               if (was_off)
1374                  stbtt_setvertex(&vertices[num_vertices++], STBTT_vcurve, x,y, cx, cy);
1375               else
1376                  stbtt_setvertex(&vertices[num_vertices++], STBTT_vline, x,y,0,0);
1377               was_off = 0;
1378            }
1379         }
1380      }
1381      num_vertices = stbtt__close_shape(vertices, num_vertices, was_off, start_off, sx,sy,scx,scy,cx,cy);
1382   } else if (numberOfContours == -1) {
1383      // Compound shapes.
1384      int more = 1;
1385      stbtt_uint8 *comp = data + g + 10;
1386      num_vertices = 0;
1387      vertices = 0;
1388      while (more) {
1389         stbtt_uint16 flags, gidx;
1390         int comp_num_verts = 0, i;
1391         stbtt_vertex *comp_verts = 0, *tmp = 0;
1392         float mtx[6] = {1,0,0,1,0,0}, m, n;
1393         
1394         flags = ttSHORT(comp); comp+=2;
1395         gidx = ttSHORT(comp); comp+=2;
1396
1397         if (flags & 2) { // XY values
1398            if (flags & 1) { // shorts
1399               mtx[4] = ttSHORT(comp); comp+=2;
1400               mtx[5] = ttSHORT(comp); comp+=2;
1401            } else {
1402               mtx[4] = ttCHAR(comp); comp+=1;
1403               mtx[5] = ttCHAR(comp); comp+=1;
1404            }
1405         }
1406         else {
1407            // @TODO handle matching point
1408            STBTT_assert(0);
1409         }
1410         if (flags & (1<<3)) { // WE_HAVE_A_SCALE
1411            mtx[0] = mtx[3] = ttSHORT(comp)/16384.0f; comp+=2;
1412            mtx[1] = mtx[2] = 0;
1413         } else if (flags & (1<<6)) { // WE_HAVE_AN_X_AND_YSCALE
1414            mtx[0] = ttSHORT(comp)/16384.0f; comp+=2;
1415            mtx[1] = mtx[2] = 0;
1416            mtx[3] = ttSHORT(comp)/16384.0f; comp+=2;
1417         } else if (flags & (1<<7)) { // WE_HAVE_A_TWO_BY_TWO
1418            mtx[0] = ttSHORT(comp)/16384.0f; comp+=2;
1419            mtx[1] = ttSHORT(comp)/16384.0f; comp+=2;
1420            mtx[2] = ttSHORT(comp)/16384.0f; comp+=2;
1421            mtx[3] = ttSHORT(comp)/16384.0f; comp+=2;
1422         }
1423         
1424         // Find transformation scales.
1425         m = (float) STBTT_sqrt(mtx[0]*mtx[0] + mtx[1]*mtx[1]);
1426         n = (float) STBTT_sqrt(mtx[2]*mtx[2] + mtx[3]*mtx[3]);
1427
1428         // Get indexed glyph.
1429         comp_num_verts = stbtt_GetGlyphShape(info, gidx, &comp_verts);
1430         if (comp_num_verts > 0) {
1431            // Transform vertices.
1432            for (i = 0; i < comp_num_verts; ++i) {
1433               stbtt_vertex* v = &comp_verts[i];
1434               stbtt_vertex_type x,y;
1435               x=v->x; y=v->y;
1436               v->x = (stbtt_vertex_type)(m * (mtx[0]*x + mtx[2]*y + mtx[4]));
1437               v->y = (stbtt_vertex_type)(n * (mtx[1]*x + mtx[3]*y + mtx[5]));
1438               x=v->cx; y=v->cy;
1439               v->cx = (stbtt_vertex_type)(m * (mtx[0]*x + mtx[2]*y + mtx[4]));
1440               v->cy = (stbtt_vertex_type)(n * (mtx[1]*x + mtx[3]*y + mtx[5]));
1441            }
1442            // Append vertices.
1443            tmp = (stbtt_vertex*)STBTT_malloc((num_vertices+comp_num_verts)*sizeof(stbtt_vertex), info->userdata);
1444            if (!tmp) {
1445               if (vertices) STBTT_free(vertices, info->userdata);
1446               if (comp_verts) STBTT_free(comp_verts, info->userdata);
1447               return 0;
1448            }
1449            if (num_vertices > 0) STBTT_memcpy(tmp, vertices, num_vertices*sizeof(stbtt_vertex));
1450            STBTT_memcpy(tmp+num_vertices, comp_verts, comp_num_verts*sizeof(stbtt_vertex));
1451            if (vertices) STBTT_free(vertices, info->userdata);
1452            vertices = tmp;
1453            STBTT_free(comp_verts, info->userdata);
1454            num_vertices += comp_num_verts;
1455         }
1456         // More components ?
1457         more = flags & (1<<5);
1458      }
1459   } else if (numberOfContours < 0) {
1460      // @TODO other compound variations?
1461      STBTT_assert(0);
1462   } else {
1463      // numberOfCounters == 0, do nothing
1464   }
1465
1466   *pvertices = vertices;
1467   return num_vertices;
1468}
1469
1470STBTT_DEF void stbtt_GetGlyphHMetrics(const stbtt_fontinfo *info, int glyph_index, int *advanceWidth, int *leftSideBearing)
1471{
1472   stbtt_uint16 numOfLongHorMetrics = ttUSHORT(info->data+info->hhea + 34);
1473   if (glyph_index < numOfLongHorMetrics) {
1474      if (advanceWidth)     *advanceWidth    = ttSHORT(info->data + info->hmtx + 4*glyph_index);
1475      if (leftSideBearing)  *leftSideBearing = ttSHORT(info->data + info->hmtx + 4*glyph_index + 2);
1476   } else {
1477      if (advanceWidth)     *advanceWidth    = ttSHORT(info->data + info->hmtx + 4*(numOfLongHorMetrics-1));
1478      if (leftSideBearing)  *leftSideBearing = ttSHORT(info->data + info->hmtx + 4*numOfLongHorMetrics + 2*(glyph_index - numOfLongHorMetrics));
1479   }
1480}
1481
1482STBTT_DEF int  stbtt_GetGlyphKernAdvance(const stbtt_fontinfo *info, int glyph1, int glyph2)
1483{
1484   stbtt_uint8 *data = info->data + info->kern;
1485   stbtt_uint32 needle, straw;
1486   int l, r, m;
1487
1488   // we only look at the first table. it must be 'horizontal' and format 0.
1489   if (!info->kern)
1490      return 0;
1491   if (ttUSHORT(data+2) < 1) // number of tables, need at least 1
1492      return 0;
1493   if (ttUSHORT(data+8) != 1) // horizontal flag must be set in format
1494      return 0;
1495
1496   l = 0;
1497   r = ttUSHORT(data+10) - 1;
1498   needle = glyph1 << 16 | glyph2;
1499   while (l <= r) {
1500      m = (l + r) >> 1;
1501      straw = ttULONG(data+18+(m*6)); // note: unaligned read
1502      if (needle < straw)
1503         r = m - 1;
1504      else if (needle > straw)
1505         l = m + 1;
1506      else
1507         return ttSHORT(data+22+(m*6));
1508   }
1509   return 0;
1510}
1511
1512STBTT_DEF int  stbtt_GetCodepointKernAdvance(const stbtt_fontinfo *info, int ch1, int ch2)
1513{
1514   if (!info->kern) // if no kerning table, don't waste time looking up both codepoint->glyphs
1515      return 0;
1516   return stbtt_GetGlyphKernAdvance(info, stbtt_FindGlyphIndex(info,ch1), stbtt_FindGlyphIndex(info,ch2));
1517}
1518
1519STBTT_DEF void stbtt_GetCodepointHMetrics(const stbtt_fontinfo *info, int codepoint, int *advanceWidth, int *leftSideBearing)
1520{
1521   stbtt_GetGlyphHMetrics(info, stbtt_FindGlyphIndex(info,codepoint), advanceWidth, leftSideBearing);
1522}
1523
1524STBTT_DEF void stbtt_GetFontVMetrics(const stbtt_fontinfo *info, int *ascent, int *descent, int *lineGap)
1525{
1526   if (ascent ) *ascent  = ttSHORT(info->data+info->hhea + 4);
1527   if (descent) *descent = ttSHORT(info->data+info->hhea + 6);
1528   if (lineGap) *lineGap = ttSHORT(info->data+info->hhea + 8);
1529}
1530
1531STBTT_DEF void stbtt_GetFontBoundingBox(const stbtt_fontinfo *info, int *x0, int *y0, int *x1, int *y1)
1532{
1533   *x0 = ttSHORT(info->data + info->head + 36);
1534   *y0 = ttSHORT(info->data + info->head + 38);
1535   *x1 = ttSHORT(info->data + info->head + 40);
1536   *y1 = ttSHORT(info->data + info->head + 42);
1537}
1538
1539STBTT_DEF float stbtt_ScaleForPixelHeight(const stbtt_fontinfo *info, float height)
1540{
1541   int fheight = ttSHORT(info->data + info->hhea + 4) - ttSHORT(info->data + info->hhea + 6);
1542   return (float) height / fheight;
1543}
1544
1545STBTT_DEF float stbtt_ScaleForMappingEmToPixels(const stbtt_fontinfo *info, float pixels)
1546{
1547   int unitsPerEm = ttUSHORT(info->data + info->head + 18);
1548   return pixels / unitsPerEm;
1549}
1550
1551STBTT_DEF void stbtt_FreeShape(const stbtt_fontinfo *info, stbtt_vertex *v)
1552{
1553   STBTT_free(v, info->userdata);
1554}
1555
1556//////////////////////////////////////////////////////////////////////////////
1557//
1558// antialiasing software rasterizer
1559//
1560
1561STBTT_DEF void stbtt_GetGlyphBitmapBoxSubpixel(const stbtt_fontinfo *font, int glyph, float scale_x, float scale_y,float shift_x, float shift_y, int *ix0, int *iy0, int *ix1, int *iy1)
1562{
1563   int x0,y0,x1,y1;
1564   if (!stbtt_GetGlyphBox(font, glyph, &x0,&y0,&x1,&y1)) {
1565      // e.g. space character
1566      if (ix0) *ix0 = 0;
1567      if (iy0) *iy0 = 0;
1568      if (ix1) *ix1 = 0;
1569      if (iy1) *iy1 = 0;
1570   } else {
1571      // move to integral bboxes (treating pixels as little squares, what pixels get touched)?
1572      if (ix0) *ix0 = STBTT_ifloor( x0 * scale_x + shift_x);
1573      if (iy0) *iy0 = STBTT_ifloor(-y1 * scale_y + shift_y);
1574      if (ix1) *ix1 = STBTT_iceil ( x1 * scale_x + shift_x);
1575      if (iy1) *iy1 = STBTT_iceil (-y0 * scale_y + shift_y);
1576   }
1577}
1578
1579STBTT_DEF void stbtt_GetGlyphBitmapBox(const stbtt_fontinfo *font, int glyph, float scale_x, float scale_y, int *ix0, int *iy0, int *ix1, int *iy1)
1580{
1581   stbtt_GetGlyphBitmapBoxSubpixel(font, glyph, scale_x, scale_y,0.0f,0.0f, ix0, iy0, ix1, iy1);
1582}
1583
1584STBTT_DEF void stbtt_GetCodepointBitmapBoxSubpixel(const stbtt_fontinfo *font, int codepoint, float scale_x, float scale_y, float shift_x, float shift_y, int *ix0, int *iy0, int *ix1, int *iy1)
1585{
1586   stbtt_GetGlyphBitmapBoxSubpixel(font, stbtt_FindGlyphIndex(font,codepoint), scale_x, scale_y,shift_x,shift_y, ix0,iy0,ix1,iy1);
1587}
1588
1589STBTT_DEF void stbtt_GetCodepointBitmapBox(const stbtt_fontinfo *font, int codepoint, float scale_x, float scale_y, int *ix0, int *iy0, int *ix1, int *iy1)
1590{
1591   stbtt_GetCodepointBitmapBoxSubpixel(font, codepoint, scale_x, scale_y,0.0f,0.0f, ix0,iy0,ix1,iy1);
1592}
1593
1594//////////////////////////////////////////////////////////////////////////////
1595//
1596//  Rasterizer
1597
1598typedef struct stbtt__hheap_chunk
1599{
1600   struct stbtt__hheap_chunk *next;
1601} stbtt__hheap_chunk;
1602
1603typedef struct stbtt__hheap
1604{
1605   struct stbtt__hheap_chunk *head;
1606   void   *first_free;
1607   int    num_remaining_in_head_chunk;
1608} stbtt__hheap;
1609
1610static void *stbtt__hheap_alloc(stbtt__hheap *hh, size_t size, void *userdata)
1611{
1612   if (hh->first_free) {
1613      void *p = hh->first_free;
1614      hh->first_free = * (void **) p;
1615      return p;
1616   } else {
1617      if (hh->num_remaining_in_head_chunk == 0) {
1618         int count = (size < 32 ? 2000 : size < 128 ? 800 : 100);
1619         stbtt__hheap_chunk *c = (stbtt__hheap_chunk *) STBTT_malloc(sizeof(stbtt__hheap_chunk) + size * count, userdata);
1620         if (c == NULL)
1621            return NULL;
1622         c->next = hh->head;
1623         hh->head = c;
1624         hh->num_remaining_in_head_chunk = count;
1625      }
1626      --hh->num_remaining_in_head_chunk;
1627      return (char *) (hh->head) + size * hh->num_remaining_in_head_chunk;
1628   }
1629}
1630
1631static void stbtt__hheap_free(stbtt__hheap *hh, void *p)
1632{
1633   *(void **) p = hh->first_free;
1634   hh->first_free = p;
1635}
1636
1637static void stbtt__hheap_cleanup(stbtt__hheap *hh, void *userdata)
1638{
1639   stbtt__hheap_chunk *c = hh->head;
1640   while (c) {
1641      stbtt__hheap_chunk *n = c->next;
1642      STBTT_free(c, userdata);
1643      c = n;
1644   }
1645}
1646
1647typedef struct stbtt__edge {
1648   float x0,y0, x1,y1;
1649   int invert;
1650} stbtt__edge;
1651
1652
1653typedef struct stbtt__active_edge
1654{
1655   struct stbtt__active_edge *next;
1656   #if STBTT_RASTERIZER_VERSION==1
1657   int x,dx;
1658   float ey;
1659   int direction;
1660   #elif STBTT_RASTERIZER_VERSION==2
1661   float fx,fdx,fdy;
1662   float direction;
1663   float sy;
1664   float ey;
1665   #else
1666   #error "Unrecognized value of STBTT_RASTERIZER_VERSION"
1667   #endif
1668} stbtt__active_edge;
1669
1670#if STBTT_RASTERIZER_VERSION == 1
1671#define STBTT_FIXSHIFT   10
1672#define STBTT_FIX        (1 << STBTT_FIXSHIFT)
1673#define STBTT_FIXMASK    (STBTT_FIX-1)
1674
1675static stbtt__active_edge *stbtt__new_active(stbtt__hheap *hh, stbtt__edge *e, int off_x, float start_point, void *userdata)
1676{
1677   stbtt__active_edge *z = (stbtt__active_edge *) stbtt__hheap_alloc(hh, sizeof(*z), userdata);
1678   float dxdy = (e->x1 - e->x0) / (e->y1 - e->y0);
1679   if (!z) return z;
1680   
1681   // round dx down to avoid overshooting
1682   if (dxdy < 0)
1683      z->dx = -STBTT_ifloor(STBTT_FIX * -dxdy);
1684   else
1685      z->dx = STBTT_ifloor(STBTT_FIX * dxdy);
1686
1687   z->x = STBTT_ifloor(STBTT_FIX * e->x0 + z->dx * (start_point - e->y0)); // use z->dx so when we offset later it's by the same amount
1688   z->x -= off_x * STBTT_FIX;
1689
1690   z->ey = e->y1;
1691   z->next = 0;
1692   z->direction = e->invert ? 1 : -1;
1693   return z;
1694}
1695#elif STBTT_RASTERIZER_VERSION == 2
1696static stbtt__active_edge *stbtt__new_active(stbtt__hheap *hh, stbtt__edge *e, int off_x, float start_point, void *userdata)
1697{
1698   stbtt__active_edge *z = (stbtt__active_edge *) stbtt__hheap_alloc(hh, sizeof(*z), userdata);
1699   float dxdy = (e->x1 - e->x0) / (e->y1 - e->y0);
1700   //STBTT_assert(e->y0 <= start_point);
1701   if (!z) return z;
1702   z->fdx = dxdy;
1703   z->fdy = dxdy != 0.0f ? (1.0f/dxdy) : 0.0f;
1704   z->fx = e->x0 + dxdy * (start_point - e->y0);
1705   z->fx -= off_x;
1706   z->direction = e->invert ? 1.0f : -1.0f;
1707   z->sy = e->y0;
1708   z->ey = e->y1;
1709   z->next = 0;
1710   return z;
1711}
1712#else
1713#error "Unrecognized value of STBTT_RASTERIZER_VERSION"
1714#endif
1715
1716#if STBTT_RASTERIZER_VERSION == 1
1717// note: this routine clips fills that extend off the edges... ideally this
1718// wouldn't happen, but it could happen if the truetype glyph bounding boxes
1719// are wrong, or if the user supplies a too-small bitmap
1720static void stbtt__fill_active_edges(unsigned char *scanline, int len, stbtt__active_edge *e, int max_weight)
1721{
1722   // non-zero winding fill
1723   int x0=0, w=0;
1724
1725   while (e) {
1726      if (w == 0) {
1727         // if we're currently at zero, we need to record the edge start point
1728         x0 = e->x; w += e->direction;
1729      } else {
1730         int x1 = e->x; w += e->direction;
1731         // if we went to zero, we need to draw
1732         if (w == 0) {
1733            int i = x0 >> STBTT_FIXSHIFT;
1734            int j = x1 >> STBTT_FIXSHIFT;
1735
1736            if (i < len && j >= 0) {
1737               if (i == j) {
1738                  // x0,x1 are the same pixel, so compute combined coverage
1739                  scanline[i] = scanline[i] + (stbtt_uint8) ((x1 - x0) * max_weight >> STBTT_FIXSHIFT);
1740               } else {
1741                  if (i >= 0) // add antialiasing for x0
1742                     scanline[i] = scanline[i] + (stbtt_uint8) (((STBTT_FIX - (x0 & STBTT_FIXMASK)) * max_weight) >> STBTT_FIXSHIFT);
1743                  else
1744                     i = -1; // clip
1745
1746                  if (j < len) // add antialiasing for x1
1747                     scanline[j] = scanline[j] + (stbtt_uint8) (((x1 & STBTT_FIXMASK) * max_weight) >> STBTT_FIXSHIFT);
1748                  else
1749                     j = len; // clip
1750
1751                  for (++i; i < j; ++i) // fill pixels between x0 and x1
1752                     scanline[i] = scanline[i] + (stbtt_uint8) max_weight;
1753               }
1754            }
1755         }
1756      }
1757      
1758      e = e->next;
1759   }
1760}
1761
1762static void stbtt__rasterize_sorted_edges(stbtt__bitmap *result, stbtt__edge *e, int n, int vsubsample, int off_x, int off_y, void *userdata)
1763{
1764   stbtt__hheap hh = { 0, 0, 0 };
1765   stbtt__active_edge *active = NULL;
1766   int y,j=0;
1767   int max_weight = (255 / vsubsample);  // weight per vertical scanline
1768   int s; // vertical subsample index
1769   unsigned char scanline_data[512], *scanline;
1770
1771   if (result->w > 512)
1772      scanline = (unsigned char *) STBTT_malloc(result->w, userdata);
1773   else
1774      scanline = scanline_data;
1775
1776   y = off_y * vsubsample;
1777   e[n].y0 = (off_y + result->h) * (float) vsubsample + 1;
1778
1779   while (j < result->h) {
1780      STBTT_memset(scanline, 0, result->w);
1781      for (s=0; s < vsubsample; ++s) {
1782         // find center of pixel for this scanline
1783         float scan_y = y + 0.5f;
1784         stbtt__active_edge **step = &active;
1785
1786         // update all active edges;
1787         // remove all active edges that terminate before the center of this scanline
1788         while (*step) {
1789            stbtt__active_edge * z = *step;
1790            if (z->ey <= scan_y) {
1791               *step = z->next; // delete from list
1792               STBTT_assert(z->direction);
1793               z->direction = 0;
1794               stbtt__hheap_free(&hh, z);
1795            } else {
1796               z->x += z->dx; // advance to position for current scanline
1797               step = &((*step)->next); // advance through list
1798            }
1799         }
1800
1801         // resort the list if needed
1802         for(;;) {
1803            int changed=0;
1804            step = &active;
1805            while (*step && (*step)->next) {
1806               if ((*step)->x > (*step)->next->x) {
1807                  stbtt__active_edge *t = *step;
1808                  stbtt__active_edge *q = t->next;
1809
1810                  t->next = q->next;
1811                  q->next = t;
1812                  *step = q;
1813                  changed = 1;
1814               }
1815               step = &(*step)->next;
1816            }
1817            if (!changed) break;
1818         }
1819
1820         // insert all edges that start before the center of this scanline -- omit ones that also end on this scanline
1821         while (e->y0 <= scan_y) {
1822            if (e->y1 > scan_y) {
1823               stbtt__active_edge *z = stbtt__new_active(&hh, e, off_x, scan_y, userdata);
1824               // find insertion point
1825               if (active == NULL)
1826                  active = z;
1827               else if (z->x < active->x) {
1828                  // insert at front
1829                  z->next = active;
1830                  active = z;
1831               } else {
1832                  // find thing to insert AFTER
1833                  stbtt__active_edge *p = active;
1834                  while (p->next && p->next->x < z->x)
1835                     p = p->next;
1836                  // at this point, p->next->x is NOT < z->x
1837                  z->next = p->next;
1838                  p->next = z;
1839               }
1840            }
1841            ++e;
1842         }
1843
1844         // now process all active edges in XOR fashion
1845         if (active)
1846            stbtt__fill_active_edges(scanline, result->w, active, max_weight);
1847
1848         ++y;
1849      }
1850      STBTT_memcpy(result->pixels + j * result->stride, scanline, result->w);
1851      ++j;
1852   }
1853
1854   stbtt__hheap_cleanup(&hh, userdata);
1855
1856   if (scanline != scanline_data)
1857      STBTT_free(scanline, userdata);
1858}
1859
1860#elif STBTT_RASTERIZER_VERSION == 2
1861
1862// the edge passed in here does not cross the vertical line at x or the vertical line at x+1
1863// (i.e. it has already been clipped to those)
1864static void stbtt__handle_clipped_edge(float *scanline, int x, stbtt__active_edge *e, float x0, float y0, float x1, float y1)
1865{
1866   if (y0 == y1) return;
1867   STBTT_assert(y0 < y1);
1868   STBTT_assert(e->sy <= e->ey);
1869   if (y0 > e->ey) return;
1870   if (y1 < e->sy) return;
1871   if (y0 < e->sy) {
1872      x0 += (x1-x0) * (e->sy - y0) / (y1-y0);
1873      y0 = e->sy;
1874   }
1875   if (y1 > e->ey) {
1876      x1 += (x1-x0) * (e->ey - y1) / (y1-y0);
1877      y1 = e->ey;
1878   }
1879
1880   if (x0 == x)
1881      STBTT_assert(x1 <= x+1);
1882   else if (x0 == x+1)
1883      STBTT_assert(x1 >= x);
1884   else if (x0 <= x)
1885      STBTT_assert(x1 <= x);
1886   else if (x0 >= x+1)
1887      STBTT_assert(x1 >= x+1);
1888   else
1889      STBTT_assert(x1 >= x && x1 <= x+1);
1890
1891   if (x0 <= x && x1 <= x)
1892      scanline[x] += e->direction * (y1-y0);
1893   else if (x0 >= x+1 && x1 >= x+1)
1894      ;
1895   else {
1896      STBTT_assert(x0 >= x && x0 <= x+1 && x1 >= x && x1 <= x+1);
1897      scanline[x] += e->direction * (y1-y0) * (1-((x0-x)+(x1-x))/2); // coverage = 1 - average x position
1898   }
1899}
1900
1901static void stbtt__fill_active_edges_new(float *scanline, float *scanline_fill, int len, stbtt__active_edge *e, float y_top)
1902{
1903   float y_bottom = y_top+1;
1904
1905   while (e) {
1906      // brute force every pixel
1907
1908      // compute intersection points with top & bottom
1909      STBTT_assert(e->ey >= y_top);
1910
1911      if (e->fdx == 0) {
1912         float x0 = e->fx;
1913         if (x0 < len) {
1914            if (x0 >= 0) {
1915               stbtt__handle_clipped_edge(scanline,(int) x0,e, x0,y_top, x0,y_bottom);
1916               stbtt__handle_clipped_edge(scanline_fill-1,(int) x0+1,e, x0,y_top, x0,y_bottom);
1917            } else {
1918               stbtt__handle_clipped_edge(scanline_fill-1,0,e, x0,y_top, x0,y_bottom);
1919            }
1920         }
1921      } else {
1922         float x0 = e->fx;
1923         float dx = e->fdx;
1924         float xb = x0 + dx;
1925         float x_top, x_bottom;
1926         float sy0,sy1;
1927         float dy = e->fdy;
1928         STBTT_assert(e->sy <= y_bottom && e->ey >= y_top);
1929
1930         // compute endpoints of line segment clipped to this scanline (if the
1931         // line segment starts on this scanline. x0 is the intersection of the
1932         // line with y_top, but that may be off the line segment.
1933         if (e->sy > y_top) {
1934            x_top = x0 + dx * (e->sy - y_top);
1935            sy0 = e->sy;
1936         } else {
1937            x_top = x0;
1938            sy0 = y_top;
1939         }
1940         if (e->ey < y_bottom) {
1941            x_bottom = x0 + dx * (e->ey - y_top);
1942            sy1 = e->ey;
1943         } else {
1944            x_bottom = xb;
1945            sy1 = y_bottom;
1946         }
1947
1948         if (x_top >= 0 && x_bottom >= 0 && x_top < len && x_bottom < len) {
1949            // from here on, we don't have to range check x values
1950
1951            if ((int) x_top == (int) x_bottom) {
1952               float height;
1953               // simple case, only spans one pixel
1954               int x = (int) x_top;
1955               height = sy1 - sy0;
1956               STBTT_assert(x >= 0 && x < len);
1957               scanline[x] += e->direction * (1-((x_top - x) + (x_bottom-x))/2)  * height;
1958               scanline_fill[x] += e->direction * height; // everything right of this pixel is filled
1959            } else {
1960               int x,x1,x2;
1961               float y_crossing, step, sign, area;
1962               // covers 2+ pixels
1963               if (x_top > x_bottom) {
1964                  // flip scanline vertically; signed area is the same
1965                  float t;
1966                  sy0 = y_bottom - (sy0 - y_top);
1967                  sy1 = y_bottom - (sy1 - y_top);
1968                  t = sy0, sy0 = sy1, sy1 = t;
1969                  t = x_bottom, x_bottom = x_top, x_top = t;
1970                  dx = -dx;
1971                  dy = -dy;
1972                  t = x0, x0 = xb, xb = t;
1973               }
1974
1975               x1 = (int) x_top;
1976               x2 = (int) x_bottom;
1977               // compute intersection with y axis at x1+1
1978               y_crossing = (x1+1 - x0) * dy + y_top;
1979
1980               sign = e->direction;
1981               // area of the rectangle covered from y0..y_crossing
1982               area = sign * (y_crossing-sy0);
1983               // area of the triangle (x_top,y0), (x+1,y0), (x+1,y_crossing)
1984               scanline[x1] += area * (1-((x_top - x1)+(x1+1-x1))/2);
1985
1986               step = sign * dy;
1987               for (x = x1+1; x < x2; ++x) {
1988                  scanline[x] += area + step/2;
1989                  area += step;
1990               }
1991               y_crossing += dy * (x2 - (x1+1));
1992
1993               STBTT_assert(fabs(area) <= 1.01f);
1994
1995               scanline[x2] += area + sign * (1-(x_bottom-x2)/2) * (sy1-y_crossing);
1996
1997               scanline_fill[x2] += sign * (sy1-sy0);
1998            }
1999         } else {
2000            // if edge goes outside of box we're drawing, we require
2001            // clipping logic. since this does not match the intended use
2002            // of this library, we use a different, very slow brute
2003            // force implementation
2004            int x;
2005            for (x=0; x < len; ++x) {
2006               // cases:
2007               //
2008               // there can be up to two intersections with the pixel. any intersection
2009               // with left or right edges can be handled by splitting into two (or three)
2010               // regions. intersections with top & bottom do not necessitate case-wise logic.
2011               //
2012               // the old way of doing this found the intersections with the left & right edges,
2013               // then used some simple logic to produce up to three segments in sorted order
2014               // from top-to-bottom. however, this had a problem: if an x edge was epsilon
2015               // across the x border, then the corresponding y position might not be distinct
2016               // from the other y segment, and it might ignored as an empty segment. to avoid
2017               // that, we need to explicitly produce segments based on x positions.
2018
2019               // rename variables to clear pairs
2020               float y0 = y_top;
2021               float x1 = (float) (x);
2022               float x2 = (float) (x+1);
2023               float x3 = xb;
2024               float y3 = y_bottom;
2025               float y1,y2;
2026
2027               // x = e->x + e->dx * (y-y_top)
2028               // (y-y_top) = (x - e->x) / e->dx
2029               // y = (x - e->x) / e->dx + y_top
2030               y1 = (x - x0) / dx + y_top;
2031               y2 = (x+1 - x0) / dx + y_top;
2032
2033               if (x0 < x1 && x3 > x2) {         // three segments descending down-right
2034                  stbtt__handle_clipped_edge(scanline,x,e, x0,y0, x1,y1);
2035                  stbtt__handle_clipped_edge(scanline,x,e, x1,y1, x2,y2);
2036                  stbtt__handle_clipped_edge(scanline,x,e, x2,y2, x3,y3);
2037               } else if (x3 < x1 && x0 > x2) {  // three segments descending down-left
2038                  stbtt__handle_clipped_edge(scanline,x,e, x0,y0, x2,y2);
2039                  stbtt__handle_clipped_edge(scanline,x,e, x2,y2, x1,y1);
2040                  stbtt__handle_clipped_edge(scanline,x,e, x1,y1, x3,y3);
2041               } else if (x0 < x1 && x3 > x1) {  // two segments across x, down-right
2042                  stbtt__handle_clipped_edge(scanline,x,e, x0,y0, x1,y1);
2043                  stbtt__handle_clipped_edge(scanline,x,e, x1,y1, x3,y3);
2044               } else if (x3 < x1 && x0 > x1) {  // two segments across x, down-left
2045                  stbtt__handle_clipped_edge(scanline,x,e, x0,y0, x1,y1);
2046                  stbtt__handle_clipped_edge(scanline,x,e, x1,y1, x3,y3);
2047               } else if (x0 < x2 && x3 > x2) {  // two segments across x+1, down-right
2048                  stbtt__handle_clipped_edge(scanline,x,e, x0,y0, x2,y2);
2049                  stbtt__handle_clipped_edge(scanline,x,e, x2,y2, x3,y3);
2050               } else if (x3 < x2 && x0 > x2) {  // two segments across x+1, down-left
2051                  stbtt__handle_clipped_edge(scanline,x,e, x0,y0, x2,y2);
2052                  stbtt__handle_clipped_edge(scanline,x,e, x2,y2, x3,y3);
2053               } else {  // one segment
2054                  stbtt__handle_clipped_edge(scanline,x,e, x0,y0, x3,y3);
2055               }
2056            }
2057         }
2058      }
2059      e = e->next;
2060   }
2061}
2062
2063// directly AA rasterize edges w/o supersampling
2064static void stbtt__rasterize_sorted_edges(stbtt__bitmap *result, stbtt__edge *e, int n, int vsubsample, int off_x, int off_y, void *userdata)
2065{
2066   stbtt__hheap hh = { 0, 0, 0 };
2067   stbtt__active_edge *active = NULL;
2068   int y,j=0, i;
2069   float scanline_data[129], *scanline, *scanline2;
2070
2071   if (result->w > 64)
2072      scanline = (float *) STBTT_malloc((result->w*2+1) * sizeof(float), userdata);
2073   else
2074      scanline = scanline_data;
2075
2076   scanline2 = scanline + result->w;
2077
2078   y = off_y;
2079   e[n].y0 = (float) (off_y + result->h) + 1;
2080
2081   while (j < result->h) {
2082      // find center of pixel for this scanline
2083      float scan_y_top    = y + 0.0f;
2084      float scan_y_bottom = y + 1.0f;
2085      stbtt__active_edge **step = &active;
2086
2087      STBTT_memset(scanline , 0, result->w*sizeof(scanline[0]));
2088      STBTT_memset(scanline2, 0, (result->w+1)*sizeof(scanline[0]));
2089
2090      // update all active edges;
2091      // remove all active edges that terminate before the top of this scanline
2092      while (*step) {
2093         stbtt__active_edge * z = *step;
2094         if (z->ey <= scan_y_top) {
2095            *step = z->next; // delete from list
2096            STBTT_assert(z->direction);
2097            z->direction = 0;
2098            stbtt__hheap_free(&hh, z);
2099         } else {
2100            step = &((*step)->next); // advance through list
2101         }
2102      }
2103
2104      // insert all edges that start before the bottom of this scanline
2105      while (e->y0 <= scan_y_bottom) {
2106         if (e->y0 != e->y1) {
2107            stbtt__active_edge *z = stbtt__new_active(&hh, e, off_x, scan_y_top, userdata);
2108            STBTT_assert(z->ey >= scan_y_top);
2109            // insert at front
2110            z->next = active;
2111            active = z;
2112         }
2113         ++e;
2114      }
2115
2116      // now process all active edges
2117      if (active)
2118         stbtt__fill_active_edges_new(scanline, scanline2+1, result->w, active, scan_y_top);
2119
2120      {
2121         float sum = 0;
2122         for (i=0; i < result->w; ++i) {
2123            float k;
2124            int m;
2125            sum += scanline2[i];
2126            k = scanline[i] + sum;
2127            k = (float) STBTT_fabs(k)*255 + 0.5f;
2128            m = (int) k;
2129            if (m > 255) m = 255;
2130            result->pixels[j*result->stride + i] = (unsigned char) m;
2131         }
2132      }
2133      // advance all the edges
2134      step = &active;
2135      while (*step) {
2136         stbtt__active_edge *z = *step;
2137         z->fx += z->fdx; // advance to position for current scanline
2138         step = &((*step)->next); // advance through list
2139      }
2140
2141      ++y;
2142      ++j;
2143   }
2144
2145   stbtt__hheap_cleanup(&hh, userdata);
2146
2147   if (scanline != scanline_data)
2148      STBTT_free(scanline, userdata);
2149}
2150#else
2151#error "Unrecognized value of STBTT_RASTERIZER_VERSION"
2152#endif
2153
2154#define STBTT__COMPARE(a,b)  ((a)->y0 < (b)->y0)
2155
2156static void stbtt__sort_edges_ins_sort(stbtt__edge *p, int n)
2157{
2158   int i,j;
2159   for (i=1; i < n; ++i) {
2160      stbtt__edge t = p[i], *a = &t;
2161      j = i;
2162      while (j > 0) {
2163         stbtt__edge *b = &p[j-1];
2164         int c = STBTT__COMPARE(a,b);
2165         if (!c) break;
2166         p[j] = p[j-1];
2167         --j;
2168      }
2169      if (i != j)
2170         p[j] = t;
2171   }
2172}
2173
2174static void stbtt__sort_edges_quicksort(stbtt__edge *p, int n)
2175{
2176   /* threshhold for transitioning to insertion sort */
2177   while (n > 12) {
2178      stbtt__edge t;
2179      int c01,c12,c,m,i,j;
2180
2181      /* compute median of three */
2182      m = n >> 1;
2183      c01 = STBTT__COMPARE(&p[0],&p[m]);
2184      c12 = STBTT__COMPARE(&p[m],&p[n-1]);
2185      /* if 0 >= mid >= end, or 0 < mid < end, then use mid */
2186      if (c01 != c12) {
2187         /* otherwise, we'll need to swap something else to middle */
2188         int z;
2189         c = STBTT__COMPARE(&p[0],&p[n-1]);
2190         /* 0>mid && mid<n:  0>n => n; 0<n => 0 */
2191         /* 0<mid && mid>n:  0>n => 0; 0<n => n */
2192         z = (c == c12) ? 0 : n-1;
2193         t = p[z];
2194         p[z] = p[m];
2195         p[m] = t;
2196      }
2197      /* now p[m] is the median-of-three */
2198      /* swap it to the beginning so it won't move around */
2199      t = p[0];
2200      p[0] = p[m];
2201      p[m] = t;
2202
2203      /* partition loop */
2204      i=1;
2205      j=n-1;
2206      for(;;) {
2207         /* handling of equality is crucial here */
2208         /* for sentinels & efficiency with duplicates */
2209         for (;;++i) {
2210            if (!STBTT__COMPARE(&p[i], &p[0])) break;
2211         }
2212         for (;;--j) {
2213            if (!STBTT__COMPARE(&p[0], &p[j])) break;
2214         }
2215         /* make sure we haven't crossed */
2216         if (i >= j) break;
2217         t = p[i];
2218         p[i] = p[j];
2219         p[j] = t;
2220
2221         ++i;
2222         --j;
2223      }
2224      /* recurse on smaller side, iterate on larger */
2225      if (j < (n-i)) {
2226         stbtt__sort_edges_quicksort(p,j);
2227         p = p+i;
2228         n = n-i;
2229      } else {
2230         stbtt__sort_edges_quicksort(p+i, n-i);
2231         n = j;
2232      }
2233   }
2234}
2235
2236static void stbtt__sort_edges(stbtt__edge *p, int n)
2237{
2238   stbtt__sort_edges_quicksort(p, n);
2239   stbtt__sort_edges_ins_sort(p, n);
2240}
2241
2242typedef struct
2243{
2244   float x,y;
2245} stbtt__point;
2246
2247static void stbtt__rasterize(stbtt__bitmap *result, stbtt__point *pts, int *wcount, int windings, float scale_x, float scale_y, float shift_x, float shift_y, int off_x, int off_y, int invert, void *userdata)
2248{
2249   float y_scale_inv = invert ? -scale_y : scale_y;
2250   stbtt__edge *e;
2251   int n,i,j,k,m;
2252#if STBTT_RASTERIZER_VERSION == 1
2253   int vsubsample = result->h < 8 ? 15 : 5;
2254#elif STBTT_RASTERIZER_VERSION == 2
2255   int vsubsample = 1;
2256#else
2257   #error "Unrecognized value of STBTT_RASTERIZER_VERSION"
2258#endif
2259   // vsubsample should divide 255 evenly; otherwise we won't reach full opacity
2260
2261   // now we have to blow out the windings into explicit edge lists
2262   n = 0;
2263   for (i=0; i < windings; ++i)
2264      n += wcount[i];
2265
2266   e = (stbtt__edge *) STBTT_malloc(sizeof(*e) * (n+1), userdata); // add an extra one as a sentinel
2267   if (e == 0) return;
2268   n = 0;
2269
2270   m=0;
2271   for (i=0; i < windings; ++i) {
2272      stbtt__point *p = pts + m;
2273      m += wcount[i];
2274      j = wcount[i]-1;
2275      for (k=0; k < wcount[i]; j=k++) {
2276         int a=k,b=j;
2277         // skip the edge if horizontal
2278         if (p[j].y == p[k].y)
2279            continue;
2280         // add edge from j to k to the list
2281         e[n].invert = 0;
2282         if (invert ? p[j].y > p[k].y : p[j].y < p[k].y) {
2283            e[n].invert = 1;
2284            a=j,b=k;
2285         }
2286         e[n].x0 = p[a].x * scale_x + shift_x;
2287         e[n].y0 = (p[a].y * y_scale_inv + shift_y) * vsubsample;
2288         e[n].x1 = p[b].x * scale_x + shift_x;
2289         e[n].y1 = (p[b].y * y_scale_inv + shift_y) * vsubsample;
2290         ++n;
2291      }
2292   }
2293
2294   // now sort the edges by their highest point (should snap to integer, and then by x)
2295   //STBTT_sort(e, n, sizeof(e[0]), stbtt__edge_compare);
2296   stbtt__sort_edges(e, n);
2297
2298   // now, traverse the scanlines and find the intersections on each scanline, use xor winding rule
2299   stbtt__rasterize_sorted_edges(result, e, n, vsubsample, off_x, off_y, userdata);
2300
2301   STBTT_free(e, userdata);
2302}
2303
2304static void stbtt__add_point(stbtt__point *points, int n, float x, float y)
2305{
2306   if (!points) return; // during first pass, it's unallocated
2307   points[n].x = x;
2308   points[n].y = y;
2309}
2310
2311// tesselate until threshhold p is happy... @TODO warped to compensate for non-linear stretching
2312static int stbtt__tesselate_curve(stbtt__point *points, int *num_points, float x0, float y0, float x1, float y1, float x2, float y2, float objspace_flatness_squared, int n)
2313{
2314   // midpoint
2315   float mx = (x0 + 2*x1 + x2)/4;
2316   float my = (y0 + 2*y1 + y2)/4;
2317   // versus directly drawn line
2318   float dx = (x0+x2)/2 - mx;
2319   float dy = (y0+y2)/2 - my;
2320   if (n > 16) // 65536 segments on one curve better be enough!
2321      return 1;
2322   if (dx*dx+dy*dy > objspace_flatness_squared) { // half-pixel error allowed... need to be smaller if AA
2323      stbtt__tesselate_curve(points, num_points, x0,y0, (x0+x1)/2.0f,(y0+y1)/2.0f, mx,my, objspace_flatness_squared,n+1);
2324      stbtt__tesselate_curve(points, num_points, mx,my, (x1+x2)/2.0f,(y1+y2)/2.0f, x2,y2, objspace_flatness_squared,n+1);
2325   } else {
2326      stbtt__add_point(points, *num_points,x2,y2);
2327      *num_points = *num_points+1;
2328   }
2329   return 1;
2330}
2331
2332// returns number of contours
2333static stbtt__point *stbtt_FlattenCurves(stbtt_vertex *vertices, int num_verts, float objspace_flatness, int **contour_lengths, int *num_contours, void *userdata)
2334{
2335   stbtt__point *points=0;
2336   int num_points=0;
2337
2338   float objspace_flatness_squared = objspace_flatness * objspace_flatness;
2339   int i,n=0,start=0, pass;
2340
2341   // count how many "moves" there are to get the contour count
2342   for (i=0; i < num_verts; ++i)
2343      if (vertices[i].type == STBTT_vmove)
2344         ++n;
2345
2346   *num_contours = n;
2347   if (n == 0) return 0;
2348
2349   *contour_lengths = (int *) STBTT_malloc(sizeof(**contour_lengths) * n, userdata);
2350
2351   if (*contour_lengths == 0) {
2352      *num_contours = 0;
2353      return 0;
2354   }
2355
2356   // make two passes through the points so we don't need to realloc
2357   for (pass=0; pass < 2; ++pass) {
2358      float x=0,y=0;
2359      if (pass == 1) {
2360         points = (stbtt__point *) STBTT_malloc(num_points * sizeof(points[0]), userdata);
2361         if (points == NULL) goto error;
2362      }
2363      num_points = 0;
2364      n= -1;
2365      for (i=0; i < num_verts; ++i) {
2366         switch (vertices[i].type) {
2367            case STBTT_vmove:
2368               // start the next contour
2369               if (n >= 0)
2370                  (*contour_lengths)[n] = num_points - start;
2371               ++n;
2372               start = num_points;
2373
2374               x = vertices[i].x, y = vertices[i].y;
2375               stbtt__add_point(points, num_points++, x,y);
2376               break;
2377            case STBTT_vline:
2378               x = vertices[i].x, y = vertices[i].y;
2379               stbtt__add_point(points, num_points++, x, y);
2380               break;
2381            case STBTT_vcurve:
2382               stbtt__tesselate_curve(points, &num_points, x,y,
2383                                        vertices[i].cx, vertices[i].cy,
2384                                        vertices[i].x,  vertices[i].y,
2385                                        objspace_flatness_squared, 0);
2386               x = vertices[i].x, y = vertices[i].y;
2387               break;
2388         }
2389      }
2390      (*contour_lengths)[n] = num_points - start;
2391   }
2392
2393   return points;
2394error:
2395   STBTT_free(points, userdata);
2396   STBTT_free(*contour_lengths, userdata);
2397   *contour_lengths = 0;
2398   *num_contours = 0;
2399   return NULL;
2400}
2401
2402STBTT_DEF void stbtt_Rasterize(stbtt__bitmap *result, float flatness_in_pixels, stbtt_vertex *vertices, int num_verts, float scale_x, float scale_y, float shift_x, float shift_y, int x_off, int y_off, int invert, void *userdata)
2403{
2404   float scale = scale_x > scale_y ? scale_y : scale_x;
2405   int winding_count, *winding_lengths;
2406   stbtt__point *windings = stbtt_FlattenCurves(vertices, num_verts, flatness_in_pixels / scale, &winding_lengths, &winding_count, userdata);
2407   if (windings) {
2408      stbtt__rasterize(result, windings, winding_lengths, winding_count, scale_x, scale_y, shift_x, shift_y, x_off, y_off, invert, userdata);
2409      STBTT_free(winding_lengths, userdata);
2410      STBTT_free(windings, userdata);
2411   }
2412}
2413
2414STBTT_DEF void stbtt_FreeBitmap(unsigned char *bitmap, void *userdata)
2415{
2416   STBTT_free(bitmap, userdata);
2417}
2418
2419STBTT_DEF unsigned char *stbtt_GetGlyphBitmapSubpixel(const stbtt_fontinfo *info, float scale_x, float scale_y, float shift_x, float shift_y, int glyph, int *width, int *height, int *xoff, int *yoff)
2420{
2421   int ix0,iy0,ix1,iy1;
2422   stbtt__bitmap gbm;
2423   stbtt_vertex *vertices;   
2424   int num_verts = stbtt_GetGlyphShape(info, glyph, &vertices);
2425
2426   if (scale_x == 0) scale_x = scale_y;
2427   if (scale_y == 0) {
2428      if (scale_x == 0) {
2429         STBTT_free(vertices, info->userdata);
2430         return NULL;
2431      }
2432      scale_y = scale_x;
2433   }
2434
2435   stbtt_GetGlyphBitmapBoxSubpixel(info, glyph, scale_x, scale_y, shift_x, shift_y, &ix0,&iy0,&ix1,&iy1);
2436
2437   // now we get the size
2438   gbm.w = (ix1 - ix0);
2439   gbm.h = (iy1 - iy0);
2440   gbm.pixels = NULL; // in case we error
2441
2442   if (width ) *width  = gbm.w;
2443   if (height) *height = gbm.h;
2444   if (xoff  ) *xoff   = ix0;
2445   if (yoff  ) *yoff   = iy0;
2446   
2447   if (gbm.w && gbm.h) {
2448      gbm.pixels = (unsigned char *) STBTT_malloc(gbm.w * gbm.h, info->userdata);
2449      if (gbm.pixels) {
2450         gbm.stride = gbm.w;
2451
2452         stbtt_Rasterize(&gbm, 0.35f, vertices, num_verts, scale_x, scale_y, shift_x, shift_y, ix0, iy0, 1, info->userdata);
2453      }
2454   }
2455   STBTT_free(vertices, info->userdata);
2456   return gbm.pixels;
2457}   
2458
2459STBTT_DEF unsigned char *stbtt_GetGlyphBitmap(const stbtt_fontinfo *info, float scale_x, float scale_y, int glyph, int *width, int *height, int *xoff, int *yoff)
2460{
2461   return stbtt_GetGlyphBitmapSubpixel(info, scale_x, scale_y, 0.0f, 0.0f, glyph, width, height, xoff, yoff);
2462}
2463
2464STBTT_DEF void stbtt_MakeGlyphBitmapSubpixel(const stbtt_fontinfo *info, unsigned char *output, int out_w, int out_h, int out_stride, float scale_x, float scale_y, float shift_x, float shift_y, int glyph)
2465{
2466   int ix0,iy0;
2467   stbtt_vertex *vertices;
2468   int num_verts = stbtt_GetGlyphShape(info, glyph, &vertices);
2469   stbtt__bitmap gbm;   
2470
2471   stbtt_GetGlyphBitmapBoxSubpixel(info, glyph, scale_x, scale_y, shift_x, shift_y, &ix0,&iy0,0,0);
2472   gbm.pixels = output;
2473   gbm.w = out_w;
2474   gbm.h = out_h;
2475   gbm.stride = out_stride;
2476
2477   if (gbm.w && gbm.h)
2478      stbtt_Rasterize(&gbm, 0.35f, vertices, num_verts, scale_x, scale_y, shift_x, shift_y, ix0,iy0, 1, info->userdata);
2479
2480   STBTT_free(vertices, info->userdata);
2481}
2482
2483STBTT_DEF void stbtt_MakeGlyphBitmap(const stbtt_fontinfo *info, unsigned char *output, int out_w, int out_h, int out_stride, float scale_x, float scale_y, int glyph)
2484{
2485   stbtt_MakeGlyphBitmapSubpixel(info, output, out_w, out_h, out_stride, scale_x, scale_y, 0.0f,0.0f, glyph);
2486}
2487
2488STBTT_DEF unsigned char *stbtt_GetCodepointBitmapSubpixel(const stbtt_fontinfo *info, float scale_x, float scale_y, float shift_x, float shift_y, int codepoint, int *width, int *height, int *xoff, int *yoff)
2489{
2490   return stbtt_GetGlyphBitmapSubpixel(info, scale_x, scale_y,shift_x,shift_y, stbtt_FindGlyphIndex(info,codepoint), width,height,xoff,yoff);
2491}   
2492
2493STBTT_DEF void stbtt_MakeCodepointBitmapSubpixel(const stbtt_fontinfo *info, unsigned char *output, int out_w, int out_h, int out_stride, float scale_x, float scale_y, float shift_x, float shift_y, int codepoint)
2494{
2495   stbtt_MakeGlyphBitmapSubpixel(info, output, out_w, out_h, out_stride, scale_x, scale_y, shift_x, shift_y, stbtt_FindGlyphIndex(info,codepoint));
2496}
2497
2498STBTT_DEF unsigned char *stbtt_GetCodepointBitmap(const stbtt_fontinfo *info, float scale_x, float scale_y, int codepoint, int *width, int *height, int *xoff, int *yoff)
2499{
2500   return stbtt_GetCodepointBitmapSubpixel(info, scale_x, scale_y, 0.0f,0.0f, codepoint, width,height,xoff,yoff);
2501}   
2502
2503STBTT_DEF void stbtt_MakeCodepointBitmap(const stbtt_fontinfo *info, unsigned char *output, int out_w, int out_h, int out_stride, float scale_x, float scale_y, int codepoint)
2504{
2505   stbtt_MakeCodepointBitmapSubpixel(info, output, out_w, out_h, out_stride, scale_x, scale_y, 0.0f,0.0f, codepoint);
2506}
2507
2508//////////////////////////////////////////////////////////////////////////////
2509//
2510// bitmap baking
2511//
2512// This is SUPER-CRAPPY packing to keep source code small
2513
2514STBTT_DEF int stbtt_BakeFontBitmap(const unsigned char *data, int offset,  // font location (use offset=0 for plain .ttf)
2515                                float pixel_height,                     // height of font in pixels
2516                                unsigned char *pixels, int pw, int ph,  // bitmap to be filled in
2517                                int first_char, int num_chars,          // characters to bake
2518                                stbtt_bakedchar *chardata)
2519{
2520   float scale;
2521   int x,y,bottom_y, i;
2522   stbtt_fontinfo f;
2523   if (!stbtt_InitFont(&f, data, offset))
2524      return -1;
2525   STBTT_memset(pixels, 0, pw*ph); // background of 0 around pixels
2526   x=y=1;
2527   bottom_y = 1;
2528
2529   scale = stbtt_ScaleForPixelHeight(&f, pixel_height);
2530
2531   for (i=0; i < num_chars; ++i) {
2532      int advance, lsb, x0,y0,x1,y1,gw,gh;
2533      int g = stbtt_FindGlyphIndex(&f, first_char + i);
2534      stbtt_GetGlyphHMetrics(&f, g, &advance, &lsb);
2535      stbtt_GetGlyphBitmapBox(&f, g, scale,scale, &x0,&y0,&x1,&y1);
2536      gw = x1-x0;
2537      gh = y1-y0;
2538      if (x + gw + 1 >= pw)
2539         y = bottom_y, x = 1; // advance to next row
2540      if (y + gh + 1 >= ph) // check if it fits vertically AFTER potentially moving to next row
2541         return -i;
2542      STBTT_assert(x+gw < pw);
2543      STBTT_assert(y+gh < ph);
2544      stbtt_MakeGlyphBitmap(&f, pixels+x+y*pw, gw,gh,pw, scale,scale, g);
2545      chardata[i].x0 = (stbtt_int16) x;
2546      chardata[i].y0 = (stbtt_int16) y;
2547      chardata[i].x1 = (stbtt_int16) (x + gw);
2548      chardata[i].y1 = (stbtt_int16) (y + gh);
2549      chardata[i].xadvance = scale * advance;
2550      chardata[i].xoff     = (float) x0;
2551      chardata[i].yoff     = (float) y0;
2552      x = x + gw + 1;
2553      if (y+gh+1 > bottom_y)
2554         bottom_y = y+gh+1;
2555   }
2556   return bottom_y;
2557}
2558
2559STBTT_DEF void stbtt_GetBakedQuad(stbtt_bakedchar *chardata, int pw, int ph, int char_index, float *xpos, float *ypos, stbtt_aligned_quad *q, int opengl_fillrule)
2560{
2561   float d3d_bias = opengl_fillrule ? 0 : -0.5f;
2562   float ipw = 1.0f / pw, iph = 1.0f / ph;
2563   stbtt_bakedchar *b = chardata + char_index;
2564   int round_x = STBTT_ifloor((*xpos + b->xoff) + 0.5f);
2565   int round_y = STBTT_ifloor((*ypos + b->yoff) + 0.5f);
2566
2567   q->x0 = round_x + d3d_bias;
2568   q->y0 = round_y + d3d_bias;
2569   q->x1 = round_x + b->x1 - b->x0 + d3d_bias;
2570   q->y1 = round_y + b->y1 - b->y0 + d3d_bias;
2571
2572   q->s0 = b->x0 * ipw;
2573   q->t0 = b->y0 * iph;
2574   q->s1 = b->x1 * ipw;
2575   q->t1 = b->y1 * iph;
2576
2577   *xpos += b->xadvance;
2578}
2579
2580//////////////////////////////////////////////////////////////////////////////
2581//
2582// rectangle packing replacement routines if you don't have stb_rect_pack.h
2583//
2584
2585#ifndef STB_RECT_PACK_VERSION
2586#ifdef _MSC_VER
2587#define STBTT__NOTUSED(v)  (void)(v)
2588#else
2589#define STBTT__NOTUSED(v)  (void)sizeof(v)
2590#endif
2591
2592typedef int stbrp_coord;
2593
2594////////////////////////////////////////////////////////////////////////////////////
2595//                                                                                //
2596//                                                                                //
2597// COMPILER WARNING ?!?!?                                                         //
2598//                                                                                //
2599//                                                                                //
2600// if you get a compile warning due to these symbols being defined more than      //
2601// once, move #include "stb_rect_pack.h" before #include "stb_truetype.h"         //
2602//                                                                                //
2603////////////////////////////////////////////////////////////////////////////////////
2604
2605typedef struct
2606{
2607   int width,height;
2608   int x,y,bottom_y;
2609} stbrp_context;
2610
2611typedef struct
2612{
2613   unsigned char x;
2614} stbrp_node;
2615
2616struct stbrp_rect
2617{
2618   stbrp_coord x,y;
2619   int id,w,h,was_packed;
2620};
2621
2622static void stbrp_init_target(stbrp_context *con, int pw, int ph, stbrp_node *nodes, int num_nodes)
2623{
2624   con->width  = pw;
2625   con->height = ph;
2626   con->x = 0;
2627   con->y = 0;
2628   con->bottom_y = 0;
2629   STBTT__NOTUSED(nodes);
2630   STBTT__NOTUSED(num_nodes);   
2631}
2632
2633static void stbrp_pack_rects(stbrp_context *con, stbrp_rect *rects, int num_rects)
2634{
2635   int i;
2636   for (i=0; i < num_rects; ++i) {
2637      if (con->x + rects[i].w > con->width) {
2638         con->x = 0;
2639         con->y = con->bottom_y;
2640      }
2641      if (con->y + rects[i].h > con->height)
2642         break;
2643      rects[i].x = con->x;
2644      rects[i].y = con->y;
2645      rects[i].was_packed = 1;
2646      con->x += rects[i].w;
2647      if (con->y + rects[i].h > con->bottom_y)
2648         con->bottom_y = con->y + rects[i].h;
2649   }
2650   for (   ; i < num_rects; ++i)
2651      rects[i].was_packed = 0;
2652}
2653#endif
2654
2655//////////////////////////////////////////////////////////////////////////////
2656//
2657// bitmap baking
2658//
2659// This is SUPER-AWESOME (tm Ryan Gordon) packing using stb_rect_pack.h. If
2660// stb_rect_pack.h isn't available, it uses the BakeFontBitmap strategy.
2661
2662STBTT_DEF int stbtt_PackBegin(stbtt_pack_context *spc, unsigned char *pixels, int pw, int ph, int stride_in_bytes, int padding, void *alloc_context)
2663{
2664   stbrp_context *context = (stbrp_context *) STBTT_malloc(sizeof(*context)            ,alloc_context);
2665   int            num_nodes = pw - padding;
2666   stbrp_node    *nodes   = (stbrp_node    *) STBTT_malloc(sizeof(*nodes  ) * num_nodes,alloc_context);
2667
2668   if (context == NULL || nodes == NULL) {
2669      if (context != NULL) STBTT_free(context, alloc_context);
2670      if (nodes   != NULL) STBTT_free(nodes  , alloc_context);
2671      return 0;
2672   }
2673
2674   spc->user_allocator_context = alloc_context;
2675   spc->width = pw;
2676   spc->height = ph;
2677   spc->pixels = pixels;
2678   spc->pack_info = context;
2679   spc->nodes = nodes;
2680   spc->padding = padding;
2681   spc->stride_in_bytes = stride_in_bytes != 0 ? stride_in_bytes : pw;
2682   spc->h_oversample = 1;
2683   spc->v_oversample = 1;
2684
2685   stbrp_init_target(context, pw-padding, ph-padding, nodes, num_nodes);
2686
2687   if (pixels)
2688      STBTT_memset(pixels, 0, pw*ph); // background of 0 around pixels
2689
2690   return 1;
2691}
2692
2693STBTT_DEF void stbtt_PackEnd  (stbtt_pack_context *spc)
2694{
2695   STBTT_free(spc->nodes    , spc->user_allocator_context);
2696   STBTT_free(spc->pack_info, spc->user_allocator_context);
2697}
2698
2699STBTT_DEF void stbtt_PackSetOversampling(stbtt_pack_context *spc, unsigned int h_oversample, unsigned int v_oversample)
2700{
2701   STBTT_assert(h_oversample <= STBTT_MAX_OVERSAMPLE);
2702   STBTT_assert(v_oversample <= STBTT_MAX_OVERSAMPLE);
2703   if (h_oversample <= STBTT_MAX_OVERSAMPLE)
2704      spc->h_oversample = h_oversample;
2705   if (v_oversample <= STBTT_MAX_OVERSAMPLE)
2706      spc->v_oversample = v_oversample;
2707}
2708
2709#define STBTT__OVER_MASK  (STBTT_MAX_OVERSAMPLE-1)
2710
2711static void stbtt__h_prefilter(unsigned char *pixels, int w, int h, int stride_in_bytes, unsigned int kernel_width)
2712{
2713   unsigned char buffer[STBTT_MAX_OVERSAMPLE];
2714   int safe_w = w - kernel_width;
2715   int j;
2716   for (j=0; j < h; ++j) {
2717      int i;
2718      unsigned int total;
2719      STBTT_memset(buffer, 0, kernel_width);
2720
2721      total = 0;
2722
2723      // make kernel_width a constant in common cases so compiler can optimize out the divide
2724      switch (kernel_width) {
2725         case 2:
2726            for (i=0; i <= safe_w; ++i) {
2727               total += pixels[i] - buffer[i & STBTT__OVER_MASK];
2728               buffer[(i+kernel_width) & STBTT__OVER_MASK] = pixels[i];
2729               pixels[i] = (unsigned char) (total / 2);
2730            }
2731            break;
2732         case 3:
2733            for (i=0; i <= safe_w; ++i) {
2734               total += pixels[i] - buffer[i & STBTT__OVER_MASK];
2735               buffer[(i+kernel_width) & STBTT__OVER_MASK] = pixels[i];
2736               pixels[i] = (unsigned char) (total / 3);
2737            }
2738            break;
2739         case 4:
2740            for (i=0; i <= safe_w; ++i) {
2741               total += pixels[i] - buffer[i & STBTT__OVER_MASK];
2742               buffer[(i+kernel_width) & STBTT__OVER_MASK] = pixels[i];
2743               pixels[i] = (unsigned char) (total / 4);
2744            }
2745            break;
2746         case 5:
2747            for (i=0; i <= safe_w; ++i) {
2748               total += pixels[i] - buffer[i & STBTT__OVER_MASK];
2749               buffer[(i+kernel_width) & STBTT__OVER_MASK] = pixels[i];
2750               pixels[i] = (unsigned char) (total / 5);
2751            }
2752            break;
2753         default:
2754            for (i=0; i <= safe_w; ++i) {
2755               total += pixels[i] - buffer[i & STBTT__OVER_MASK];
2756               buffer[(i+kernel_width) & STBTT__OVER_MASK] = pixels[i];
2757               pixels[i] = (unsigned char) (total / kernel_width);
2758            }
2759            break;
2760      }
2761
2762      for (; i < w; ++i) {
2763         STBTT_assert(pixels[i] == 0);
2764         total -= buffer[i & STBTT__OVER_MASK];
2765         pixels[i] = (unsigned char) (total / kernel_width);
2766      }
2767
2768      pixels += stride_in_bytes;
2769   }
2770}
2771
2772static void stbtt__v_prefilter(unsigned char *pixels, int w, int h, int stride_in_bytes, unsigned int kernel_width)
2773{
2774   unsigned char buffer[STBTT_MAX_OVERSAMPLE];
2775   int safe_h = h - kernel_width;
2776   int j;
2777   for (j=0; j < w; ++j) {
2778      int i;
2779      unsigned int total;
2780      STBTT_memset(buffer, 0, kernel_width);
2781
2782      total = 0;
2783
2784      // make kernel_width a constant in common cases so compiler can optimize out the divide
2785      switch (kernel_width) {
2786         case 2:
2787            for (i=0; i <= safe_h; ++i) {
2788               total += pixels[i*stride_in_bytes] - buffer[i & STBTT__OVER_MASK];
2789               buffer[(i+kernel_width) & STBTT__OVER_MASK] = pixels[i*stride_in_bytes];
2790               pixels[i*stride_in_bytes] = (unsigned char) (total / 2);
2791            }
2792            break;
2793         case 3:
2794            for (i=0; i <= safe_h; ++i) {
2795               total += pixels[i*stride_in_bytes] - buffer[i & STBTT__OVER_MASK];
2796               buffer[(i+kernel_width) & STBTT__OVER_MASK] = pixels[i*stride_in_bytes];
2797               pixels[i*stride_in_bytes] = (unsigned char) (total / 3);
2798            }
2799            break;
2800         case 4:
2801            for (i=0; i <= safe_h; ++i) {
2802               total += pixels[i*stride_in_bytes] - buffer[i & STBTT__OVER_MASK];
2803               buffer[(i+kernel_width) & STBTT__OVER_MASK] = pixels[i*stride_in_bytes];
2804               pixels[i*stride_in_bytes] = (unsigned char) (total / 4);
2805            }
2806            break;
2807         case 5:
2808            for (i=0; i <= safe_h; ++i) {
2809               total += pixels[i*stride_in_bytes] - buffer[i & STBTT__OVER_MASK];
2810               buffer[(i+kernel_width) & STBTT__OVER_MASK] = pixels[i*stride_in_bytes];
2811               pixels[i*stride_in_bytes] = (unsigned char) (total / 5);
2812            }
2813            break;
2814         default:
2815            for (i=0; i <= safe_h; ++i) {
2816               total += pixels[i*stride_in_bytes] - buffer[i & STBTT__OVER_MASK];
2817               buffer[(i+kernel_width) & STBTT__OVER_MASK] = pixels[i*stride_in_bytes];
2818               pixels[i*stride_in_bytes] = (unsigned char) (total / kernel_width);
2819            }
2820            break;
2821      }
2822
2823      for (; i < h; ++i) {
2824         STBTT_assert(pixels[i*stride_in_bytes] == 0);
2825         total -= buffer[i & STBTT__OVER_MASK];
2826         pixels[i*stride_in_bytes] = (unsigned char) (total / kernel_width);
2827      }
2828
2829      pixels += 1;
2830   }
2831}
2832
2833static float stbtt__oversample_shift(int oversample)
2834{
2835   if (!oversample)
2836      return 0.0f;
2837
2838   // The prefilter is a box filter of width "oversample",
2839   // which shifts phase by (oversample - 1)/2 pixels in
2840   // oversampled space. We want to shift in the opposite
2841   // direction to counter this.
2842   return (float)-(oversample - 1) / (2.0f * (float)oversample);
2843}
2844
2845// rects array must be big enough to accommodate all characters in the given ranges
2846STBTT_DEF int stbtt_PackFontRangesGatherRects(stbtt_pack_context *spc, stbtt_fontinfo *info, stbtt_pack_range *ranges, int num_ranges, stbrp_rect *rects)
2847{
2848   int i,j,k;
2849
2850   k=0;
2851   for (i=0; i < num_ranges; ++i) {
2852      float fh = ranges[i].font_size;
2853      float scale = fh > 0 ? stbtt_ScaleForPixelHeight(info, fh) : stbtt_ScaleForMappingEmToPixels(info, -fh);
2854      ranges[i].h_oversample = (unsigned char) spc->h_oversample;
2855      ranges[i].v_oversample = (unsigned char) spc->v_oversample;
2856      for (j=0; j < ranges[i].num_chars; ++j) {
2857         int x0,y0,x1,y1;
2858         int codepoint = ranges[i].array_of_unicode_codepoints == NULL ? ranges[i].first_unicode_codepoint_in_range + j : ranges[i].array_of_unicode_codepoints[j];
2859         int glyph = stbtt_FindGlyphIndex(info, codepoint);
2860         stbtt_GetGlyphBitmapBoxSubpixel(info,glyph,
2861                                         scale * spc->h_oversample,
2862                                         scale * spc->v_oversample,
2863                                         0,0,
2864                                         &x0,&y0,&x1,&y1);
2865         rects[k].w = (stbrp_coord) (x1-x0 + spc->padding + spc->h_oversample-1);
2866         rects[k].h = (stbrp_coord) (y1-y0 + spc->padding + spc->v_oversample-1);
2867         ++k;
2868      }
2869   }
2870
2871   return k;
2872}
2873
2874// rects array must be big enough to accommodate all characters in the given ranges
2875STBTT_DEF int stbtt_PackFontRangesRenderIntoRects(stbtt_pack_context *spc, stbtt_fontinfo *info, stbtt_pack_range *ranges, int num_ranges, stbrp_rect *rects)
2876{
2877   int i,j,k, return_value = 1;
2878
2879   // save current values
2880   int old_h_over = spc->h_oversample;
2881   int old_v_over = spc->v_oversample;
2882
2883   k = 0;
2884   for (i=0; i < num_ranges; ++i) {
2885      float fh = ranges[i].font_size;
2886      float scale = fh > 0 ? stbtt_ScaleForPixelHeight(info, fh) : stbtt_ScaleForMappingEmToPixels(info, -fh);
2887      float recip_h,recip_v,sub_x,sub_y;
2888      spc->h_oversample = ranges[i].h_oversample;
2889      spc->v_oversample = ranges[i].v_oversample;
2890      recip_h = 1.0f / spc->h_oversample;
2891      recip_v = 1.0f / spc->v_oversample;
2892      sub_x = stbtt__oversample_shift(spc->h_oversample);
2893      sub_y = stbtt__oversample_shift(spc->v_oversample);
2894      for (j=0; j < ranges[i].num_chars; ++j) {
2895         stbrp_rect *r = &rects[k];
2896         if (r->was_packed) {
2897            stbtt_packedchar *bc = &ranges[i].chardata_for_range[j];
2898            int advance, lsb, x0,y0,x1,y1;
2899            int codepoint = ranges[i].array_of_unicode_codepoints == NULL ? ranges[i].first_unicode_codepoint_in_range + j : ranges[i].array_of_unicode_codepoints[j];
2900            int glyph = stbtt_FindGlyphIndex(info, codepoint);
2901            stbrp_coord pad = (stbrp_coord) spc->padding;
2902
2903            // pad on left and top
2904            r->x += pad;
2905            r->y += pad;
2906            r->w -= pad;
2907            r->h -= pad;
2908            stbtt_GetGlyphHMetrics(info, glyph, &advance, &lsb);
2909            stbtt_GetGlyphBitmapBox(info, glyph,
2910                                    scale * spc->h_oversample,
2911                                    scale * spc->v_oversample,
2912                                    &x0,&y0,&x1,&y1);
2913            stbtt_MakeGlyphBitmapSubpixel(info,
2914                                          spc->pixels + r->x + r->y*spc->stride_in_bytes,
2915                                          r->w - spc->h_oversample+1,
2916                                          r->h - spc->v_oversample+1,
2917                                          spc->stride_in_bytes,
2918                                          scale * spc->h_oversample,
2919                                          scale * spc->v_oversample,
2920                                          0,0,
2921                                          glyph);
2922
2923            if (spc->h_oversample > 1)
2924               stbtt__h_prefilter(spc->pixels + r->x + r->y*spc->stride_in_bytes,
2925                                  r->w, r->h, spc->stride_in_bytes,
2926                                  spc->h_oversample);
2927
2928            if (spc->v_oversample > 1)
2929               stbtt__v_prefilter(spc->pixels + r->x + r->y*spc->stride_in_bytes,
2930                                  r->w, r->h, spc->stride_in_bytes,
2931                                  spc->v_oversample);
2932
2933            bc->x0       = (stbtt_int16)  r->x;
2934            bc->y0       = (stbtt_int16)  r->y;
2935            bc->x1       = (stbtt_int16) (r->x + r->w);
2936            bc->y1       = (stbtt_int16) (r->y + r->h);
2937            bc->xadvance =                scale * advance;
2938            bc->xoff     =       (float)  x0 * recip_h + sub_x;
2939            bc->yoff     =       (float)  y0 * recip_v + sub_y;
2940            bc->xoff2    =                (x0 + r->w) * recip_h + sub_x;
2941            bc->yoff2    =                (y0 + r->h) * recip_v + sub_y;
2942         } else {
2943            return_value = 0; // if any fail, report failure
2944         }
2945
2946         ++k;
2947      }
2948   }
2949
2950   // restore original values
2951   spc->h_oversample = old_h_over;
2952   spc->v_oversample = old_v_over;
2953
2954   return return_value;
2955}
2956
2957STBTT_DEF void stbtt_PackFontRangesPackRects(stbtt_pack_context *spc, stbrp_rect *rects, int num_rects)
2958{
2959   stbrp_pack_rects((stbrp_context *) spc->pack_info, rects, num_rects);
2960}
2961
2962STBTT_DEF int stbtt_PackFontRanges(stbtt_pack_context *spc, unsigned char *fontdata, int font_index, stbtt_pack_range *ranges, int num_ranges)
2963{
2964   stbtt_fontinfo info;
2965   int i,j,n, return_value = 1;
2966   //stbrp_context *context = (stbrp_context *) spc->pack_info;
2967   stbrp_rect    *rects;
2968
2969   // flag all characters as NOT packed
2970   for (i=0; i < num_ranges; ++i)
2971      for (j=0; j < ranges[i].num_chars; ++j)
2972         ranges[i].chardata_for_range[j].x0 =
2973         ranges[i].chardata_for_range[j].y0 =
2974         ranges[i].chardata_for_range[j].x1 =
2975         ranges[i].chardata_for_range[j].y1 = 0;
2976
2977   n = 0;
2978   for (i=0; i < num_ranges; ++i)
2979      n += ranges[i].num_chars;
2980         
2981   rects = (stbrp_rect *) STBTT_malloc(sizeof(*rects) * n, spc->user_allocator_context);
2982   if (rects == NULL)
2983      return 0;
2984
2985   stbtt_InitFont(&info, fontdata, stbtt_GetFontOffsetForIndex(fontdata,font_index));
2986
2987   n = stbtt_PackFontRangesGatherRects(spc, &info, ranges, num_ranges, rects);
2988
2989   stbtt_PackFontRangesPackRects(spc, rects, n);
2990  
2991   return_value = stbtt_PackFontRangesRenderIntoRects(spc, &info, ranges, num_ranges, rects);
2992
2993   STBTT_free(rects, spc->user_allocator_context);
2994   return return_value;
2995}
2996
2997STBTT_DEF int stbtt_PackFontRange(stbtt_pack_context *spc, unsigned char *fontdata, int font_index, float font_size,
2998            int first_unicode_codepoint_in_range, int num_chars_in_range, stbtt_packedchar *chardata_for_range)
2999{
3000   stbtt_pack_range range;
3001   range.first_unicode_codepoint_in_range = first_unicode_codepoint_in_range;
3002   range.array_of_unicode_codepoints = NULL;
3003   range.num_chars                   = num_chars_in_range;
3004   range.chardata_for_range          = chardata_for_range;
3005   range.font_size                   = font_size;
3006   return stbtt_PackFontRanges(spc, fontdata, font_index, &range, 1);
3007}
3008
3009STBTT_DEF void stbtt_GetPackedQuad(stbtt_packedchar *chardata, int pw, int ph, int char_index, float *xpos, float *ypos, stbtt_aligned_quad *q, int align_to_integer)
3010{
3011   float ipw = 1.0f / pw, iph = 1.0f / ph;
3012   stbtt_packedchar *b = chardata + char_index;
3013
3014   if (align_to_integer) {
3015      float x = (float) STBTT_ifloor((*xpos + b->xoff) + 0.5f);
3016      float y = (float) STBTT_ifloor((*ypos + b->yoff) + 0.5f);
3017      q->x0 = x;
3018      q->y0 = y;
3019      q->x1 = x + b->xoff2 - b->xoff;
3020      q->y1 = y + b->yoff2 - b->yoff;
3021   } else {
3022      q->x0 = *xpos + b->xoff;
3023      q->y0 = *ypos + b->yoff;
3024      q->x1 = *xpos + b->xoff2;
3025      q->y1 = *ypos + b->yoff2;
3026   }
3027
3028   q->s0 = b->x0 * ipw;
3029   q->t0 = b->y0 * iph;
3030   q->s1 = b->x1 * ipw;
3031   q->t1 = b->y1 * iph;
3032
3033   *xpos += b->xadvance;
3034}
3035
3036
3037//////////////////////////////////////////////////////////////////////////////
3038//
3039// font name matching -- recommended not to use this
3040//
3041
3042// check if a utf8 string contains a prefix which is the utf16 string; if so return length of matching utf8 string
3043static stbtt_int32 stbtt__CompareUTF8toUTF16_bigendian_prefix(const stbtt_uint8 *s1, stbtt_int32 len1, const stbtt_uint8 *s2, stbtt_int32 len2) 
3044{
3045   stbtt_int32 i=0;
3046
3047   // convert utf16 to utf8 and compare the results while converting
3048   while (len2) {
3049      stbtt_uint16 ch = s2[0]*256 + s2[1];
3050      if (ch < 0x80) {
3051         if (i >= len1) return -1;
3052         if (s1[i++] != ch) return -1;
3053      } else if (ch < 0x800) {
3054         if (i+1 >= len1) return -1;
3055         if (s1[i++] != 0xc0 + (ch >> 6)) return -1;
3056         if (s1[i++] != 0x80 + (ch & 0x3f)) return -1;
3057      } else if (ch >= 0xd800 && ch < 0xdc00) {
3058         stbtt_uint32 c;
3059         stbtt_uint16 ch2 = s2[2]*256 + s2[3];
3060         if (i+3 >= len1) return -1;
3061         c = ((ch - 0xd800) << 10) + (ch2 - 0xdc00) + 0x10000;
3062         if (s1[i++] != 0xf0 + (c >> 18)) return -1;
3063         if (s1[i++] != 0x80 + ((c >> 12) & 0x3f)) return -1;
3064         if (s1[i++] != 0x80 + ((c >>  6) & 0x3f)) return -1;
3065         if (s1[i++] != 0x80 + ((c      ) & 0x3f)) return -1;
3066         s2 += 2; // plus another 2 below
3067         len2 -= 2;
3068      } else if (ch >= 0xdc00 && ch < 0xe000) {
3069         return -1;
3070      } else {
3071         if (i+2 >= len1) return -1;
3072         if (s1[i++] != 0xe0 + (ch >> 12)) return -1;
3073         if (s1[i++] != 0x80 + ((ch >> 6) & 0x3f)) return -1;
3074         if (s1[i++] != 0x80 + ((ch     ) & 0x3f)) return -1;
3075      }
3076      s2 += 2;
3077      len2 -= 2;
3078   }
3079   return i;
3080}
3081
3082STBTT_DEF int stbtt_CompareUTF8toUTF16_bigendian(const char *s1, int len1, const char *s2, int len2) 
3083{
3084   return len1 == stbtt__CompareUTF8toUTF16_bigendian_prefix((const stbtt_uint8*) s1, len1, (const stbtt_uint8*) s2, len2);
3085}
3086
3087// returns results in whatever encoding you request... but note that 2-byte encodings
3088// will be BIG-ENDIAN... use stbtt_CompareUTF8toUTF16_bigendian() to compare
3089STBTT_DEF const char *stbtt_GetFontNameString(const stbtt_fontinfo *font, int *length, int platformID, int encodingID, int languageID, int nameID)
3090{
3091   stbtt_int32 i,count,stringOffset;
3092   stbtt_uint8 *fc = font->data;
3093   stbtt_uint32 offset = font->fontstart;
3094   stbtt_uint32 nm = stbtt__find_table(fc, offset, "name");
3095   if (!nm) return NULL;
3096
3097   count = ttUSHORT(fc+nm+2);
3098   stringOffset = nm + ttUSHORT(fc+nm+4);
3099   for (i=0; i < count; ++i) {
3100      stbtt_uint32 loc = nm + 6 + 12 * i;
3101      if (platformID == ttUSHORT(fc+loc+0) && encodingID == ttUSHORT(fc+loc+2)
3102          && languageID == ttUSHORT(fc+loc+4) && nameID == ttUSHORT(fc+loc+6)) {
3103         *length = ttUSHORT(fc+loc+8);
3104         return (const char *) (fc+stringOffset+ttUSHORT(fc+loc+10));
3105      }
3106   }
3107   return NULL;
3108}
3109
3110static int stbtt__matchpair(stbtt_uint8 *fc, stbtt_uint32 nm, stbtt_uint8 *name, stbtt_int32 nlen, stbtt_int32 target_id, stbtt_int32 next_id)
3111{
3112   stbtt_int32 i;
3113   stbtt_int32 count = ttUSHORT(fc+nm+2);
3114   stbtt_int32 stringOffset = nm + ttUSHORT(fc+nm+4);
3115
3116   for (i=0; i < count; ++i) {
3117      stbtt_uint32 loc = nm + 6 + 12 * i;
3118      stbtt_int32 id = ttUSHORT(fc+loc+6);
3119      if (id == target_id) {
3120         // find the encoding
3121         stbtt_int32 platform = ttUSHORT(fc+loc+0), encoding = ttUSHORT(fc+loc+2), language = ttUSHORT(fc+loc+4);
3122
3123         // is this a Unicode encoding?
3124         if (platform == 0 || (platform == 3 && encoding == 1) || (platform == 3 && encoding == 10)) {
3125            stbtt_int32 slen = ttUSHORT(fc+loc+8);
3126            stbtt_int32 off = ttUSHORT(fc+loc+10);
3127
3128            // check if there's a prefix match
3129            stbtt_int32 matchlen = stbtt__CompareUTF8toUTF16_bigendian_prefix(name, nlen, fc+stringOffset+off,slen);
3130            if (matchlen >= 0) {
3131               // check for target_id+1 immediately following, with same encoding & language
3132               if (i+1 < count && ttUSHORT(fc+loc+12+6) == next_id && ttUSHORT(fc+loc+12) == platform && ttUSHORT(fc+loc+12+2) == encoding && ttUSHORT(fc+loc+12+4) == language) {
3133                  slen = ttUSHORT(fc+loc+12+8);
3134                  off = ttUSHORT(fc+loc+12+10);
3135                  if (slen == 0) {
3136                     if (matchlen == nlen)
3137                        return 1;
3138                  } else if (matchlen < nlen && name[matchlen] == ' ') {
3139                     ++matchlen;
3140                     if (stbtt_CompareUTF8toUTF16_bigendian((char*) (name+matchlen), nlen-matchlen, (char*)(fc+stringOffset+off),slen))
3141                        return 1;
3142                  }
3143               } else {
3144                  // if nothing immediately following
3145                  if (matchlen == nlen)
3146                     return 1;
3147               }
3148            }
3149         }
3150
3151         // @TODO handle other encodings
3152      }
3153   }
3154   return 0;
3155}
3156
3157static int stbtt__matches(stbtt_uint8 *fc, stbtt_uint32 offset, stbtt_uint8 *name, stbtt_int32 flags)
3158{
3159   stbtt_int32 nlen = (stbtt_int32) STBTT_strlen((char *) name);
3160   stbtt_uint32 nm,hd;
3161   if (!stbtt__isfont(fc+offset)) return 0;
3162
3163   // check italics/bold/underline flags in macStyle...
3164   if (flags) {
3165      hd = stbtt__find_table(fc, offset, "head");
3166      if ((ttUSHORT(fc+hd+44) & 7) != (flags & 7)) return 0;
3167   }
3168
3169   nm = stbtt__find_table(fc, offset, "name");
3170   if (!nm) return 0;
3171
3172   if (flags) {
3173      // if we checked the macStyle flags, then just check the family and ignore the subfamily
3174      if (stbtt__matchpair(fc, nm, name, nlen, 16, -1))  return 1;
3175      if (stbtt__matchpair(fc, nm, name, nlen,  1, -1))  return 1;
3176      if (stbtt__matchpair(fc, nm, name, nlen,  3, -1))  return 1;
3177   } else {
3178      if (stbtt__matchpair(fc, nm, name, nlen, 16, 17))  return 1;
3179      if (stbtt__matchpair(fc, nm, name, nlen,  1,  2))  return 1;
3180      if (stbtt__matchpair(fc, nm, name, nlen,  3, -1))  return 1;
3181   }
3182
3183   return 0;
3184}
3185
3186STBTT_DEF int stbtt_FindMatchingFont(const unsigned char *font_collection, const char *name_utf8, stbtt_int32 flags)
3187{
3188   stbtt_int32 i;
3189   for (i=0;;++i) {
3190      stbtt_int32 off = stbtt_GetFontOffsetForIndex(font_collection, i);
3191      if (off < 0) return off;
3192      if (stbtt__matches((stbtt_uint8 *) font_collection, off, (stbtt_uint8*) name_utf8, flags))
3193         return off;
3194   }
3195}
3196
3197#endif // STB_TRUETYPE_IMPLEMENTATION
3198
3199
3200// FULL VERSION HISTORY
3201//
3202//   1.08 (2015-09-13) document stbtt_Rasterize(); fixes for vertical & horizontal edges
3203//   1.07 (2015-08-01) allow PackFontRanges to accept arrays of sparse codepoints;
3204//                     allow PackFontRanges to pack and render in separate phases;
3205//                     fix stbtt_GetFontOFfsetForIndex (never worked for non-0 input?);
3206//                     fixed an assert() bug in the new rasterizer
3207//                     replace assert() with STBTT_assert() in new rasterizer
3208//   1.06 (2015-07-14) performance improvements (~35% faster on x86 and x64 on test machine)
3209//                     also more precise AA rasterizer, except if shapes overlap
3210//                     remove need for STBTT_sort
3211//   1.05 (2015-04-15) fix misplaced definitions for STBTT_STATIC
3212//   1.04 (2015-04-15) typo in example
3213//   1.03 (2015-04-12) STBTT_STATIC, fix memory leak in new packing, various fixes
3214//   1.02 (2014-12-10) fix various warnings & compile issues w/ stb_rect_pack, C++
3215//   1.01 (2014-12-08) fix subpixel position when oversampling to exactly match
3216//                        non-oversampled; STBTT_POINT_SIZE for packed case only
3217//   1.00 (2014-12-06) add new PackBegin etc. API, w/ support for oversampling
3218//   0.99 (2014-09-18) fix multiple bugs with subpixel rendering (ryg)
3219//   0.9  (2014-08-07) support certain mac/iOS fonts without an MS platformID
3220//   0.8b (2014-07-07) fix a warning
3221//   0.8  (2014-05-25) fix a few more warnings
3222//   0.7  (2013-09-25) bugfix: subpixel glyph bug fixed in 0.5 had come back
3223//   0.6c (2012-07-24) improve documentation
3224//   0.6b (2012-07-20) fix a few more warnings
3225//   0.6  (2012-07-17) fix warnings; added stbtt_ScaleForMappingEmToPixels,
3226//                        stbtt_GetFontBoundingBox, stbtt_IsGlyphEmpty
3227//   0.5  (2011-12-09) bugfixes:
3228//                        subpixel glyph renderer computed wrong bounding box
3229//                        first vertex of shape can be off-curve (FreeSans)
3230//   0.4b (2011-12-03) fixed an error in the font baking example
3231//   0.4  (2011-12-01) kerning, subpixel rendering (tor)
3232//                    bugfixes for:
3233//                        codepoint-to-glyph conversion using table fmt=12
3234//                        codepoint-to-glyph conversion using table fmt=4
3235//                        stbtt_GetBakedQuad with non-square texture (Zer)
3236//                    updated Hello World! sample to use kerning and subpixel
3237//                    fixed some warnings
3238//   0.3  (2009-06-24) cmap fmt=12, compound shapes (MM)
3239//                    userdata, malloc-from-userdata, non-zero fill (stb)
3240//   0.2  (2009-03-11) Fix unsigned/signed char warnings
3241//   0.1  (2009-03-09) First public release
3242//
3243