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