1
// stb_truetype.h - v0.3 - public domain - 2009 Sean Barrett / RAD Game Tools
3
// This library processes TrueType files:
5
// extract glyph metrics
6
// extract glyph shapes
7
// render glyphs to one-channel bitmaps with antialiasing (box filter)
11
// crashproof on bad data
13
// subpixel positioning when rendering bitmap
16
// ADDITIONAL CONTRIBUTORS
18
// Mikko Mononen: compound shape support, more cmap formats
22
// 0.3 (2009-06-24) cmap fmt=12, compound shapes (MM)
23
// userdata, malloc-from-userdata, non-zero fill (STB)
24
// 0.2 (2009-03-11) Fix unsigned/signed char warnings
25
// 0.1 (2009-03-09) First public release
29
// Include this file in whatever places neeed to refer to it. In ONE C/C++
31
// #define STB_TRUETYPE_IMPLEMENTATION
32
// before the #include of this file. This expands out the actual
33
// implementation into that C/C++ file.
35
// Look at the header-file sections below for the API, but here's a quick skim:
37
// Simple 3D API (don't ship this, but it's fine for tools and quick start,
38
// and you can cut and paste from it to move to more advanced)
39
// stbtt_BakeFontBitmap() -- bake a font to a bitmap for use as texture
40
// stbtt_GetBakedQuad() -- compute quad to draw for a given char
42
// "Load" a font file from a memory buffer (you have to keep the buffer loaded)
44
// stbtt_GetFontOffsetForIndex() -- use for TTC font collections
46
// Render a unicode codepoint to a bitmap
47
// stbtt_GetCodepointBitmap() -- allocates and returns a bitmap
48
// stbtt_MakeCodepointBitmap() -- renders into bitmap you provide
49
// stbtt_GetCodepointBitmapBox() -- how big the bitmap must be
51
// Character advance/positioning
52
// stbtt_GetCodepointHMetrics()
53
// stbtt_GetFontVMetrics()
57
// The system uses the raw data found in the .ttf file without changing it
58
// and without building auxiliary data structures. This is a bit inefficient
59
// on little-endian systems (the data is big-endian), but assuming you're
60
// caching the bitmaps or glyph shapes this shouldn't be a big deal.
62
// It appears to be very hard to programmatically determine what font a
63
// given file is in a general way. I provide an API for this, but I don't
67
// SOURCE STATISTICS (based on v0.3, 1800 LOC)
69
// Documentation & header file 350 LOC \___ 500 LOC documentation
70
// Sample code 140 LOC /
71
// Truetype parsing 580 LOC ---- 600 LOC TrueType
72
// Software rasterization 240 LOC \ .
73
// Curve tesselation 120 LOC \__ 500 LOC Bitmap creation
74
// Bitmap management 70 LOC /
75
// Baked bitmap interface 70 LOC /
76
// Font name matching & access 150 LOC ---- 150
77
// C runtime library abstraction 60 LOC ---- 60
80
//////////////////////////////////////////////////////////////////////////////
81
//////////////////////////////////////////////////////////////////////////////
86
// Incomplete text-in-3d-api example, which draws quads properly aligned to be lossless
89
#define STB_TRUETYPE_IMPLEMENTATION // force following include to generate implementation
90
#include "stb_truetype.h"
92
char ttf_buffer[1<<20];
93
unsigned char temp_bitmap[512*512];
95
stbtt_chardata cdata[96]; // ASCII 32..126 is 95 glyphs
98
void my_stbtt_initfont(void)
100
fread(ttf_buffer, 1, 1<<20, fopen("c:/windows/fonts/times.ttf", "rb"));
101
stbtt_BakeFontBitmap(data,0, 32.0, temp_bitmap,512,512, 32,96, cdata); // no guarantee this fits!
102
// can free ttf_buffer at this point
103
glGenTextures(1, &ftex);
104
glBindTexture(GL_TEXTURE_2D, ftex);
105
glTexImage2D(GL_TEXTURE_2D, 0, GL_ALPHA, 512,512, 0, GL_ALPHA, GL_UNSIGNED_BYTE, temp_bitmap);
106
// can free temp_bitmap at this point
107
glTexParameteri(GL_TEXTURE_2D, GL_TEXTURE_MIN_FILTER, GL_LINEAR);
110
void my_stbtt_print(float x, float y, char *text)
112
// assume orthographic projection with units = screen pixels, origin at top left
113
glBindTexture(GL_TEXTURE_2D, ftex);
116
if (*text >= 32 && *text < 128) {
117
stbtt_aligned_quad q;
118
stbtt_GetBakedQuad(cdata, 512,512, *text-32, &x,&y,&q,1);//1=opengl,0=old d3d
119
glTexCoord2f(q.s0,q.t1); glVertex2f(q.x0,q.y0);
120
glTexCoord2f(q.s1,q.t1); glVertex2f(q.x1,q.y0);
121
glTexCoord2f(q.s1,q.t0); glVertex2f(q.x1,q.y1);
122
glTexCoord2f(q.s0,q.t0); glVertex2f(q.x0,q.y1);
131
//////////////////////////////////////////////////////////////////////////////
133
// Complete program (this compiles): get a single bitmap, print as ASCII art
137
#define STB_TRUETYPE_IMPLEMENTATION // force following include to generate implementation
138
#include "stb_truetype.h"
140
char ttf_buffer[1<<25];
142
int main(int argc, char **argv)
145
unsigned char *bitmap;
146
int w,h,i,j,c = (argc > 1 ? atoi(argv[1]) : 'a'), s = (argc > 2 ? atoi(argv[2]) : 20);
148
fread(ttf_buffer, 1, 1<<25, fopen(argc > 3 ? argv[3] : "c:/windows/fonts/arialbd.ttf", "rb"));
150
stbtt_InitFont(&font, ttf_buffer, stbtt_GetFontOffsetForIndex(ttf_buffer,0));
151
bitmap = stbtt_GetCodepointBitmap(&font, 0,stbtt_ScaleForPixelHeight(&font, s), c, &w, &h, 0,0);
153
for (j=0; j < h; ++j) {
154
for (i=0; i < w; ++i)
155
putchar(" .:ioVM@"[bitmap[j*w+i]>>5]);
175
//////////////////////////////////////////////////////////////////////////////
177
// Complete program: print "Hello World!" banner, with bugs
180
int main(int arg, char **argv)
182
unsigned char screen[20][79];
185
char *text = "Heljo World!";
187
fread(buffer, 1, 1000000, fopen("c:/windows/fonts/arialbd.ttf", "rb"));
188
stbtt_InitFont(&font, buffer, 0);
190
scale = stbtt_ScaleForPixelHeight(&font, 16);
191
memset(screen, 0, sizeof(screen));
194
int advance,lsb,x0,y0,x1,y1, newpos, baseline=13;
195
stbtt_GetCodepointHMetrics(&font, *text, &advance, &lsb);
196
stbtt_GetCodepointBitmapBox(&font, *text, scale,scale, &x0,&y0,&x1,&y1);
197
newpos = pos + (int) (lsb * scale) + x0;
198
stbtt_MakeCodepointBitmap(&font, &screen[baseline + y0][newpos], x1-x0,y1-y0, 79, scale,scale, *text);
199
// note that this stomps the old data, so where character boxes overlap (e.g. 'lj') it's wrong
200
// because this API is really for baking character bitmaps into textures
201
pos += (int) (advance * scale);
205
for (j=0; j < 20; ++j) {
206
for (i=0; i < 79; ++i)
207
putchar(" .:ioVM@"[screen[j][i]>>5]);
216
//////////////////////////////////////////////////////////////////////////////
217
//////////////////////////////////////////////////////////////////////////////
219
//// INTEGRATION WITH RUNTIME LIBRARIES
222
#ifdef STB_TRUETYPE_IMPLEMENTATION
223
// #define your own (u)stbtt_int8/16/32 before including to override this
225
typedef unsigned char stbtt_uint8;
226
typedef signed char stbtt_int8;
227
typedef unsigned short stbtt_uint16;
228
typedef signed short stbtt_int16;
229
typedef unsigned int stbtt_uint32;
230
typedef signed int stbtt_int32;
233
typedef char stbtt__check_size32[sizeof(stbtt_int32)==4 ? 1 : -1];
234
typedef char stbtt__check_size16[sizeof(stbtt_int16)==2 ? 1 : -1];
236
// #define your own STBTT_sort() to override this to avoid qsort
239
#define STBTT_sort(data,num_items,item_size,compare_func) qsort(data,num_items,item_size,compare_func)
242
// #define your own STBTT_ifloor/STBTT_iceil() to avoid math.h
245
#define STBTT_ifloor(x) ((int) floor(x))
246
#define STBTT_iceil(x) ((int) ceil(x))
249
// #define your own functions "STBTT_malloc" / "STBTT_free" to avoid malloc.h
252
#define STBTT_malloc(x,u) malloc(x)
253
#define STBTT_free(x,u) free(x)
258
#define STBTT_assert(x) assert(x)
263
#define STBTT_strlen(x) strlen(x)
268
#define STBTT_memcpy memcpy
269
#define STBTT_memset memset
273
///////////////////////////////////////////////////////////////////////////////
274
///////////////////////////////////////////////////////////////////////////////
280
#ifndef __STB_INCLUDE_STB_TRUETYPE_H__
281
#define __STB_INCLUDE_STB_TRUETYPE_H__
287
//////////////////////////////////////////////////////////////////////////////
289
// TEXTURE BAKING API
291
// If you use this API, you only have to call two functions ever.
296
unsigned short x0,y0,x1,y1; // coordinates of bbox in bitmap
297
float xoff,yoff,xadvance;
300
extern int stbtt_BakeFontBitmap(const unsigned char *data, int offset, // font location (use offset=0 for plain .ttf)
301
float pixel_height, // height of font in pixels
302
unsigned char *pixels, int pw, int ph, // bitmap to be filled in
303
int first_char, int num_chars, // characters to bake
304
stbtt_bakedchar *chardata); // you allocate this, it's num_chars long
305
// if return is positive, the first unused row of the bitmap
306
// if return is negative, returns the negative of the number of characters that fit
307
// if return is 0, no characters fit and no rows were used
308
// This uses a very crappy packing.
312
float x0,y0,s0,t0; // top-left
313
float x1,y1,s1,t1; // bottom-right
314
} stbtt_aligned_quad;
316
extern void stbtt_GetBakedQuad(stbtt_bakedchar *chardata, int pw, int ph, // same data as above
317
int char_index, // character to display
318
float *xpos, float *ypos, // pointers to current position in screen pixel space
319
stbtt_aligned_quad *q, // output: quad to draw
320
int opengl_fillrule); // true if opengl fill rule; false if DX9 or earlier
321
// Call GetBakedQuad with char_index = 'character - first_char', and it
322
// creates the quad you need to draw and advances the current position.
323
// It's inefficient; you might want to c&p it and optimize it.
326
//////////////////////////////////////////////////////////////////////////////
332
extern int stbtt_GetFontOffsetForIndex(const unsigned char *data, int index);
333
// Each .ttf file may have more than one font. Each has a sequential index
334
// number starting from 0. Call this function to get the font offset for a
335
// given index; it returns -1 if the index is out of range. A regular .ttf
336
// file will only define one font and it always be at offset 0, so it will
337
// return '0' for index 0, and -1 for all other indices. You can just skip
338
// this step if you know it's that kind of font.
341
// The following structure is defined publically so you can declare one on
342
// the stack or as a global or etc.
346
unsigned char *data; // pointer to .ttf file
347
int fontstart; // offset of start of font
349
int numGlyphs; // number of glyphs, needed for range checking
351
int loca,head,glyf,hhea,hmtx; // table locations as offset from start of .ttf
352
int index_map; // a cmap mapping for our chosen character encoding
353
int indexToLocFormat; // format needed to map from glyph index to glyph
356
extern int stbtt_InitFont(stbtt_fontinfo *info, const unsigned char *data, int offset);
357
// Given an offset into the file that defines a font, this function builds
358
// the necessary cached info for the rest of the system. You must allocate
359
// the stbtt_fontinfo yourself, and stbtt_InitFont will fill it out. You don't
360
// need to do anything special to free it, because the contents are a pure
361
// cache with no additional data structures. Returns 0 on failure.
364
//////////////////////////////////////////////////////////////////////////////
366
// CHARACTER TO GLYPH-INDEX CONVERSIOn
368
int stbtt_FindGlyphIndex(const stbtt_fontinfo *info, int unicode_codepoint);
369
// If you're going to perform multiple operations on the same character
370
// and you want a speed-up, call this function with the character you're
371
// going to process, then use glyph-based functions instead of the
372
// codepoint-based functions.
375
//////////////////////////////////////////////////////////////////////////////
377
// CHARACTER PROPERTIES
380
extern float stbtt_ScaleForPixelHeight(const stbtt_fontinfo *info, float pixels);
381
// computes a scale factor to produce a font whose "height" is 'pixels' tall.
382
// Height is measured as the distance from the highest ascender to the lowest
383
// descender; in other words, it's equivalent to calling stbtt_GetFontVMetrics
385
// scale = pixels / (ascent - descent)
386
// so if you prefer to measure height by the ascent only, use a similar calculation.
388
extern void stbtt_GetFontVMetrics(const stbtt_fontinfo *info, int *ascent, int *descent, int *lineGap);
389
// ascent is the coordinate above the baseline the font extends; descent
390
// is the coordinate below the baseline the font extends (i.e. it is typically negative)
391
// lineGap is the spacing between one row's descent and the next row's ascent...
392
// so you should advance the vertical position by "*ascent - *descent + *lineGap"
393
// these are expressed in unscaled coordinates
395
extern void stbtt_GetCodepointHMetrics(const stbtt_fontinfo *info, int codepoint, int *advanceWidth, int *leftSideBearing);
396
// leftSideBearing is the offset from the current horizontal position to the left edge of the character
397
// advanceWidth is the offset from the current horizontal position to the next horizontal position
398
// these are expressed in unscaled coordinates
400
extern int stbtt_GetCodepointKernAdvance(const stbtt_fontinfo *info, int ch1, int ch2);
401
// an additional amount to add to the 'advance' value between ch1 and ch2
402
// @TODO; for now always returns 0!
404
extern int stbtt_GetCodepointBox(const stbtt_fontinfo *info, int codepoint, int *x0, int *y0, int *x1, int *y1);
405
// Gets the bounding box of the visible part of the glyph, in unscaled coordinates
407
extern void stbtt_GetGlyphHMetrics(const stbtt_fontinfo *info, int glyph_index, int *advanceWidth, int *leftSideBearing);
408
extern int stbtt_GetGlyphKernAdvance(const stbtt_fontinfo *info, int glyph1, int glyph2);
409
extern int stbtt_GetGlyphBox(const stbtt_fontinfo *info, int glyph_index, int *x0, int *y0, int *x1, int *y1);
410
// as above, but takes one or more glyph indices for greater efficiency
413
//////////////////////////////////////////////////////////////////////////////
415
// GLYPH SHAPES (you probably don't need these, but they have to go before
416
// the bitmaps for C declaration-order reasons)
419
#ifndef STBTT_vmove // you can predefine these to use different values (but why?)
427
#ifndef stbtt_vertex // you can predefine this to use different values
428
// (we share this with other code at RAD)
429
#define stbtt_vertex_type short // can't use stbtt_int16 because that's not visible in the header file
432
stbtt_vertex_type x,y,cx,cy;
433
unsigned char type,padding;
437
extern int stbtt_GetCodepointShape(const stbtt_fontinfo *info, int unicode_codepoint, stbtt_vertex **vertices);
438
extern int stbtt_GetGlyphShape(const stbtt_fontinfo *info, int glyph_index, stbtt_vertex **vertices);
439
// returns # of vertices and fills *vertices with the pointer to them
440
// these are expressed in "unscaled" coordinates
442
extern void stbtt_FreeShape(const stbtt_fontinfo *info, stbtt_vertex *vertices);
443
// frees the data allocated above
445
//////////////////////////////////////////////////////////////////////////////
450
extern void stbtt_FreeBitmap(unsigned char *bitmap, void *userdata);
451
// frees the bitmap allocated below
453
extern unsigned char *stbtt_GetCodepointBitmap(const stbtt_fontinfo *info, float scale_x, float scale_y, int codepoint, int *width, int *height, int *xoff, int *yoff);
454
// allocates a large-enough single-channel 8bpp bitmap and renders the
455
// specified character/glyph at the specified scale into it, with
456
// antialiasing. 0 is no coverage (transparent), 255 is fully covered (opaque).
457
// *width & *height are filled out with the width & height of the bitmap,
458
// which is stored left-to-right, top-to-bottom.
460
// xoff/yoff are the offset it pixel space from the glyph origin to the top-left of the bitmap
462
extern 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);
463
// the same as above, but you pass in storage for the bitmap in the form
464
// of 'output', with row spacing of 'out_stride' bytes. the bitmap is
465
// clipped to out_w/out_h bytes. call the next function to get the
466
// height and width and positioning info
468
extern void stbtt_GetCodepointBitmapBox(const stbtt_fontinfo *font, int codepoint, float scale_x, float scale_y, int *ix0, int *iy0, int *ix1, int *iy1);
469
// get the bbox of the bitmap centered around the glyph origin; so the
470
// bitmap width is ix1-ix0, height is iy1-iy0, and location to place
471
// the bitmap top left is (leftSideBearing*scale,iy0).
472
// (Note that the bitmap uses y-increases-down, but the shape uses
473
// y-increases-up, so CodepointBitmapBox and CodepointBox are inverted.)
475
extern unsigned char *stbtt_GetGlyphBitmap(const stbtt_fontinfo *info, float scale_x, float scale_y, int glyph, int *width, int *height, int *xoff, int *yoff);
476
extern void stbtt_GetGlyphBitmapBox(const stbtt_fontinfo *font, int glyph, float scale_x, float scale_y, int *ix0, int *iy0, int *ix1, int *iy1);
477
extern 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);
479
//extern void stbtt_get_true_bbox(stbtt_vertex *vertices, int num_verts, float scale_x, float scale_y, int *ix0, int *iy0, int *ix1, int *iy1);
481
// @TODO: don't expose this structure
485
unsigned char *pixels;
488
extern void stbtt_Rasterize(stbtt__bitmap *result, float flatness_in_pixels, stbtt_vertex *vertices, int num_verts, float scale_x, float scale_y, int x_off, int y_off, int invert, void *userdata);
490
//////////////////////////////////////////////////////////////////////////////
492
// Finding the right font...
494
// You should really just solve this offline, keep your own tables
495
// of what font is what, and don't try to get it out of the .ttf file.
496
// That's because getting it out of the .ttf file is really hard, because
497
// the names in the file can appear in many possible encodings, in many
498
// possible languages, and e.g. if you need a case-insensitive comparison,
499
// the details of that depend on the encoding & language in a complex way
500
// (actually underspecified in truetype, but also gigantic).
502
// But you can use the provided functions in two possible ways:
503
// stbtt_FindMatchingFont() will use *case-sensitive* comparisons on
504
// unicode-encoded names to try to find the font you want;
505
// you can run this before calling stbtt_InitFont()
507
// stbtt_GetFontNameString() lets you get any of the various strings
508
// from the file yourself and do your own comparisons on them.
509
// You have to have called stbtt_InitFont() first.
512
extern int stbtt_FindMatchingFont(const unsigned char *fontdata, const char *name, int flags);
513
// returns the offset (not index) of the font that matches, or -1 if none
514
// if you use STBTT_MACSTYLE_DONTCARE, use a font name like "Arial Bold".
515
// if you use any other flag, use a font name like "Arial"; this checks
516
// the 'macStyle' header field; i don't know if fonts set this consistently
517
#define STBTT_MACSTYLE_DONTCARE 0
518
#define STBTT_MACSTYLE_BOLD 1
519
#define STBTT_MACSTYLE_ITALIC 2
520
#define STBTT_MACSTYLE_UNDERSCORE 4
521
#define STBTT_MACSTYLE_NONE 8 // <= not same as 0, this makes us check the bitfield is 0
523
extern int stbtt_CompareUTF8toUTF16_bigendian(const char *s1, int len1, const char *s2, int len2);
524
// returns 1/0 whether the first string interpreted as utf8 is identical to
525
// the second string interpreted as big-endian utf16... useful for strings from next func
527
extern char *stbtt_GetFontNameString(const stbtt_fontinfo *font, int *length, int platformID, int encodingID, int languageID, int nameID);
528
// returns the string (which may be big-endian double byte, e.g. for unicode)
529
// and puts the length in bytes in *length.
531
// some of the values for the IDs are below; for more see the truetype spec:
532
// http://developer.apple.com/textfonts/TTRefMan/RM06/Chap6name.html
533
// http://www.microsoft.com/typography/otspec/name.htm
536
STBTT_PLATFORM_ID_UNICODE =0,
537
STBTT_PLATFORM_ID_MAC =1,
538
STBTT_PLATFORM_ID_ISO =2,
539
STBTT_PLATFORM_ID_MICROSOFT =3
542
enum { // encodingID for STBTT_PLATFORM_ID_UNICODE
543
STBTT_UNICODE_EID_UNICODE_1_0 =0,
544
STBTT_UNICODE_EID_UNICODE_1_1 =1,
545
STBTT_UNICODE_EID_ISO_10646 =2,
546
STBTT_UNICODE_EID_UNICODE_2_0_BMP=3,
547
STBTT_UNICODE_EID_UNICODE_2_0_FULL=4,
550
enum { // encodingID for STBTT_PLATFORM_ID_MICROSOFT
551
STBTT_MS_EID_SYMBOL =0,
552
STBTT_MS_EID_UNICODE_BMP =1,
553
STBTT_MS_EID_SHIFTJIS =2,
554
STBTT_MS_EID_UNICODE_FULL =10,
557
enum { // encodingID for STBTT_PLATFORM_ID_MAC; same as Script Manager codes
558
STBTT_MAC_EID_ROMAN =0, STBTT_MAC_EID_ARABIC =4,
559
STBTT_MAC_EID_JAPANESE =1, STBTT_MAC_EID_HEBREW =5,
560
STBTT_MAC_EID_CHINESE_TRAD =2, STBTT_MAC_EID_GREEK =6,
561
STBTT_MAC_EID_KOREAN =3, STBTT_MAC_EID_RUSSIAN =7,
564
enum { // languageID for STBTT_PLATFORM_ID_MICROSOFT; same as LCID...
565
// problematic because there are e.g. 16 english LCIDs and 16 arabic LCIDs
566
STBTT_MS_LANG_ENGLISH =0x0409, STBTT_MS_LANG_ITALIAN =0x0410,
567
STBTT_MS_LANG_CHINESE =0x0804, STBTT_MS_LANG_JAPANESE =0x0411,
568
STBTT_MS_LANG_DUTCH =0x0413, STBTT_MS_LANG_KOREAN =0x0412,
569
STBTT_MS_LANG_FRENCH =0x040c, STBTT_MS_LANG_RUSSIAN =0x0419,
570
STBTT_MS_LANG_GERMAN =0x0407, STBTT_MS_LANG_SPANISH =0x0409,
571
STBTT_MS_LANG_HEBREW =0x040d, STBTT_MS_LANG_SWEDISH =0x041D,
574
enum { // languageID for STBTT_PLATFORM_ID_MAC
575
STBTT_MAC_LANG_ENGLISH =0 , STBTT_MAC_LANG_JAPANESE =11,
576
STBTT_MAC_LANG_ARABIC =12, STBTT_MAC_LANG_KOREAN =23,
577
STBTT_MAC_LANG_DUTCH =4 , STBTT_MAC_LANG_RUSSIAN =32,
578
STBTT_MAC_LANG_FRENCH =1 , STBTT_MAC_LANG_SPANISH =6 ,
579
STBTT_MAC_LANG_GERMAN =2 , STBTT_MAC_LANG_SWEDISH =5 ,
580
STBTT_MAC_LANG_HEBREW =10, STBTT_MAC_LANG_CHINESE_SIMPLIFIED =33,
581
STBTT_MAC_LANG_ITALIAN =3 , STBTT_MAC_LANG_CHINESE_TRAD =19,
588
#endif // __STB_INCLUDE_STB_TRUETYPE_H__
590
///////////////////////////////////////////////////////////////////////////////
591
///////////////////////////////////////////////////////////////////////////////
597
#ifdef STB_TRUETYPE_IMPLEMENTATION
599
//////////////////////////////////////////////////////////////////////////
601
// accessors to parse data from file
604
// on platforms that don't allow misaligned reads, if we want to allow
605
// truetype fonts that aren't padded to alignment, define ALLOW_UNALIGNED_TRUETYPE
607
#define ttBYTE(p) (* (stbtt_uint8 *) (p))
608
#define ttCHAR(p) (* (stbtt_int8 *) (p))
609
#define ttFixed(p) ttLONG(p)
611
#if defined(STB_TRUETYPE_BIGENDIAN) && !defined(ALLOW_UNALIGNED_TRUETYPE)
613
#define ttUSHORT(p) (* (stbtt_uint16 *) (p))
614
#define ttSHORT(p) (* (stbtt_int16 *) (p))
615
#define ttULONG(p) (* (stbtt_uint32 *) (p))
616
#define ttLONG(p) (* (stbtt_int32 *) (p))
620
stbtt_uint16 ttUSHORT(const stbtt_uint8 *p) { return p[0]*256 + p[1]; }
621
stbtt_int16 ttSHORT(const stbtt_uint8 *p) { return p[0]*256 + p[1]; }
622
stbtt_uint32 ttULONG(const stbtt_uint8 *p) { return (p[0]<<24) + (p[1]<<16) + (p[2]<<8) + p[3]; }
623
stbtt_int32 ttLONG(const stbtt_uint8 *p) { return (p[0]<<24) + (p[1]<<16) + (p[2]<<8) + p[3]; }
627
#define stbtt_tag4(p,c0,c1,c2,c3) ((p)[0] == (c0) && (p)[1] == (c1) && (p)[2] == (c2) && (p)[3] == (c3))
628
#define stbtt_tag(p,str) stbtt_tag4(p,str[0],str[1],str[2],str[3])
630
static int stbtt__isfont(const stbtt_uint8 *font)
632
// check the version number
633
if (stbtt_tag(font, "1")) return 1; // TrueType 1
634
if (stbtt_tag(font, "typ1")) return 1; // TrueType with type 1 font -- we don't support this!
635
if (stbtt_tag(font, "OTTO")) return 1; // OpenType with CFF
636
if (stbtt_tag4(font, 0,1,0,0)) return 1; // OpenType 1.0
640
// @OPTIMIZE: binary search
641
static stbtt_uint32 stbtt__find_table(stbtt_uint8 *data, stbtt_uint32 fontstart, const char *tag)
643
stbtt_int32 num_tables = ttUSHORT(data+fontstart+4);
644
stbtt_uint32 tabledir = fontstart + 12;
646
for (i=0; i < num_tables; ++i) {
647
stbtt_uint32 loc = tabledir + 16*i;
648
if (stbtt_tag(data+loc+0, tag))
649
return ttULONG(data+loc+8);
654
int stbtt_GetFontOffsetForIndex(const unsigned char *font_collection, int index)
656
// if it's just a font, there's only one valid index
657
if (stbtt__isfont(font_collection))
658
return index == 0 ? 0 : -1;
660
// check if it's a TTC
661
if (stbtt_tag(font_collection, "ttcf")) {
663
if (ttULONG(font_collection+4) == 0x00010000 || ttULONG(font_collection+4) == 0x00020000) {
664
stbtt_int32 n = ttLONG(font_collection+8);
667
return ttULONG(font_collection+12+index*14);
673
int stbtt_InitFont(stbtt_fontinfo *info, const unsigned char *data2, int fontstart)
675
stbtt_uint8 *data = (stbtt_uint8 *) data2;
676
stbtt_uint32 cmap, t;
677
stbtt_int32 i,numTables;
680
info->fontstart = fontstart;
682
cmap = stbtt__find_table(data, fontstart, "cmap");
683
info->loca = stbtt__find_table(data, fontstart, "loca");
684
info->head = stbtt__find_table(data, fontstart, "head");
685
info->glyf = stbtt__find_table(data, fontstart, "glyf");
686
info->hhea = stbtt__find_table(data, fontstart, "hhea");
687
info->hmtx = stbtt__find_table(data, fontstart, "hmtx");
688
if (!cmap || !info->loca || !info->head || !info->glyf || !info->hhea || !info->hmtx)
691
t = stbtt__find_table(data, fontstart, "maxp");
693
info->numGlyphs = ttUSHORT(data+t+4);
695
info->numGlyphs = 0xffff;
697
// find a cmap encoding table we understand *now* to avoid searching
698
// later. (todo: could make this installable)
699
// the same regardless of glyph.
700
numTables = ttUSHORT(data + cmap + 2);
702
for (i=0; i < numTables; ++i) {
703
stbtt_uint32 encoding_record = cmap + 4 + 8 * i;
704
// find an encoding we understand:
705
switch(ttUSHORT(data+encoding_record)) {
706
case STBTT_PLATFORM_ID_MICROSOFT:
707
switch (ttUSHORT(data+encoding_record+2)) {
708
case STBTT_MS_EID_UNICODE_BMP:
709
case STBTT_MS_EID_UNICODE_FULL:
711
info->index_map = cmap + ttULONG(data+encoding_record+4);
717
if (info->index_map == 0)
720
info->indexToLocFormat = ttUSHORT(data+info->head + 50);
724
int stbtt_FindGlyphIndex(const stbtt_fontinfo *info, int unicode_codepoint)
726
stbtt_uint8 *data = info->data;
727
stbtt_uint32 index_map = info->index_map;
729
stbtt_uint16 format = ttUSHORT(data + index_map + 0);
730
if (format == 0) { // apple byte encoding
731
stbtt_int32 bytes = ttUSHORT(data + index_map + 2);
732
if (unicode_codepoint < bytes-6)
733
return ttBYTE(data + index_map + 6 + unicode_codepoint);
735
} else if (format == 6) {
736
stbtt_uint32 first = ttUSHORT(data + index_map + 6);
737
stbtt_uint32 count = ttUSHORT(data + index_map + 8);
738
if ((stbtt_uint32) unicode_codepoint >= first && (stbtt_uint32) unicode_codepoint < first+count)
739
return ttUSHORT(data + index_map + 10 + (unicode_codepoint - first)*2);
741
} else if (format == 2) {
742
STBTT_assert(0); // @TODO: high-byte mapping for japanese/chinese/korean
744
} else if (format == 4) { // standard mapping for windows fonts: binary search collection of ranges
745
stbtt_uint16 segcount = ttUSHORT(data+index_map+6) >> 1;
746
stbtt_uint16 searchRange = ttUSHORT(data+index_map+8) >> 1;
747
stbtt_uint16 entrySelector = ttUSHORT(data+index_map+10);
748
stbtt_uint16 rangeShift = ttUSHORT(data+index_map+12) >> 1;
749
stbtt_uint16 item, offset, start, end;
751
// do a binary search of the segments
752
stbtt_uint32 endCount = index_map + 14;
753
stbtt_uint32 search = endCount;
755
if (unicode_codepoint > 0xffff)
758
// they lie from endCount .. endCount + segCount
759
// but searchRange is the nearest power of two, so...
760
if (unicode_codepoint >= ttUSHORT(data + search + rangeShift*2))
761
search += rangeShift*2;
763
// now decrement to bias correctly to find smallest
765
while (entrySelector) {
766
stbtt_uint16 start, end;
768
start = ttUSHORT(data + search + 2 + segcount*2 + 2);
769
end = ttUSHORT(data + search + 2);
770
start = ttUSHORT(data + search + searchRange*2 + segcount*2 + 2);
771
end = ttUSHORT(data + search + searchRange*2);
772
if (unicode_codepoint > end)
773
search += searchRange*2;
778
item = (stbtt_uint16) ((search - endCount) >> 1);
780
STBTT_assert(unicode_codepoint <= ttUSHORT(data + endCount + 2*item));
781
start = ttUSHORT(data + index_map + 14 + segcount*2 + 2 + 2*item);
782
end = ttUSHORT(data + index_map + 14 + 2 + 2*item);
783
if (unicode_codepoint < start)
786
offset = ttUSHORT(data + index_map + 14 + segcount*6 + 2 + 2*item);
788
return unicode_codepoint + ttSHORT(data + index_map + 14 + segcount*4 + 2 + 2*item);
790
return ttUSHORT(data + offset + (unicode_codepoint-start)*2 + index_map + 14 + segcount*6 + 2 + 2*item);
791
} else if (format == 12) {
792
stbtt_uint16 ngroups = ttUSHORT(data+index_map+6);
793
stbtt_int32 low,high;
794
low = 0; high = (stbtt_int32)ngroups;
795
// Binary search the right group.
796
while (low <= high) {
797
stbtt_int32 mid = low + ((high-low) >> 1); // rounds down, so low <= mid < high
798
stbtt_uint32 start_char = ttULONG(data+index_map+16+mid*12);
799
stbtt_uint32 end_char = ttULONG(data+index_map+16+mid*12+4);
800
if ((stbtt_uint32) unicode_codepoint < start_char)
802
else if ((stbtt_uint32) unicode_codepoint > end_char)
805
stbtt_uint32 start_glyph = ttULONG(data+index_map+16+mid*12+8);
806
return start_glyph + unicode_codepoint-start_char;
809
return 0; // not found
816
int stbtt_GetCodepointShape(const stbtt_fontinfo *info, int unicode_codepoint, stbtt_vertex **vertices)
818
return stbtt_GetGlyphShape(info, stbtt_FindGlyphIndex(info, unicode_codepoint), vertices);
821
static void stbtt_setvertex(stbtt_vertex *v, stbtt_uint8 type, stbtt_int16 x, stbtt_int16 y, stbtt_int16 cx, stbtt_int16 cy)
830
static int stbtt__GetGlyfOffset(const stbtt_fontinfo *info, int glyph_index)
834
if (glyph_index >= info->numGlyphs) return -1; // glyph index out of range
835
if (info->indexToLocFormat >= 2) return -1; // unknown index->glyph map format
837
if (info->indexToLocFormat == 0) {
838
g1 = info->glyf + ttUSHORT(info->data + info->loca + glyph_index * 2) * 2;
839
g2 = info->glyf + ttUSHORT(info->data + info->loca + glyph_index * 2 + 2) * 2;
841
g1 = info->glyf + ttULONG (info->data + info->loca + glyph_index * 4);
842
g2 = info->glyf + ttULONG (info->data + info->loca + glyph_index * 4 + 4);
845
return g1==g2 ? -1 : g1; // if length is 0, return -1
848
int stbtt_GetGlyphBox(const stbtt_fontinfo *info, int glyph_index, int *x0, int *y0, int *x1, int *y1)
850
int g = stbtt__GetGlyfOffset(info, glyph_index);
853
if (x0) *x0 = ttSHORT(info->data + g + 2);
854
if (y0) *y0 = ttSHORT(info->data + g + 4);
855
if (x1) *x1 = ttSHORT(info->data + g + 6);
856
if (y1) *y1 = ttSHORT(info->data + g + 8);
860
int stbtt_GetCodepointBox(const stbtt_fontinfo *info, int codepoint, int *x0, int *y0, int *x1, int *y1)
862
return stbtt_GetGlyphBox(info, stbtt_FindGlyphIndex(info,codepoint), x0,y0,x1,y1);
865
int stbtt_GetGlyphShape(const stbtt_fontinfo *info, int glyph_index, stbtt_vertex **pvertices)
867
stbtt_int16 numberOfContours;
868
stbtt_uint8 *endPtsOfContours;
869
stbtt_uint8 *data = info->data;
870
stbtt_vertex *vertices=0;
872
int g = stbtt__GetGlyfOffset(info, glyph_index);
878
numberOfContours = ttSHORT(data + g);
880
if (numberOfContours > 0) {
881
stbtt_uint8 flags=0,flagcount;
882
stbtt_int32 ins, i,j=0,m,n, next_move, was_off=0, off;
883
stbtt_int16 x,y,cx,cy,sx,sy;
885
endPtsOfContours = (data + g + 10);
886
ins = ttUSHORT(data + g + 10 + numberOfContours * 2);
887
points = data + g + 10 + numberOfContours * 2 + 2 + ins;
889
n = 1+ttUSHORT(endPtsOfContours + numberOfContours*2-2);
891
m = n + numberOfContours; // a loose bound on how many vertices we might need
892
vertices = (stbtt_vertex *) STBTT_malloc(m * sizeof(vertices[0]), info->userdata);
899
// in first pass, we load uninterpreted data into the allocated array
900
// above, shifted to the end of the array so we won't overwrite it when
901
// we create our final data starting from the front
903
off = m - n; // starting offset for uninterpreted data, regardless of how m ends up being calculated
907
for (i=0; i < n; ++i) {
908
if (flagcount == 0) {
911
flagcount = *points++;
914
vertices[off+i].type = flags;
917
// now load x coordinates
919
for (i=0; i < n; ++i) {
920
flags = vertices[off+i].type;
922
stbtt_int16 dx = *points++;
923
x += (flags & 16) ? dx : -dx; // ???
926
x = x + (stbtt_int16) (points[0]*256 + points[1]);
930
vertices[off+i].x = x;
933
// now load y coordinates
935
for (i=0; i < n; ++i) {
936
flags = vertices[off+i].type;
938
stbtt_int16 dy = *points++;
939
y += (flags & 32) ? dy : -dy; // ???
942
y = y + (stbtt_int16) (points[0]*256 + points[1]);
946
vertices[off+i].y = y;
949
// now convert them to our format
951
sx = sy = cx = cy = 0;
952
for (i=0; i < n; ++i) {
953
flags = vertices[off+i].type;
954
x = (stbtt_int16) vertices[off+i].x;
955
y = (stbtt_int16) vertices[off+i].y;
956
if (next_move == i) {
957
// when we get to the end, we have to close the shape explicitly
960
stbtt_setvertex(&vertices[num_vertices++], STBTT_vcurve,sx,sy,cx,cy);
962
stbtt_setvertex(&vertices[num_vertices++], STBTT_vline,sx,sy,0,0);
965
// now start the new one
966
stbtt_setvertex(&vertices[num_vertices++], STBTT_vmove,x,y,0,0);
967
next_move = 1 + ttUSHORT(endPtsOfContours+j*2);
973
if (!(flags & 1)) { // if it's a curve
974
if (was_off) // two off-curve control points in a row means interpolate an on-curve midpoint
975
stbtt_setvertex(&vertices[num_vertices++], STBTT_vcurve, (cx+x)>>1, (cy+y)>>1, cx, cy);
981
stbtt_setvertex(&vertices[num_vertices++], STBTT_vcurve, x,y, cx, cy);
983
stbtt_setvertex(&vertices[num_vertices++], STBTT_vline, x,y,0,0);
990
stbtt_setvertex(&vertices[num_vertices++], STBTT_vcurve,sx,sy,cx,cy);
992
stbtt_setvertex(&vertices[num_vertices++], STBTT_vline,sx,sy,0,0);
994
} else if (numberOfContours == -1) {
997
stbtt_uint8 *comp = data + g + 10;
1001
stbtt_uint16 flags, gidx;
1002
int comp_num_verts = 0, i;
1003
stbtt_vertex *comp_verts = 0, *tmp = 0;
1004
float mtx[6] = {1,0,0,1,0,0}, m, n;
1006
flags = ttSHORT(comp); comp+=2;
1007
gidx = ttSHORT(comp); comp+=2;
1009
if (flags & 2) { // XY values
1010
if (flags & 1) { // shorts
1011
mtx[4] = ttSHORT(comp); comp+=2;
1012
mtx[5] = ttSHORT(comp); comp+=2;
1014
mtx[4] = ttCHAR(comp); comp+=1;
1015
mtx[5] = ttCHAR(comp); comp+=1;
1019
// @TODO handle matching point
1022
if (flags & (1<<3)) { // WE_HAVE_A_SCALE
1023
mtx[0] = mtx[3] = ttSHORT(comp)/16384.0f; comp+=2;
1024
mtx[1] = mtx[2] = 0;
1025
} else if (flags & (1<<6)) { // WE_HAVE_AN_X_AND_YSCALE
1026
mtx[0] = ttSHORT(comp)/16384.0f; comp+=2;
1027
mtx[1] = mtx[2] = 0;
1028
mtx[3] = ttSHORT(comp)/16384.0f; comp+=2;
1029
} else if (flags & (1<<7)) { // WE_HAVE_A_TWO_BY_TWO
1030
mtx[0] = ttSHORT(comp)/16384.0f; comp+=2;
1031
mtx[1] = ttSHORT(comp)/16384.0f; comp+=2;
1032
mtx[2] = ttSHORT(comp)/16384.0f; comp+=2;
1033
mtx[3] = ttSHORT(comp)/16384.0f; comp+=2;
1036
// Find transformation scales.
1037
m = (float) sqrt(mtx[0]*mtx[0] + mtx[1]*mtx[1]);
1038
n = (float) sqrt(mtx[2]*mtx[2] + mtx[3]*mtx[3]);
1040
// Get indexed glyph.
1041
comp_num_verts = stbtt_GetGlyphShape(info, gidx, &comp_verts);
1042
if (comp_num_verts > 0) {
1043
// Transform vertices.
1044
for (i = 0; i < comp_num_verts; ++i) {
1045
stbtt_vertex* v = &comp_verts[i];
1046
stbtt_vertex_type x,y;
1048
v->x = (stbtt_vertex_type)(m * (mtx[0]*x + mtx[2]*y + mtx[4]));
1049
v->y = (stbtt_vertex_type)(n * (mtx[1]*x + mtx[3]*y + mtx[5]));
1051
v->cx = (stbtt_vertex_type)(m * (mtx[0]*x + mtx[2]*y + mtx[4]));
1052
v->cy = (stbtt_vertex_type)(n * (mtx[1]*x + mtx[3]*y + mtx[5]));
1055
tmp = (stbtt_vertex*)STBTT_malloc((num_vertices+comp_num_verts)*sizeof(stbtt_vertex), info->userdata);
1057
if (vertices) STBTT_free(vertices, info->userdata);
1058
if (comp_verts) STBTT_free(comp_verts, info->userdata);
1061
if (num_vertices > 0) memcpy(tmp, vertices, num_vertices*sizeof(stbtt_vertex));
1062
memcpy(tmp+num_vertices, comp_verts, comp_num_verts*sizeof(stbtt_vertex));
1063
if (vertices) STBTT_free(vertices, info->userdata);
1065
STBTT_free(comp_verts, info->userdata);
1066
num_vertices += comp_num_verts;
1068
// More components ?
1069
more = flags & (1<<5);
1071
} else if (numberOfContours < 0) {
1072
// @TODO other compound variations?
1075
// numberOfCounters == 0, do nothing
1078
*pvertices = vertices;
1079
return num_vertices;
1082
void stbtt_GetGlyphHMetrics(const stbtt_fontinfo *info, int glyph_index, int *advanceWidth, int *leftSideBearing)
1084
stbtt_uint16 numOfLongHorMetrics = ttUSHORT(info->data+info->hhea + 34);
1085
if (glyph_index < numOfLongHorMetrics) {
1086
if (advanceWidth) *advanceWidth = ttSHORT(info->data + info->hmtx + 4*glyph_index);
1087
if (leftSideBearing) *leftSideBearing = ttSHORT(info->data + info->hmtx + 4*glyph_index + 2);
1089
if (advanceWidth) *advanceWidth = ttSHORT(info->data + info->hmtx + 4*(numOfLongHorMetrics-1));
1090
if (leftSideBearing) *leftSideBearing = ttSHORT(info->data + info->hmtx + 4*numOfLongHorMetrics + 2*(glyph_index - numOfLongHorMetrics));
1094
int stbtt_GetGlyphKernAdvance(const stbtt_fontinfo * /*info*/, int /*glyph1*/, int /*glyph2*/)
1099
int stbtt_GetCodepointKernAdvance(const stbtt_fontinfo * /*info*/, int /*ch1*/, int /*ch2*/)
1104
void stbtt_GetCodepointHMetrics(const stbtt_fontinfo *info, int codepoint, int *advanceWidth, int *leftSideBearing)
1106
stbtt_GetGlyphHMetrics(info, stbtt_FindGlyphIndex(info,codepoint), advanceWidth, leftSideBearing);
1109
void stbtt_GetFontVMetrics(const stbtt_fontinfo *info, int *ascent, int *descent, int *lineGap)
1111
if (ascent ) *ascent = ttSHORT(info->data+info->hhea + 4);
1112
if (descent) *descent = ttSHORT(info->data+info->hhea + 6);
1113
if (lineGap) *lineGap = ttSHORT(info->data+info->hhea + 8);
1116
float stbtt_ScaleForPixelHeight(const stbtt_fontinfo *info, float height)
1118
int fheight = ttSHORT(info->data + info->hhea + 4) - ttSHORT(info->data + info->hhea + 6);
1119
return (float) height / fheight;
1122
void stbtt_FreeShape(const stbtt_fontinfo *info, stbtt_vertex *v)
1124
STBTT_free(v, info->userdata);
1127
//////////////////////////////////////////////////////////////////////////////
1129
// antialiasing software rasterizer
1132
void stbtt_GetGlyphBitmapBox(const stbtt_fontinfo *font, int glyph, float scale_x, float scale_y, int *ix0, int *iy0, int *ix1, int *iy1)
1135
if (!stbtt_GetGlyphBox(font, glyph, &x0,&y0,&x1,&y1))
1136
x0=y0=x1=y1=0; // e.g. space character
1137
// now move to integral bboxes (treating pixels as little squares, what pixels get touched)?
1138
if (ix0) *ix0 = STBTT_ifloor(x0 * scale_x);
1139
if (iy0) *iy0 = -STBTT_iceil (y1 * scale_y);
1140
if (ix1) *ix1 = STBTT_iceil (x1 * scale_x);
1141
if (iy1) *iy1 = -STBTT_ifloor(y0 * scale_y);
1144
void stbtt_GetCodepointBitmapBox(const stbtt_fontinfo *font, int codepoint, float scale_x, float scale_y, int *ix0, int *iy0, int *ix1, int *iy1)
1146
stbtt_GetGlyphBitmapBox(font, stbtt_FindGlyphIndex(font,codepoint), scale_x, scale_y, ix0,iy0,ix1,iy1);
1149
typedef struct stbtt__edge {
1154
typedef struct stbtt__active_edge
1158
struct stbtt__active_edge *next;
1160
} stbtt__active_edge;
1163
#define FIX (1 << FIXSHIFT)
1164
#define FIXMASK (FIX-1)
1166
static stbtt__active_edge *new_active(stbtt__edge *e, int off_x, float start_point, void *userdata)
1168
stbtt__active_edge *z = (stbtt__active_edge *) STBTT_malloc(sizeof(*z), userdata); // @TODO: make a pool of these!!!
1169
float dxdy = (e->x1 - e->x0) / (e->y1 - e->y0);
1170
STBTT_assert(e->y0 <= start_point);
1172
// round dx down to avoid going too far
1174
z->dx = -STBTT_ifloor(FIX * -dxdy);
1176
z->dx = STBTT_ifloor(FIX * dxdy);
1177
z->x = STBTT_ifloor(FIX * (e->x0 + dxdy * (start_point - e->y0)));
1178
z->x -= off_x * FIX;
1181
z->valid = e->invert ? 1 : -1;
1185
// note: this routine clips fills that extend off the edges... ideally this
1186
// wouldn't happen, but it could happen if the truetype glyph bounding boxes
1187
// are wrong, or if the user supplies a too-small bitmap
1188
static void stbtt__fill_active_edges(unsigned char *scanline, int len, stbtt__active_edge *e, int max_weight)
1190
// non-zero winding fill
1195
// if we're currently at zero, we need to record the edge start point
1196
x0 = e->x; w += e->valid;
1198
int x1 = e->x; w += e->valid;
1199
// if we went to zero, we need to draw
1201
int i = x0 >> FIXSHIFT;
1202
int j = x1 >> FIXSHIFT;
1204
if (i < len && j >= 0) {
1206
// x0,x1 are the same pixel, so compute combined coverage
1207
scanline[i] = scanline[i] + (stbtt_uint8) ((x1 - x0) * max_weight >> FIXSHIFT);
1209
if (i >= 0) // add antialiasing for x0
1210
scanline[i] = scanline[i] + (stbtt_uint8) (((FIX - (x0 & FIXMASK)) * max_weight) >> FIXSHIFT);
1214
if (j < len) // add antialiasing for x1
1215
scanline[j] = scanline[j] + (stbtt_uint8) (((x1 & FIXMASK) * max_weight) >> FIXSHIFT);
1219
for (++i; i < j; ++i) // fill pixels between x0 and x1
1220
scanline[i] = scanline[i] + (stbtt_uint8) max_weight;
1230
static void stbtt__rasterize_sorted_edges(stbtt__bitmap *result, stbtt__edge *e, int n, int vsubsample, int off_x, int off_y, void *userdata)
1232
stbtt__active_edge *active = NULL;
1234
int max_weight = (255 / vsubsample); // weight per vertical scanline
1235
int s; // vertical subsample index
1236
unsigned char scanline_data[512], *scanline;
1238
if (result->w > 512)
1239
scanline = (unsigned char *) STBTT_malloc(result->w, userdata);
1241
scanline = scanline_data;
1243
y = off_y * vsubsample;
1244
e[n].y0 = (off_y + result->h) * (float) vsubsample + 1;
1246
while (j < result->h) {
1247
STBTT_memset(scanline, 0, result->w);
1248
for (s=0; s < vsubsample; ++s) {
1249
// find center of pixel for this scanline
1250
float scan_y = y + 0.5f;
1251
stbtt__active_edge **step = &active;
1253
// update all active edges;
1254
// remove all active edges that terminate before the center of this scanline
1256
stbtt__active_edge * z = *step;
1257
if (z->ey <= scan_y) {
1258
*step = z->next; // delete from list
1259
STBTT_assert(z->valid);
1261
STBTT_free(z, userdata);
1263
z->x += z->dx; // advance to position for current scanline
1264
step = &((*step)->next); // advance through list
1268
// resort the list if needed
1272
while (*step && (*step)->next) {
1273
if ((*step)->x > (*step)->next->x) {
1274
stbtt__active_edge *t = *step;
1275
stbtt__active_edge *q = t->next;
1282
step = &(*step)->next;
1284
if (!changed) break;
1287
// insert all edges that start before the center of this scanline -- omit ones that also end on this scanline
1288
while (e->y0 <= scan_y) {
1289
if (e->y1 > scan_y) {
1290
stbtt__active_edge *z = new_active(e, off_x, scan_y, userdata);
1291
// find insertion point
1294
else if (z->x < active->x) {
1299
// find thing to insert AFTER
1300
stbtt__active_edge *p = active;
1301
while (p->next && p->next->x < z->x)
1303
// at this point, p->next->x is NOT < z->x
1311
// now process all active edges in XOR fashion
1313
stbtt__fill_active_edges(scanline, result->w, active, max_weight);
1317
STBTT_memcpy(result->pixels + j * result->stride, scanline, result->w);
1322
stbtt__active_edge *z = active;
1323
active = active->next;
1324
STBTT_free(z, userdata);
1327
if (scanline != scanline_data)
1328
STBTT_free(scanline, userdata);
1331
static int stbtt__edge_compare(const void *p, const void *q)
1333
stbtt__edge *a = (stbtt__edge *) p;
1334
stbtt__edge *b = (stbtt__edge *) q;
1336
if (a->y0 < b->y0) return -1;
1337
if (a->y0 > b->y0) return 1;
1346
static void stbtt__rasterize(stbtt__bitmap *result, stbtt__point *pts, int *wcount, int windings, float scale_x, float scale_y, int off_x, int off_y, int invert, void *userdata)
1348
float y_scale_inv = invert ? -scale_y : scale_y;
1351
int vsubsample = result->h < 8 ? 15 : 5;
1352
// vsubsample should divide 255 evenly; otherwise we won't reach full opacity
1354
// now we have to blow out the windings into explicit edge lists
1356
for (i=0; i < windings; ++i)
1359
e = (stbtt__edge *) STBTT_malloc(sizeof(*e) * (n+1), userdata); // add an extra one as a sentinel
1364
for (i=0; i < windings; ++i) {
1365
stbtt__point *p = pts + m;
1368
for (k=0; k < wcount[i]; j=k++) {
1370
// skip the edge if horizontal
1371
if (p[j].y == p[k].y)
1373
// add edge from j to k to the list
1375
if (invert ? p[j].y > p[k].y : p[j].y < p[k].y) {
1379
e[n].x0 = p[a].x * scale_x;
1380
e[n].y0 = p[a].y * y_scale_inv * vsubsample;
1381
e[n].x1 = p[b].x * scale_x;
1382
e[n].y1 = p[b].y * y_scale_inv * vsubsample;
1387
// now sort the edges by their highest point (should snap to integer, and then by x)
1388
STBTT_sort(e, n, sizeof(e[0]), stbtt__edge_compare);
1390
// now, traverse the scanlines and find the intersections on each scanline, use xor winding rule
1391
stbtt__rasterize_sorted_edges(result, e, n, vsubsample, off_x, off_y, userdata);
1393
STBTT_free(e, userdata);
1396
static void stbtt__add_point(stbtt__point *points, int n, float x, float y)
1398
if (!points) return; // during first pass, it's unallocated
1403
// tesselate until threshhold p is happy... @TODO warped to compensate for non-linear stretching
1404
static 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)
1407
float mx = (x0 + 2*x1 + x2)/4;
1408
float my = (y0 + 2*y1 + y2)/4;
1409
// versus directly drawn line
1410
float dx = (x0+x2)/2 - mx;
1411
float dy = (y0+y2)/2 - my;
1412
if (n > 16) // 65536 segments on one curve better be enough!
1414
if (dx*dx+dy*dy > objspace_flatness_squared) { // half-pixel error allowed... need to be smaller if AA
1415
stbtt__tesselate_curve(points, num_points, x0,y0, (x0+x1)/2.0f,(y0+y1)/2.0f, mx,my, objspace_flatness_squared,n+1);
1416
stbtt__tesselate_curve(points, num_points, mx,my, (x1+x2)/2.0f,(y1+y2)/2.0f, x2,y2, objspace_flatness_squared,n+1);
1418
stbtt__add_point(points, *num_points,x2,y2);
1419
*num_points = *num_points+1;
1424
// returns number of contours
1425
stbtt__point *stbtt_FlattenCurves(stbtt_vertex *vertices, int num_verts, float objspace_flatness, int **contour_lengths, int *num_contours, void *userdata)
1427
stbtt__point *points=0;
1430
float objspace_flatness_squared = objspace_flatness * objspace_flatness;
1431
int i,n=0,start=0, pass;
1433
// count how many "moves" there are to get the contour count
1434
for (i=0; i < num_verts; ++i)
1435
if (vertices[i].type == STBTT_vmove)
1439
if (n == 0) return 0;
1441
*contour_lengths = (int *) STBTT_malloc(sizeof(**contour_lengths) * n, userdata);
1443
if (*contour_lengths == 0) {
1448
// make two passes through the points so we don't need to realloc
1449
for (pass=0; pass < 2; ++pass) {
1452
points = (stbtt__point *) STBTT_malloc(num_points * sizeof(points[0]), userdata);
1453
if (points == NULL) goto error;
1457
for (i=0; i < num_verts; ++i) {
1458
switch (vertices[i].type) {
1460
// start the next contour
1462
(*contour_lengths)[n] = num_points - start;
1466
x = vertices[i].x, y = vertices[i].y;
1467
stbtt__add_point(points, num_points++, x,y);
1470
x = vertices[i].x, y = vertices[i].y;
1471
stbtt__add_point(points, num_points++, x, y);
1474
stbtt__tesselate_curve(points, &num_points, x,y,
1475
vertices[i].cx, vertices[i].cy,
1476
vertices[i].x, vertices[i].y,
1477
objspace_flatness_squared, 0);
1478
x = vertices[i].x, y = vertices[i].y;
1482
(*contour_lengths)[n] = num_points - start;
1487
STBTT_free(points, userdata);
1488
STBTT_free(*contour_lengths, userdata);
1489
*contour_lengths = 0;
1494
void stbtt_Rasterize(stbtt__bitmap *result, float flatness_in_pixels, stbtt_vertex *vertices, int num_verts, float scale_x, float scale_y, int x_off, int y_off, int invert, void *userdata)
1496
float scale = scale_x > scale_y ? scale_y : scale_x;
1497
int winding_count, *winding_lengths;
1498
stbtt__point *windings = stbtt_FlattenCurves(vertices, num_verts, flatness_in_pixels / scale, &winding_lengths, &winding_count, userdata);
1500
stbtt__rasterize(result, windings, winding_lengths, winding_count, scale_x, scale_y, x_off, y_off, invert, userdata);
1501
STBTT_free(winding_lengths, userdata);
1502
STBTT_free(windings, userdata);
1506
void stbtt_FreeBitmap(unsigned char *bitmap, void *userdata)
1508
STBTT_free(bitmap, userdata);
1511
unsigned char *stbtt_GetGlyphBitmap(const stbtt_fontinfo *info, float scale_x, float scale_y, int glyph, int *width, int *height, int *xoff, int *yoff)
1513
int ix0,iy0,ix1,iy1;
1515
stbtt_vertex *vertices;
1516
int num_verts = stbtt_GetGlyphShape(info, glyph, &vertices);
1518
if (scale_x == 0) scale_x = scale_y;
1520
if (scale_x == 0) return NULL;
1524
stbtt_GetGlyphBitmapBox(info, glyph, scale_x, scale_y, &ix0,&iy0,&ix1,&iy1);
1526
// now we get the size
1527
gbm.w = (ix1 - ix0);
1528
gbm.h = (iy1 - iy0);
1529
gbm.pixels = NULL; // in case we error
1531
if (width ) *width = gbm.w;
1532
if (height) *height = gbm.h;
1533
if (xoff ) *xoff = ix0;
1534
if (yoff ) *yoff = iy0;
1536
if (gbm.w && gbm.h) {
1537
gbm.pixels = (unsigned char *) STBTT_malloc(gbm.w * gbm.h, info->userdata);
1541
stbtt_Rasterize(&gbm, 0.35f, vertices, num_verts, scale_x, scale_y, ix0, iy0, 1, info->userdata);
1544
STBTT_free(vertices, info->userdata);
1548
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)
1551
stbtt_vertex *vertices;
1552
int num_verts = stbtt_GetGlyphShape(info, glyph, &vertices);
1555
stbtt_GetGlyphBitmapBox(info, glyph, scale_x, scale_y, &ix0,&iy0,0,0);
1556
gbm.pixels = output;
1559
gbm.stride = out_stride;
1562
stbtt_Rasterize(&gbm, 0.35f, vertices, num_verts, scale_x, scale_y, ix0,iy0, 1, info->userdata);
1564
STBTT_free(vertices, info->userdata);
1567
unsigned char *stbtt_GetCodepointBitmap(const stbtt_fontinfo *info, float scale_x, float scale_y, int codepoint, int *width, int *height, int *xoff, int *yoff)
1569
return stbtt_GetGlyphBitmap(info, scale_x, scale_y, stbtt_FindGlyphIndex(info,codepoint), width,height,xoff,yoff);
1572
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)
1574
stbtt_MakeGlyphBitmap(info, output, out_w, out_h, out_stride, scale_x, scale_y, stbtt_FindGlyphIndex(info,codepoint));
1577
//////////////////////////////////////////////////////////////////////////////
1581
// This is SUPER-SHITTY packing to keep source code small
1583
extern int stbtt_BakeFontBitmap(const unsigned char *data, int offset, // font location (use offset=0 for plain .ttf)
1584
float pixel_height, // height of font in pixels
1585
unsigned char *pixels, int pw, int ph, // bitmap to be filled in
1586
int first_char, int num_chars, // characters to bake
1587
stbtt_bakedchar *chardata)
1590
int x,y,bottom_y, i;
1592
stbtt_InitFont(&f, data, offset);
1593
STBTT_memset(pixels, 0, pw*ph); // background of 0 around pixels
1597
scale = stbtt_ScaleForPixelHeight(&f, pixel_height);
1599
for (i=0; i < num_chars; ++i) {
1600
int advance, lsb, x0,y0,x1,y1,gw,gh;
1601
int g = stbtt_FindGlyphIndex(&f, first_char + i);
1602
stbtt_GetGlyphHMetrics(&f, g, &advance, &lsb);
1603
stbtt_GetGlyphBitmapBox(&f, g, scale,scale, &x0,&y0,&x1,&y1);
1606
if (x + gw + 1 >= pw)
1607
y = bottom_y, x = 1; // advance to next row
1608
if (y + gh + 1 >= ph) // check if it fits vertically AFTER potentially moving to next row
1610
STBTT_assert(x+gw < pw);
1611
STBTT_assert(y+gh < ph);
1612
stbtt_MakeGlyphBitmap(&f, pixels+x+y*pw, gw,gh,pw, scale,scale, g);
1613
chardata[i].x0 = (stbtt_int16) x;
1614
chardata[i].y0 = (stbtt_int16) y;
1615
chardata[i].x1 = (stbtt_int16) (x + gw);
1616
chardata[i].y1 = (stbtt_int16) (y + gh);
1617
chardata[i].xadvance = scale * advance;
1618
chardata[i].xoff = (float) x0;
1619
chardata[i].yoff = (float) y0;
1621
if (y+gh+2 > bottom_y)
1627
void stbtt_GetBakedQuad(stbtt_bakedchar *chardata, int pw, int ph, int char_index, float *xpos, float *ypos, stbtt_aligned_quad *q, int opengl_fillrule)
1629
float d3d_bias = opengl_fillrule ? 0 : -0.5f;
1630
float ipw = 1.0f / pw, iph = 1.0f / ph;
1631
stbtt_bakedchar *b = chardata + char_index;
1632
int round_x = STBTT_ifloor((*xpos + b->xoff) + 0.5);
1633
int round_y = STBTT_ifloor((*ypos + b->yoff) + 0.5);
1635
q->x0 = round_x + d3d_bias;
1636
q->y0 = round_y + d3d_bias;
1637
q->x1 = round_x + b->x1 - b->x0 + d3d_bias;
1638
q->y1 = round_y + b->y1 - b->y0 + d3d_bias;
1640
q->s0 = b->x0 * ipw;
1641
q->t0 = b->y0 * ipw;
1642
q->s1 = b->x1 * iph;
1643
q->t1 = b->y1 * iph;
1645
*xpos += b->xadvance;
1648
//////////////////////////////////////////////////////////////////////////////
1650
// font name matching -- recommended not to use this
1653
// check if a utf8 string contains a prefix which is the utf16 string; if so return length of matching utf8 string
1654
static stbtt_int32 stbtt__CompareUTF8toUTF16_bigendian_prefix(stbtt_uint8 *s1, stbtt_int32 len1, stbtt_uint8 *s2, stbtt_int32 len2)
1658
// convert utf16 to utf8 and compare the results while converting
1660
stbtt_uint16 ch = s2[0]*256 + s2[1];
1662
if (i >= len1) return -1;
1663
if (s1[i++] != ch) return -1;
1664
} else if (ch < 0x800) {
1665
if (i+1 >= len1) return -1;
1666
if (s1[i++] != 0xc0 + (ch >> 6)) return -1;
1667
if (s1[i++] != 0x80 + (ch & 0x3f)) return -1;
1668
} else if (ch >= 0xd800 && ch < 0xdc00) {
1670
stbtt_uint16 ch2 = s2[2]*256 + s2[3];
1671
if (i+3 >= len1) return -1;
1672
c = ((ch - 0xd800) << 10) + (ch2 - 0xdc00) + 0x10000;
1673
if (s1[i++] != 0xf0 + (c >> 18)) return -1;
1674
if (s1[i++] != 0x80 + ((c >> 12) & 0x3f)) return -1;
1675
if (s1[i++] != 0x80 + ((c >> 6) & 0x3f)) return -1;
1676
if (s1[i++] != 0x80 + ((c ) & 0x3f)) return -1;
1677
s2 += 2; // plus another 2 below
1679
} else if (ch >= 0xdc00 && ch < 0xe000) {
1682
if (i+2 >= len1) return -1;
1683
if (s1[i++] != 0xe0 + (ch >> 12)) return -1;
1684
if (s1[i++] != 0x80 + ((ch >> 6) & 0x3f)) return -1;
1685
if (s1[i++] != 0x80 + ((ch ) & 0x3f)) return -1;
1693
int stbtt_CompareUTF8toUTF16_bigendian(const char *s1, int len1, const char *s2, int len2)
1695
return len1 == stbtt__CompareUTF8toUTF16_bigendian_prefix((stbtt_uint8*) s1, len1, (stbtt_uint8*) s2, len2);
1698
// returns results in whatever encoding you request... but note that 2-byte encodings
1699
// will be BIG-ENDIAN... use stbtt_CompareUTF8toUTF16_bigendian() to compare
1700
char *stbtt_GetFontNameString(const stbtt_fontinfo *font, int *length, int platformID, int encodingID, int languageID, int nameID)
1702
stbtt_int32 i,count,stringOffset;
1703
stbtt_uint8 *fc = font->data;
1704
stbtt_uint32 offset = font->fontstart;
1705
stbtt_uint32 nm = stbtt__find_table(fc, offset, "name");
1706
if (!nm) return NULL;
1708
count = ttUSHORT(fc+nm+2);
1709
stringOffset = nm + ttUSHORT(fc+nm+4);
1710
for (i=0; i < count; ++i) {
1711
stbtt_uint32 loc = nm + 6 + 12 * i;
1712
if (platformID == ttUSHORT(fc+loc+0) && encodingID == ttUSHORT(fc+loc+2)
1713
&& languageID == ttUSHORT(fc+loc+4) && nameID == ttUSHORT(fc+loc+6)) {
1714
*length = ttUSHORT(fc+loc+8);
1715
return (char *) (fc+stringOffset+ttUSHORT(fc+loc+10));
1721
static int stbtt__matchpair(stbtt_uint8 *fc, stbtt_uint32 nm, stbtt_uint8 *name, stbtt_int32 nlen, stbtt_int32 target_id, stbtt_int32 next_id)
1724
stbtt_int32 count = ttUSHORT(fc+nm+2);
1725
stbtt_int32 stringOffset = nm + ttUSHORT(fc+nm+4);
1727
for (i=0; i < count; ++i) {
1728
stbtt_uint32 loc = nm + 6 + 12 * i;
1729
stbtt_int32 id = ttUSHORT(fc+loc+6);
1730
if (id == target_id) {
1731
// find the encoding
1732
stbtt_int32 platform = ttUSHORT(fc+loc+0), encoding = ttUSHORT(fc+loc+2), language = ttUSHORT(fc+loc+4);
1734
// is this a Unicode encoding?
1735
if (platform == 0 || (platform == 3 && encoding == 1) || (platform == 3 && encoding == 10)) {
1736
stbtt_int32 slen = ttUSHORT(fc+loc+8), off = ttUSHORT(fc+loc+10);
1738
// check if there's a prefix match
1739
stbtt_int32 matchlen = stbtt__CompareUTF8toUTF16_bigendian_prefix(name, nlen, fc+stringOffset+off,slen);
1740
if (matchlen >= 0) {
1741
// check for target_id+1 immediately following, with same encoding & language
1742
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) {
1743
stbtt_int32 slen = ttUSHORT(fc+loc+12+8), off = ttUSHORT(fc+loc+12+10);
1745
if (matchlen == nlen)
1747
} else if (matchlen < nlen && name[matchlen] == ' ') {
1749
if (stbtt_CompareUTF8toUTF16_bigendian((char*) (name+matchlen), nlen-matchlen, (char*)(fc+stringOffset+off),slen))
1753
// if nothing immediately following
1754
if (matchlen == nlen)
1760
// @TODO handle other encodings
1766
static int stbtt__matches(stbtt_uint8 *fc, stbtt_uint32 offset, stbtt_uint8 *name, stbtt_int32 flags)
1768
stbtt_int32 nlen = STBTT_strlen((char *) name);
1770
if (!stbtt__isfont(fc+offset)) return 0;
1772
// check italics/bold/underline flags in macStyle...
1774
hd = stbtt__find_table(fc, offset, "head");
1775
if ((ttUSHORT(fc+hd+44) & 7) != (flags & 7)) return 0;
1778
nm = stbtt__find_table(fc, offset, "name");
1782
// if we checked the macStyle flags, then just check the family and ignore the subfamily
1783
if (stbtt__matchpair(fc, nm, name, nlen, 16, -1)) return 1;
1784
if (stbtt__matchpair(fc, nm, name, nlen, 1, -1)) return 1;
1785
if (stbtt__matchpair(fc, nm, name, nlen, 3, -1)) return 1;
1787
if (stbtt__matchpair(fc, nm, name, nlen, 16, 17)) return 1;
1788
if (stbtt__matchpair(fc, nm, name, nlen, 1, 2)) return 1;
1789
if (stbtt__matchpair(fc, nm, name, nlen, 3, -1)) return 1;
1795
int stbtt_FindMatchingFont(const unsigned char *font_collection, const char *name_utf8, stbtt_int32 flags)
1799
stbtt_int32 off = stbtt_GetFontOffsetForIndex(font_collection, i);
1800
if (off < 0) return off;
1801
if (stbtt__matches((stbtt_uint8 *) font_collection, off, (stbtt_uint8*) name_utf8, flags))
1806
#endif // STB_TRUETYPE_IMPLEMENTATION
1
// stb_truetype.h - v0.7 - public domain
2
// authored from 2009-2013 by Sean Barrett / RAD Game Tools
4
// This library processes TrueType files:
6
// extract glyph metrics
7
// extract glyph shapes
8
// render glyphs to one-channel bitmaps with antialiasing (box filter)
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?
19
// ADDITIONAL CONTRIBUTORS
21
// Mikko Mononen: compound shape support, more cmap formats
22
// Tor Andersson: kerning, subpixel rendering
24
// Bug/warning reports:
25
// "Zer" on mollyrocket (with fix)
27
// stoiko (Haemimont Games)
33
// 0.7 (2013-09-25) bugfix: subpixel glyph bug fixed in 0.5 had come back
34
// 0.6c (2012-07-24) improve documentation
35
// 0.6b (2012-07-20) fix a few more warnings
36
// 0.6 (2012-07-17) fix warnings; added stbtt_ScaleForMappingEmToPixels,
37
// stbtt_GetFontBoundingBox, stbtt_IsGlyphEmpty
38
// 0.5 (2011-12-09) bugfixes:
39
// subpixel glyph renderer computed wrong bounding box
40
// first vertex of shape can be off-curve (FreeSans)
41
// 0.4b (2011-12-03) fixed an error in the font baking example
42
// 0.4 (2011-12-01) kerning, subpixel rendering (tor)
44
// codepoint-to-glyph conversion using table fmt=12
45
// codepoint-to-glyph conversion using table fmt=4
46
// stbtt_GetBakedQuad with non-square texture (Zer)
47
// updated Hello World! sample to use kerning and subpixel
48
// fixed some warnings
49
// 0.3 (2009-06-24) cmap fmt=12, compound shapes (MM)
50
// userdata, malloc-from-userdata, non-zero fill (STB)
51
// 0.2 (2009-03-11) Fix unsigned/signed char warnings
52
// 0.1 (2009-03-09) First public release
56
// This software is in the public domain. Where that dedication is not
57
// recognized, you are granted a perpetual, irrevokable license to copy
58
// and modify this file as you see fit.
62
// Include this file in whatever places neeed to refer to it. In ONE C/C++
64
// #define STB_TRUETYPE_IMPLEMENTATION
65
// before the #include of this file. This expands out the actual
66
// implementation into that C/C++ file.
68
// Simple 3D API (don't ship this, but it's fine for tools and quick start,
69
// and you can cut and paste from it to move to more advanced)
70
// stbtt_BakeFontBitmap() -- bake a font to a bitmap for use as texture
71
// stbtt_GetBakedQuad() -- compute quad to draw for a given char
73
// "Load" a font file from a memory buffer (you have to keep the buffer loaded)
75
// stbtt_GetFontOffsetForIndex() -- use for TTC font collections
77
// Render a unicode codepoint to a bitmap
78
// stbtt_GetCodepointBitmap() -- allocates and returns a bitmap
79
// stbtt_MakeCodepointBitmap() -- renders into bitmap you provide
80
// stbtt_GetCodepointBitmapBox() -- how big the bitmap must be
82
// Character advance/positioning
83
// stbtt_GetCodepointHMetrics()
84
// stbtt_GetFontVMetrics()
85
// stbtt_GetCodepointKernAdvance()
87
// ADDITIONAL DOCUMENTATION
89
// Immediately after this block comment are a series of sample programs.
91
// After the sample programs is the "header file" section. This section
92
// includes documentation for each API function.
94
// Some important concepts to understand to use this library:
97
// Characters are defined by unicode codepoints, e.g. 65 is
98
// uppercase A, 231 is lowercase c with a cedilla, 0x7e30 is
99
// the hiragana for "ma".
102
// A visual character shape (every codepoint is rendered as
106
// A font-specific integer ID representing a glyph
109
// Glyph shapes are defined relative to a baseline, which is the
110
// bottom of uppercase characters. Characters extend both above
111
// and below the baseline.
114
// As you draw text to the screen, you keep track of a "current point"
115
// which is the origin of each character. The current point's vertical
116
// position is the baseline. Even "baked fonts" use this model.
118
// Vertical Font Metrics
119
// The vertical qualities of the font, used to vertically position
120
// and space the characters. See docs for stbtt_GetFontVMetrics.
122
// Font Size in Pixels or Points
123
// The preferred interface for specifying font sizes in stb_truetype
124
// is to specify how tall the font's vertical extent should be in pixels.
125
// If that sounds good enough, skip the next paragraph.
127
// Most font APIs instead use "points", which are a common typographic
128
// measurement for describing font size, defined as 72 points per inch.
129
// stb_truetype provides a point API for compatibility. However, true
130
// "per inch" conventions don't make much sense on computer displays
131
// since they different monitors have different number of pixels per
132
// inch. For example, Windows traditionally uses a convention that
133
// there are 96 pixels per inch, thus making 'inch' measurements have
134
// nothing to do with inches, and thus effectively defining a point to
135
// be 1.333 pixels. Additionally, the TrueType font data provides
136
// an explicit scale factor to scale a given font's glyphs to points,
137
// but the author has observed that this scale factor is often wrong
138
// for non-commercial fonts, thus making fonts scaled in points
139
// according to the TrueType spec incoherently sized in practice.
145
// - Use the functions with Subpixel at the end to allow your characters
146
// to have subpixel positioning. Since the font is anti-aliased, not
147
// hinted, this is very import for quality. (This is not possible with
150
// - Kerning is now supported, and if you're supporting subpixel rendering
151
// then kerning is worth using to give your text a polished look.
155
// - Convert Unicode codepoints to glyph indexes and operate on the glyphs;
156
// if you don't do this, stb_truetype is forced to do the conversion on
159
// - There are a lot of memory allocations. We should modify it to take
160
// a temp buffer and allocate from the temp buffer (without freeing),
161
// should help performance a lot.
165
// The system uses the raw data found in the .ttf file without changing it
166
// and without building auxiliary data structures. This is a bit inefficient
167
// on little-endian systems (the data is big-endian), but assuming you're
168
// caching the bitmaps or glyph shapes this shouldn't be a big deal.
170
// It appears to be very hard to programmatically determine what font a
171
// given file is in a general way. I provide an API for this, but I don't
175
// SOURCE STATISTICS (based on v0.6c, 2050 LOC)
177
// Documentation & header file 520 LOC \___ 660 LOC documentation
178
// Sample code 140 LOC /
179
// Truetype parsing 620 LOC ---- 620 LOC TrueType
180
// Software rasterization 240 LOC \ .
181
// Curve tesselation 120 LOC \__ 550 LOC Bitmap creation
182
// Bitmap management 100 LOC /
183
// Baked bitmap interface 70 LOC /
184
// Font name matching & access 150 LOC ---- 150
185
// C runtime library abstraction 60 LOC ---- 60
188
//////////////////////////////////////////////////////////////////////////////
189
//////////////////////////////////////////////////////////////////////////////
194
// Incomplete text-in-3d-api example, which draws quads properly aligned to be lossless
197
#define STB_TRUETYPE_IMPLEMENTATION // force following include to generate implementation
198
#include "stb_truetype.h"
200
char ttf_buffer[1<<20];
201
unsigned char temp_bitmap[512*512];
203
stbtt_bakedchar cdata[96]; // ASCII 32..126 is 95 glyphs
206
void my_stbtt_initfont(void)
208
fread(ttf_buffer, 1, 1<<20, fopen("c:/windows/fonts/times.ttf", "rb"));
209
stbtt_BakeFontBitmap(data,0, 32.0, temp_bitmap,512,512, 32,96, cdata); // no guarantee this fits!
210
// can free ttf_buffer at this point
211
glGenTextures(1, &ftex);
212
glBindTexture(GL_TEXTURE_2D, ftex);
213
glTexImage2D(GL_TEXTURE_2D, 0, GL_ALPHA, 512,512, 0, GL_ALPHA, GL_UNSIGNED_BYTE, temp_bitmap);
214
// can free temp_bitmap at this point
215
glTexParameteri(GL_TEXTURE_2D, GL_TEXTURE_MIN_FILTER, GL_LINEAR);
218
void my_stbtt_print(float x, float y, char *text)
220
// assume orthographic projection with units = screen pixels, origin at top left
221
glBindTexture(GL_TEXTURE_2D, ftex);
224
if (*text >= 32 && *text < 128) {
225
stbtt_aligned_quad q;
226
stbtt_GetBakedQuad(cdata, 512,512, *text-32, &x,&y,&q,1);//1=opengl,0=old d3d
227
glTexCoord2f(q.s0,q.t1); glVertex2f(q.x0,q.y0);
228
glTexCoord2f(q.s1,q.t1); glVertex2f(q.x1,q.y0);
229
glTexCoord2f(q.s1,q.t0); glVertex2f(q.x1,q.y1);
230
glTexCoord2f(q.s0,q.t0); glVertex2f(q.x0,q.y1);
239
//////////////////////////////////////////////////////////////////////////////
241
// Complete program (this compiles): get a single bitmap, print as ASCII art
245
#define STB_TRUETYPE_IMPLEMENTATION // force following include to generate implementation
246
#include "stb_truetype.h"
248
char ttf_buffer[1<<25];
250
int main(int argc, char **argv)
253
unsigned char *bitmap;
254
int w,h,i,j,c = (argc > 1 ? atoi(argv[1]) : 'a'), s = (argc > 2 ? atoi(argv[2]) : 20);
256
fread(ttf_buffer, 1, 1<<25, fopen(argc > 3 ? argv[3] : "c:/windows/fonts/arialbd.ttf", "rb"));
258
stbtt_InitFont(&font, ttf_buffer, stbtt_GetFontOffsetForIndex(ttf_buffer,0));
259
bitmap = stbtt_GetCodepointBitmap(&font, 0,stbtt_ScaleForPixelHeight(&font, s), c, &w, &h, 0,0);
261
for (j=0; j < h; ++j) {
262
for (i=0; i < w; ++i)
263
putchar(" .:ioVM@"[bitmap[j*w+i]>>5]);
283
//////////////////////////////////////////////////////////////////////////////
285
// Complete program: print "Hello World!" banner, with bugs
289
unsigned char screen[20][79];
291
int main(int arg, char **argv)
294
int i,j,ascent,baseline,ch=0;
296
char *text = "Heljo World!";
298
fread(buffer, 1, 1000000, fopen("c:/windows/fonts/arialbd.ttf", "rb"));
299
stbtt_InitFont(&font, buffer, 0);
301
scale = stbtt_ScaleForPixelHeight(&font, 15);
302
stbtt_GetFontVMetrics(&font, &ascent,0,0);
303
baseline = (int) (ascent*scale);
306
int advance,lsb,x0,y0,x1,y1;
307
float x_shift = xpos - (float) floor(xpos);
308
stbtt_GetCodepointHMetrics(&font, text[ch], &advance, &lsb);
309
stbtt_GetCodepointBitmapBoxSubpixel(&font, text[ch], scale,scale,x_shift,0, &x0,&y0,&x1,&y1);
310
stbtt_MakeCodepointBitmapSubpixel(&font, &screen[baseline + y0][(int) xpos + x0], x1-x0,y1-y0, 79, scale,scale,x_shift,0, text[ch]);
311
// note that this stomps the old data, so where character boxes overlap (e.g. 'lj') it's wrong
312
// because this API is really for baking character bitmaps into textures. if you want to render
313
// a sequence of characters, you really need to render each bitmap to a temp buffer, then
314
// "alpha blend" that into the working buffer
315
xpos += (advance * scale);
317
xpos += scale*stbtt_GetCodepointKernAdvance(&font, text[ch],text[ch+1]);
321
for (j=0; j < 20; ++j) {
322
for (i=0; i < 78; ++i)
323
putchar(" .:ioVM@"[screen[j][i]>>5]);
332
//////////////////////////////////////////////////////////////////////////////
333
//////////////////////////////////////////////////////////////////////////////
335
//// INTEGRATION WITH YOUR CODEBASE
337
//// The following sections allow you to supply alternate definitions
338
//// of C library functions used by stb_truetype.
340
#ifdef STB_TRUETYPE_IMPLEMENTATION
341
// #define your own (u)stbtt_int8/16/32 before including to override this
343
typedef unsigned char stbtt_uint8;
344
typedef signed char stbtt_int8;
345
typedef unsigned short stbtt_uint16;
346
typedef signed short stbtt_int16;
347
typedef unsigned int stbtt_uint32;
348
typedef signed int stbtt_int32;
351
typedef char stbtt__check_size32[sizeof(stbtt_int32)==4 ? 1 : -1];
352
typedef char stbtt__check_size16[sizeof(stbtt_int16)==2 ? 1 : -1];
354
// #define your own STBTT_sort() to override this to avoid qsort
357
#define STBTT_sort(data,num_items,item_size,compare_func) qsort(data,num_items,item_size,compare_func)
360
// #define your own STBTT_ifloor/STBTT_iceil() to avoid math.h
363
#define STBTT_ifloor(x) ((int) floor(x))
364
#define STBTT_iceil(x) ((int) ceil(x))
367
// #define your own functions "STBTT_malloc" / "STBTT_free" to avoid malloc.h
370
#define STBTT_malloc(x,u) malloc(x)
371
#define STBTT_free(x,u) free(x)
376
#define STBTT_assert(x) assert(x)
381
#define STBTT_strlen(x) strlen(x)
386
#define STBTT_memcpy memcpy
387
#define STBTT_memset memset
391
///////////////////////////////////////////////////////////////////////////////
392
///////////////////////////////////////////////////////////////////////////////
398
#ifndef __STB_INCLUDE_STB_TRUETYPE_H__
399
#define __STB_INCLUDE_STB_TRUETYPE_H__
405
//////////////////////////////////////////////////////////////////////////////
407
// TEXTURE BAKING API
409
// If you use this API, you only have to call two functions ever.
414
unsigned short x0,y0,x1,y1; // coordinates of bbox in bitmap
415
float xoff,yoff,xadvance;
418
extern int stbtt_BakeFontBitmap(const unsigned char *data, int offset, // font location (use offset=0 for plain .ttf)
419
float pixel_height, // height of font in pixels
420
unsigned char *pixels, int pw, int ph, // bitmap to be filled in
421
int first_char, int num_chars, // characters to bake
422
stbtt_bakedchar *chardata); // you allocate this, it's num_chars long
423
// if return is positive, the first unused row of the bitmap
424
// if return is negative, returns the negative of the number of characters that fit
425
// if return is 0, no characters fit and no rows were used
426
// This uses a very crappy packing.
430
float x0,y0,s0,t0; // top-left
431
float x1,y1,s1,t1; // bottom-right
432
} stbtt_aligned_quad;
434
extern void stbtt_GetBakedQuad(stbtt_bakedchar *chardata, int pw, int ph, // same data as above
435
int char_index, // character to display
436
float *xpos, float *ypos, // pointers to current position in screen pixel space
437
stbtt_aligned_quad *q, // output: quad to draw
438
int opengl_fillrule); // true if opengl fill rule; false if DX9 or earlier
439
// Call GetBakedQuad with char_index = 'character - first_char', and it
440
// creates the quad you need to draw and advances the current position.
442
// The coordinate system used assumes y increases downwards.
444
// Characters will extend both above and below the current position;
445
// see discussion of "BASELINE" above.
447
// It's inefficient; you might want to c&p it and optimize it.
450
//////////////////////////////////////////////////////////////////////////////
456
extern int stbtt_GetFontOffsetForIndex(const unsigned char *data, int index);
457
// Each .ttf/.ttc file may have more than one font. Each font has a sequential
458
// index number starting from 0. Call this function to get the font offset for
459
// a given index; it returns -1 if the index is out of range. A regular .ttf
460
// file will only define one font and it always be at offset 0, so it will
461
// return '0' for index 0, and -1 for all other indices. You can just skip
462
// this step if you know it's that kind of font.
465
// The following structure is defined publically so you can declare one on
466
// the stack or as a global or etc, but you should treat it as opaque.
467
typedef struct stbtt_fontinfo
470
unsigned char * data; // pointer to .ttf file
471
int fontstart; // offset of start of font
473
int numGlyphs; // number of glyphs, needed for range checking
475
int loca,head,glyf,hhea,hmtx,kern; // table locations as offset from start of .ttf
476
int index_map; // a cmap mapping for our chosen character encoding
477
int indexToLocFormat; // format needed to map from glyph index to glyph
480
extern int stbtt_InitFont(stbtt_fontinfo *info, const unsigned char *data, int offset);
481
// Given an offset into the file that defines a font, this function builds
482
// the necessary cached info for the rest of the system. You must allocate
483
// the stbtt_fontinfo yourself, and stbtt_InitFont will fill it out. You don't
484
// need to do anything special to free it, because the contents are pure
485
// value data with no additional data structures. Returns 0 on failure.
488
//////////////////////////////////////////////////////////////////////////////
490
// CHARACTER TO GLYPH-INDEX CONVERSIOn
492
int stbtt_FindGlyphIndex(const stbtt_fontinfo *info, int unicode_codepoint);
493
// If you're going to perform multiple operations on the same character
494
// and you want a speed-up, call this function with the character you're
495
// going to process, then use glyph-based functions instead of the
496
// codepoint-based functions.
499
//////////////////////////////////////////////////////////////////////////////
501
// CHARACTER PROPERTIES
504
extern float stbtt_ScaleForPixelHeight(const stbtt_fontinfo *info, float pixels);
505
// computes a scale factor to produce a font whose "height" is 'pixels' tall.
506
// Height is measured as the distance from the highest ascender to the lowest
507
// descender; in other words, it's equivalent to calling stbtt_GetFontVMetrics
509
// scale = pixels / (ascent - descent)
510
// so if you prefer to measure height by the ascent only, use a similar calculation.
512
extern float stbtt_ScaleForMappingEmToPixels(const stbtt_fontinfo *info, float pixels);
513
// computes a scale factor to produce a font whose EM size is mapped to
514
// 'pixels' tall. This is probably what traditional APIs compute, but
517
extern void stbtt_GetFontVMetrics(const stbtt_fontinfo *info, int *ascent, int *descent, int *lineGap);
518
// ascent is the coordinate above the baseline the font extends; descent
519
// is the coordinate below the baseline the font extends (i.e. it is typically negative)
520
// lineGap is the spacing between one row's descent and the next row's ascent...
521
// so you should advance the vertical position by "*ascent - *descent + *lineGap"
522
// these are expressed in unscaled coordinates, so you must multiply by
523
// the scale factor for a given size
525
extern void stbtt_GetFontBoundingBox(const stbtt_fontinfo *info, int *x0, int *y0, int *x1, int *y1);
526
// the bounding box around all possible characters
528
extern void stbtt_GetCodepointHMetrics(const stbtt_fontinfo *info, int codepoint, int *advanceWidth, int *leftSideBearing);
529
// leftSideBearing is the offset from the current horizontal position to the left edge of the character
530
// advanceWidth is the offset from the current horizontal position to the next horizontal position
531
// these are expressed in unscaled coordinates
533
extern int stbtt_GetCodepointKernAdvance(const stbtt_fontinfo *info, int ch1, int ch2);
534
// an additional amount to add to the 'advance' value between ch1 and ch2
535
// @TODO; for now always returns 0!
537
extern int stbtt_GetCodepointBox(const stbtt_fontinfo *info, int codepoint, int *x0, int *y0, int *x1, int *y1);
538
// Gets the bounding box of the visible part of the glyph, in unscaled coordinates
540
extern void stbtt_GetGlyphHMetrics(const stbtt_fontinfo *info, int glyph_index, int *advanceWidth, int *leftSideBearing);
541
extern int stbtt_GetGlyphKernAdvance(const stbtt_fontinfo *info, int glyph1, int glyph2);
542
extern int stbtt_GetGlyphBox(const stbtt_fontinfo *info, int glyph_index, int *x0, int *y0, int *x1, int *y1);
543
// as above, but takes one or more glyph indices for greater efficiency
546
//////////////////////////////////////////////////////////////////////////////
548
// GLYPH SHAPES (you probably don't need these, but they have to go before
549
// the bitmaps for C declaration-order reasons)
552
#ifndef STBTT_vmove // you can predefine these to use different values (but why?)
560
#ifndef stbtt_vertex // you can predefine this to use different values
561
// (we share this with other code at RAD)
562
#define stbtt_vertex_type short // can't use stbtt_int16 because that's not visible in the header file
565
stbtt_vertex_type x,y,cx,cy;
566
unsigned char type,padding;
570
extern int stbtt_IsGlyphEmpty(const stbtt_fontinfo *info, int glyph_index);
571
// returns non-zero if nothing is drawn for this glyph
573
extern int stbtt_GetCodepointShape(const stbtt_fontinfo *info, int unicode_codepoint, stbtt_vertex **vertices);
574
extern int stbtt_GetGlyphShape(const stbtt_fontinfo *info, int glyph_index, stbtt_vertex **vertices);
575
// returns # of vertices and fills *vertices with the pointer to them
576
// these are expressed in "unscaled" coordinates
578
extern void stbtt_FreeShape(const stbtt_fontinfo *info, stbtt_vertex *vertices);
579
// frees the data allocated above
581
//////////////////////////////////////////////////////////////////////////////
586
extern void stbtt_FreeBitmap(unsigned char *bitmap, void *userdata);
587
// frees the bitmap allocated below
589
extern unsigned char *stbtt_GetCodepointBitmap(const stbtt_fontinfo *info, float scale_x, float scale_y, int codepoint, int *width, int *height, int *xoff, int *yoff);
590
// allocates a large-enough single-channel 8bpp bitmap and renders the
591
// specified character/glyph at the specified scale into it, with
592
// antialiasing. 0 is no coverage (transparent), 255 is fully covered (opaque).
593
// *width & *height are filled out with the width & height of the bitmap,
594
// which is stored left-to-right, top-to-bottom.
596
// xoff/yoff are the offset it pixel space from the glyph origin to the top-left of the bitmap
598
extern 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);
599
// the same as stbtt_GetCodepoitnBitmap, but you can specify a subpixel
600
// shift for the character
602
extern 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);
603
// the same as stbtt_GetCodepointBitmap, but you pass in storage for the bitmap
604
// in the form of 'output', with row spacing of 'out_stride' bytes. the bitmap
605
// is clipped to out_w/out_h bytes. Call stbtt_GetCodepointBitmapBox to get the
606
// width and height and positioning info for it first.
608
extern 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);
609
// same as stbtt_MakeCodepointBitmap, but you can specify a subpixel
610
// shift for the character
612
extern void stbtt_GetCodepointBitmapBox(const stbtt_fontinfo *font, int codepoint, float scale_x, float scale_y, int *ix0, int *iy0, int *ix1, int *iy1);
613
// get the bbox of the bitmap centered around the glyph origin; so the
614
// bitmap width is ix1-ix0, height is iy1-iy0, and location to place
615
// the bitmap top left is (leftSideBearing*scale,iy0).
616
// (Note that the bitmap uses y-increases-down, but the shape uses
617
// y-increases-up, so CodepointBitmapBox and CodepointBox are inverted.)
619
extern 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);
620
// same as stbtt_GetCodepointBitmapBox, but you can specify a subpixel
621
// shift for the character
623
// the following functions are equivalent to the above functions, but operate
624
// on glyph indices instead of Unicode codepoints (for efficiency)
625
extern unsigned char *stbtt_GetGlyphBitmap(const stbtt_fontinfo *info, float scale_x, float scale_y, int glyph, int *width, int *height, int *xoff, int *yoff);
626
extern 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);
627
extern 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);
628
extern 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);
629
extern void stbtt_GetGlyphBitmapBox(const stbtt_fontinfo *font, int glyph, float scale_x, float scale_y, int *ix0, int *iy0, int *ix1, int *iy1);
630
extern 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);
633
// @TODO: don't expose this structure
637
unsigned char *pixels;
640
extern 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);
642
//////////////////////////////////////////////////////////////////////////////
644
// Finding the right font...
646
// You should really just solve this offline, keep your own tables
647
// of what font is what, and don't try to get it out of the .ttf file.
648
// That's because getting it out of the .ttf file is really hard, because
649
// the names in the file can appear in many possible encodings, in many
650
// possible languages, and e.g. if you need a case-insensitive comparison,
651
// the details of that depend on the encoding & language in a complex way
652
// (actually underspecified in truetype, but also gigantic).
654
// But you can use the provided functions in two possible ways:
655
// stbtt_FindMatchingFont() will use *case-sensitive* comparisons on
656
// unicode-encoded names to try to find the font you want;
657
// you can run this before calling stbtt_InitFont()
659
// stbtt_GetFontNameString() lets you get any of the various strings
660
// from the file yourself and do your own comparisons on them.
661
// You have to have called stbtt_InitFont() first.
664
extern int stbtt_FindMatchingFont(const unsigned char *fontdata, const char *name, int flags);
665
// returns the offset (not index) of the font that matches, or -1 if none
666
// if you use STBTT_MACSTYLE_DONTCARE, use a font name like "Arial Bold".
667
// if you use any other flag, use a font name like "Arial"; this checks
668
// the 'macStyle' header field; i don't know if fonts set this consistently
669
#define STBTT_MACSTYLE_DONTCARE 0
670
#define STBTT_MACSTYLE_BOLD 1
671
#define STBTT_MACSTYLE_ITALIC 2
672
#define STBTT_MACSTYLE_UNDERSCORE 4
673
#define STBTT_MACSTYLE_NONE 8 // <= not same as 0, this makes us check the bitfield is 0
675
extern int stbtt_CompareUTF8toUTF16_bigendian(const char *s1, int len1, const char *s2, int len2);
676
// returns 1/0 whether the first string interpreted as utf8 is identical to
677
// the second string interpreted as big-endian utf16... useful for strings from next func
679
extern const char *stbtt_GetFontNameString(const stbtt_fontinfo *font, int *length, int platformID, int encodingID, int languageID, int nameID);
680
// returns the string (which may be big-endian double byte, e.g. for unicode)
681
// and puts the length in bytes in *length.
683
// some of the values for the IDs are below; for more see the truetype spec:
684
// http://developer.apple.com/textfonts/TTRefMan/RM06/Chap6name.html
685
// http://www.microsoft.com/typography/otspec/name.htm
688
STBTT_PLATFORM_ID_UNICODE =0,
689
STBTT_PLATFORM_ID_MAC =1,
690
STBTT_PLATFORM_ID_ISO =2,
691
STBTT_PLATFORM_ID_MICROSOFT =3
694
enum { // encodingID for STBTT_PLATFORM_ID_UNICODE
695
STBTT_UNICODE_EID_UNICODE_1_0 =0,
696
STBTT_UNICODE_EID_UNICODE_1_1 =1,
697
STBTT_UNICODE_EID_ISO_10646 =2,
698
STBTT_UNICODE_EID_UNICODE_2_0_BMP=3,
699
STBTT_UNICODE_EID_UNICODE_2_0_FULL=4
702
enum { // encodingID for STBTT_PLATFORM_ID_MICROSOFT
703
STBTT_MS_EID_SYMBOL =0,
704
STBTT_MS_EID_UNICODE_BMP =1,
705
STBTT_MS_EID_SHIFTJIS =2,
706
STBTT_MS_EID_UNICODE_FULL =10
709
enum { // encodingID for STBTT_PLATFORM_ID_MAC; same as Script Manager codes
710
STBTT_MAC_EID_ROMAN =0, STBTT_MAC_EID_ARABIC =4,
711
STBTT_MAC_EID_JAPANESE =1, STBTT_MAC_EID_HEBREW =5,
712
STBTT_MAC_EID_CHINESE_TRAD =2, STBTT_MAC_EID_GREEK =6,
713
STBTT_MAC_EID_KOREAN =3, STBTT_MAC_EID_RUSSIAN =7
716
enum { // languageID for STBTT_PLATFORM_ID_MICROSOFT; same as LCID...
717
// problematic because there are e.g. 16 english LCIDs and 16 arabic LCIDs
718
STBTT_MS_LANG_ENGLISH =0x0409, STBTT_MS_LANG_ITALIAN =0x0410,
719
STBTT_MS_LANG_CHINESE =0x0804, STBTT_MS_LANG_JAPANESE =0x0411,
720
STBTT_MS_LANG_DUTCH =0x0413, STBTT_MS_LANG_KOREAN =0x0412,
721
STBTT_MS_LANG_FRENCH =0x040c, STBTT_MS_LANG_RUSSIAN =0x0419,
722
STBTT_MS_LANG_GERMAN =0x0407, STBTT_MS_LANG_SPANISH =0x0409,
723
STBTT_MS_LANG_HEBREW =0x040d, STBTT_MS_LANG_SWEDISH =0x041D
726
enum { // languageID for STBTT_PLATFORM_ID_MAC
727
STBTT_MAC_LANG_ENGLISH =0 , STBTT_MAC_LANG_JAPANESE =11,
728
STBTT_MAC_LANG_ARABIC =12, STBTT_MAC_LANG_KOREAN =23,
729
STBTT_MAC_LANG_DUTCH =4 , STBTT_MAC_LANG_RUSSIAN =32,
730
STBTT_MAC_LANG_FRENCH =1 , STBTT_MAC_LANG_SPANISH =6 ,
731
STBTT_MAC_LANG_GERMAN =2 , STBTT_MAC_LANG_SWEDISH =5 ,
732
STBTT_MAC_LANG_HEBREW =10, STBTT_MAC_LANG_CHINESE_SIMPLIFIED =33,
733
STBTT_MAC_LANG_ITALIAN =3 , STBTT_MAC_LANG_CHINESE_TRAD =19
740
#endif // __STB_INCLUDE_STB_TRUETYPE_H__
742
///////////////////////////////////////////////////////////////////////////////
743
///////////////////////////////////////////////////////////////////////////////
749
#ifdef STB_TRUETYPE_IMPLEMENTATION
751
//////////////////////////////////////////////////////////////////////////
753
// accessors to parse data from file
756
// on platforms that don't allow misaligned reads, if we want to allow
757
// truetype fonts that aren't padded to alignment, define ALLOW_UNALIGNED_TRUETYPE
759
#define ttBYTE(p) (* (stbtt_uint8 *) (p))
760
#define ttCHAR(p) (* (stbtt_int8 *) (p))
761
#define ttFixed(p) ttLONG(p)
763
#if defined(STB_TRUETYPE_BIGENDIAN) && !defined(ALLOW_UNALIGNED_TRUETYPE)
765
#define ttUSHORT(p) (* (stbtt_uint16 *) (p))
766
#define ttSHORT(p) (* (stbtt_int16 *) (p))
767
#define ttULONG(p) (* (stbtt_uint32 *) (p))
768
#define ttLONG(p) (* (stbtt_int32 *) (p))
772
stbtt_uint16 ttUSHORT(const stbtt_uint8 *p) { return p[0]*256 + p[1]; }
773
stbtt_int16 ttSHORT(const stbtt_uint8 *p) { return p[0]*256 + p[1]; }
774
stbtt_uint32 ttULONG(const stbtt_uint8 *p) { return (p[0]<<24) + (p[1]<<16) + (p[2]<<8) + p[3]; }
775
stbtt_int32 ttLONG(const stbtt_uint8 *p) { return (p[0]<<24) + (p[1]<<16) + (p[2]<<8) + p[3]; }
779
#define stbtt_tag4(p,c0,c1,c2,c3) ((p)[0] == (c0) && (p)[1] == (c1) && (p)[2] == (c2) && (p)[3] == (c3))
780
#define stbtt_tag(p,str) stbtt_tag4(p,str[0],str[1],str[2],str[3])
782
static int stbtt__isfont(const stbtt_uint8 *font)
784
// check the version number
785
if (stbtt_tag4(font, '1',0,0,0)) return 1; // TrueType 1
786
if (stbtt_tag(font, "typ1")) return 1; // TrueType with type 1 font -- we don't support this!
787
if (stbtt_tag(font, "OTTO")) return 1; // OpenType with CFF
788
if (stbtt_tag4(font, 0,1,0,0)) return 1; // OpenType 1.0
792
// @OPTIMIZE: binary search
793
static stbtt_uint32 stbtt__find_table(stbtt_uint8 *data, stbtt_uint32 fontstart, const char *tag)
795
stbtt_int32 num_tables = ttUSHORT(data+fontstart+4);
796
stbtt_uint32 tabledir = fontstart + 12;
798
for (i=0; i < num_tables; ++i) {
799
stbtt_uint32 loc = tabledir + 16*i;
800
if (stbtt_tag(data+loc+0, tag))
801
return ttULONG(data+loc+8);
806
int stbtt_GetFontOffsetForIndex(const unsigned char *font_collection, int index)
808
// if it's just a font, there's only one valid index
809
if (stbtt__isfont(font_collection))
810
return index == 0 ? 0 : -1;
812
// check if it's a TTC
813
if (stbtt_tag(font_collection, "ttcf")) {
815
if (ttULONG(font_collection+4) == 0x00010000 || ttULONG(font_collection+4) == 0x00020000) {
816
stbtt_int32 n = ttLONG(font_collection+8);
819
return ttULONG(font_collection+12+index*14);
825
int stbtt_InitFont(stbtt_fontinfo *info, const unsigned char *data2, int fontstart)
827
stbtt_uint8 *data = (stbtt_uint8 *) data2;
828
stbtt_uint32 cmap, t;
829
stbtt_int32 i,numTables;
832
info->fontstart = fontstart;
834
cmap = stbtt__find_table(data, fontstart, "cmap"); // required
835
info->loca = stbtt__find_table(data, fontstart, "loca"); // required
836
info->head = stbtt__find_table(data, fontstart, "head"); // required
837
info->glyf = stbtt__find_table(data, fontstart, "glyf"); // required
838
info->hhea = stbtt__find_table(data, fontstart, "hhea"); // required
839
info->hmtx = stbtt__find_table(data, fontstart, "hmtx"); // required
840
info->kern = stbtt__find_table(data, fontstart, "kern"); // not required
841
if (!cmap || !info->loca || !info->head || !info->glyf || !info->hhea || !info->hmtx)
844
t = stbtt__find_table(data, fontstart, "maxp");
846
info->numGlyphs = ttUSHORT(data+t+4);
848
info->numGlyphs = 0xffff;
850
// find a cmap encoding table we understand *now* to avoid searching
851
// later. (todo: could make this installable)
852
// the same regardless of glyph.
853
numTables = ttUSHORT(data + cmap + 2);
855
for (i=0; i < numTables; ++i) {
856
stbtt_uint32 encoding_record = cmap + 4 + 8 * i;
857
// find an encoding we understand:
858
switch(ttUSHORT(data+encoding_record)) {
859
case STBTT_PLATFORM_ID_MICROSOFT:
860
switch (ttUSHORT(data+encoding_record+2)) {
861
case STBTT_MS_EID_UNICODE_BMP:
862
case STBTT_MS_EID_UNICODE_FULL:
864
info->index_map = cmap + ttULONG(data+encoding_record+4);
870
if (info->index_map == 0)
873
info->indexToLocFormat = ttUSHORT(data+info->head + 50);
877
int stbtt_FindGlyphIndex(const stbtt_fontinfo *info, int unicode_codepoint)
879
stbtt_uint8 *data = info->data;
880
stbtt_uint32 index_map = info->index_map;
882
stbtt_uint16 format = ttUSHORT(data + index_map + 0);
883
if (format == 0) { // apple byte encoding
884
stbtt_int32 bytes = ttUSHORT(data + index_map + 2);
885
if (unicode_codepoint < bytes-6)
886
return ttBYTE(data + index_map + 6 + unicode_codepoint);
888
} else if (format == 6) {
889
stbtt_uint32 first = ttUSHORT(data + index_map + 6);
890
stbtt_uint32 count = ttUSHORT(data + index_map + 8);
891
if ((stbtt_uint32) unicode_codepoint >= first && (stbtt_uint32) unicode_codepoint < first+count)
892
return ttUSHORT(data + index_map + 10 + (unicode_codepoint - first)*2);
894
} else if (format == 2) {
895
STBTT_assert(0); // @TODO: high-byte mapping for japanese/chinese/korean
897
} else if (format == 4) { // standard mapping for windows fonts: binary search collection of ranges
898
stbtt_uint16 segcount = ttUSHORT(data+index_map+6) >> 1;
899
stbtt_uint16 searchRange = ttUSHORT(data+index_map+8) >> 1;
900
stbtt_uint16 entrySelector = ttUSHORT(data+index_map+10);
901
stbtt_uint16 rangeShift = ttUSHORT(data+index_map+12) >> 1;
902
stbtt_uint16 item, offset, start;
904
// do a binary search of the segments
905
stbtt_uint32 endCount = index_map + 14;
906
stbtt_uint32 search = endCount;
908
if (unicode_codepoint > 0xffff)
911
// they lie from endCount .. endCount + segCount
912
// but searchRange is the nearest power of two, so...
913
if (unicode_codepoint >= ttUSHORT(data + search + rangeShift*2))
914
search += rangeShift*2;
916
// now decrement to bias correctly to find smallest
918
while (entrySelector) {
921
end = ttUSHORT(data + search + 2);
922
end = ttUSHORT(data + search + searchRange*2);
923
if (unicode_codepoint > end)
924
search += searchRange*2;
929
item = (stbtt_uint16) ((search - endCount) >> 1);
931
STBTT_assert(unicode_codepoint <= ttUSHORT(data + endCount + 2*item));
932
start = ttUSHORT(data + index_map + 14 + segcount*2 + 2 + 2*item);
933
if (unicode_codepoint < start)
936
offset = ttUSHORT(data + index_map + 14 + segcount*6 + 2 + 2*item);
938
return (stbtt_uint16) (unicode_codepoint + ttSHORT(data + index_map + 14 + segcount*4 + 2 + 2*item));
940
return ttUSHORT(data + offset + (unicode_codepoint-start)*2 + index_map + 14 + segcount*6 + 2 + 2*item);
941
} else if (format == 12 || format == 13) {
942
stbtt_uint32 ngroups = ttULONG(data+index_map+12);
943
stbtt_int32 low,high;
944
low = 0; high = (stbtt_int32)ngroups;
945
// Binary search the right group.
947
stbtt_int32 mid = low + ((high-low) >> 1); // rounds down, so low <= mid < high
948
stbtt_uint32 start_char = ttULONG(data+index_map+16+mid*12);
949
stbtt_uint32 end_char = ttULONG(data+index_map+16+mid*12+4);
950
if ((stbtt_uint32) unicode_codepoint < start_char)
952
else if ((stbtt_uint32) unicode_codepoint > end_char)
955
stbtt_uint32 start_glyph = ttULONG(data+index_map+16+mid*12+8);
957
return start_glyph + unicode_codepoint-start_char;
962
return 0; // not found
969
int stbtt_GetCodepointShape(const stbtt_fontinfo *info, int unicode_codepoint, stbtt_vertex **vertices)
971
return stbtt_GetGlyphShape(info, stbtt_FindGlyphIndex(info, unicode_codepoint), vertices);
974
static void stbtt_setvertex(stbtt_vertex *v, stbtt_uint8 type, stbtt_int32 x, stbtt_int32 y, stbtt_int32 cx, stbtt_int32 cy)
977
v->x = (stbtt_int16) x;
978
v->y = (stbtt_int16) y;
979
v->cx = (stbtt_int16) cx;
980
v->cy = (stbtt_int16) cy;
983
static int stbtt__GetGlyfOffset(const stbtt_fontinfo *info, int glyph_index)
987
if (glyph_index >= info->numGlyphs) return -1; // glyph index out of range
988
if (info->indexToLocFormat >= 2) return -1; // unknown index->glyph map format
990
if (info->indexToLocFormat == 0) {
991
g1 = info->glyf + ttUSHORT(info->data + info->loca + glyph_index * 2) * 2;
992
g2 = info->glyf + ttUSHORT(info->data + info->loca + glyph_index * 2 + 2) * 2;
994
g1 = info->glyf + ttULONG (info->data + info->loca + glyph_index * 4);
995
g2 = info->glyf + ttULONG (info->data + info->loca + glyph_index * 4 + 4);
998
return g1==g2 ? -1 : g1; // if length is 0, return -1
1001
int stbtt_GetGlyphBox(const stbtt_fontinfo *info, int glyph_index, int *x0, int *y0, int *x1, int *y1)
1003
int g = stbtt__GetGlyfOffset(info, glyph_index);
1004
if (g < 0) return 0;
1006
if (x0) *x0 = ttSHORT(info->data + g + 2);
1007
if (y0) *y0 = ttSHORT(info->data + g + 4);
1008
if (x1) *x1 = ttSHORT(info->data + g + 6);
1009
if (y1) *y1 = ttSHORT(info->data + g + 8);
1013
int stbtt_GetCodepointBox(const stbtt_fontinfo *info, int codepoint, int *x0, int *y0, int *x1, int *y1)
1015
return stbtt_GetGlyphBox(info, stbtt_FindGlyphIndex(info,codepoint), x0,y0,x1,y1);
1018
int stbtt_IsGlyphEmpty(const stbtt_fontinfo *info, int glyph_index)
1020
stbtt_int16 numberOfContours;
1021
int g = stbtt__GetGlyfOffset(info, glyph_index);
1022
if (g < 0) return 1;
1023
numberOfContours = ttSHORT(info->data + g);
1024
return numberOfContours == 0;
1027
static int stbtt__close_shape(stbtt_vertex *vertices, int num_vertices, int was_off, int start_off,
1028
stbtt_int32 sx, stbtt_int32 sy, stbtt_int32 scx, stbtt_int32 scy, stbtt_int32 cx, stbtt_int32 cy)
1032
stbtt_setvertex(&vertices[num_vertices++], STBTT_vcurve, (cx+scx)>>1, (cy+scy)>>1, cx,cy);
1033
stbtt_setvertex(&vertices[num_vertices++], STBTT_vcurve, sx,sy,scx,scy);
1036
stbtt_setvertex(&vertices[num_vertices++], STBTT_vcurve,sx,sy,cx,cy);
1038
stbtt_setvertex(&vertices[num_vertices++], STBTT_vline,sx,sy,0,0);
1040
return num_vertices;
1043
int stbtt_GetGlyphShape(const stbtt_fontinfo *info, int glyph_index, stbtt_vertex **pvertices)
1045
stbtt_int16 numberOfContours;
1046
stbtt_uint8 *endPtsOfContours;
1047
stbtt_uint8 *data = info->data;
1048
stbtt_vertex *vertices=0;
1050
int g = stbtt__GetGlyfOffset(info, glyph_index);
1054
if (g < 0) return 0;
1056
numberOfContours = ttSHORT(data + g);
1058
if (numberOfContours > 0) {
1059
stbtt_uint8 flags=0,flagcount;
1060
stbtt_int32 ins, i,j=0,m,n, next_move, was_off=0, off, start_off=0;
1061
stbtt_int32 x,y,cx,cy,sx,sy, scx,scy;
1062
stbtt_uint8 *points;
1063
endPtsOfContours = (data + g + 10);
1064
ins = ttUSHORT(data + g + 10 + numberOfContours * 2);
1065
points = data + g + 10 + numberOfContours * 2 + 2 + ins;
1067
n = 1+ttUSHORT(endPtsOfContours + numberOfContours*2-2);
1069
m = n + 2*numberOfContours; // a loose bound on how many vertices we might need
1070
vertices = (stbtt_vertex *) STBTT_malloc(m * sizeof(vertices[0]), info->userdata);
1077
// in first pass, we load uninterpreted data into the allocated array
1078
// above, shifted to the end of the array so we won't overwrite it when
1079
// we create our final data starting from the front
1081
off = m - n; // starting offset for uninterpreted data, regardless of how m ends up being calculated
1085
for (i=0; i < n; ++i) {
1086
if (flagcount == 0) {
1089
flagcount = *points++;
1092
vertices[off+i].type = flags;
1095
// now load x coordinates
1097
for (i=0; i < n; ++i) {
1098
flags = vertices[off+i].type;
1100
stbtt_int16 dx = *points++;
1101
x += (flags & 16) ? dx : -dx; // ???
1103
if (!(flags & 16)) {
1104
x = x + (stbtt_int16) (points[0]*256 + points[1]);
1108
vertices[off+i].x = (stbtt_int16) x;
1111
// now load y coordinates
1113
for (i=0; i < n; ++i) {
1114
flags = vertices[off+i].type;
1116
stbtt_int16 dy = *points++;
1117
y += (flags & 32) ? dy : -dy; // ???
1119
if (!(flags & 32)) {
1120
y = y + (stbtt_int16) (points[0]*256 + points[1]);
1124
vertices[off+i].y = (stbtt_int16) y;
1127
// now convert them to our format
1129
sx = sy = cx = cy = scx = scy = 0;
1130
for (i=0; i < n; ++i) {
1131
flags = vertices[off+i].type;
1132
x = (stbtt_int16) vertices[off+i].x;
1133
y = (stbtt_int16) vertices[off+i].y;
1135
if (next_move == i) {
1137
num_vertices = stbtt__close_shape(vertices, num_vertices, was_off, start_off, sx,sy,scx,scy,cx,cy);
1139
// now start the new one
1140
start_off = !(flags & 1);
1142
// if we start off with an off-curve point, then when we need to find a point on the curve
1143
// where we can start, and we need to save some state for when we wraparound.
1146
if (!(vertices[off+i+1].type & 1)) {
1147
// next point is also a curve point, so interpolate an on-point curve
1148
sx = (x + (stbtt_int32) vertices[off+i+1].x) >> 1;
1149
sy = (y + (stbtt_int32) vertices[off+i+1].y) >> 1;
1151
// otherwise just use the next point as our start point
1152
sx = (stbtt_int32) vertices[off+i+1].x;
1153
sy = (stbtt_int32) vertices[off+i+1].y;
1154
++i; // we're using point i+1 as the starting point, so skip it
1160
stbtt_setvertex(&vertices[num_vertices++], STBTT_vmove,sx,sy,0,0);
1162
next_move = 1 + ttUSHORT(endPtsOfContours+j*2);
1165
if (!(flags & 1)) { // if it's a curve
1166
if (was_off) // two off-curve control points in a row means interpolate an on-curve midpoint
1167
stbtt_setvertex(&vertices[num_vertices++], STBTT_vcurve, (cx+x)>>1, (cy+y)>>1, cx, cy);
1173
stbtt_setvertex(&vertices[num_vertices++], STBTT_vcurve, x,y, cx, cy);
1175
stbtt_setvertex(&vertices[num_vertices++], STBTT_vline, x,y,0,0);
1180
num_vertices = stbtt__close_shape(vertices, num_vertices, was_off, start_off, sx,sy,scx,scy,cx,cy);
1181
} else if (numberOfContours == -1) {
1184
stbtt_uint8 *comp = data + g + 10;
1188
stbtt_uint16 flags, gidx;
1189
int comp_num_verts = 0, i;
1190
stbtt_vertex *comp_verts = 0, *tmp = 0;
1191
float mtx[6] = {1,0,0,1,0,0}, m, n;
1193
flags = ttSHORT(comp); comp+=2;
1194
gidx = ttSHORT(comp); comp+=2;
1196
if (flags & 2) { // XY values
1197
if (flags & 1) { // shorts
1198
mtx[4] = ttSHORT(comp); comp+=2;
1199
mtx[5] = ttSHORT(comp); comp+=2;
1201
mtx[4] = ttCHAR(comp); comp+=1;
1202
mtx[5] = ttCHAR(comp); comp+=1;
1206
// @TODO handle matching point
1209
if (flags & (1<<3)) { // WE_HAVE_A_SCALE
1210
mtx[0] = mtx[3] = ttSHORT(comp)/16384.0f; comp+=2;
1211
mtx[1] = mtx[2] = 0;
1212
} else if (flags & (1<<6)) { // WE_HAVE_AN_X_AND_YSCALE
1213
mtx[0] = ttSHORT(comp)/16384.0f; comp+=2;
1214
mtx[1] = mtx[2] = 0;
1215
mtx[3] = ttSHORT(comp)/16384.0f; comp+=2;
1216
} else if (flags & (1<<7)) { // WE_HAVE_A_TWO_BY_TWO
1217
mtx[0] = ttSHORT(comp)/16384.0f; comp+=2;
1218
mtx[1] = ttSHORT(comp)/16384.0f; comp+=2;
1219
mtx[2] = ttSHORT(comp)/16384.0f; comp+=2;
1220
mtx[3] = ttSHORT(comp)/16384.0f; comp+=2;
1223
// Find transformation scales.
1224
m = (float) sqrt(mtx[0]*mtx[0] + mtx[1]*mtx[1]);
1225
n = (float) sqrt(mtx[2]*mtx[2] + mtx[3]*mtx[3]);
1227
// Get indexed glyph.
1228
comp_num_verts = stbtt_GetGlyphShape(info, gidx, &comp_verts);
1229
if (comp_num_verts > 0) {
1230
// Transform vertices.
1231
for (i = 0; i < comp_num_verts; ++i) {
1232
stbtt_vertex* v = &comp_verts[i];
1233
stbtt_vertex_type x,y;
1235
v->x = (stbtt_vertex_type)(m * (mtx[0]*x + mtx[2]*y + mtx[4]));
1236
v->y = (stbtt_vertex_type)(n * (mtx[1]*x + mtx[3]*y + mtx[5]));
1238
v->cx = (stbtt_vertex_type)(m * (mtx[0]*x + mtx[2]*y + mtx[4]));
1239
v->cy = (stbtt_vertex_type)(n * (mtx[1]*x + mtx[3]*y + mtx[5]));
1242
tmp = (stbtt_vertex*)STBTT_malloc((num_vertices+comp_num_verts)*sizeof(stbtt_vertex), info->userdata);
1244
if (vertices) STBTT_free(vertices, info->userdata);
1245
if (comp_verts) STBTT_free(comp_verts, info->userdata);
1248
if (num_vertices > 0) memcpy(tmp, vertices, num_vertices*sizeof(stbtt_vertex));
1249
memcpy(tmp+num_vertices, comp_verts, comp_num_verts*sizeof(stbtt_vertex));
1250
if (vertices) STBTT_free(vertices, info->userdata);
1252
STBTT_free(comp_verts, info->userdata);
1253
num_vertices += comp_num_verts;
1255
// More components ?
1256
more = flags & (1<<5);
1258
} else if (numberOfContours < 0) {
1259
// @TODO other compound variations?
1262
// numberOfCounters == 0, do nothing
1265
*pvertices = vertices;
1266
return num_vertices;
1269
void stbtt_GetGlyphHMetrics(const stbtt_fontinfo *info, int glyph_index, int *advanceWidth, int *leftSideBearing)
1271
stbtt_uint16 numOfLongHorMetrics = ttUSHORT(info->data+info->hhea + 34);
1272
if (glyph_index < numOfLongHorMetrics) {
1273
if (advanceWidth) *advanceWidth = ttSHORT(info->data + info->hmtx + 4*glyph_index);
1274
if (leftSideBearing) *leftSideBearing = ttSHORT(info->data + info->hmtx + 4*glyph_index + 2);
1276
if (advanceWidth) *advanceWidth = ttSHORT(info->data + info->hmtx + 4*(numOfLongHorMetrics-1));
1277
if (leftSideBearing) *leftSideBearing = ttSHORT(info->data + info->hmtx + 4*numOfLongHorMetrics + 2*(glyph_index - numOfLongHorMetrics));
1281
int stbtt_GetGlyphKernAdvance(const stbtt_fontinfo *info, int glyph1, int glyph2)
1283
stbtt_uint8 *data = info->data + info->kern;
1284
stbtt_uint32 needle, straw;
1287
// we only look at the first table. it must be 'horizontal' and format 0.
1290
if (ttUSHORT(data+2) < 1) // number of tables, need at least 1
1292
if (ttUSHORT(data+8) != 1) // horizontal flag must be set in format
1296
r = ttUSHORT(data+10) - 1;
1297
needle = glyph1 << 16 | glyph2;
1300
straw = ttULONG(data+18+(m*6)); // note: unaligned read
1303
else if (needle > straw)
1306
return ttSHORT(data+22+(m*6));
1311
int stbtt_GetCodepointKernAdvance(const stbtt_fontinfo *info, int ch1, int ch2)
1313
if (!info->kern) // if no kerning table, don't waste time looking up both codepoint->glyphs
1315
return stbtt_GetGlyphKernAdvance(info, stbtt_FindGlyphIndex(info,ch1), stbtt_FindGlyphIndex(info,ch2));
1318
void stbtt_GetCodepointHMetrics(const stbtt_fontinfo *info, int codepoint, int *advanceWidth, int *leftSideBearing)
1320
stbtt_GetGlyphHMetrics(info, stbtt_FindGlyphIndex(info,codepoint), advanceWidth, leftSideBearing);
1323
void stbtt_GetFontVMetrics(const stbtt_fontinfo *info, int *ascent, int *descent, int *lineGap)
1325
if (ascent ) *ascent = ttSHORT(info->data+info->hhea + 4);
1326
if (descent) *descent = ttSHORT(info->data+info->hhea + 6);
1327
if (lineGap) *lineGap = ttSHORT(info->data+info->hhea + 8);
1330
void stbtt_GetFontBoundingBox(const stbtt_fontinfo *info, int *x0, int *y0, int *x1, int *y1)
1332
*x0 = ttSHORT(info->data + info->head + 36);
1333
*y0 = ttSHORT(info->data + info->head + 38);
1334
*x1 = ttSHORT(info->data + info->head + 40);
1335
*y1 = ttSHORT(info->data + info->head + 42);
1338
float stbtt_ScaleForPixelHeight(const stbtt_fontinfo *info, float height)
1340
int fheight = ttSHORT(info->data + info->hhea + 4) - ttSHORT(info->data + info->hhea + 6);
1341
return (float) height / fheight;
1344
float stbtt_ScaleForMappingEmToPixels(const stbtt_fontinfo *info, float pixels)
1346
int unitsPerEm = ttUSHORT(info->data + info->head + 18);
1347
return pixels / unitsPerEm;
1350
void stbtt_FreeShape(const stbtt_fontinfo *info, stbtt_vertex *v)
1352
STBTT_free(v, info->userdata);
1355
//////////////////////////////////////////////////////////////////////////////
1357
// antialiasing software rasterizer
1360
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)
1363
if (!stbtt_GetGlyphBox(font, glyph, &x0,&y0,&x1,&y1))
1364
x0=y0=x1=y1=0; // e.g. space character
1365
// now move to integral bboxes (treating pixels as little squares, what pixels get touched)?
1366
if (ix0) *ix0 = STBTT_ifloor(x0 * scale_x + shift_x);
1367
if (iy0) *iy0 = -STBTT_iceil (y1 * scale_y + shift_y);
1368
if (ix1) *ix1 = STBTT_iceil (x1 * scale_x + shift_x);
1369
if (iy1) *iy1 = -STBTT_ifloor(y0 * scale_y + shift_y);
1371
void stbtt_GetGlyphBitmapBox(const stbtt_fontinfo *font, int glyph, float scale_x, float scale_y, int *ix0, int *iy0, int *ix1, int *iy1)
1373
stbtt_GetGlyphBitmapBoxSubpixel(font, glyph, scale_x, scale_y,0.0f,0.0f, ix0, iy0, ix1, iy1);
1376
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)
1378
stbtt_GetGlyphBitmapBoxSubpixel(font, stbtt_FindGlyphIndex(font,codepoint), scale_x, scale_y,shift_x,shift_y, ix0,iy0,ix1,iy1);
1381
void stbtt_GetCodepointBitmapBox(const stbtt_fontinfo *font, int codepoint, float scale_x, float scale_y, int *ix0, int *iy0, int *ix1, int *iy1)
1383
stbtt_GetCodepointBitmapBoxSubpixel(font, codepoint, scale_x, scale_y,0.0f,0.0f, ix0,iy0,ix1,iy1);
1386
typedef struct stbtt__edge {
1391
typedef struct stbtt__active_edge
1395
struct stbtt__active_edge *next;
1397
} stbtt__active_edge;
1400
#define FIX (1 << FIXSHIFT)
1401
#define FIXMASK (FIX-1)
1403
static stbtt__active_edge *new_active(stbtt__edge *e, int off_x, float start_point, void *userdata)
1405
stbtt__active_edge *z = (stbtt__active_edge *) STBTT_malloc(sizeof(*z), userdata); // @TODO: make a pool of these!!!
1406
float dxdy = (e->x1 - e->x0) / (e->y1 - e->y0);
1407
STBTT_assert(e->y0 <= start_point);
1409
// round dx down to avoid going too far
1411
z->dx = -STBTT_ifloor(FIX * -dxdy);
1413
z->dx = STBTT_ifloor(FIX * dxdy);
1414
z->x = STBTT_ifloor(FIX * (e->x0 + dxdy * (start_point - e->y0)));
1415
z->x -= off_x * FIX;
1418
z->valid = e->invert ? 1 : -1;
1422
// note: this routine clips fills that extend off the edges... ideally this
1423
// wouldn't happen, but it could happen if the truetype glyph bounding boxes
1424
// are wrong, or if the user supplies a too-small bitmap
1425
static void stbtt__fill_active_edges(unsigned char *scanline, int len, stbtt__active_edge *e, int max_weight)
1427
// non-zero winding fill
1432
// if we're currently at zero, we need to record the edge start point
1433
x0 = e->x; w += e->valid;
1435
int x1 = e->x; w += e->valid;
1436
// if we went to zero, we need to draw
1438
int i = x0 >> FIXSHIFT;
1439
int j = x1 >> FIXSHIFT;
1441
if (i < len && j >= 0) {
1443
// x0,x1 are the same pixel, so compute combined coverage
1444
scanline[i] = scanline[i] + (stbtt_uint8) ((x1 - x0) * max_weight >> FIXSHIFT);
1446
if (i >= 0) // add antialiasing for x0
1447
scanline[i] = scanline[i] + (stbtt_uint8) (((FIX - (x0 & FIXMASK)) * max_weight) >> FIXSHIFT);
1451
if (j < len) // add antialiasing for x1
1452
scanline[j] = scanline[j] + (stbtt_uint8) (((x1 & FIXMASK) * max_weight) >> FIXSHIFT);
1456
for (++i; i < j; ++i) // fill pixels between x0 and x1
1457
scanline[i] = scanline[i] + (stbtt_uint8) max_weight;
1467
static void stbtt__rasterize_sorted_edges(stbtt__bitmap *result, stbtt__edge *e, int n, int vsubsample, int off_x, int off_y, void *userdata)
1469
stbtt__active_edge *active = NULL;
1471
int max_weight = (255 / vsubsample); // weight per vertical scanline
1472
int s; // vertical subsample index
1473
unsigned char scanline_data[512], *scanline;
1475
if (result->w > 512)
1476
scanline = (unsigned char *) STBTT_malloc(result->w, userdata);
1478
scanline = scanline_data;
1480
y = off_y * vsubsample;
1481
e[n].y0 = (off_y + result->h) * (float) vsubsample + 1;
1483
while (j < result->h) {
1484
STBTT_memset(scanline, 0, result->w);
1485
for (s=0; s < vsubsample; ++s) {
1486
// find center of pixel for this scanline
1487
float scan_y = y + 0.5f;
1488
stbtt__active_edge **step = &active;
1490
// update all active edges;
1491
// remove all active edges that terminate before the center of this scanline
1493
stbtt__active_edge * z = *step;
1494
if (z->ey <= scan_y) {
1495
*step = z->next; // delete from list
1496
STBTT_assert(z->valid);
1498
STBTT_free(z, userdata);
1500
z->x += z->dx; // advance to position for current scanline
1501
step = &((*step)->next); // advance through list
1505
// resort the list if needed
1509
while (*step && (*step)->next) {
1510
if ((*step)->x > (*step)->next->x) {
1511
stbtt__active_edge *t = *step;
1512
stbtt__active_edge *q = t->next;
1519
step = &(*step)->next;
1521
if (!changed) break;
1524
// insert all edges that start before the center of this scanline -- omit ones that also end on this scanline
1525
while (e->y0 <= scan_y) {
1526
if (e->y1 > scan_y) {
1527
stbtt__active_edge *z = new_active(e, off_x, scan_y, userdata);
1528
// find insertion point
1531
else if (z->x < active->x) {
1536
// find thing to insert AFTER
1537
stbtt__active_edge *p = active;
1538
while (p->next && p->next->x < z->x)
1540
// at this point, p->next->x is NOT < z->x
1548
// now process all active edges in XOR fashion
1550
stbtt__fill_active_edges(scanline, result->w, active, max_weight);
1554
STBTT_memcpy(result->pixels + j * result->stride, scanline, result->w);
1559
stbtt__active_edge *z = active;
1560
active = active->next;
1561
STBTT_free(z, userdata);
1564
if (scanline != scanline_data)
1565
STBTT_free(scanline, userdata);
1568
static int stbtt__edge_compare(const void *p, const void *q)
1570
stbtt__edge *a = (stbtt__edge *) p;
1571
stbtt__edge *b = (stbtt__edge *) q;
1573
if (a->y0 < b->y0) return -1;
1574
if (a->y0 > b->y0) return 1;
1583
static 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)
1585
float y_scale_inv = invert ? -scale_y : scale_y;
1588
int vsubsample = result->h < 8 ? 15 : 5;
1589
// vsubsample should divide 255 evenly; otherwise we won't reach full opacity
1591
// now we have to blow out the windings into explicit edge lists
1593
for (i=0; i < windings; ++i)
1596
e = (stbtt__edge *) STBTT_malloc(sizeof(*e) * (n+1), userdata); // add an extra one as a sentinel
1601
for (i=0; i < windings; ++i) {
1602
stbtt__point *p = pts + m;
1605
for (k=0; k < wcount[i]; j=k++) {
1607
// skip the edge if horizontal
1608
if (p[j].y == p[k].y)
1610
// add edge from j to k to the list
1612
if (invert ? p[j].y > p[k].y : p[j].y < p[k].y) {
1616
e[n].x0 = p[a].x * scale_x + shift_x;
1617
e[n].y0 = p[a].y * y_scale_inv * vsubsample + shift_y;
1618
e[n].x1 = p[b].x * scale_x + shift_x;
1619
e[n].y1 = p[b].y * y_scale_inv * vsubsample + shift_y;
1624
// now sort the edges by their highest point (should snap to integer, and then by x)
1625
STBTT_sort(e, n, sizeof(e[0]), stbtt__edge_compare);
1627
// now, traverse the scanlines and find the intersections on each scanline, use xor winding rule
1628
stbtt__rasterize_sorted_edges(result, e, n, vsubsample, off_x, off_y, userdata);
1630
STBTT_free(e, userdata);
1633
static void stbtt__add_point(stbtt__point *points, int n, float x, float y)
1635
if (!points) return; // during first pass, it's unallocated
1640
// tesselate until threshhold p is happy... @TODO warped to compensate for non-linear stretching
1641
static 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)
1644
float mx = (x0 + 2*x1 + x2)/4;
1645
float my = (y0 + 2*y1 + y2)/4;
1646
// versus directly drawn line
1647
float dx = (x0+x2)/2 - mx;
1648
float dy = (y0+y2)/2 - my;
1649
if (n > 16) // 65536 segments on one curve better be enough!
1651
if (dx*dx+dy*dy > objspace_flatness_squared) { // half-pixel error allowed... need to be smaller if AA
1652
stbtt__tesselate_curve(points, num_points, x0,y0, (x0+x1)/2.0f,(y0+y1)/2.0f, mx,my, objspace_flatness_squared,n+1);
1653
stbtt__tesselate_curve(points, num_points, mx,my, (x1+x2)/2.0f,(y1+y2)/2.0f, x2,y2, objspace_flatness_squared,n+1);
1655
stbtt__add_point(points, *num_points,x2,y2);
1656
*num_points = *num_points+1;
1661
// returns number of contours
1662
stbtt__point *stbtt_FlattenCurves(stbtt_vertex *vertices, int num_verts, float objspace_flatness, int **contour_lengths, int *num_contours, void *userdata)
1664
stbtt__point *points=0;
1667
float objspace_flatness_squared = objspace_flatness * objspace_flatness;
1668
int i,n=0,start=0, pass;
1670
// count how many "moves" there are to get the contour count
1671
for (i=0; i < num_verts; ++i)
1672
if (vertices[i].type == STBTT_vmove)
1676
if (n == 0) return 0;
1678
*contour_lengths = (int *) STBTT_malloc(sizeof(**contour_lengths) * n, userdata);
1680
if (*contour_lengths == 0) {
1685
// make two passes through the points so we don't need to realloc
1686
for (pass=0; pass < 2; ++pass) {
1689
points = (stbtt__point *) STBTT_malloc(num_points * sizeof(points[0]), userdata);
1690
if (points == NULL) goto error;
1694
for (i=0; i < num_verts; ++i) {
1695
switch (vertices[i].type) {
1697
// start the next contour
1699
(*contour_lengths)[n] = num_points - start;
1703
x = vertices[i].x, y = vertices[i].y;
1704
stbtt__add_point(points, num_points++, x,y);
1707
x = vertices[i].x, y = vertices[i].y;
1708
stbtt__add_point(points, num_points++, x, y);
1711
stbtt__tesselate_curve(points, &num_points, x,y,
1712
vertices[i].cx, vertices[i].cy,
1713
vertices[i].x, vertices[i].y,
1714
objspace_flatness_squared, 0);
1715
x = vertices[i].x, y = vertices[i].y;
1719
(*contour_lengths)[n] = num_points - start;
1724
STBTT_free(points, userdata);
1725
STBTT_free(*contour_lengths, userdata);
1726
*contour_lengths = 0;
1731
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)
1733
float scale = scale_x > scale_y ? scale_y : scale_x;
1734
int winding_count, *winding_lengths;
1735
stbtt__point *windings = stbtt_FlattenCurves(vertices, num_verts, flatness_in_pixels / scale, &winding_lengths, &winding_count, userdata);
1737
stbtt__rasterize(result, windings, winding_lengths, winding_count, scale_x, scale_y, shift_x, shift_y, x_off, y_off, invert, userdata);
1738
STBTT_free(winding_lengths, userdata);
1739
STBTT_free(windings, userdata);
1743
void stbtt_FreeBitmap(unsigned char *bitmap, void *userdata)
1745
STBTT_free(bitmap, userdata);
1748
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)
1750
int ix0,iy0,ix1,iy1;
1752
stbtt_vertex *vertices;
1753
int num_verts = stbtt_GetGlyphShape(info, glyph, &vertices);
1755
if (scale_x == 0) scale_x = scale_y;
1757
if (scale_x == 0) return NULL;
1761
stbtt_GetGlyphBitmapBoxSubpixel(info, glyph, scale_x, scale_y, shift_x, shift_y, &ix0,&iy0,&ix1,&iy1);
1763
// now we get the size
1764
gbm.w = (ix1 - ix0);
1765
gbm.h = (iy1 - iy0);
1766
gbm.pixels = NULL; // in case we error
1768
if (width ) *width = gbm.w;
1769
if (height) *height = gbm.h;
1770
if (xoff ) *xoff = ix0;
1771
if (yoff ) *yoff = iy0;
1773
if (gbm.w && gbm.h) {
1774
gbm.pixels = (unsigned char *) STBTT_malloc(gbm.w * gbm.h, info->userdata);
1778
stbtt_Rasterize(&gbm, 0.35f, vertices, num_verts, scale_x, scale_y, shift_x, shift_y, ix0, iy0, 1, info->userdata);
1781
STBTT_free(vertices, info->userdata);
1785
unsigned char *stbtt_GetGlyphBitmap(const stbtt_fontinfo *info, float scale_x, float scale_y, int glyph, int *width, int *height, int *xoff, int *yoff)
1787
return stbtt_GetGlyphBitmapSubpixel(info, scale_x, scale_y, 0.0f, 0.0f, glyph, width, height, xoff, yoff);
1790
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)
1793
stbtt_vertex *vertices;
1794
int num_verts = stbtt_GetGlyphShape(info, glyph, &vertices);
1797
stbtt_GetGlyphBitmapBoxSubpixel(info, glyph, scale_x, scale_y, shift_x, shift_y, &ix0,&iy0,0,0);
1798
gbm.pixels = output;
1801
gbm.stride = out_stride;
1804
stbtt_Rasterize(&gbm, 0.35f, vertices, num_verts, scale_x, scale_y, shift_x, shift_y, ix0,iy0, 1, info->userdata);
1806
STBTT_free(vertices, info->userdata);
1809
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)
1811
stbtt_MakeGlyphBitmapSubpixel(info, output, out_w, out_h, out_stride, scale_x, scale_y, 0.0f,0.0f, glyph);
1814
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)
1816
return stbtt_GetGlyphBitmapSubpixel(info, scale_x, scale_y,shift_x,shift_y, stbtt_FindGlyphIndex(info,codepoint), width,height,xoff,yoff);
1819
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)
1821
stbtt_MakeGlyphBitmapSubpixel(info, output, out_w, out_h, out_stride, scale_x, scale_y, shift_x, shift_y, stbtt_FindGlyphIndex(info,codepoint));
1824
unsigned char *stbtt_GetCodepointBitmap(const stbtt_fontinfo *info, float scale_x, float scale_y, int codepoint, int *width, int *height, int *xoff, int *yoff)
1826
return stbtt_GetCodepointBitmapSubpixel(info, scale_x, scale_y, 0.0f,0.0f, codepoint, width,height,xoff,yoff);
1829
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)
1831
stbtt_MakeCodepointBitmapSubpixel(info, output, out_w, out_h, out_stride, scale_x, scale_y, 0.0f,0.0f, codepoint);
1834
//////////////////////////////////////////////////////////////////////////////
1838
// This is SUPER-CRAPPY packing to keep source code small
1840
extern int stbtt_BakeFontBitmap(const unsigned char *data, int offset, // font location (use offset=0 for plain .ttf)
1841
float pixel_height, // height of font in pixels
1842
unsigned char *pixels, int pw, int ph, // bitmap to be filled in
1843
int first_char, int num_chars, // characters to bake
1844
stbtt_bakedchar *chardata)
1847
int x,y,bottom_y, i;
1849
stbtt_InitFont(&f, data, offset);
1850
STBTT_memset(pixels, 0, pw*ph); // background of 0 around pixels
1854
scale = stbtt_ScaleForPixelHeight(&f, pixel_height);
1856
for (i=0; i < num_chars; ++i) {
1857
int advance, lsb, x0,y0,x1,y1,gw,gh;
1858
int g = stbtt_FindGlyphIndex(&f, first_char + i);
1859
stbtt_GetGlyphHMetrics(&f, g, &advance, &lsb);
1860
stbtt_GetGlyphBitmapBox(&f, g, scale,scale, &x0,&y0,&x1,&y1);
1863
if (x + gw + 1 >= pw)
1864
y = bottom_y, x = 1; // advance to next row
1865
if (y + gh + 1 >= ph) // check if it fits vertically AFTER potentially moving to next row
1867
STBTT_assert(x+gw < pw);
1868
STBTT_assert(y+gh < ph);
1869
stbtt_MakeGlyphBitmap(&f, pixels+x+y*pw, gw,gh,pw, scale,scale, g);
1870
chardata[i].x0 = (stbtt_int16) x;
1871
chardata[i].y0 = (stbtt_int16) y;
1872
chardata[i].x1 = (stbtt_int16) (x + gw);
1873
chardata[i].y1 = (stbtt_int16) (y + gh);
1874
chardata[i].xadvance = scale * advance;
1875
chardata[i].xoff = (float) x0;
1876
chardata[i].yoff = (float) y0;
1878
if (y+gh+2 > bottom_y)
1884
void stbtt_GetBakedQuad(stbtt_bakedchar *chardata, int pw, int ph, int char_index, float *xpos, float *ypos, stbtt_aligned_quad *q, int opengl_fillrule)
1886
float d3d_bias = opengl_fillrule ? 0 : -0.5f;
1887
float ipw = 1.0f / pw, iph = 1.0f / ph;
1888
stbtt_bakedchar *b = chardata + char_index;
1889
int round_x = STBTT_ifloor((*xpos + b->xoff) + 0.5);
1890
int round_y = STBTT_ifloor((*ypos + b->yoff) + 0.5);
1892
q->x0 = round_x + d3d_bias;
1893
q->y0 = round_y + d3d_bias;
1894
q->x1 = round_x + b->x1 - b->x0 + d3d_bias;
1895
q->y1 = round_y + b->y1 - b->y0 + d3d_bias;
1897
q->s0 = b->x0 * ipw;
1898
q->t0 = b->y0 * iph;
1899
q->s1 = b->x1 * ipw;
1900
q->t1 = b->y1 * iph;
1902
*xpos += b->xadvance;
1905
//////////////////////////////////////////////////////////////////////////////
1907
// font name matching -- recommended not to use this
1910
// check if a utf8 string contains a prefix which is the utf16 string; if so return length of matching utf8 string
1911
static stbtt_int32 stbtt__CompareUTF8toUTF16_bigendian_prefix(const stbtt_uint8 *s1, stbtt_int32 len1, const stbtt_uint8 *s2, stbtt_int32 len2)
1915
// convert utf16 to utf8 and compare the results while converting
1917
stbtt_uint16 ch = s2[0]*256 + s2[1];
1919
if (i >= len1) return -1;
1920
if (s1[i++] != ch) return -1;
1921
} else if (ch < 0x800) {
1922
if (i+1 >= len1) return -1;
1923
if (s1[i++] != 0xc0 + (ch >> 6)) return -1;
1924
if (s1[i++] != 0x80 + (ch & 0x3f)) return -1;
1925
} else if (ch >= 0xd800 && ch < 0xdc00) {
1927
stbtt_uint16 ch2 = s2[2]*256 + s2[3];
1928
if (i+3 >= len1) return -1;
1929
c = ((ch - 0xd800) << 10) + (ch2 - 0xdc00) + 0x10000;
1930
if (s1[i++] != 0xf0 + (c >> 18)) return -1;
1931
if (s1[i++] != 0x80 + ((c >> 12) & 0x3f)) return -1;
1932
if (s1[i++] != 0x80 + ((c >> 6) & 0x3f)) return -1;
1933
if (s1[i++] != 0x80 + ((c ) & 0x3f)) return -1;
1934
s2 += 2; // plus another 2 below
1936
} else if (ch >= 0xdc00 && ch < 0xe000) {
1939
if (i+2 >= len1) return -1;
1940
if (s1[i++] != 0xe0 + (ch >> 12)) return -1;
1941
if (s1[i++] != 0x80 + ((ch >> 6) & 0x3f)) return -1;
1942
if (s1[i++] != 0x80 + ((ch ) & 0x3f)) return -1;
1950
int stbtt_CompareUTF8toUTF16_bigendian(const char *s1, int len1, const char *s2, int len2)
1952
return len1 == stbtt__CompareUTF8toUTF16_bigendian_prefix((const stbtt_uint8*) s1, len1, (const stbtt_uint8*) s2, len2);
1955
// returns results in whatever encoding you request... but note that 2-byte encodings
1956
// will be BIG-ENDIAN... use stbtt_CompareUTF8toUTF16_bigendian() to compare
1957
const char *stbtt_GetFontNameString(const stbtt_fontinfo *font, int *length, int platformID, int encodingID, int languageID, int nameID)
1959
stbtt_int32 i,count,stringOffset;
1960
stbtt_uint8 *fc = font->data;
1961
stbtt_uint32 offset = font->fontstart;
1962
stbtt_uint32 nm = stbtt__find_table(fc, offset, "name");
1963
if (!nm) return NULL;
1965
count = ttUSHORT(fc+nm+2);
1966
stringOffset = nm + ttUSHORT(fc+nm+4);
1967
for (i=0; i < count; ++i) {
1968
stbtt_uint32 loc = nm + 6 + 12 * i;
1969
if (platformID == ttUSHORT(fc+loc+0) && encodingID == ttUSHORT(fc+loc+2)
1970
&& languageID == ttUSHORT(fc+loc+4) && nameID == ttUSHORT(fc+loc+6)) {
1971
*length = ttUSHORT(fc+loc+8);
1972
return (const char *) (fc+stringOffset+ttUSHORT(fc+loc+10));
1978
static int stbtt__matchpair(stbtt_uint8 *fc, stbtt_uint32 nm, stbtt_uint8 *name, stbtt_int32 nlen, stbtt_int32 target_id, stbtt_int32 next_id)
1981
stbtt_int32 count = ttUSHORT(fc+nm+2);
1982
stbtt_int32 stringOffset = nm + ttUSHORT(fc+nm+4);
1984
for (i=0; i < count; ++i) {
1985
stbtt_uint32 loc = nm + 6 + 12 * i;
1986
stbtt_int32 id = ttUSHORT(fc+loc+6);
1987
if (id == target_id) {
1988
// find the encoding
1989
stbtt_int32 platform = ttUSHORT(fc+loc+0), encoding = ttUSHORT(fc+loc+2), language = ttUSHORT(fc+loc+4);
1991
// is this a Unicode encoding?
1992
if (platform == 0 || (platform == 3 && encoding == 1) || (platform == 3 && encoding == 10)) {
1993
stbtt_int32 slen = ttUSHORT(fc+loc+8), off = ttUSHORT(fc+loc+10);
1995
// check if there's a prefix match
1996
stbtt_int32 matchlen = stbtt__CompareUTF8toUTF16_bigendian_prefix(name, nlen, fc+stringOffset+off,slen);
1997
if (matchlen >= 0) {
1998
// check for target_id+1 immediately following, with same encoding & language
1999
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) {
2000
stbtt_int32 slen = ttUSHORT(fc+loc+12+8), off = ttUSHORT(fc+loc+12+10);
2002
if (matchlen == nlen)
2004
} else if (matchlen < nlen && name[matchlen] == ' ') {
2006
if (stbtt_CompareUTF8toUTF16_bigendian((char*) (name+matchlen), nlen-matchlen, (char*)(fc+stringOffset+off),slen))
2010
// if nothing immediately following
2011
if (matchlen == nlen)
2017
// @TODO handle other encodings
2023
static int stbtt__matches(stbtt_uint8 *fc, stbtt_uint32 offset, stbtt_uint8 *name, stbtt_int32 flags)
2025
stbtt_int32 nlen = (stbtt_int32) STBTT_strlen((char *) name);
2027
if (!stbtt__isfont(fc+offset)) return 0;
2029
// check italics/bold/underline flags in macStyle...
2031
hd = stbtt__find_table(fc, offset, "head");
2032
if ((ttUSHORT(fc+hd+44) & 7) != (flags & 7)) return 0;
2035
nm = stbtt__find_table(fc, offset, "name");
2039
// if we checked the macStyle flags, then just check the family and ignore the subfamily
2040
if (stbtt__matchpair(fc, nm, name, nlen, 16, -1)) return 1;
2041
if (stbtt__matchpair(fc, nm, name, nlen, 1, -1)) return 1;
2042
if (stbtt__matchpair(fc, nm, name, nlen, 3, -1)) return 1;
2044
if (stbtt__matchpair(fc, nm, name, nlen, 16, 17)) return 1;
2045
if (stbtt__matchpair(fc, nm, name, nlen, 1, 2)) return 1;
2046
if (stbtt__matchpair(fc, nm, name, nlen, 3, -1)) return 1;
2052
int stbtt_FindMatchingFont(const unsigned char *font_collection, const char *name_utf8, stbtt_int32 flags)
2056
stbtt_int32 off = stbtt_GetFontOffsetForIndex(font_collection, i);
2057
if (off < 0) return off;
2058
if (stbtt__matches((stbtt_uint8 *) font_collection, off, (stbtt_uint8*) name_utf8, flags))
2063
#endif // STB_TRUETYPE_IMPLEMENTATION