🛠️🐜 Antkeeper superbuild with dependencies included https://antkeeper.com
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

5077 lines
194 KiB

  1. // stb_truetype.h - v1.26 - public domain
  2. // authored from 2009-2021 by Sean Barrett / RAD Game Tools
  3. //
  4. // =======================================================================
  5. //
  6. // NO SECURITY GUARANTEE -- DO NOT USE THIS ON UNTRUSTED FONT FILES
  7. //
  8. // This library does no range checking of the offsets found in the file,
  9. // meaning an attacker can use it to read arbitrary memory.
  10. //
  11. // =======================================================================
  12. //
  13. // This library processes TrueType files:
  14. // parse files
  15. // extract glyph metrics
  16. // extract glyph shapes
  17. // render glyphs to one-channel bitmaps with antialiasing (box filter)
  18. // render glyphs to one-channel SDF bitmaps (signed-distance field/function)
  19. //
  20. // Todo:
  21. // non-MS cmaps
  22. // crashproof on bad data
  23. // hinting? (no longer patented)
  24. // cleartype-style AA?
  25. // optimize: use simple memory allocator for intermediates
  26. // optimize: build edge-list directly from curves
  27. // optimize: rasterize directly from curves?
  28. //
  29. // ADDITIONAL CONTRIBUTORS
  30. //
  31. // Mikko Mononen: compound shape support, more cmap formats
  32. // Tor Andersson: kerning, subpixel rendering
  33. // Dougall Johnson: OpenType / Type 2 font handling
  34. // Daniel Ribeiro Maciel: basic GPOS-based kerning
  35. //
  36. // Misc other:
  37. // Ryan Gordon
  38. // Simon Glass
  39. // github:IntellectualKitty
  40. // Imanol Celaya
  41. // Daniel Ribeiro Maciel
  42. //
  43. // Bug/warning reports/fixes:
  44. // "Zer" on mollyrocket Fabian "ryg" Giesen github:NiLuJe
  45. // Cass Everitt Martins Mozeiko github:aloucks
  46. // stoiko (Haemimont Games) Cap Petschulat github:oyvindjam
  47. // Brian Hook Omar Cornut github:vassvik
  48. // Walter van Niftrik Ryan Griege
  49. // David Gow Peter LaValle
  50. // David Given Sergey Popov
  51. // Ivan-Assen Ivanov Giumo X. Clanjor
  52. // Anthony Pesch Higor Euripedes
  53. // Johan Duparc Thomas Fields
  54. // Hou Qiming Derek Vinyard
  55. // Rob Loach Cort Stratton
  56. // Kenney Phillis Jr. Brian Costabile
  57. // Ken Voskuil (kaesve)
  58. //
  59. // VERSION HISTORY
  60. //
  61. // 1.26 (2021-08-28) fix broken rasterizer
  62. // 1.25 (2021-07-11) many fixes
  63. // 1.24 (2020-02-05) fix warning
  64. // 1.23 (2020-02-02) query SVG data for glyphs; query whole kerning table (but only kern not GPOS)
  65. // 1.22 (2019-08-11) minimize missing-glyph duplication; fix kerning if both 'GPOS' and 'kern' are defined
  66. // 1.21 (2019-02-25) fix warning
  67. // 1.20 (2019-02-07) PackFontRange skips missing codepoints; GetScaleFontVMetrics()
  68. // 1.19 (2018-02-11) GPOS kerning, STBTT_fmod
  69. // 1.18 (2018-01-29) add missing function
  70. // 1.17 (2017-07-23) make more arguments const; doc fix
  71. // 1.16 (2017-07-12) SDF support
  72. // 1.15 (2017-03-03) make more arguments const
  73. // 1.14 (2017-01-16) num-fonts-in-TTC function
  74. // 1.13 (2017-01-02) support OpenType fonts, certain Apple fonts
  75. // 1.12 (2016-10-25) suppress warnings about casting away const with -Wcast-qual
  76. // 1.11 (2016-04-02) fix unused-variable warning
  77. // 1.10 (2016-04-02) user-defined fabs(); rare memory leak; remove duplicate typedef
  78. // 1.09 (2016-01-16) warning fix; avoid crash on outofmem; use allocation userdata properly
  79. // 1.08 (2015-09-13) document stbtt_Rasterize(); fixes for vertical & horizontal edges
  80. // 1.07 (2015-08-01) allow PackFontRanges to accept arrays of sparse codepoints;
  81. // variant PackFontRanges to pack and render in separate phases;
  82. // fix stbtt_GetFontOFfsetForIndex (never worked for non-0 input?);
  83. // fixed an assert() bug in the new rasterizer
  84. // replace assert() with STBTT_assert() in new rasterizer
  85. //
  86. // Full history can be found at the end of this file.
  87. //
  88. // LICENSE
  89. //
  90. // See end of file for license information.
  91. //
  92. // USAGE
  93. //
  94. // Include this file in whatever places need to refer to it. In ONE C/C++
  95. // file, write:
  96. // #define STB_TRUETYPE_IMPLEMENTATION
  97. // before the #include of this file. This expands out the actual
  98. // implementation into that C/C++ file.
  99. //
  100. // To make the implementation private to the file that generates the implementation,
  101. // #define STBTT_STATIC
  102. //
  103. // Simple 3D API (don't ship this, but it's fine for tools and quick start)
  104. // stbtt_BakeFontBitmap() -- bake a font to a bitmap for use as texture
  105. // stbtt_GetBakedQuad() -- compute quad to draw for a given char
  106. //
  107. // Improved 3D API (more shippable):
  108. // #include "stb_rect_pack.h" -- optional, but you really want it
  109. // stbtt_PackBegin()
  110. // stbtt_PackSetOversampling() -- for improved quality on small fonts
  111. // stbtt_PackFontRanges() -- pack and renders
  112. // stbtt_PackEnd()
  113. // stbtt_GetPackedQuad()
  114. //
  115. // "Load" a font file from a memory buffer (you have to keep the buffer loaded)
  116. // stbtt_InitFont()
  117. // stbtt_GetFontOffsetForIndex() -- indexing for TTC font collections
  118. // stbtt_GetNumberOfFonts() -- number of fonts for TTC font collections
  119. //
  120. // Render a unicode codepoint to a bitmap
  121. // stbtt_GetCodepointBitmap() -- allocates and returns a bitmap
  122. // stbtt_MakeCodepointBitmap() -- renders into bitmap you provide
  123. // stbtt_GetCodepointBitmapBox() -- how big the bitmap must be
  124. //
  125. // Character advance/positioning
  126. // stbtt_GetCodepointHMetrics()
  127. // stbtt_GetFontVMetrics()
  128. // stbtt_GetFontVMetricsOS2()
  129. // stbtt_GetCodepointKernAdvance()
  130. //
  131. // Starting with version 1.06, the rasterizer was replaced with a new,
  132. // faster and generally-more-precise rasterizer. The new rasterizer more
  133. // accurately measures pixel coverage for anti-aliasing, except in the case
  134. // where multiple shapes overlap, in which case it overestimates the AA pixel
  135. // coverage. Thus, anti-aliasing of intersecting shapes may look wrong. If
  136. // this turns out to be a problem, you can re-enable the old rasterizer with
  137. // #define STBTT_RASTERIZER_VERSION 1
  138. // which will incur about a 15% speed hit.
  139. //
  140. // ADDITIONAL DOCUMENTATION
  141. //
  142. // Immediately after this block comment are a series of sample programs.
  143. //
  144. // After the sample programs is the "header file" section. This section
  145. // includes documentation for each API function.
  146. //
  147. // Some important concepts to understand to use this library:
  148. //
  149. // Codepoint
  150. // Characters are defined by unicode codepoints, e.g. 65 is
  151. // uppercase A, 231 is lowercase c with a cedilla, 0x7e30 is
  152. // the hiragana for "ma".
  153. //
  154. // Glyph
  155. // A visual character shape (every codepoint is rendered as
  156. // some glyph)
  157. //
  158. // Glyph index
  159. // A font-specific integer ID representing a glyph
  160. //
  161. // Baseline
  162. // Glyph shapes are defined relative to a baseline, which is the
  163. // bottom of uppercase characters. Characters extend both above
  164. // and below the baseline.
  165. //
  166. // Current Point
  167. // As you draw text to the screen, you keep track of a "current point"
  168. // which is the origin of each character. The current point's vertical
  169. // position is the baseline. Even "baked fonts" use this model.
  170. //
  171. // Vertical Font Metrics
  172. // The vertical qualities of the font, used to vertically position
  173. // and space the characters. See docs for stbtt_GetFontVMetrics.
  174. //
  175. // Font Size in Pixels or Points
  176. // The preferred interface for specifying font sizes in stb_truetype
  177. // is to specify how tall the font's vertical extent should be in pixels.
  178. // If that sounds good enough, skip the next paragraph.
  179. //
  180. // Most font APIs instead use "points", which are a common typographic
  181. // measurement for describing font size, defined as 72 points per inch.
  182. // stb_truetype provides a point API for compatibility. However, true
  183. // "per inch" conventions don't make much sense on computer displays
  184. // since different monitors have different number of pixels per
  185. // inch. For example, Windows traditionally uses a convention that
  186. // there are 96 pixels per inch, thus making 'inch' measurements have
  187. // nothing to do with inches, and thus effectively defining a point to
  188. // be 1.333 pixels. Additionally, the TrueType font data provides
  189. // an explicit scale factor to scale a given font's glyphs to points,
  190. // but the author has observed that this scale factor is often wrong
  191. // for non-commercial fonts, thus making fonts scaled in points
  192. // according to the TrueType spec incoherently sized in practice.
  193. //
  194. // DETAILED USAGE:
  195. //
  196. // Scale:
  197. // Select how high you want the font to be, in points or pixels.
  198. // Call ScaleForPixelHeight or ScaleForMappingEmToPixels to compute
  199. // a scale factor SF that will be used by all other functions.
  200. //
  201. // Baseline:
  202. // You need to select a y-coordinate that is the baseline of where
  203. // your text will appear. Call GetFontBoundingBox to get the baseline-relative
  204. // bounding box for all characters. SF*-y0 will be the distance in pixels
  205. // that the worst-case character could extend above the baseline, so if
  206. // you want the top edge of characters to appear at the top of the
  207. // screen where y=0, then you would set the baseline to SF*-y0.
  208. //
  209. // Current point:
  210. // Set the current point where the first character will appear. The
  211. // first character could extend left of the current point; this is font
  212. // dependent. You can either choose a current point that is the leftmost
  213. // point and hope, or add some padding, or check the bounding box or
  214. // left-side-bearing of the first character to be displayed and set
  215. // the current point based on that.
  216. //
  217. // Displaying a character:
  218. // Compute the bounding box of the character. It will contain signed values
  219. // relative to <current_point, baseline>. I.e. if it returns x0,y0,x1,y1,
  220. // then the character should be displayed in the rectangle from
  221. // <current_point+SF*x0, baseline+SF*y0> to <current_point+SF*x1,baseline+SF*y1).
  222. //
  223. // Advancing for the next character:
  224. // Call GlyphHMetrics, and compute 'current_point += SF * advance'.
  225. //
  226. //
  227. // ADVANCED USAGE
  228. //
  229. // Quality:
  230. //
  231. // - Use the functions with Subpixel at the end to allow your characters
  232. // to have subpixel positioning. Since the font is anti-aliased, not
  233. // hinted, this is very import for quality. (This is not possible with
  234. // baked fonts.)
  235. //
  236. // - Kerning is now supported, and if you're supporting subpixel rendering
  237. // then kerning is worth using to give your text a polished look.
  238. //
  239. // Performance:
  240. //
  241. // - Convert Unicode codepoints to glyph indexes and operate on the glyphs;
  242. // if you don't do this, stb_truetype is forced to do the conversion on
  243. // every call.
  244. //
  245. // - There are a lot of memory allocations. We should modify it to take
  246. // a temp buffer and allocate from the temp buffer (without freeing),
  247. // should help performance a lot.
  248. //
  249. // NOTES
  250. //
  251. // The system uses the raw data found in the .ttf file without changing it
  252. // and without building auxiliary data structures. This is a bit inefficient
  253. // on little-endian systems (the data is big-endian), but assuming you're
  254. // caching the bitmaps or glyph shapes this shouldn't be a big deal.
  255. //
  256. // It appears to be very hard to programmatically determine what font a
  257. // given file is in a general way. I provide an API for this, but I don't
  258. // recommend it.
  259. //
  260. //
  261. // PERFORMANCE MEASUREMENTS FOR 1.06:
  262. //
  263. // 32-bit 64-bit
  264. // Previous release: 8.83 s 7.68 s
  265. // Pool allocations: 7.72 s 6.34 s
  266. // Inline sort : 6.54 s 5.65 s
  267. // New rasterizer : 5.63 s 5.00 s
  268. //////////////////////////////////////////////////////////////////////////////
  269. //////////////////////////////////////////////////////////////////////////////
  270. ////
  271. //// SAMPLE PROGRAMS
  272. ////
  273. //
  274. // Incomplete text-in-3d-api example, which draws quads properly aligned to be lossless.
  275. // See "tests/truetype_demo_win32.c" for a complete version.
  276. #if 0
  277. #define STB_TRUETYPE_IMPLEMENTATION // force following include to generate implementation
  278. #include "stb_truetype.h"
  279. unsigned char ttf_buffer[1<<20];
  280. unsigned char temp_bitmap[512*512];
  281. stbtt_bakedchar cdata[96]; // ASCII 32..126 is 95 glyphs
  282. GLuint ftex;
  283. void my_stbtt_initfont(void)
  284. {
  285. fread(ttf_buffer, 1, 1<<20, fopen("c:/windows/fonts/times.ttf", "rb"));
  286. stbtt_BakeFontBitmap(ttf_buffer,0, 32.0, temp_bitmap,512,512, 32,96, cdata); // no guarantee this fits!
  287. // can free ttf_buffer at this point
  288. glGenTextures(1, &ftex);
  289. glBindTexture(GL_TEXTURE_2D, ftex);
  290. glTexImage2D(GL_TEXTURE_2D, 0, GL_ALPHA, 512,512, 0, GL_ALPHA, GL_UNSIGNED_BYTE, temp_bitmap);
  291. // can free temp_bitmap at this point
  292. glTexParameteri(GL_TEXTURE_2D, GL_TEXTURE_MIN_FILTER, GL_LINEAR);
  293. }
  294. void my_stbtt_print(float x, float y, char *text)
  295. {
  296. // assume orthographic projection with units = screen pixels, origin at top left
  297. glEnable(GL_BLEND);
  298. glBlendFunc(GL_SRC_ALPHA, GL_ONE_MINUS_SRC_ALPHA);
  299. glEnable(GL_TEXTURE_2D);
  300. glBindTexture(GL_TEXTURE_2D, ftex);
  301. glBegin(GL_QUADS);
  302. while (*text) {
  303. if (*text >= 32 && *text < 128) {
  304. stbtt_aligned_quad q;
  305. stbtt_GetBakedQuad(cdata, 512,512, *text-32, &x,&y,&q,1);//1=opengl & d3d10+,0=d3d9
  306. glTexCoord2f(q.s0,q.t0); glVertex2f(q.x0,q.y0);
  307. glTexCoord2f(q.s1,q.t0); glVertex2f(q.x1,q.y0);
  308. glTexCoord2f(q.s1,q.t1); glVertex2f(q.x1,q.y1);
  309. glTexCoord2f(q.s0,q.t1); glVertex2f(q.x0,q.y1);
  310. }
  311. ++text;
  312. }
  313. glEnd();
  314. }
  315. #endif
  316. //
  317. //
  318. //////////////////////////////////////////////////////////////////////////////
  319. //
  320. // Complete program (this compiles): get a single bitmap, print as ASCII art
  321. //
  322. #if 0
  323. #include <stdio.h>
  324. #define STB_TRUETYPE_IMPLEMENTATION // force following include to generate implementation
  325. #include "stb_truetype.h"
  326. char ttf_buffer[1<<25];
  327. int main(int argc, char **argv)
  328. {
  329. stbtt_fontinfo font;
  330. unsigned char *bitmap;
  331. int w,h,i,j,c = (argc > 1 ? atoi(argv[1]) : 'a'), s = (argc > 2 ? atoi(argv[2]) : 20);
  332. fread(ttf_buffer, 1, 1<<25, fopen(argc > 3 ? argv[3] : "c:/windows/fonts/arialbd.ttf", "rb"));
  333. stbtt_InitFont(&font, ttf_buffer, stbtt_GetFontOffsetForIndex(ttf_buffer,0));
  334. bitmap = stbtt_GetCodepointBitmap(&font, 0,stbtt_ScaleForPixelHeight(&font, s), c, &w, &h, 0,0);
  335. for (j=0; j < h; ++j) {
  336. for (i=0; i < w; ++i)
  337. putchar(" .:ioVM@"[bitmap[j*w+i]>>5]);
  338. putchar('\n');
  339. }
  340. return 0;
  341. }
  342. #endif
  343. //
  344. // Output:
  345. //
  346. // .ii.
  347. // @@@@@@.
  348. // V@Mio@@o
  349. // :i. V@V
  350. // :oM@@M
  351. // :@@@MM@M
  352. // @@o o@M
  353. // :@@. M@M
  354. // @@@o@@@@
  355. // :M@@V:@@.
  356. //
  357. //////////////////////////////////////////////////////////////////////////////
  358. //
  359. // Complete program: print "Hello World!" banner, with bugs
  360. //
  361. #if 0
  362. char buffer[24<<20];
  363. unsigned char screen[20][79];
  364. int main(int arg, char **argv)
  365. {
  366. stbtt_fontinfo font;
  367. int i,j,ascent,baseline,ch=0;
  368. float scale, xpos=2; // leave a little padding in case the character extends left
  369. char *text = "Heljo World!"; // intentionally misspelled to show 'lj' brokenness
  370. fread(buffer, 1, 1000000, fopen("c:/windows/fonts/arialbd.ttf", "rb"));
  371. stbtt_InitFont(&font, buffer, 0);
  372. scale = stbtt_ScaleForPixelHeight(&font, 15);
  373. stbtt_GetFontVMetrics(&font, &ascent,0,0);
  374. baseline = (int) (ascent*scale);
  375. while (text[ch]) {
  376. int advance,lsb,x0,y0,x1,y1;
  377. float x_shift = xpos - (float) floor(xpos);
  378. stbtt_GetCodepointHMetrics(&font, text[ch], &advance, &lsb);
  379. stbtt_GetCodepointBitmapBoxSubpixel(&font, text[ch], scale,scale,x_shift,0, &x0,&y0,&x1,&y1);
  380. stbtt_MakeCodepointBitmapSubpixel(&font, &screen[baseline + y0][(int) xpos + x0], x1-x0,y1-y0, 79, scale,scale,x_shift,0, text[ch]);
  381. // note that this stomps the old data, so where character boxes overlap (e.g. 'lj') it's wrong
  382. // because this API is really for baking character bitmaps into textures. if you want to render
  383. // a sequence of characters, you really need to render each bitmap to a temp buffer, then
  384. // "alpha blend" that into the working buffer
  385. xpos += (advance * scale);
  386. if (text[ch+1])
  387. xpos += scale*stbtt_GetCodepointKernAdvance(&font, text[ch],text[ch+1]);
  388. ++ch;
  389. }
  390. for (j=0; j < 20; ++j) {
  391. for (i=0; i < 78; ++i)
  392. putchar(" .:ioVM@"[screen[j][i]>>5]);
  393. putchar('\n');
  394. }
  395. return 0;
  396. }
  397. #endif
  398. //////////////////////////////////////////////////////////////////////////////
  399. //////////////////////////////////////////////////////////////////////////////
  400. ////
  401. //// INTEGRATION WITH YOUR CODEBASE
  402. ////
  403. //// The following sections allow you to supply alternate definitions
  404. //// of C library functions used by stb_truetype, e.g. if you don't
  405. //// link with the C runtime library.
  406. #ifdef STB_TRUETYPE_IMPLEMENTATION
  407. // #define your own (u)stbtt_int8/16/32 before including to override this
  408. #ifndef stbtt_uint8
  409. typedef unsigned char stbtt_uint8;
  410. typedef signed char stbtt_int8;
  411. typedef unsigned short stbtt_uint16;
  412. typedef signed short stbtt_int16;
  413. typedef unsigned int stbtt_uint32;
  414. typedef signed int stbtt_int32;
  415. #endif
  416. typedef char stbtt__check_size32[sizeof(stbtt_int32)==4 ? 1 : -1];
  417. typedef char stbtt__check_size16[sizeof(stbtt_int16)==2 ? 1 : -1];
  418. // e.g. #define your own STBTT_ifloor/STBTT_iceil() to avoid math.h
  419. #ifndef STBTT_ifloor
  420. #include <math.h>
  421. #define STBTT_ifloor(x) ((int) floor(x))
  422. #define STBTT_iceil(x) ((int) ceil(x))
  423. #endif
  424. #ifndef STBTT_sqrt
  425. #include <math.h>
  426. #define STBTT_sqrt(x) sqrt(x)
  427. #define STBTT_pow(x,y) pow(x,y)
  428. #endif
  429. #ifndef STBTT_fmod
  430. #include <math.h>
  431. #define STBTT_fmod(x,y) fmod(x,y)
  432. #endif
  433. #ifndef STBTT_cos
  434. #include <math.h>
  435. #define STBTT_cos(x) cos(x)
  436. #define STBTT_acos(x) acos(x)
  437. #endif
  438. #ifndef STBTT_fabs
  439. #include <math.h>
  440. #define STBTT_fabs(x) fabs(x)
  441. #endif
  442. // #define your own functions "STBTT_malloc" / "STBTT_free" to avoid malloc.h
  443. #ifndef STBTT_malloc
  444. #include <stdlib.h>
  445. #define STBTT_malloc(x,u) ((void)(u),malloc(x))
  446. #define STBTT_free(x,u) ((void)(u),free(x))
  447. #endif
  448. #ifndef STBTT_assert
  449. #include <assert.h>
  450. #define STBTT_assert(x) assert(x)
  451. #endif
  452. #ifndef STBTT_strlen
  453. #include <string.h>
  454. #define STBTT_strlen(x) strlen(x)
  455. #endif
  456. #ifndef STBTT_memcpy
  457. #include <string.h>
  458. #define STBTT_memcpy memcpy
  459. #define STBTT_memset memset
  460. #endif
  461. #endif
  462. ///////////////////////////////////////////////////////////////////////////////
  463. ///////////////////////////////////////////////////////////////////////////////
  464. ////
  465. //// INTERFACE
  466. ////
  467. ////
  468. #ifndef __STB_INCLUDE_STB_TRUETYPE_H__
  469. #define __STB_INCLUDE_STB_TRUETYPE_H__
  470. #ifdef STBTT_STATIC
  471. #define STBTT_DEF static
  472. #else
  473. #define STBTT_DEF extern
  474. #endif
  475. #ifdef __cplusplus
  476. extern "C" {
  477. #endif
  478. // private structure
  479. typedef struct
  480. {
  481. unsigned char *data;
  482. int cursor;
  483. int size;
  484. } stbtt__buf;
  485. //////////////////////////////////////////////////////////////////////////////
  486. //
  487. // TEXTURE BAKING API
  488. //
  489. // If you use this API, you only have to call two functions ever.
  490. //
  491. typedef struct
  492. {
  493. unsigned short x0,y0,x1,y1; // coordinates of bbox in bitmap
  494. float xoff,yoff,xadvance;
  495. } stbtt_bakedchar;
  496. STBTT_DEF int stbtt_BakeFontBitmap(const unsigned char *data, int offset, // font location (use offset=0 for plain .ttf)
  497. float pixel_height, // height of font in pixels
  498. unsigned char *pixels, int pw, int ph, // bitmap to be filled in
  499. int first_char, int num_chars, // characters to bake
  500. stbtt_bakedchar *chardata); // you allocate this, it's num_chars long
  501. // if return is positive, the first unused row of the bitmap
  502. // if return is negative, returns the negative of the number of characters that fit
  503. // if return is 0, no characters fit and no rows were used
  504. // This uses a very crappy packing.
  505. typedef struct
  506. {
  507. float x0,y0,s0,t0; // top-left
  508. float x1,y1,s1,t1; // bottom-right
  509. } stbtt_aligned_quad;
  510. STBTT_DEF void stbtt_GetBakedQuad(const stbtt_bakedchar *chardata, int pw, int ph, // same data as above
  511. int char_index, // character to display
  512. float *xpos, float *ypos, // pointers to current position in screen pixel space
  513. stbtt_aligned_quad *q, // output: quad to draw
  514. int opengl_fillrule); // true if opengl fill rule; false if DX9 or earlier
  515. // Call GetBakedQuad with char_index = 'character - first_char', and it
  516. // creates the quad you need to draw and advances the current position.
  517. //
  518. // The coordinate system used assumes y increases downwards.
  519. //
  520. // Characters will extend both above and below the current position;
  521. // see discussion of "BASELINE" above.
  522. //
  523. // It's inefficient; you might want to c&p it and optimize it.
  524. STBTT_DEF void stbtt_GetScaledFontVMetrics(const unsigned char *fontdata, int index, float size, float *ascent, float *descent, float *lineGap);
  525. // Query the font vertical metrics without having to create a font first.
  526. //////////////////////////////////////////////////////////////////////////////
  527. //
  528. // NEW TEXTURE BAKING API
  529. //
  530. // This provides options for packing multiple fonts into one atlas, not
  531. // perfectly but better than nothing.
  532. typedef struct
  533. {
  534. unsigned short x0,y0,x1,y1; // coordinates of bbox in bitmap
  535. float xoff,yoff,xadvance;
  536. float xoff2,yoff2;
  537. } stbtt_packedchar;
  538. typedef struct stbtt_pack_context stbtt_pack_context;
  539. typedef struct stbtt_fontinfo stbtt_fontinfo;
  540. #ifndef STB_RECT_PACK_VERSION
  541. typedef struct stbrp_rect stbrp_rect;
  542. #endif
  543. STBTT_DEF int stbtt_PackBegin(stbtt_pack_context *spc, unsigned char *pixels, int width, int height, int stride_in_bytes, int padding, void *alloc_context);
  544. // Initializes a packing context stored in the passed-in stbtt_pack_context.
  545. // Future calls using this context will pack characters into the bitmap passed
  546. // in here: a 1-channel bitmap that is width * height. stride_in_bytes is
  547. // the distance from one row to the next (or 0 to mean they are packed tightly
  548. // together). "padding" is the amount of padding to leave between each
  549. // character (normally you want '1' for bitmaps you'll use as textures with
  550. // bilinear filtering).
  551. //
  552. // Returns 0 on failure, 1 on success.
  553. STBTT_DEF void stbtt_PackEnd (stbtt_pack_context *spc);
  554. // Cleans up the packing context and frees all memory.
  555. #define STBTT_POINT_SIZE(x) (-(x))
  556. STBTT_DEF int stbtt_PackFontRange(stbtt_pack_context *spc, const unsigned char *fontdata, int font_index, float font_size,
  557. int first_unicode_char_in_range, int num_chars_in_range, stbtt_packedchar *chardata_for_range);
  558. // Creates character bitmaps from the font_index'th font found in fontdata (use
  559. // font_index=0 if you don't know what that is). It creates num_chars_in_range
  560. // bitmaps for characters with unicode values starting at first_unicode_char_in_range
  561. // and increasing. Data for how to render them is stored in chardata_for_range;
  562. // pass these to stbtt_GetPackedQuad to get back renderable quads.
  563. //
  564. // font_size is the full height of the character from ascender to descender,
  565. // as computed by stbtt_ScaleForPixelHeight. To use a point size as computed
  566. // by stbtt_ScaleForMappingEmToPixels, wrap the point size in STBTT_POINT_SIZE()
  567. // and pass that result as 'font_size':
  568. // ..., 20 , ... // font max minus min y is 20 pixels tall
  569. // ..., STBTT_POINT_SIZE(20), ... // 'M' is 20 pixels tall
  570. typedef struct
  571. {
  572. float font_size;
  573. int first_unicode_codepoint_in_range; // if non-zero, then the chars are continuous, and this is the first codepoint
  574. int *array_of_unicode_codepoints; // if non-zero, then this is an array of unicode codepoints
  575. int num_chars;
  576. stbtt_packedchar *chardata_for_range; // output
  577. unsigned char h_oversample, v_oversample; // don't set these, they're used internally
  578. } stbtt_pack_range;
  579. STBTT_DEF int stbtt_PackFontRanges(stbtt_pack_context *spc, const unsigned char *fontdata, int font_index, stbtt_pack_range *ranges, int num_ranges);
  580. // Creates character bitmaps from multiple ranges of characters stored in
  581. // ranges. This will usually create a better-packed bitmap than multiple
  582. // calls to stbtt_PackFontRange. Note that you can call this multiple
  583. // times within a single PackBegin/PackEnd.
  584. STBTT_DEF void stbtt_PackSetOversampling(stbtt_pack_context *spc, unsigned int h_oversample, unsigned int v_oversample);
  585. // Oversampling a font increases the quality by allowing higher-quality subpixel
  586. // positioning, and is especially valuable at smaller text sizes.
  587. //
  588. // This function sets the amount of oversampling for all following calls to
  589. // stbtt_PackFontRange(s) or stbtt_PackFontRangesGatherRects for a given
  590. // pack context. The default (no oversampling) is achieved by h_oversample=1
  591. // and v_oversample=1. The total number of pixels required is
  592. // h_oversample*v_oversample larger than the default; for example, 2x2
  593. // oversampling requires 4x the storage of 1x1. For best results, render
  594. // oversampled textures with bilinear filtering. Look at the readme in
  595. // stb/tests/oversample for information about oversampled fonts
  596. //
  597. // To use with PackFontRangesGather etc., you must set it before calls
  598. // call to PackFontRangesGatherRects.
  599. STBTT_DEF void stbtt_PackSetSkipMissingCodepoints(stbtt_pack_context *spc, int skip);
  600. // If skip != 0, this tells stb_truetype to skip any codepoints for which
  601. // there is no corresponding glyph. If skip=0, which is the default, then
  602. // codepoints without a glyph recived the font's "missing character" glyph,
  603. // typically an empty box by convention.
  604. STBTT_DEF void stbtt_GetPackedQuad(const stbtt_packedchar *chardata, int pw, int ph, // same data as above
  605. int char_index, // character to display
  606. float *xpos, float *ypos, // pointers to current position in screen pixel space
  607. stbtt_aligned_quad *q, // output: quad to draw
  608. int align_to_integer);
  609. STBTT_DEF int stbtt_PackFontRangesGatherRects(stbtt_pack_context *spc, const stbtt_fontinfo *info, stbtt_pack_range *ranges, int num_ranges, stbrp_rect *rects);
  610. STBTT_DEF void stbtt_PackFontRangesPackRects(stbtt_pack_context *spc, stbrp_rect *rects, int num_rects);
  611. STBTT_DEF int stbtt_PackFontRangesRenderIntoRects(stbtt_pack_context *spc, const stbtt_fontinfo *info, stbtt_pack_range *ranges, int num_ranges, stbrp_rect *rects);
  612. // Calling these functions in sequence is roughly equivalent to calling
  613. // stbtt_PackFontRanges(). If you more control over the packing of multiple
  614. // fonts, or if you want to pack custom data into a font texture, take a look
  615. // at the source to of stbtt_PackFontRanges() and create a custom version
  616. // using these functions, e.g. call GatherRects multiple times,
  617. // building up a single array of rects, then call PackRects once,
  618. // then call RenderIntoRects repeatedly. This may result in a
  619. // better packing than calling PackFontRanges multiple times
  620. // (or it may not).
  621. // this is an opaque structure that you shouldn't mess with which holds
  622. // all the context needed from PackBegin to PackEnd.
  623. struct stbtt_pack_context {
  624. void *user_allocator_context;
  625. void *pack_info;
  626. int width;
  627. int height;
  628. int stride_in_bytes;
  629. int padding;
  630. int skip_missing;
  631. unsigned int h_oversample, v_oversample;
  632. unsigned char *pixels;
  633. void *nodes;
  634. };
  635. //////////////////////////////////////////////////////////////////////////////
  636. //
  637. // FONT LOADING
  638. //
  639. //
  640. STBTT_DEF int stbtt_GetNumberOfFonts(const unsigned char *data);
  641. // This function will determine the number of fonts in a font file. TrueType
  642. // collection (.ttc) files may contain multiple fonts, while TrueType font
  643. // (.ttf) files only contain one font. The number of fonts can be used for
  644. // indexing with the previous function where the index is between zero and one
  645. // less than the total fonts. If an error occurs, -1 is returned.
  646. STBTT_DEF int stbtt_GetFontOffsetForIndex(const unsigned char *data, int index);
  647. // Each .ttf/.ttc file may have more than one font. Each font has a sequential
  648. // index number starting from 0. Call this function to get the font offset for
  649. // a given index; it returns -1 if the index is out of range. A regular .ttf
  650. // file will only define one font and it always be at offset 0, so it will
  651. // return '0' for index 0, and -1 for all other indices.
  652. // The following structure is defined publicly so you can declare one on
  653. // the stack or as a global or etc, but you should treat it as opaque.
  654. struct stbtt_fontinfo
  655. {
  656. void * userdata;
  657. unsigned char * data; // pointer to .ttf file
  658. int fontstart; // offset of start of font
  659. int numGlyphs; // number of glyphs, needed for range checking
  660. int loca,head,glyf,hhea,hmtx,kern,gpos,svg; // table locations as offset from start of .ttf
  661. int index_map; // a cmap mapping for our chosen character encoding
  662. int indexToLocFormat; // format needed to map from glyph index to glyph
  663. stbtt__buf cff; // cff font data
  664. stbtt__buf charstrings; // the charstring index
  665. stbtt__buf gsubrs; // global charstring subroutines index
  666. stbtt__buf subrs; // private charstring subroutines index
  667. stbtt__buf fontdicts; // array of font dicts
  668. stbtt__buf fdselect; // map from glyph to fontdict
  669. };
  670. STBTT_DEF int stbtt_InitFont(stbtt_fontinfo *info, const unsigned char *data, int offset);
  671. // Given an offset into the file that defines a font, this function builds
  672. // the necessary cached info for the rest of the system. You must allocate
  673. // the stbtt_fontinfo yourself, and stbtt_InitFont will fill it out. You don't
  674. // need to do anything special to free it, because the contents are pure
  675. // value data with no additional data structures. Returns 0 on failure.
  676. //////////////////////////////////////////////////////////////////////////////
  677. //
  678. // CHARACTER TO GLYPH-INDEX CONVERSIOn
  679. STBTT_DEF int stbtt_FindGlyphIndex(const stbtt_fontinfo *info, int unicode_codepoint);
  680. // If you're going to perform multiple operations on the same character
  681. // and you want a speed-up, call this function with the character you're
  682. // going to process, then use glyph-based functions instead of the
  683. // codepoint-based functions.
  684. // Returns 0 if the character codepoint is not defined in the font.
  685. //////////////////////////////////////////////////////////////////////////////
  686. //
  687. // CHARACTER PROPERTIES
  688. //
  689. STBTT_DEF float stbtt_ScaleForPixelHeight(const stbtt_fontinfo *info, float pixels);
  690. // computes a scale factor to produce a font whose "height" is 'pixels' tall.
  691. // Height is measured as the distance from the highest ascender to the lowest
  692. // descender; in other words, it's equivalent to calling stbtt_GetFontVMetrics
  693. // and computing:
  694. // scale = pixels / (ascent - descent)
  695. // so if you prefer to measure height by the ascent only, use a similar calculation.
  696. STBTT_DEF float stbtt_ScaleForMappingEmToPixels(const stbtt_fontinfo *info, float pixels);
  697. // computes a scale factor to produce a font whose EM size is mapped to
  698. // 'pixels' tall. This is probably what traditional APIs compute, but
  699. // I'm not positive.
  700. STBTT_DEF void stbtt_GetFontVMetrics(const stbtt_fontinfo *info, int *ascent, int *descent, int *lineGap);
  701. // ascent is the coordinate above the baseline the font extends; descent
  702. // is the coordinate below the baseline the font extends (i.e. it is typically negative)
  703. // lineGap is the spacing between one row's descent and the next row's ascent...
  704. // so you should advance the vertical position by "*ascent - *descent + *lineGap"
  705. // these are expressed in unscaled coordinates, so you must multiply by
  706. // the scale factor for a given size
  707. STBTT_DEF int stbtt_GetFontVMetricsOS2(const stbtt_fontinfo *info, int *typoAscent, int *typoDescent, int *typoLineGap);
  708. // analogous to GetFontVMetrics, but returns the "typographic" values from the OS/2
  709. // table (specific to MS/Windows TTF files).
  710. //
  711. // Returns 1 on success (table present), 0 on failure.
  712. STBTT_DEF void stbtt_GetFontBoundingBox(const stbtt_fontinfo *info, int *x0, int *y0, int *x1, int *y1);
  713. // the bounding box around all possible characters
  714. STBTT_DEF void stbtt_GetCodepointHMetrics(const stbtt_fontinfo *info, int codepoint, int *advanceWidth, int *leftSideBearing);
  715. // leftSideBearing is the offset from the current horizontal position to the left edge of the character
  716. // advanceWidth is the offset from the current horizontal position to the next horizontal position
  717. // these are expressed in unscaled coordinates
  718. STBTT_DEF int stbtt_GetCodepointKernAdvance(const stbtt_fontinfo *info, int ch1, int ch2);
  719. // an additional amount to add to the 'advance' value between ch1 and ch2
  720. STBTT_DEF int stbtt_GetCodepointBox(const stbtt_fontinfo *info, int codepoint, int *x0, int *y0, int *x1, int *y1);
  721. // Gets the bounding box of the visible part of the glyph, in unscaled coordinates
  722. STBTT_DEF void stbtt_GetGlyphHMetrics(const stbtt_fontinfo *info, int glyph_index, int *advanceWidth, int *leftSideBearing);
  723. STBTT_DEF int stbtt_GetGlyphKernAdvance(const stbtt_fontinfo *info, int glyph1, int glyph2);
  724. STBTT_DEF int stbtt_GetGlyphBox(const stbtt_fontinfo *info, int glyph_index, int *x0, int *y0, int *x1, int *y1);
  725. // as above, but takes one or more glyph indices for greater efficiency
  726. typedef struct stbtt_kerningentry
  727. {
  728. int glyph1; // use stbtt_FindGlyphIndex
  729. int glyph2;
  730. int advance;
  731. } stbtt_kerningentry;
  732. STBTT_DEF int stbtt_GetKerningTableLength(const stbtt_fontinfo *info);
  733. STBTT_DEF int stbtt_GetKerningTable(const stbtt_fontinfo *info, stbtt_kerningentry* table, int table_length);
  734. // Retrieves a complete list of all of the kerning pairs provided by the font
  735. // stbtt_GetKerningTable never writes more than table_length entries and returns how many entries it did write.
  736. // The table will be sorted by (a.glyph1 == b.glyph1)?(a.glyph2 < b.glyph2):(a.glyph1 < b.glyph1)
  737. //////////////////////////////////////////////////////////////////////////////
  738. //
  739. // GLYPH SHAPES (you probably don't need these, but they have to go before
  740. // the bitmaps for C declaration-order reasons)
  741. //
  742. #ifndef STBTT_vmove // you can predefine these to use different values (but why?)
  743. enum {
  744. STBTT_vmove=1,
  745. STBTT_vline,
  746. STBTT_vcurve,
  747. STBTT_vcubic
  748. };
  749. #endif
  750. #ifndef stbtt_vertex // you can predefine this to use different values
  751. // (we share this with other code at RAD)
  752. #define stbtt_vertex_type short // can't use stbtt_int16 because that's not visible in the header file
  753. typedef struct
  754. {
  755. stbtt_vertex_type x,y,cx,cy,cx1,cy1;
  756. unsigned char type,padding;
  757. } stbtt_vertex;
  758. #endif
  759. STBTT_DEF int stbtt_IsGlyphEmpty(const stbtt_fontinfo *info, int glyph_index);
  760. // returns non-zero if nothing is drawn for this glyph
  761. STBTT_DEF int stbtt_GetCodepointShape(const stbtt_fontinfo *info, int unicode_codepoint, stbtt_vertex **vertices);
  762. STBTT_DEF int stbtt_GetGlyphShape(const stbtt_fontinfo *info, int glyph_index, stbtt_vertex **vertices);
  763. // returns # of vertices and fills *vertices with the pointer to them
  764. // these are expressed in "unscaled" coordinates
  765. //
  766. // The shape is a series of contours. Each one starts with
  767. // a STBTT_moveto, then consists of a series of mixed
  768. // STBTT_lineto and STBTT_curveto segments. A lineto
  769. // draws a line from previous endpoint to its x,y; a curveto
  770. // draws a quadratic bezier from previous endpoint to
  771. // its x,y, using cx,cy as the bezier control point.
  772. STBTT_DEF void stbtt_FreeShape(const stbtt_fontinfo *info, stbtt_vertex *vertices);
  773. // frees the data allocated above
  774. STBTT_DEF unsigned char *stbtt_FindSVGDoc(const stbtt_fontinfo *info, int gl);
  775. STBTT_DEF int stbtt_GetCodepointSVG(const stbtt_fontinfo *info, int unicode_codepoint, const char **svg);
  776. STBTT_DEF int stbtt_GetGlyphSVG(const stbtt_fontinfo *info, int gl, const char **svg);
  777. // fills svg with the character's SVG data.
  778. // returns data size or 0 if SVG not found.
  779. //////////////////////////////////////////////////////////////////////////////
  780. //
  781. // BITMAP RENDERING
  782. //
  783. STBTT_DEF void stbtt_FreeBitmap(unsigned char *bitmap, void *userdata);
  784. // frees the bitmap allocated below
  785. STBTT_DEF unsigned char *stbtt_GetCodepointBitmap(const stbtt_fontinfo *info, float scale_x, float scale_y, int codepoint, int *width, int *height, int *xoff, int *yoff);
  786. // allocates a large-enough single-channel 8bpp bitmap and renders the
  787. // specified character/glyph at the specified scale into it, with
  788. // antialiasing. 0 is no coverage (transparent), 255 is fully covered (opaque).
  789. // *width & *height are filled out with the width & height of the bitmap,
  790. // which is stored left-to-right, top-to-bottom.
  791. //
  792. // xoff/yoff are the offset it pixel space from the glyph origin to the top-left of the bitmap
  793. STBTT_DEF unsigned char *stbtt_GetCodepointBitmapSubpixel(const stbtt_fontinfo *info, float scale_x, float scale_y, float shift_x, float shift_y, int codepoint, int *width, int *height, int *xoff, int *yoff);
  794. // the same as stbtt_GetCodepoitnBitmap, but you can specify a subpixel
  795. // shift for the character
  796. STBTT_DEF void stbtt_MakeCodepointBitmap(const stbtt_fontinfo *info, unsigned char *output, int out_w, int out_h, int out_stride, float scale_x, float scale_y, int codepoint);
  797. // the same as stbtt_GetCodepointBitmap, but you pass in storage for the bitmap
  798. // in the form of 'output', with row spacing of 'out_stride' bytes. the bitmap
  799. // is clipped to out_w/out_h bytes. Call stbtt_GetCodepointBitmapBox to get the
  800. // width and height and positioning info for it first.
  801. STBTT_DEF void stbtt_MakeCodepointBitmapSubpixel(const stbtt_fontinfo *info, unsigned char *output, int out_w, int out_h, int out_stride, float scale_x, float scale_y, float shift_x, float shift_y, int codepoint);
  802. // same as stbtt_MakeCodepointBitmap, but you can specify a subpixel
  803. // shift for the character
  804. STBTT_DEF void stbtt_MakeCodepointBitmapSubpixelPrefilter(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 oversample_x, int oversample_y, float *sub_x, float *sub_y, int codepoint);
  805. // same as stbtt_MakeCodepointBitmapSubpixel, but prefiltering
  806. // is performed (see stbtt_PackSetOversampling)
  807. STBTT_DEF void stbtt_GetCodepointBitmapBox(const stbtt_fontinfo *font, int codepoint, float scale_x, float scale_y, int *ix0, int *iy0, int *ix1, int *iy1);
  808. // get the bbox of the bitmap centered around the glyph origin; so the
  809. // bitmap width is ix1-ix0, height is iy1-iy0, and location to place
  810. // the bitmap top left is (leftSideBearing*scale,iy0).
  811. // (Note that the bitmap uses y-increases-down, but the shape uses
  812. // y-increases-up, so CodepointBitmapBox and CodepointBox are inverted.)
  813. STBTT_DEF void stbtt_GetCodepointBitmapBoxSubpixel(const stbtt_fontinfo *font, int codepoint, float scale_x, float scale_y, float shift_x, float shift_y, int *ix0, int *iy0, int *ix1, int *iy1);
  814. // same as stbtt_GetCodepointBitmapBox, but you can specify a subpixel
  815. // shift for the character
  816. // the following functions are equivalent to the above functions, but operate
  817. // on glyph indices instead of Unicode codepoints (for efficiency)
  818. STBTT_DEF unsigned char *stbtt_GetGlyphBitmap(const stbtt_fontinfo *info, float scale_x, float scale_y, int glyph, int *width, int *height, int *xoff, int *yoff);
  819. STBTT_DEF unsigned char *stbtt_GetGlyphBitmapSubpixel(const stbtt_fontinfo *info, float scale_x, float scale_y, float shift_x, float shift_y, int glyph, int *width, int *height, int *xoff, int *yoff);
  820. STBTT_DEF void stbtt_MakeGlyphBitmap(const stbtt_fontinfo *info, unsigned char *output, int out_w, int out_h, int out_stride, float scale_x, float scale_y, int glyph);
  821. STBTT_DEF void stbtt_MakeGlyphBitmapSubpixel(const stbtt_fontinfo *info, unsigned char *output, int out_w, int out_h, int out_stride, float scale_x, float scale_y, float shift_x, float shift_y, int glyph);
  822. STBTT_DEF void stbtt_MakeGlyphBitmapSubpixelPrefilter(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 oversample_x, int oversample_y, float *sub_x, float *sub_y, int glyph);
  823. STBTT_DEF void stbtt_GetGlyphBitmapBox(const stbtt_fontinfo *font, int glyph, float scale_x, float scale_y, int *ix0, int *iy0, int *ix1, int *iy1);
  824. STBTT_DEF void stbtt_GetGlyphBitmapBoxSubpixel(const stbtt_fontinfo *font, int glyph, float scale_x, float scale_y,float shift_x, float shift_y, int *ix0, int *iy0, int *ix1, int *iy1);
  825. // @TODO: don't expose this structure
  826. typedef struct
  827. {
  828. int w,h,stride;
  829. unsigned char *pixels;
  830. } stbtt__bitmap;
  831. // rasterize a shape with quadratic beziers into a bitmap
  832. STBTT_DEF void stbtt_Rasterize(stbtt__bitmap *result, // 1-channel bitmap to draw into
  833. float flatness_in_pixels, // allowable error of curve in pixels
  834. stbtt_vertex *vertices, // array of vertices defining shape
  835. int num_verts, // number of vertices in above array
  836. float scale_x, float scale_y, // scale applied to input vertices
  837. float shift_x, float shift_y, // translation applied to input vertices
  838. int x_off, int y_off, // another translation applied to input
  839. int invert, // if non-zero, vertically flip shape
  840. void *userdata); // context for to STBTT_MALLOC
  841. //////////////////////////////////////////////////////////////////////////////
  842. //
  843. // Signed Distance Function (or Field) rendering
  844. STBTT_DEF void stbtt_FreeSDF(unsigned char *bitmap, void *userdata);
  845. // frees the SDF bitmap allocated below
  846. STBTT_DEF unsigned char * stbtt_GetGlyphSDF(const stbtt_fontinfo *info, float scale, int glyph, int padding, unsigned char onedge_value, float pixel_dist_scale, int *width, int *height, int *xoff, int *yoff);
  847. STBTT_DEF unsigned char * stbtt_GetCodepointSDF(const stbtt_fontinfo *info, float scale, int codepoint, int padding, unsigned char onedge_value, float pixel_dist_scale, int *width, int *height, int *xoff, int *yoff);
  848. // These functions compute a discretized SDF field for a single character, suitable for storing
  849. // in a single-channel texture, sampling with bilinear filtering, and testing against
  850. // larger than some threshold to produce scalable fonts.
  851. // info -- the font
  852. // scale -- controls the size of the resulting SDF bitmap, same as it would be creating a regular bitmap
  853. // glyph/codepoint -- the character to generate the SDF for
  854. // padding -- extra "pixels" around the character which are filled with the distance to the character (not 0),
  855. // which allows effects like bit outlines
  856. // onedge_value -- value 0-255 to test the SDF against to reconstruct the character (i.e. the isocontour of the character)
  857. // pixel_dist_scale -- what value the SDF should increase by when moving one SDF "pixel" away from the edge (on the 0..255 scale)
  858. // if positive, > onedge_value is inside; if negative, < onedge_value is inside
  859. // width,height -- output height & width of the SDF bitmap (including padding)
  860. // xoff,yoff -- output origin of the character
  861. // return value -- a 2D array of bytes 0..255, width*height in size
  862. //
  863. // pixel_dist_scale & onedge_value are a scale & bias that allows you to make
  864. // optimal use of the limited 0..255 for your application, trading off precision
  865. // and special effects. SDF values outside the range 0..255 are clamped to 0..255.
  866. //
  867. // Example:
  868. // scale = stbtt_ScaleForPixelHeight(22)
  869. // padding = 5
  870. // onedge_value = 180
  871. // pixel_dist_scale = 180/5.0 = 36.0
  872. //
  873. // This will create an SDF bitmap in which the character is about 22 pixels
  874. // high but the whole bitmap is about 22+5+5=32 pixels high. To produce a filled
  875. // shape, sample the SDF at each pixel and fill the pixel if the SDF value
  876. // is greater than or equal to 180/255. (You'll actually want to antialias,
  877. // which is beyond the scope of this example.) Additionally, you can compute
  878. // offset outlines (e.g. to stroke the character border inside & outside,
  879. // or only outside). For example, to fill outside the character up to 3 SDF
  880. // pixels, you would compare against (180-36.0*3)/255 = 72/255. The above
  881. // choice of variables maps a range from 5 pixels outside the shape to
  882. // 2 pixels inside the shape to 0..255; this is intended primarily for apply
  883. // outside effects only (the interior range is needed to allow proper
  884. // antialiasing of the font at *smaller* sizes)
  885. //
  886. // The function computes the SDF analytically at each SDF pixel, not by e.g.
  887. // building a higher-res bitmap and approximating it. In theory the quality
  888. // should be as high as possible for an SDF of this size & representation, but
  889. // unclear if this is true in practice (perhaps building a higher-res bitmap
  890. // and computing from that can allow drop-out prevention).
  891. //
  892. // The algorithm has not been optimized at all, so expect it to be slow
  893. // if computing lots of characters or very large sizes.
  894. //////////////////////////////////////////////////////////////////////////////
  895. //
  896. // Finding the right font...
  897. //
  898. // You should really just solve this offline, keep your own tables
  899. // of what font is what, and don't try to get it out of the .ttf file.
  900. // That's because getting it out of the .ttf file is really hard, because
  901. // the names in the file can appear in many possible encodings, in many
  902. // possible languages, and e.g. if you need a case-insensitive comparison,
  903. // the details of that depend on the encoding & language in a complex way
  904. // (actually underspecified in truetype, but also gigantic).
  905. //
  906. // But you can use the provided functions in two possible ways:
  907. // stbtt_FindMatchingFont() will use *case-sensitive* comparisons on
  908. // unicode-encoded names to try to find the font you want;
  909. // you can run this before calling stbtt_InitFont()
  910. //
  911. // stbtt_GetFontNameString() lets you get any of the various strings
  912. // from the file yourself and do your own comparisons on them.
  913. // You have to have called stbtt_InitFont() first.
  914. STBTT_DEF int stbtt_FindMatchingFont(const unsigned char *fontdata, const char *name, int flags);
  915. // returns the offset (not index) of the font that matches, or -1 if none
  916. // if you use STBTT_MACSTYLE_DONTCARE, use a font name like "Arial Bold".
  917. // if you use any other flag, use a font name like "Arial"; this checks
  918. // the 'macStyle' header field; i don't know if fonts set this consistently
  919. #define STBTT_MACSTYLE_DONTCARE 0
  920. #define STBTT_MACSTYLE_BOLD 1
  921. #define STBTT_MACSTYLE_ITALIC 2
  922. #define STBTT_MACSTYLE_UNDERSCORE 4
  923. #define STBTT_MACSTYLE_NONE 8 // <= not same as 0, this makes us check the bitfield is 0
  924. STBTT_DEF int stbtt_CompareUTF8toUTF16_bigendian(const char *s1, int len1, const char *s2, int len2);
  925. // returns 1/0 whether the first string interpreted as utf8 is identical to
  926. // the second string interpreted as big-endian utf16... useful for strings from next func
  927. STBTT_DEF const char *stbtt_GetFontNameString(const stbtt_fontinfo *font, int *length, int platformID, int encodingID, int languageID, int nameID);
  928. // returns the string (which may be big-endian double byte, e.g. for unicode)
  929. // and puts the length in bytes in *length.
  930. //
  931. // some of the values for the IDs are below; for more see the truetype spec:
  932. // http://developer.apple.com/textfonts/TTRefMan/RM06/Chap6name.html
  933. // http://www.microsoft.com/typography/otspec/name.htm
  934. enum { // platformID
  935. STBTT_PLATFORM_ID_UNICODE =0,
  936. STBTT_PLATFORM_ID_MAC =1,
  937. STBTT_PLATFORM_ID_ISO =2,
  938. STBTT_PLATFORM_ID_MICROSOFT =3
  939. };
  940. enum { // encodingID for STBTT_PLATFORM_ID_UNICODE
  941. STBTT_UNICODE_EID_UNICODE_1_0 =0,
  942. STBTT_UNICODE_EID_UNICODE_1_1 =1,
  943. STBTT_UNICODE_EID_ISO_10646 =2,
  944. STBTT_UNICODE_EID_UNICODE_2_0_BMP=3,
  945. STBTT_UNICODE_EID_UNICODE_2_0_FULL=4
  946. };
  947. enum { // encodingID for STBTT_PLATFORM_ID_MICROSOFT
  948. STBTT_MS_EID_SYMBOL =0,
  949. STBTT_MS_EID_UNICODE_BMP =1,
  950. STBTT_MS_EID_SHIFTJIS =2,
  951. STBTT_MS_EID_UNICODE_FULL =10
  952. };
  953. enum { // encodingID for STBTT_PLATFORM_ID_MAC; same as Script Manager codes
  954. STBTT_MAC_EID_ROMAN =0, STBTT_MAC_EID_ARABIC =4,
  955. STBTT_MAC_EID_JAPANESE =1, STBTT_MAC_EID_HEBREW =5,
  956. STBTT_MAC_EID_CHINESE_TRAD =2, STBTT_MAC_EID_GREEK =6,
  957. STBTT_MAC_EID_KOREAN =3, STBTT_MAC_EID_RUSSIAN =7
  958. };
  959. enum { // languageID for STBTT_PLATFORM_ID_MICROSOFT; same as LCID...
  960. // problematic because there are e.g. 16 english LCIDs and 16 arabic LCIDs
  961. STBTT_MS_LANG_ENGLISH =0x0409, STBTT_MS_LANG_ITALIAN =0x0410,
  962. STBTT_MS_LANG_CHINESE =0x0804, STBTT_MS_LANG_JAPANESE =0x0411,
  963. STBTT_MS_LANG_DUTCH =0x0413, STBTT_MS_LANG_KOREAN =0x0412,
  964. STBTT_MS_LANG_FRENCH =0x040c, STBTT_MS_LANG_RUSSIAN =0x0419,
  965. STBTT_MS_LANG_GERMAN =0x0407, STBTT_MS_LANG_SPANISH =0x0409,
  966. STBTT_MS_LANG_HEBREW =0x040d, STBTT_MS_LANG_SWEDISH =0x041D
  967. };
  968. enum { // languageID for STBTT_PLATFORM_ID_MAC
  969. STBTT_MAC_LANG_ENGLISH =0 , STBTT_MAC_LANG_JAPANESE =11,
  970. STBTT_MAC_LANG_ARABIC =12, STBTT_MAC_LANG_KOREAN =23,
  971. STBTT_MAC_LANG_DUTCH =4 , STBTT_MAC_LANG_RUSSIAN =32,
  972. STBTT_MAC_LANG_FRENCH =1 , STBTT_MAC_LANG_SPANISH =6 ,
  973. STBTT_MAC_LANG_GERMAN =2 , STBTT_MAC_LANG_SWEDISH =5 ,
  974. STBTT_MAC_LANG_HEBREW =10, STBTT_MAC_LANG_CHINESE_SIMPLIFIED =33,
  975. STBTT_MAC_LANG_ITALIAN =3 , STBTT_MAC_LANG_CHINESE_TRAD =19
  976. };
  977. #ifdef __cplusplus
  978. }
  979. #endif
  980. #endif // __STB_INCLUDE_STB_TRUETYPE_H__
  981. ///////////////////////////////////////////////////////////////////////////////
  982. ///////////////////////////////////////////////////////////////////////////////
  983. ////
  984. //// IMPLEMENTATION
  985. ////
  986. ////
  987. #ifdef STB_TRUETYPE_IMPLEMENTATION
  988. #ifndef STBTT_MAX_OVERSAMPLE
  989. #define STBTT_MAX_OVERSAMPLE 8
  990. #endif
  991. #if STBTT_MAX_OVERSAMPLE > 255
  992. #error "STBTT_MAX_OVERSAMPLE cannot be > 255"
  993. #endif
  994. typedef int stbtt__test_oversample_pow2[(STBTT_MAX_OVERSAMPLE & (STBTT_MAX_OVERSAMPLE-1)) == 0 ? 1 : -1];
  995. #ifndef STBTT_RASTERIZER_VERSION
  996. #define STBTT_RASTERIZER_VERSION 2
  997. #endif
  998. #ifdef _MSC_VER
  999. #define STBTT__NOTUSED(v) (void)(v)
  1000. #else
  1001. #define STBTT__NOTUSED(v) (void)sizeof(v)
  1002. #endif
  1003. //////////////////////////////////////////////////////////////////////////
  1004. //
  1005. // stbtt__buf helpers to parse data from file
  1006. //
  1007. static stbtt_uint8 stbtt__buf_get8(stbtt__buf *b)
  1008. {
  1009. if (b->cursor >= b->size)
  1010. return 0;
  1011. return b->data[b->cursor++];
  1012. }
  1013. static stbtt_uint8 stbtt__buf_peek8(stbtt__buf *b)
  1014. {
  1015. if (b->cursor >= b->size)
  1016. return 0;
  1017. return b->data[b->cursor];
  1018. }
  1019. static void stbtt__buf_seek(stbtt__buf *b, int o)
  1020. {
  1021. STBTT_assert(!(o > b->size || o < 0));
  1022. b->cursor = (o > b->size || o < 0) ? b->size : o;
  1023. }
  1024. static void stbtt__buf_skip(stbtt__buf *b, int o)
  1025. {
  1026. stbtt__buf_seek(b, b->cursor + o);
  1027. }
  1028. static stbtt_uint32 stbtt__buf_get(stbtt__buf *b, int n)
  1029. {
  1030. stbtt_uint32 v = 0;
  1031. int i;
  1032. STBTT_assert(n >= 1 && n <= 4);
  1033. for (i = 0; i < n; i++)
  1034. v = (v << 8) | stbtt__buf_get8(b);
  1035. return v;
  1036. }
  1037. static stbtt__buf stbtt__new_buf(const void *p, size_t size)
  1038. {
  1039. stbtt__buf r;
  1040. STBTT_assert(size < 0x40000000);
  1041. r.data = (stbtt_uint8*) p;
  1042. r.size = (int) size;
  1043. r.cursor = 0;
  1044. return r;
  1045. }
  1046. #define stbtt__buf_get16(b) stbtt__buf_get((b), 2)
  1047. #define stbtt__buf_get32(b) stbtt__buf_get((b), 4)
  1048. static stbtt__buf stbtt__buf_range(const stbtt__buf *b, int o, int s)
  1049. {
  1050. stbtt__buf r = stbtt__new_buf(NULL, 0);
  1051. if (o < 0 || s < 0 || o > b->size || s > b->size - o) return r;
  1052. r.data = b->data + o;
  1053. r.size = s;
  1054. return r;
  1055. }
  1056. static stbtt__buf stbtt__cff_get_index(stbtt__buf *b)
  1057. {
  1058. int count, start, offsize;
  1059. start = b->cursor;
  1060. count = stbtt__buf_get16(b);
  1061. if (count) {
  1062. offsize = stbtt__buf_get8(b);
  1063. STBTT_assert(offsize >= 1 && offsize <= 4);
  1064. stbtt__buf_skip(b, offsize * count);
  1065. stbtt__buf_skip(b, stbtt__buf_get(b, offsize) - 1);
  1066. }
  1067. return stbtt__buf_range(b, start, b->cursor - start);
  1068. }
  1069. static stbtt_uint32 stbtt__cff_int(stbtt__buf *b)
  1070. {
  1071. int b0 = stbtt__buf_get8(b);
  1072. if (b0 >= 32 && b0 <= 246) return b0 - 139;
  1073. else if (b0 >= 247 && b0 <= 250) return (b0 - 247)*256 + stbtt__buf_get8(b) + 108;
  1074. else if (b0 >= 251 && b0 <= 254) return -(b0 - 251)*256 - stbtt__buf_get8(b) - 108;
  1075. else if (b0 == 28) return stbtt__buf_get16(b);
  1076. else if (b0 == 29) return stbtt__buf_get32(b);
  1077. STBTT_assert(0);
  1078. return 0;
  1079. }
  1080. static void stbtt__cff_skip_operand(stbtt__buf *b) {
  1081. int v, b0 = stbtt__buf_peek8(b);
  1082. STBTT_assert(b0 >= 28);
  1083. if (b0 == 30) {
  1084. stbtt__buf_skip(b, 1);
  1085. while (b->cursor < b->size) {
  1086. v = stbtt__buf_get8(b);
  1087. if ((v & 0xF) == 0xF || (v >> 4) == 0xF)
  1088. break;
  1089. }
  1090. } else {
  1091. stbtt__cff_int(b);
  1092. }
  1093. }
  1094. static stbtt__buf stbtt__dict_get(stbtt__buf *b, int key)
  1095. {
  1096. stbtt__buf_seek(b, 0);
  1097. while (b->cursor < b->size) {
  1098. int start = b->cursor, end, op;
  1099. while (stbtt__buf_peek8(b) >= 28)
  1100. stbtt__cff_skip_operand(b);
  1101. end = b->cursor;
  1102. op = stbtt__buf_get8(b);
  1103. if (op == 12) op = stbtt__buf_get8(b) | 0x100;
  1104. if (op == key) return stbtt__buf_range(b, start, end-start);
  1105. }
  1106. return stbtt__buf_range(b, 0, 0);
  1107. }
  1108. static void stbtt__dict_get_ints(stbtt__buf *b, int key, int outcount, stbtt_uint32 *out)
  1109. {
  1110. int i;
  1111. stbtt__buf operands = stbtt__dict_get(b, key);
  1112. for (i = 0; i < outcount && operands.cursor < operands.size; i++)
  1113. out[i] = stbtt__cff_int(&operands);
  1114. }
  1115. static int stbtt__cff_index_count(stbtt__buf *b)
  1116. {
  1117. stbtt__buf_seek(b, 0);
  1118. return stbtt__buf_get16(b);
  1119. }
  1120. static stbtt__buf stbtt__cff_index_get(stbtt__buf b, int i)
  1121. {
  1122. int count, offsize, start, end;
  1123. stbtt__buf_seek(&b, 0);
  1124. count = stbtt__buf_get16(&b);
  1125. offsize = stbtt__buf_get8(&b);
  1126. STBTT_assert(i >= 0 && i < count);
  1127. STBTT_assert(offsize >= 1 && offsize <= 4);
  1128. stbtt__buf_skip(&b, i*offsize);
  1129. start = stbtt__buf_get(&b, offsize);
  1130. end = stbtt__buf_get(&b, offsize);
  1131. return stbtt__buf_range(&b, 2+(count+1)*offsize+start, end - start);
  1132. }
  1133. //////////////////////////////////////////////////////////////////////////
  1134. //
  1135. // accessors to parse data from file
  1136. //
  1137. // on platforms that don't allow misaligned reads, if we want to allow
  1138. // truetype fonts that aren't padded to alignment, define ALLOW_UNALIGNED_TRUETYPE
  1139. #define ttBYTE(p) (* (stbtt_uint8 *) (p))
  1140. #define ttCHAR(p) (* (stbtt_int8 *) (p))
  1141. #define ttFixed(p) ttLONG(p)
  1142. static stbtt_uint16 ttUSHORT(stbtt_uint8 *p) { return p[0]*256 + p[1]; }
  1143. static stbtt_int16 ttSHORT(stbtt_uint8 *p) { return p[0]*256 + p[1]; }
  1144. static stbtt_uint32 ttULONG(stbtt_uint8 *p) { return (p[0]<<24) + (p[1]<<16) + (p[2]<<8) + p[3]; }
  1145. static stbtt_int32 ttLONG(stbtt_uint8 *p) { return (p[0]<<24) + (p[1]<<16) + (p[2]<<8) + p[3]; }
  1146. #define stbtt_tag4(p,c0,c1,c2,c3) ((p)[0] == (c0) && (p)[1] == (c1) && (p)[2] == (c2) && (p)[3] == (c3))
  1147. #define stbtt_tag(p,str) stbtt_tag4(p,str[0],str[1],str[2],str[3])
  1148. static int stbtt__isfont(stbtt_uint8 *font)
  1149. {
  1150. // check the version number
  1151. if (stbtt_tag4(font, '1',0,0,0)) return 1; // TrueType 1
  1152. if (stbtt_tag(font, "typ1")) return 1; // TrueType with type 1 font -- we don't support this!
  1153. if (stbtt_tag(font, "OTTO")) return 1; // OpenType with CFF
  1154. if (stbtt_tag4(font, 0,1,0,0)) return 1; // OpenType 1.0
  1155. if (stbtt_tag(font, "true")) return 1; // Apple specification for TrueType fonts
  1156. return 0;
  1157. }
  1158. // @OPTIMIZE: binary search
  1159. static stbtt_uint32 stbtt__find_table(stbtt_uint8 *data, stbtt_uint32 fontstart, const char *tag)
  1160. {
  1161. stbtt_int32 num_tables = ttUSHORT(data+fontstart+4);
  1162. stbtt_uint32 tabledir = fontstart + 12;
  1163. stbtt_int32 i;
  1164. for (i=0; i < num_tables; ++i) {
  1165. stbtt_uint32 loc = tabledir + 16*i;
  1166. if (stbtt_tag(data+loc+0, tag))
  1167. return ttULONG(data+loc+8);
  1168. }
  1169. return 0;
  1170. }
  1171. static int stbtt_GetFontOffsetForIndex_internal(unsigned char *font_collection, int index)
  1172. {
  1173. // if it's just a font, there's only one valid index
  1174. if (stbtt__isfont(font_collection))
  1175. return index == 0 ? 0 : -1;
  1176. // check if it's a TTC
  1177. if (stbtt_tag(font_collection, "ttcf")) {
  1178. // version 1?
  1179. if (ttULONG(font_collection+4) == 0x00010000 || ttULONG(font_collection+4) == 0x00020000) {
  1180. stbtt_int32 n = ttLONG(font_collection+8);
  1181. if (index >= n)
  1182. return -1;
  1183. return ttULONG(font_collection+12+index*4);
  1184. }
  1185. }
  1186. return -1;
  1187. }
  1188. static int stbtt_GetNumberOfFonts_internal(unsigned char *font_collection)
  1189. {
  1190. // if it's just a font, there's only one valid font
  1191. if (stbtt__isfont(font_collection))
  1192. return 1;
  1193. // check if it's a TTC
  1194. if (stbtt_tag(font_collection, "ttcf")) {
  1195. // version 1?
  1196. if (ttULONG(font_collection+4) == 0x00010000 || ttULONG(font_collection+4) == 0x00020000) {
  1197. return ttLONG(font_collection+8);
  1198. }
  1199. }
  1200. return 0;
  1201. }
  1202. static stbtt__buf stbtt__get_subrs(stbtt__buf cff, stbtt__buf fontdict)
  1203. {
  1204. stbtt_uint32 subrsoff = 0, private_loc[2] = { 0, 0 };
  1205. stbtt__buf pdict;
  1206. stbtt__dict_get_ints(&fontdict, 18, 2, private_loc);
  1207. if (!private_loc[1] || !private_loc[0]) return stbtt__new_buf(NULL, 0);
  1208. pdict = stbtt__buf_range(&cff, private_loc[1], private_loc[0]);
  1209. stbtt__dict_get_ints(&pdict, 19, 1, &subrsoff);
  1210. if (!subrsoff) return stbtt__new_buf(NULL, 0);
  1211. stbtt__buf_seek(&cff, private_loc[1]+subrsoff);
  1212. return stbtt__cff_get_index(&cff);
  1213. }
  1214. // since most people won't use this, find this table the first time it's needed
  1215. static int stbtt__get_svg(stbtt_fontinfo *info)
  1216. {
  1217. stbtt_uint32 t;
  1218. if (info->svg < 0) {
  1219. t = stbtt__find_table(info->data, info->fontstart, "SVG ");
  1220. if (t) {
  1221. stbtt_uint32 offset = ttULONG(info->data + t + 2);
  1222. info->svg = t + offset;
  1223. } else {
  1224. info->svg = 0;
  1225. }
  1226. }
  1227. return info->svg;
  1228. }
  1229. static int stbtt_InitFont_internal(stbtt_fontinfo *info, unsigned char *data, int fontstart)
  1230. {
  1231. stbtt_uint32 cmap, t;
  1232. stbtt_int32 i,numTables;
  1233. info->data = data;
  1234. info->fontstart = fontstart;
  1235. info->cff = stbtt__new_buf(NULL, 0);
  1236. cmap = stbtt__find_table(data, fontstart, "cmap"); // required
  1237. info->loca = stbtt__find_table(data, fontstart, "loca"); // required
  1238. info->head = stbtt__find_table(data, fontstart, "head"); // required
  1239. info->glyf = stbtt__find_table(data, fontstart, "glyf"); // required
  1240. info->hhea = stbtt__find_table(data, fontstart, "hhea"); // required
  1241. info->hmtx = stbtt__find_table(data, fontstart, "hmtx"); // required
  1242. info->kern = stbtt__find_table(data, fontstart, "kern"); // not required
  1243. info->gpos = stbtt__find_table(data, fontstart, "GPOS"); // not required
  1244. if (!cmap || !info->head || !info->hhea || !info->hmtx)
  1245. return 0;
  1246. if (info->glyf) {
  1247. // required for truetype
  1248. if (!info->loca) return 0;
  1249. } else {
  1250. // initialization for CFF / Type2 fonts (OTF)
  1251. stbtt__buf b, topdict, topdictidx;
  1252. stbtt_uint32 cstype = 2, charstrings = 0, fdarrayoff = 0, fdselectoff = 0;
  1253. stbtt_uint32 cff;
  1254. cff = stbtt__find_table(data, fontstart, "CFF ");
  1255. if (!cff) return 0;
  1256. info->fontdicts = stbtt__new_buf(NULL, 0);
  1257. info->fdselect = stbtt__new_buf(NULL, 0);
  1258. // @TODO this should use size from table (not 512MB)
  1259. info->cff = stbtt__new_buf(data+cff, 512*1024*1024);
  1260. b = info->cff;
  1261. // read the header
  1262. stbtt__buf_skip(&b, 2);
  1263. stbtt__buf_seek(&b, stbtt__buf_get8(&b)); // hdrsize
  1264. // @TODO the name INDEX could list multiple fonts,
  1265. // but we just use the first one.
  1266. stbtt__cff_get_index(&b); // name INDEX
  1267. topdictidx = stbtt__cff_get_index(&b);
  1268. topdict = stbtt__cff_index_get(topdictidx, 0);
  1269. stbtt__cff_get_index(&b); // string INDEX
  1270. info->gsubrs = stbtt__cff_get_index(&b);
  1271. stbtt__dict_get_ints(&topdict, 17, 1, &charstrings);
  1272. stbtt__dict_get_ints(&topdict, 0x100 | 6, 1, &cstype);
  1273. stbtt__dict_get_ints(&topdict, 0x100 | 36, 1, &fdarrayoff);
  1274. stbtt__dict_get_ints(&topdict, 0x100 | 37, 1, &fdselectoff);
  1275. info->subrs = stbtt__get_subrs(b, topdict);
  1276. // we only support Type 2 charstrings
  1277. if (cstype != 2) return 0;
  1278. if (charstrings == 0) return 0;
  1279. if (fdarrayoff) {
  1280. // looks like a CID font
  1281. if (!fdselectoff) return 0;
  1282. stbtt__buf_seek(&b, fdarrayoff);
  1283. info->fontdicts = stbtt__cff_get_index(&b);
  1284. info->fdselect = stbtt__buf_range(&b, fdselectoff, b.size-fdselectoff);
  1285. }
  1286. stbtt__buf_seek(&b, charstrings);
  1287. info->charstrings = stbtt__cff_get_index(&b);
  1288. }
  1289. t = stbtt__find_table(data, fontstart, "maxp");
  1290. if (t)
  1291. info->numGlyphs = ttUSHORT(data+t+4);
  1292. else
  1293. info->numGlyphs = 0xffff;
  1294. info->svg = -1;
  1295. // find a cmap encoding table we understand *now* to avoid searching
  1296. // later. (todo: could make this installable)
  1297. // the same regardless of glyph.
  1298. numTables = ttUSHORT(data + cmap + 2);
  1299. info->index_map = 0;
  1300. for (i=0; i < numTables; ++i) {
  1301. stbtt_uint32 encoding_record = cmap + 4 + 8 * i;
  1302. // find an encoding we understand:
  1303. switch(ttUSHORT(data+encoding_record)) {
  1304. case STBTT_PLATFORM_ID_MICROSOFT:
  1305. switch (ttUSHORT(data+encoding_record+2)) {
  1306. case STBTT_MS_EID_UNICODE_BMP:
  1307. case STBTT_MS_EID_UNICODE_FULL:
  1308. // MS/Unicode
  1309. info->index_map = cmap + ttULONG(data+encoding_record+4);
  1310. break;
  1311. }
  1312. break;
  1313. case STBTT_PLATFORM_ID_UNICODE:
  1314. // Mac/iOS has these
  1315. // all the encodingIDs are unicode, so we don't bother to check it
  1316. info->index_map = cmap + ttULONG(data+encoding_record+4);
  1317. break;
  1318. }
  1319. }
  1320. if (info->index_map == 0)
  1321. return 0;
  1322. info->indexToLocFormat = ttUSHORT(data+info->head + 50);
  1323. return 1;
  1324. }
  1325. STBTT_DEF int stbtt_FindGlyphIndex(const stbtt_fontinfo *info, int unicode_codepoint)
  1326. {
  1327. stbtt_uint8 *data = info->data;
  1328. stbtt_uint32 index_map = info->index_map;
  1329. stbtt_uint16 format = ttUSHORT(data + index_map + 0);
  1330. if (format == 0) { // apple byte encoding
  1331. stbtt_int32 bytes = ttUSHORT(data + index_map + 2);
  1332. if (unicode_codepoint < bytes-6)
  1333. return ttBYTE(data + index_map + 6 + unicode_codepoint);
  1334. return 0;
  1335. } else if (format == 6) {
  1336. stbtt_uint32 first = ttUSHORT(data + index_map + 6);
  1337. stbtt_uint32 count = ttUSHORT(data + index_map + 8);
  1338. if ((stbtt_uint32) unicode_codepoint >= first && (stbtt_uint32) unicode_codepoint < first+count)
  1339. return ttUSHORT(data + index_map + 10 + (unicode_codepoint - first)*2);
  1340. return 0;
  1341. } else if (format == 2) {
  1342. STBTT_assert(0); // @TODO: high-byte mapping for japanese/chinese/korean
  1343. return 0;
  1344. } else if (format == 4) { // standard mapping for windows fonts: binary search collection of ranges
  1345. stbtt_uint16 segcount = ttUSHORT(data+index_map+6) >> 1;
  1346. stbtt_uint16 searchRange = ttUSHORT(data+index_map+8) >> 1;
  1347. stbtt_uint16 entrySelector = ttUSHORT(data+index_map+10);
  1348. stbtt_uint16 rangeShift = ttUSHORT(data+index_map+12) >> 1;
  1349. // do a binary search of the segments
  1350. stbtt_uint32 endCount = index_map + 14;
  1351. stbtt_uint32 search = endCount;
  1352. if (unicode_codepoint > 0xffff)
  1353. return 0;
  1354. // they lie from endCount .. endCount + segCount
  1355. // but searchRange is the nearest power of two, so...
  1356. if (unicode_codepoint >= ttUSHORT(data + search + rangeShift*2))
  1357. search += rangeShift*2;
  1358. // now decrement to bias correctly to find smallest
  1359. search -= 2;
  1360. while (entrySelector) {
  1361. stbtt_uint16 end;
  1362. searchRange >>= 1;
  1363. end = ttUSHORT(data + search + searchRange*2);
  1364. if (unicode_codepoint > end)
  1365. search += searchRange*2;
  1366. --entrySelector;
  1367. }
  1368. search += 2;
  1369. {
  1370. stbtt_uint16 offset, start, last;
  1371. stbtt_uint16 item = (stbtt_uint16) ((search - endCount) >> 1);
  1372. start = ttUSHORT(data + index_map + 14 + segcount*2 + 2 + 2*item);
  1373. last = ttUSHORT(data + endCount + 2*item);
  1374. if (unicode_codepoint < start || unicode_codepoint > last)
  1375. return 0;
  1376. offset = ttUSHORT(data + index_map + 14 + segcount*6 + 2 + 2*item);
  1377. if (offset == 0)
  1378. return (stbtt_uint16) (unicode_codepoint + ttSHORT(data + index_map + 14 + segcount*4 + 2 + 2*item));
  1379. return ttUSHORT(data + offset + (unicode_codepoint-start)*2 + index_map + 14 + segcount*6 + 2 + 2*item);
  1380. }
  1381. } else if (format == 12 || format == 13) {
  1382. stbtt_uint32 ngroups = ttULONG(data+index_map+12);
  1383. stbtt_int32 low,high;
  1384. low = 0; high = (stbtt_int32)ngroups;
  1385. // Binary search the right group.
  1386. while (low < high) {
  1387. stbtt_int32 mid = low + ((high-low) >> 1); // rounds down, so low <= mid < high
  1388. stbtt_uint32 start_char = ttULONG(data+index_map+16+mid*12);
  1389. stbtt_uint32 end_char = ttULONG(data+index_map+16+mid*12+4);
  1390. if ((stbtt_uint32) unicode_codepoint < start_char)
  1391. high = mid;
  1392. else if ((stbtt_uint32) unicode_codepoint > end_char)
  1393. low = mid+1;
  1394. else {
  1395. stbtt_uint32 start_glyph = ttULONG(data+index_map+16+mid*12+8);
  1396. if (format == 12)
  1397. return start_glyph + unicode_codepoint-start_char;
  1398. else // format == 13
  1399. return start_glyph;
  1400. }
  1401. }
  1402. return 0; // not found
  1403. }
  1404. // @TODO
  1405. STBTT_assert(0);
  1406. return 0;
  1407. }
  1408. STBTT_DEF int stbtt_GetCodepointShape(const stbtt_fontinfo *info, int unicode_codepoint, stbtt_vertex **vertices)
  1409. {
  1410. return stbtt_GetGlyphShape(info, stbtt_FindGlyphIndex(info, unicode_codepoint), vertices);
  1411. }
  1412. static void stbtt_setvertex(stbtt_vertex *v, stbtt_uint8 type, stbtt_int32 x, stbtt_int32 y, stbtt_int32 cx, stbtt_int32 cy)
  1413. {
  1414. v->type = type;
  1415. v->x = (stbtt_int16) x;
  1416. v->y = (stbtt_int16) y;
  1417. v->cx = (stbtt_int16) cx;
  1418. v->cy = (stbtt_int16) cy;
  1419. }
  1420. static int stbtt__GetGlyfOffset(const stbtt_fontinfo *info, int glyph_index)
  1421. {
  1422. int g1,g2;
  1423. STBTT_assert(!info->cff.size);
  1424. if (glyph_index >= info->numGlyphs) return -1; // glyph index out of range
  1425. if (info->indexToLocFormat >= 2) return -1; // unknown index->glyph map format
  1426. if (info->indexToLocFormat == 0) {
  1427. g1 = info->glyf + ttUSHORT(info->data + info->loca + glyph_index * 2) * 2;
  1428. g2 = info->glyf + ttUSHORT(info->data + info->loca + glyph_index * 2 + 2) * 2;
  1429. } else {
  1430. g1 = info->glyf + ttULONG (info->data + info->loca + glyph_index * 4);
  1431. g2 = info->glyf + ttULONG (info->data + info->loca + glyph_index * 4 + 4);
  1432. }
  1433. return g1==g2 ? -1 : g1; // if length is 0, return -1
  1434. }
  1435. static int stbtt__GetGlyphInfoT2(const stbtt_fontinfo *info, int glyph_index, int *x0, int *y0, int *x1, int *y1);
  1436. STBTT_DEF int stbtt_GetGlyphBox(const stbtt_fontinfo *info, int glyph_index, int *x0, int *y0, int *x1, int *y1)
  1437. {
  1438. if (info->cff.size) {
  1439. stbtt__GetGlyphInfoT2(info, glyph_index, x0, y0, x1, y1);
  1440. } else {
  1441. int g = stbtt__GetGlyfOffset(info, glyph_index);
  1442. if (g < 0) return 0;
  1443. if (x0) *x0 = ttSHORT(info->data + g + 2);
  1444. if (y0) *y0 = ttSHORT(info->data + g + 4);
  1445. if (x1) *x1 = ttSHORT(info->data + g + 6);
  1446. if (y1) *y1 = ttSHORT(info->data + g + 8);
  1447. }
  1448. return 1;
  1449. }
  1450. STBTT_DEF int stbtt_GetCodepointBox(const stbtt_fontinfo *info, int codepoint, int *x0, int *y0, int *x1, int *y1)
  1451. {
  1452. return stbtt_GetGlyphBox(info, stbtt_FindGlyphIndex(info,codepoint), x0,y0,x1,y1);
  1453. }
  1454. STBTT_DEF int stbtt_IsGlyphEmpty(const stbtt_fontinfo *info, int glyph_index)
  1455. {
  1456. stbtt_int16 numberOfContours;
  1457. int g;
  1458. if (info->cff.size)
  1459. return stbtt__GetGlyphInfoT2(info, glyph_index, NULL, NULL, NULL, NULL) == 0;
  1460. g = stbtt__GetGlyfOffset(info, glyph_index);
  1461. if (g < 0) return 1;
  1462. numberOfContours = ttSHORT(info->data + g);
  1463. return numberOfContours == 0;
  1464. }
  1465. static int stbtt__close_shape(stbtt_vertex *vertices, int num_vertices, int was_off, int start_off,
  1466. stbtt_int32 sx, stbtt_int32 sy, stbtt_int32 scx, stbtt_int32 scy, stbtt_int32 cx, stbtt_int32 cy)
  1467. {
  1468. if (start_off) {
  1469. if (was_off)
  1470. stbtt_setvertex(&vertices[num_vertices++], STBTT_vcurve, (cx+scx)>>1, (cy+scy)>>1, cx,cy);
  1471. stbtt_setvertex(&vertices[num_vertices++], STBTT_vcurve, sx,sy,scx,scy);
  1472. } else {
  1473. if (was_off)
  1474. stbtt_setvertex(&vertices[num_vertices++], STBTT_vcurve,sx,sy,cx,cy);
  1475. else
  1476. stbtt_setvertex(&vertices[num_vertices++], STBTT_vline,sx,sy,0,0);
  1477. }
  1478. return num_vertices;
  1479. }
  1480. static int stbtt__GetGlyphShapeTT(const stbtt_fontinfo *info, int glyph_index, stbtt_vertex **pvertices)
  1481. {
  1482. stbtt_int16 numberOfContours;
  1483. stbtt_uint8 *endPtsOfContours;
  1484. stbtt_uint8 *data = info->data;
  1485. stbtt_vertex *vertices=0;
  1486. int num_vertices=0;
  1487. int g = stbtt__GetGlyfOffset(info, glyph_index);
  1488. *pvertices = NULL;
  1489. if (g < 0) return 0;
  1490. numberOfContours = ttSHORT(data + g);
  1491. if (numberOfContours > 0) {
  1492. stbtt_uint8 flags=0,flagcount;
  1493. stbtt_int32 ins, i,j=0,m,n, next_move, was_off=0, off, start_off=0;
  1494. stbtt_int32 x,y,cx,cy,sx,sy, scx,scy;
  1495. stbtt_uint8 *points;
  1496. endPtsOfContours = (data + g + 10);
  1497. ins = ttUSHORT(data + g + 10 + numberOfContours * 2);
  1498. points = data + g + 10 + numberOfContours * 2 + 2 + ins;
  1499. n = 1+ttUSHORT(endPtsOfContours + numberOfContours*2-2);
  1500. m = n + 2*numberOfContours; // a loose bound on how many vertices we might need
  1501. vertices = (stbtt_vertex *) STBTT_malloc(m * sizeof(vertices[0]), info->userdata);
  1502. if (vertices == 0)
  1503. return 0;
  1504. next_move = 0;
  1505. flagcount=0;
  1506. // in first pass, we load uninterpreted data into the allocated array
  1507. // above, shifted to the end of the array so we won't overwrite it when
  1508. // we create our final data starting from the front
  1509. off = m - n; // starting offset for uninterpreted data, regardless of how m ends up being calculated
  1510. // first load flags
  1511. for (i=0; i < n; ++i) {
  1512. if (flagcount == 0) {
  1513. flags = *points++;
  1514. if (flags & 8)
  1515. flagcount = *points++;
  1516. } else
  1517. --flagcount;
  1518. vertices[off+i].type = flags;
  1519. }
  1520. // now load x coordinates
  1521. x=0;
  1522. for (i=0; i < n; ++i) {
  1523. flags = vertices[off+i].type;
  1524. if (flags & 2) {
  1525. stbtt_int16 dx = *points++;
  1526. x += (flags & 16) ? dx : -dx; // ???
  1527. } else {
  1528. if (!(flags & 16)) {
  1529. x = x + (stbtt_int16) (points[0]*256 + points[1]);
  1530. points += 2;
  1531. }
  1532. }
  1533. vertices[off+i].x = (stbtt_int16) x;
  1534. }
  1535. // now load y coordinates
  1536. y=0;
  1537. for (i=0; i < n; ++i) {
  1538. flags = vertices[off+i].type;
  1539. if (flags & 4) {
  1540. stbtt_int16 dy = *points++;
  1541. y += (flags & 32) ? dy : -dy; // ???
  1542. } else {
  1543. if (!(flags & 32)) {
  1544. y = y + (stbtt_int16) (points[0]*256 + points[1]);
  1545. points += 2;
  1546. }
  1547. }
  1548. vertices[off+i].y = (stbtt_int16) y;
  1549. }
  1550. // now convert them to our format
  1551. num_vertices=0;
  1552. sx = sy = cx = cy = scx = scy = 0;
  1553. for (i=0; i < n; ++i) {
  1554. flags = vertices[off+i].type;
  1555. x = (stbtt_int16) vertices[off+i].x;
  1556. y = (stbtt_int16) vertices[off+i].y;
  1557. if (next_move == i) {
  1558. if (i != 0)
  1559. num_vertices = stbtt__close_shape(vertices, num_vertices, was_off, start_off, sx,sy,scx,scy,cx,cy);
  1560. // now start the new one
  1561. start_off = !(flags & 1);
  1562. if (start_off) {
  1563. // if we start off with an off-curve point, then when we need to find a point on the curve
  1564. // where we can start, and we need to save some state for when we wraparound.
  1565. scx = x;
  1566. scy = y;
  1567. if (!(vertices[off+i+1].type & 1)) {
  1568. // next point is also a curve point, so interpolate an on-point curve
  1569. sx = (x + (stbtt_int32) vertices[off+i+1].x) >> 1;
  1570. sy = (y + (stbtt_int32) vertices[off+i+1].y) >> 1;
  1571. } else {
  1572. // otherwise just use the next point as our start point
  1573. sx = (stbtt_int32) vertices[off+i+1].x;
  1574. sy = (stbtt_int32) vertices[off+i+1].y;
  1575. ++i; // we're using point i+1 as the starting point, so skip it
  1576. }
  1577. } else {
  1578. sx = x;
  1579. sy = y;
  1580. }
  1581. stbtt_setvertex(&vertices[num_vertices++], STBTT_vmove,sx,sy,0,0);
  1582. was_off = 0;
  1583. next_move = 1 + ttUSHORT(endPtsOfContours+j*2);
  1584. ++j;
  1585. } else {
  1586. if (!(flags & 1)) { // if it's a curve
  1587. if (was_off) // two off-curve control points in a row means interpolate an on-curve midpoint
  1588. stbtt_setvertex(&vertices[num_vertices++], STBTT_vcurve, (cx+x)>>1, (cy+y)>>1, cx, cy);
  1589. cx = x;
  1590. cy = y;
  1591. was_off = 1;
  1592. } else {
  1593. if (was_off)
  1594. stbtt_setvertex(&vertices[num_vertices++], STBTT_vcurve, x,y, cx, cy);
  1595. else
  1596. stbtt_setvertex(&vertices[num_vertices++], STBTT_vline, x,y,0,0);
  1597. was_off = 0;
  1598. }
  1599. }
  1600. }
  1601. num_vertices = stbtt__close_shape(vertices, num_vertices, was_off, start_off, sx,sy,scx,scy,cx,cy);
  1602. } else if (numberOfContours < 0) {
  1603. // Compound shapes.
  1604. int more = 1;
  1605. stbtt_uint8 *comp = data + g + 10;
  1606. num_vertices = 0;
  1607. vertices = 0;
  1608. while (more) {
  1609. stbtt_uint16 flags, gidx;
  1610. int comp_num_verts = 0, i;
  1611. stbtt_vertex *comp_verts = 0, *tmp = 0;
  1612. float mtx[6] = {1,0,0,1,0,0}, m, n;
  1613. flags = ttSHORT(comp); comp+=2;
  1614. gidx = ttSHORT(comp); comp+=2;
  1615. if (flags & 2) { // XY values
  1616. if (flags & 1) { // shorts
  1617. mtx[4] = ttSHORT(comp); comp+=2;
  1618. mtx[5] = ttSHORT(comp); comp+=2;
  1619. } else {
  1620. mtx[4] = ttCHAR(comp); comp+=1;
  1621. mtx[5] = ttCHAR(comp); comp+=1;
  1622. }
  1623. }
  1624. else {
  1625. // @TODO handle matching point
  1626. STBTT_assert(0);
  1627. }
  1628. if (flags & (1<<3)) { // WE_HAVE_A_SCALE
  1629. mtx[0] = mtx[3] = ttSHORT(comp)/16384.0f; comp+=2;
  1630. mtx[1] = mtx[2] = 0;
  1631. } else if (flags & (1<<6)) { // WE_HAVE_AN_X_AND_YSCALE
  1632. mtx[0] = ttSHORT(comp)/16384.0f; comp+=2;
  1633. mtx[1] = mtx[2] = 0;
  1634. mtx[3] = ttSHORT(comp)/16384.0f; comp+=2;
  1635. } else if (flags & (1<<7)) { // WE_HAVE_A_TWO_BY_TWO
  1636. mtx[0] = ttSHORT(comp)/16384.0f; comp+=2;
  1637. mtx[1] = ttSHORT(comp)/16384.0f; comp+=2;
  1638. mtx[2] = ttSHORT(comp)/16384.0f; comp+=2;
  1639. mtx[3] = ttSHORT(comp)/16384.0f; comp+=2;
  1640. }
  1641. // Find transformation scales.
  1642. m = (float) STBTT_sqrt(mtx[0]*mtx[0] + mtx[1]*mtx[1]);
  1643. n = (float) STBTT_sqrt(mtx[2]*mtx[2] + mtx[3]*mtx[3]);
  1644. // Get indexed glyph.
  1645. comp_num_verts = stbtt_GetGlyphShape(info, gidx, &comp_verts);
  1646. if (comp_num_verts > 0) {
  1647. // Transform vertices.
  1648. for (i = 0; i < comp_num_verts; ++i) {
  1649. stbtt_vertex* v = &comp_verts[i];
  1650. stbtt_vertex_type x,y;
  1651. x=v->x; y=v->y;
  1652. v->x = (stbtt_vertex_type)(m * (mtx[0]*x + mtx[2]*y + mtx[4]));
  1653. v->y = (stbtt_vertex_type)(n * (mtx[1]*x + mtx[3]*y + mtx[5]));
  1654. x=v->cx; y=v->cy;
  1655. v->cx = (stbtt_vertex_type)(m * (mtx[0]*x + mtx[2]*y + mtx[4]));
  1656. v->cy = (stbtt_vertex_type)(n * (mtx[1]*x + mtx[3]*y + mtx[5]));
  1657. }
  1658. // Append vertices.
  1659. tmp = (stbtt_vertex*)STBTT_malloc((num_vertices+comp_num_verts)*sizeof(stbtt_vertex), info->userdata);
  1660. if (!tmp) {
  1661. if (vertices) STBTT_free(vertices, info->userdata);
  1662. if (comp_verts) STBTT_free(comp_verts, info->userdata);
  1663. return 0;
  1664. }
  1665. if (num_vertices > 0 && vertices) STBTT_memcpy(tmp, vertices, num_vertices*sizeof(stbtt_vertex));
  1666. STBTT_memcpy(tmp+num_vertices, comp_verts, comp_num_verts*sizeof(stbtt_vertex));
  1667. if (vertices) STBTT_free(vertices, info->userdata);
  1668. vertices = tmp;
  1669. STBTT_free(comp_verts, info->userdata);
  1670. num_vertices += comp_num_verts;
  1671. }
  1672. // More components ?
  1673. more = flags & (1<<5);
  1674. }
  1675. } else {
  1676. // numberOfCounters == 0, do nothing
  1677. }
  1678. *pvertices = vertices;
  1679. return num_vertices;
  1680. }
  1681. typedef struct
  1682. {
  1683. int bounds;
  1684. int started;
  1685. float first_x, first_y;
  1686. float x, y;
  1687. stbtt_int32 min_x, max_x, min_y, max_y;
  1688. stbtt_vertex *pvertices;
  1689. int num_vertices;
  1690. } stbtt__csctx;
  1691. #define STBTT__CSCTX_INIT(bounds) {bounds,0, 0,0, 0,0, 0,0,0,0, NULL, 0}
  1692. static void stbtt__track_vertex(stbtt__csctx *c, stbtt_int32 x, stbtt_int32 y)
  1693. {
  1694. if (x > c->max_x || !c->started) c->max_x = x;
  1695. if (y > c->max_y || !c->started) c->max_y = y;
  1696. if (x < c->min_x || !c->started) c->min_x = x;
  1697. if (y < c->min_y || !c->started) c->min_y = y;
  1698. c->started = 1;
  1699. }
  1700. static void stbtt__csctx_v(stbtt__csctx *c, stbtt_uint8 type, stbtt_int32 x, stbtt_int32 y, stbtt_int32 cx, stbtt_int32 cy, stbtt_int32 cx1, stbtt_int32 cy1)
  1701. {
  1702. if (c->bounds) {
  1703. stbtt__track_vertex(c, x, y);
  1704. if (type == STBTT_vcubic) {
  1705. stbtt__track_vertex(c, cx, cy);
  1706. stbtt__track_vertex(c, cx1, cy1);
  1707. }
  1708. } else {
  1709. stbtt_setvertex(&c->pvertices[c->num_vertices], type, x, y, cx, cy);
  1710. c->pvertices[c->num_vertices].cx1 = (stbtt_int16) cx1;
  1711. c->pvertices[c->num_vertices].cy1 = (stbtt_int16) cy1;
  1712. }
  1713. c->num_vertices++;
  1714. }
  1715. static void stbtt__csctx_close_shape(stbtt__csctx *ctx)
  1716. {
  1717. if (ctx->first_x != ctx->x || ctx->first_y != ctx->y)
  1718. stbtt__csctx_v(ctx, STBTT_vline, (int)ctx->first_x, (int)ctx->first_y, 0, 0, 0, 0);
  1719. }
  1720. static void stbtt__csctx_rmove_to(stbtt__csctx *ctx, float dx, float dy)
  1721. {
  1722. stbtt__csctx_close_shape(ctx);
  1723. ctx->first_x = ctx->x = ctx->x + dx;
  1724. ctx->first_y = ctx->y = ctx->y + dy;
  1725. stbtt__csctx_v(ctx, STBTT_vmove, (int)ctx->x, (int)ctx->y, 0, 0, 0, 0);
  1726. }
  1727. static void stbtt__csctx_rline_to(stbtt__csctx *ctx, float dx, float dy)
  1728. {
  1729. ctx->x += dx;
  1730. ctx->y += dy;
  1731. stbtt__csctx_v(ctx, STBTT_vline, (int)ctx->x, (int)ctx->y, 0, 0, 0, 0);
  1732. }
  1733. static void stbtt__csctx_rccurve_to(stbtt__csctx *ctx, float dx1, float dy1, float dx2, float dy2, float dx3, float dy3)
  1734. {
  1735. float cx1 = ctx->x + dx1;
  1736. float cy1 = ctx->y + dy1;
  1737. float cx2 = cx1 + dx2;
  1738. float cy2 = cy1 + dy2;
  1739. ctx->x = cx2 + dx3;
  1740. ctx->y = cy2 + dy3;
  1741. stbtt__csctx_v(ctx, STBTT_vcubic, (int)ctx->x, (int)ctx->y, (int)cx1, (int)cy1, (int)cx2, (int)cy2);
  1742. }
  1743. static stbtt__buf stbtt__get_subr(stbtt__buf idx, int n)
  1744. {
  1745. int count = stbtt__cff_index_count(&idx);
  1746. int bias = 107;
  1747. if (count >= 33900)
  1748. bias = 32768;
  1749. else if (count >= 1240)
  1750. bias = 1131;
  1751. n += bias;
  1752. if (n < 0 || n >= count)
  1753. return stbtt__new_buf(NULL, 0);
  1754. return stbtt__cff_index_get(idx, n);
  1755. }
  1756. static stbtt__buf stbtt__cid_get_glyph_subrs(const stbtt_fontinfo *info, int glyph_index)
  1757. {
  1758. stbtt__buf fdselect = info->fdselect;
  1759. int nranges, start, end, v, fmt, fdselector = -1, i;
  1760. stbtt__buf_seek(&fdselect, 0);
  1761. fmt = stbtt__buf_get8(&fdselect);
  1762. if (fmt == 0) {
  1763. // untested
  1764. stbtt__buf_skip(&fdselect, glyph_index);
  1765. fdselector = stbtt__buf_get8(&fdselect);
  1766. } else if (fmt == 3) {
  1767. nranges = stbtt__buf_get16(&fdselect);
  1768. start = stbtt__buf_get16(&fdselect);
  1769. for (i = 0; i < nranges; i++) {
  1770. v = stbtt__buf_get8(&fdselect);
  1771. end = stbtt__buf_get16(&fdselect);
  1772. if (glyph_index >= start && glyph_index < end) {
  1773. fdselector = v;
  1774. break;
  1775. }
  1776. start = end;
  1777. }
  1778. }
  1779. if (fdselector == -1) stbtt__new_buf(NULL, 0);
  1780. return stbtt__get_subrs(info->cff, stbtt__cff_index_get(info->fontdicts, fdselector));
  1781. }
  1782. static int stbtt__run_charstring(const stbtt_fontinfo *info, int glyph_index, stbtt__csctx *c)
  1783. {
  1784. int in_header = 1, maskbits = 0, subr_stack_height = 0, sp = 0, v, i, b0;
  1785. int has_subrs = 0, clear_stack;
  1786. float s[48];
  1787. stbtt__buf subr_stack[10], subrs = info->subrs, b;
  1788. float f;
  1789. #define STBTT__CSERR(s) (0)
  1790. // this currently ignores the initial width value, which isn't needed if we have hmtx
  1791. b = stbtt__cff_index_get(info->charstrings, glyph_index);
  1792. while (b.cursor < b.size) {
  1793. i = 0;
  1794. clear_stack = 1;
  1795. b0 = stbtt__buf_get8(&b);
  1796. switch (b0) {
  1797. // @TODO implement hinting
  1798. case 0x13: // hintmask
  1799. case 0x14: // cntrmask
  1800. if (in_header)
  1801. maskbits += (sp / 2); // implicit "vstem"
  1802. in_header = 0;
  1803. stbtt__buf_skip(&b, (maskbits + 7) / 8);
  1804. break;
  1805. case 0x01: // hstem
  1806. case 0x03: // vstem
  1807. case 0x12: // hstemhm
  1808. case 0x17: // vstemhm
  1809. maskbits += (sp / 2);
  1810. break;
  1811. case 0x15: // rmoveto
  1812. in_header = 0;
  1813. if (sp < 2) return STBTT__CSERR("rmoveto stack");
  1814. stbtt__csctx_rmove_to(c, s[sp-2], s[sp-1]);
  1815. break;
  1816. case 0x04: // vmoveto
  1817. in_header = 0;
  1818. if (sp < 1) return STBTT__CSERR("vmoveto stack");
  1819. stbtt__csctx_rmove_to(c, 0, s[sp-1]);
  1820. break;
  1821. case 0x16: // hmoveto
  1822. in_header = 0;
  1823. if (sp < 1) return STBTT__CSERR("hmoveto stack");
  1824. stbtt__csctx_rmove_to(c, s[sp-1], 0);
  1825. break;
  1826. case 0x05: // rlineto
  1827. if (sp < 2) return STBTT__CSERR("rlineto stack");
  1828. for (; i + 1 < sp; i += 2)
  1829. stbtt__csctx_rline_to(c, s[i], s[i+1]);
  1830. break;
  1831. // hlineto/vlineto and vhcurveto/hvcurveto alternate horizontal and vertical
  1832. // starting from a different place.
  1833. case 0x07: // vlineto
  1834. if (sp < 1) return STBTT__CSERR("vlineto stack");
  1835. goto vlineto;
  1836. case 0x06: // hlineto
  1837. if (sp < 1) return STBTT__CSERR("hlineto stack");
  1838. for (;;) {
  1839. if (i >= sp) break;
  1840. stbtt__csctx_rline_to(c, s[i], 0);
  1841. i++;
  1842. vlineto:
  1843. if (i >= sp) break;
  1844. stbtt__csctx_rline_to(c, 0, s[i]);
  1845. i++;
  1846. }
  1847. break;
  1848. case 0x1F: // hvcurveto
  1849. if (sp < 4) return STBTT__CSERR("hvcurveto stack");
  1850. goto hvcurveto;
  1851. case 0x1E: // vhcurveto
  1852. if (sp < 4) return STBTT__CSERR("vhcurveto stack");
  1853. for (;;) {
  1854. if (i + 3 >= sp) break;
  1855. stbtt__csctx_rccurve_to(c, 0, s[i], s[i+1], s[i+2], s[i+3], (sp - i == 5) ? s[i + 4] : 0.0f);
  1856. i += 4;
  1857. hvcurveto:
  1858. if (i + 3 >= sp) break;
  1859. stbtt__csctx_rccurve_to(c, s[i], 0, s[i+1], s[i+2], (sp - i == 5) ? s[i+4] : 0.0f, s[i+3]);
  1860. i += 4;
  1861. }
  1862. break;
  1863. case 0x08: // rrcurveto
  1864. if (sp < 6) return STBTT__CSERR("rcurveline stack");
  1865. for (; i + 5 < sp; i += 6)
  1866. stbtt__csctx_rccurve_to(c, s[i], s[i+1], s[i+2], s[i+3], s[i+4], s[i+5]);
  1867. break;
  1868. case 0x18: // rcurveline
  1869. if (sp < 8) return STBTT__CSERR("rcurveline stack");
  1870. for (; i + 5 < sp - 2; i += 6)
  1871. stbtt__csctx_rccurve_to(c, s[i], s[i+1], s[i+2], s[i+3], s[i+4], s[i+5]);
  1872. if (i + 1 >= sp) return STBTT__CSERR("rcurveline stack");
  1873. stbtt__csctx_rline_to(c, s[i], s[i+1]);
  1874. break;
  1875. case 0x19: // rlinecurve
  1876. if (sp < 8) return STBTT__CSERR("rlinecurve stack");
  1877. for (; i + 1 < sp - 6; i += 2)
  1878. stbtt__csctx_rline_to(c, s[i], s[i+1]);
  1879. if (i + 5 >= sp) return STBTT__CSERR("rlinecurve stack");
  1880. stbtt__csctx_rccurve_to(c, s[i], s[i+1], s[i+2], s[i+3], s[i+4], s[i+5]);
  1881. break;
  1882. case 0x1A: // vvcurveto
  1883. case 0x1B: // hhcurveto
  1884. if (sp < 4) return STBTT__CSERR("(vv|hh)curveto stack");
  1885. f = 0.0;
  1886. if (sp & 1) { f = s[i]; i++; }
  1887. for (; i + 3 < sp; i += 4) {
  1888. if (b0 == 0x1B)
  1889. stbtt__csctx_rccurve_to(c, s[i], f, s[i+1], s[i+2], s[i+3], 0.0);
  1890. else
  1891. stbtt__csctx_rccurve_to(c, f, s[i], s[i+1], s[i+2], 0.0, s[i+3]);
  1892. f = 0.0;
  1893. }
  1894. break;
  1895. case 0x0A: // callsubr
  1896. if (!has_subrs) {
  1897. if (info->fdselect.size)
  1898. subrs = stbtt__cid_get_glyph_subrs(info, glyph_index);
  1899. has_subrs = 1;
  1900. }
  1901. // FALLTHROUGH
  1902. case 0x1D: // callgsubr
  1903. if (sp < 1) return STBTT__CSERR("call(g|)subr stack");
  1904. v = (int) s[--sp];
  1905. if (subr_stack_height >= 10) return STBTT__CSERR("recursion limit");
  1906. subr_stack[subr_stack_height++] = b;
  1907. b = stbtt__get_subr(b0 == 0x0A ? subrs : info->gsubrs, v);
  1908. if (b.size == 0) return STBTT__CSERR("subr not found");
  1909. b.cursor = 0;
  1910. clear_stack = 0;
  1911. break;
  1912. case 0x0B: // return
  1913. if (subr_stack_height <= 0) return STBTT__CSERR("return outside subr");
  1914. b = subr_stack[--subr_stack_height];
  1915. clear_stack = 0;
  1916. break;
  1917. case 0x0E: // endchar
  1918. stbtt__csctx_close_shape(c);
  1919. return 1;
  1920. case 0x0C: { // two-byte escape
  1921. float dx1, dx2, dx3, dx4, dx5, dx6, dy1, dy2, dy3, dy4, dy5, dy6;
  1922. float dx, dy;
  1923. int b1 = stbtt__buf_get8(&b);
  1924. switch (b1) {
  1925. // @TODO These "flex" implementations ignore the flex-depth and resolution,
  1926. // and always draw beziers.
  1927. case 0x22: // hflex
  1928. if (sp < 7) return STBTT__CSERR("hflex stack");
  1929. dx1 = s[0];
  1930. dx2 = s[1];
  1931. dy2 = s[2];
  1932. dx3 = s[3];
  1933. dx4 = s[4];
  1934. dx5 = s[5];
  1935. dx6 = s[6];
  1936. stbtt__csctx_rccurve_to(c, dx1, 0, dx2, dy2, dx3, 0);
  1937. stbtt__csctx_rccurve_to(c, dx4, 0, dx5, -dy2, dx6, 0);
  1938. break;
  1939. case 0x23: // flex
  1940. if (sp < 13) return STBTT__CSERR("flex stack");
  1941. dx1 = s[0];
  1942. dy1 = s[1];
  1943. dx2 = s[2];
  1944. dy2 = s[3];
  1945. dx3 = s[4];
  1946. dy3 = s[5];
  1947. dx4 = s[6];
  1948. dy4 = s[7];
  1949. dx5 = s[8];
  1950. dy5 = s[9];
  1951. dx6 = s[10];
  1952. dy6 = s[11];
  1953. //fd is s[12]
  1954. stbtt__csctx_rccurve_to(c, dx1, dy1, dx2, dy2, dx3, dy3);
  1955. stbtt__csctx_rccurve_to(c, dx4, dy4, dx5, dy5, dx6, dy6);
  1956. break;
  1957. case 0x24: // hflex1
  1958. if (sp < 9) return STBTT__CSERR("hflex1 stack");
  1959. dx1 = s[0];
  1960. dy1 = s[1];
  1961. dx2 = s[2];
  1962. dy2 = s[3];
  1963. dx3 = s[4];
  1964. dx4 = s[5];
  1965. dx5 = s[6];
  1966. dy5 = s[7];
  1967. dx6 = s[8];
  1968. stbtt__csctx_rccurve_to(c, dx1, dy1, dx2, dy2, dx3, 0);
  1969. stbtt__csctx_rccurve_to(c, dx4, 0, dx5, dy5, dx6, -(dy1+dy2+dy5));
  1970. break;
  1971. case 0x25: // flex1
  1972. if (sp < 11) return STBTT__CSERR("flex1 stack");
  1973. dx1 = s[0];
  1974. dy1 = s[1];
  1975. dx2 = s[2];
  1976. dy2 = s[3];
  1977. dx3 = s[4];
  1978. dy3 = s[5];
  1979. dx4 = s[6];
  1980. dy4 = s[7];
  1981. dx5 = s[8];
  1982. dy5 = s[9];
  1983. dx6 = dy6 = s[10];
  1984. dx = dx1+dx2+dx3+dx4+dx5;
  1985. dy = dy1+dy2+dy3+dy4+dy5;
  1986. if (STBTT_fabs(dx) > STBTT_fabs(dy))
  1987. dy6 = -dy;
  1988. else
  1989. dx6 = -dx;
  1990. stbtt__csctx_rccurve_to(c, dx1, dy1, dx2, dy2, dx3, dy3);
  1991. stbtt__csctx_rccurve_to(c, dx4, dy4, dx5, dy5, dx6, dy6);
  1992. break;
  1993. default:
  1994. return STBTT__CSERR("unimplemented");
  1995. }
  1996. } break;
  1997. default:
  1998. if (b0 != 255 && b0 != 28 && b0 < 32)
  1999. return STBTT__CSERR("reserved operator");
  2000. // push immediate
  2001. if (b0 == 255) {
  2002. f = (float)(stbtt_int32)stbtt__buf_get32(&b) / 0x10000;
  2003. } else {
  2004. stbtt__buf_skip(&b, -1);
  2005. f = (float)(stbtt_int16)stbtt__cff_int(&b);
  2006. }
  2007. if (sp >= 48) return STBTT__CSERR("push stack overflow");
  2008. s[sp++] = f;
  2009. clear_stack = 0;
  2010. break;
  2011. }
  2012. if (clear_stack) sp = 0;
  2013. }
  2014. return STBTT__CSERR("no endchar");
  2015. #undef STBTT__CSERR
  2016. }
  2017. static int stbtt__GetGlyphShapeT2(const stbtt_fontinfo *info, int glyph_index, stbtt_vertex **pvertices)
  2018. {
  2019. // runs the charstring twice, once to count and once to output (to avoid realloc)
  2020. stbtt__csctx count_ctx = STBTT__CSCTX_INIT(1);
  2021. stbtt__csctx output_ctx = STBTT__CSCTX_INIT(0);
  2022. if (stbtt__run_charstring(info, glyph_index, &count_ctx)) {
  2023. *pvertices = (stbtt_vertex*)STBTT_malloc(count_ctx.num_vertices*sizeof(stbtt_vertex), info->userdata);
  2024. output_ctx.pvertices = *pvertices;
  2025. if (stbtt__run_charstring(info, glyph_index, &output_ctx)) {
  2026. STBTT_assert(output_ctx.num_vertices == count_ctx.num_vertices);
  2027. return output_ctx.num_vertices;
  2028. }
  2029. }
  2030. *pvertices = NULL;
  2031. return 0;
  2032. }
  2033. static int stbtt__GetGlyphInfoT2(const stbtt_fontinfo *info, int glyph_index, int *x0, int *y0, int *x1, int *y1)
  2034. {
  2035. stbtt__csctx c = STBTT__CSCTX_INIT(1);
  2036. int r = stbtt__run_charstring(info, glyph_index, &c);
  2037. if (x0) *x0 = r ? c.min_x : 0;
  2038. if (y0) *y0 = r ? c.min_y : 0;
  2039. if (x1) *x1 = r ? c.max_x : 0;
  2040. if (y1) *y1 = r ? c.max_y : 0;
  2041. return r ? c.num_vertices : 0;
  2042. }
  2043. STBTT_DEF int stbtt_GetGlyphShape(const stbtt_fontinfo *info, int glyph_index, stbtt_vertex **pvertices)
  2044. {
  2045. if (!info->cff.size)
  2046. return stbtt__GetGlyphShapeTT(info, glyph_index, pvertices);
  2047. else
  2048. return stbtt__GetGlyphShapeT2(info, glyph_index, pvertices);
  2049. }
  2050. STBTT_DEF void stbtt_GetGlyphHMetrics(const stbtt_fontinfo *info, int glyph_index, int *advanceWidth, int *leftSideBearing)
  2051. {
  2052. stbtt_uint16 numOfLongHorMetrics = ttUSHORT(info->data+info->hhea + 34);
  2053. if (glyph_index < numOfLongHorMetrics) {
  2054. if (advanceWidth) *advanceWidth = ttSHORT(info->data + info->hmtx + 4*glyph_index);
  2055. if (leftSideBearing) *leftSideBearing = ttSHORT(info->data + info->hmtx + 4*glyph_index + 2);
  2056. } else {
  2057. if (advanceWidth) *advanceWidth = ttSHORT(info->data + info->hmtx + 4*(numOfLongHorMetrics-1));
  2058. if (leftSideBearing) *leftSideBearing = ttSHORT(info->data + info->hmtx + 4*numOfLongHorMetrics + 2*(glyph_index - numOfLongHorMetrics));
  2059. }
  2060. }
  2061. STBTT_DEF int stbtt_GetKerningTableLength(const stbtt_fontinfo *info)
  2062. {
  2063. stbtt_uint8 *data = info->data + info->kern;
  2064. // we only look at the first table. it must be 'horizontal' and format 0.
  2065. if (!info->kern)
  2066. return 0;
  2067. if (ttUSHORT(data+2) < 1) // number of tables, need at least 1
  2068. return 0;
  2069. if (ttUSHORT(data+8) != 1) // horizontal flag must be set in format
  2070. return 0;
  2071. return ttUSHORT(data+10);
  2072. }
  2073. STBTT_DEF int stbtt_GetKerningTable(const stbtt_fontinfo *info, stbtt_kerningentry* table, int table_length)
  2074. {
  2075. stbtt_uint8 *data = info->data + info->kern;
  2076. int k, length;
  2077. // we only look at the first table. it must be 'horizontal' and format 0.
  2078. if (!info->kern)
  2079. return 0;
  2080. if (ttUSHORT(data+2) < 1) // number of tables, need at least 1
  2081. return 0;
  2082. if (ttUSHORT(data+8) != 1) // horizontal flag must be set in format
  2083. return 0;
  2084. length = ttUSHORT(data+10);
  2085. if (table_length < length)
  2086. length = table_length;
  2087. for (k = 0; k < length; k++)
  2088. {
  2089. table[k].glyph1 = ttUSHORT(data+18+(k*6));
  2090. table[k].glyph2 = ttUSHORT(data+20+(k*6));
  2091. table[k].advance = ttSHORT(data+22+(k*6));
  2092. }
  2093. return length;
  2094. }
  2095. static int stbtt__GetGlyphKernInfoAdvance(const stbtt_fontinfo *info, int glyph1, int glyph2)
  2096. {
  2097. stbtt_uint8 *data = info->data + info->kern;
  2098. stbtt_uint32 needle, straw;
  2099. int l, r, m;
  2100. // we only look at the first table. it must be 'horizontal' and format 0.
  2101. if (!info->kern)
  2102. return 0;
  2103. if (ttUSHORT(data+2) < 1) // number of tables, need at least 1
  2104. return 0;
  2105. if (ttUSHORT(data+8) != 1) // horizontal flag must be set in format
  2106. return 0;
  2107. l = 0;
  2108. r = ttUSHORT(data+10) - 1;
  2109. needle = glyph1 << 16 | glyph2;
  2110. while (l <= r) {
  2111. m = (l + r) >> 1;
  2112. straw = ttULONG(data+18+(m*6)); // note: unaligned read
  2113. if (needle < straw)
  2114. r = m - 1;
  2115. else if (needle > straw)
  2116. l = m + 1;
  2117. else
  2118. return ttSHORT(data+22+(m*6));
  2119. }
  2120. return 0;
  2121. }
  2122. static stbtt_int32 stbtt__GetCoverageIndex(stbtt_uint8 *coverageTable, int glyph)
  2123. {
  2124. stbtt_uint16 coverageFormat = ttUSHORT(coverageTable);
  2125. switch (coverageFormat) {
  2126. case 1: {
  2127. stbtt_uint16 glyphCount = ttUSHORT(coverageTable + 2);
  2128. // Binary search.
  2129. stbtt_int32 l=0, r=glyphCount-1, m;
  2130. int straw, needle=glyph;
  2131. while (l <= r) {
  2132. stbtt_uint8 *glyphArray = coverageTable + 4;
  2133. stbtt_uint16 glyphID;
  2134. m = (l + r) >> 1;
  2135. glyphID = ttUSHORT(glyphArray + 2 * m);
  2136. straw = glyphID;
  2137. if (needle < straw)
  2138. r = m - 1;
  2139. else if (needle > straw)
  2140. l = m + 1;
  2141. else {
  2142. return m;
  2143. }
  2144. }
  2145. break;
  2146. }
  2147. case 2: {
  2148. stbtt_uint16 rangeCount = ttUSHORT(coverageTable + 2);
  2149. stbtt_uint8 *rangeArray = coverageTable + 4;
  2150. // Binary search.
  2151. stbtt_int32 l=0, r=rangeCount-1, m;
  2152. int strawStart, strawEnd, needle=glyph;
  2153. while (l <= r) {
  2154. stbtt_uint8 *rangeRecord;
  2155. m = (l + r) >> 1;
  2156. rangeRecord = rangeArray + 6 * m;
  2157. strawStart = ttUSHORT(rangeRecord);
  2158. strawEnd = ttUSHORT(rangeRecord + 2);
  2159. if (needle < strawStart)
  2160. r = m - 1;
  2161. else if (needle > strawEnd)
  2162. l = m + 1;
  2163. else {
  2164. stbtt_uint16 startCoverageIndex = ttUSHORT(rangeRecord + 4);
  2165. return startCoverageIndex + glyph - strawStart;
  2166. }
  2167. }
  2168. break;
  2169. }
  2170. default: return -1; // unsupported
  2171. }
  2172. return -1;
  2173. }
  2174. static stbtt_int32 stbtt__GetGlyphClass(stbtt_uint8 *classDefTable, int glyph)
  2175. {
  2176. stbtt_uint16 classDefFormat = ttUSHORT(classDefTable);
  2177. switch (classDefFormat)
  2178. {
  2179. case 1: {
  2180. stbtt_uint16 startGlyphID = ttUSHORT(classDefTable + 2);
  2181. stbtt_uint16 glyphCount = ttUSHORT(classDefTable + 4);
  2182. stbtt_uint8 *classDef1ValueArray = classDefTable + 6;
  2183. if (glyph >= startGlyphID && glyph < startGlyphID + glyphCount)
  2184. return (stbtt_int32)ttUSHORT(classDef1ValueArray + 2 * (glyph - startGlyphID));
  2185. break;
  2186. }
  2187. case 2: {
  2188. stbtt_uint16 classRangeCount = ttUSHORT(classDefTable + 2);
  2189. stbtt_uint8 *classRangeRecords = classDefTable + 4;
  2190. // Binary search.
  2191. stbtt_int32 l=0, r=classRangeCount-1, m;
  2192. int strawStart, strawEnd, needle=glyph;
  2193. while (l <= r) {
  2194. stbtt_uint8 *classRangeRecord;
  2195. m = (l + r) >> 1;
  2196. classRangeRecord = classRangeRecords + 6 * m;
  2197. strawStart = ttUSHORT(classRangeRecord);
  2198. strawEnd = ttUSHORT(classRangeRecord + 2);
  2199. if (needle < strawStart)
  2200. r = m - 1;
  2201. else if (needle > strawEnd)
  2202. l = m + 1;
  2203. else
  2204. return (stbtt_int32)ttUSHORT(classRangeRecord + 4);
  2205. }
  2206. break;
  2207. }
  2208. default:
  2209. return -1; // Unsupported definition type, return an error.
  2210. }
  2211. // "All glyphs not assigned to a class fall into class 0". (OpenType spec)
  2212. return 0;
  2213. }
  2214. // Define to STBTT_assert(x) if you want to break on unimplemented formats.
  2215. #define STBTT_GPOS_TODO_assert(x)
  2216. static stbtt_int32 stbtt__GetGlyphGPOSInfoAdvance(const stbtt_fontinfo *info, int glyph1, int glyph2)
  2217. {
  2218. stbtt_uint16 lookupListOffset;
  2219. stbtt_uint8 *lookupList;
  2220. stbtt_uint16 lookupCount;
  2221. stbtt_uint8 *data;
  2222. stbtt_int32 i, sti;
  2223. if (!info->gpos) return 0;
  2224. data = info->data + info->gpos;
  2225. if (ttUSHORT(data+0) != 1) return 0; // Major version 1
  2226. if (ttUSHORT(data+2) != 0) return 0; // Minor version 0
  2227. lookupListOffset = ttUSHORT(data+8);
  2228. lookupList = data + lookupListOffset;
  2229. lookupCount = ttUSHORT(lookupList);
  2230. for (i=0; i<lookupCount; ++i) {
  2231. stbtt_uint16 lookupOffset = ttUSHORT(lookupList + 2 + 2 * i);
  2232. stbtt_uint8 *lookupTable = lookupList + lookupOffset;
  2233. stbtt_uint16 lookupType = ttUSHORT(lookupTable);
  2234. stbtt_uint16 subTableCount = ttUSHORT(lookupTable + 4);
  2235. stbtt_uint8 *subTableOffsets = lookupTable + 6;
  2236. if (lookupType != 2) // Pair Adjustment Positioning Subtable
  2237. continue;
  2238. for (sti=0; sti<subTableCount; sti++) {
  2239. stbtt_uint16 subtableOffset = ttUSHORT(subTableOffsets + 2 * sti);
  2240. stbtt_uint8 *table = lookupTable + subtableOffset;
  2241. stbtt_uint16 posFormat = ttUSHORT(table);
  2242. stbtt_uint16 coverageOffset = ttUSHORT(table + 2);
  2243. stbtt_int32 coverageIndex = stbtt__GetCoverageIndex(table + coverageOffset, glyph1);
  2244. if (coverageIndex == -1) continue;
  2245. switch (posFormat) {
  2246. case 1: {
  2247. stbtt_int32 l, r, m;
  2248. int straw, needle;
  2249. stbtt_uint16 valueFormat1 = ttUSHORT(table + 4);
  2250. stbtt_uint16 valueFormat2 = ttUSHORT(table + 6);
  2251. if (valueFormat1 == 4 && valueFormat2 == 0) { // Support more formats?
  2252. stbtt_int32 valueRecordPairSizeInBytes = 2;
  2253. stbtt_uint16 pairSetCount = ttUSHORT(table + 8);
  2254. stbtt_uint16 pairPosOffset = ttUSHORT(table + 10 + 2 * coverageIndex);
  2255. stbtt_uint8 *pairValueTable = table + pairPosOffset;
  2256. stbtt_uint16 pairValueCount = ttUSHORT(pairValueTable);
  2257. stbtt_uint8 *pairValueArray = pairValueTable + 2;
  2258. if (coverageIndex >= pairSetCount) return 0;
  2259. needle=glyph2;
  2260. r=pairValueCount-1;
  2261. l=0;
  2262. // Binary search.
  2263. while (l <= r) {
  2264. stbtt_uint16 secondGlyph;
  2265. stbtt_uint8 *pairValue;
  2266. m = (l + r) >> 1;
  2267. pairValue = pairValueArray + (2 + valueRecordPairSizeInBytes) * m;
  2268. secondGlyph = ttUSHORT(pairValue);
  2269. straw = secondGlyph;
  2270. if (needle < straw)
  2271. r = m - 1;
  2272. else if (needle > straw)
  2273. l = m + 1;
  2274. else {
  2275. stbtt_int16 xAdvance = ttSHORT(pairValue + 2);
  2276. return xAdvance;
  2277. }
  2278. }
  2279. } else
  2280. return 0;
  2281. break;
  2282. }
  2283. case 2: {
  2284. stbtt_uint16 valueFormat1 = ttUSHORT(table + 4);
  2285. stbtt_uint16 valueFormat2 = ttUSHORT(table + 6);
  2286. if (valueFormat1 == 4 && valueFormat2 == 0) { // Support more formats?
  2287. stbtt_uint16 classDef1Offset = ttUSHORT(table + 8);
  2288. stbtt_uint16 classDef2Offset = ttUSHORT(table + 10);
  2289. int glyph1class = stbtt__GetGlyphClass(table + classDef1Offset, glyph1);
  2290. int glyph2class = stbtt__GetGlyphClass(table + classDef2Offset, glyph2);
  2291. stbtt_uint16 class1Count = ttUSHORT(table + 12);
  2292. stbtt_uint16 class2Count = ttUSHORT(table + 14);
  2293. stbtt_uint8 *class1Records, *class2Records;
  2294. stbtt_int16 xAdvance;
  2295. if (glyph1class < 0 || glyph1class >= class1Count) return 0; // malformed
  2296. if (glyph2class < 0 || glyph2class >= class2Count) return 0; // malformed
  2297. class1Records = table + 16;
  2298. class2Records = class1Records + 2 * (glyph1class * class2Count);
  2299. xAdvance = ttSHORT(class2Records + 2 * glyph2class);
  2300. return xAdvance;
  2301. } else
  2302. return 0;
  2303. break;
  2304. }
  2305. default:
  2306. return 0; // Unsupported position format
  2307. }
  2308. }
  2309. }
  2310. return 0;
  2311. }
  2312. STBTT_DEF int stbtt_GetGlyphKernAdvance(const stbtt_fontinfo *info, int g1, int g2)
  2313. {
  2314. int xAdvance = 0;
  2315. if (info->gpos)
  2316. xAdvance += stbtt__GetGlyphGPOSInfoAdvance(info, g1, g2);
  2317. else if (info->kern)
  2318. xAdvance += stbtt__GetGlyphKernInfoAdvance(info, g1, g2);
  2319. return xAdvance;
  2320. }
  2321. STBTT_DEF int stbtt_GetCodepointKernAdvance(const stbtt_fontinfo *info, int ch1, int ch2)
  2322. {
  2323. if (!info->kern && !info->gpos) // if no kerning table, don't waste time looking up both codepoint->glyphs
  2324. return 0;
  2325. return stbtt_GetGlyphKernAdvance(info, stbtt_FindGlyphIndex(info,ch1), stbtt_FindGlyphIndex(info,ch2));
  2326. }
  2327. STBTT_DEF void stbtt_GetCodepointHMetrics(const stbtt_fontinfo *info, int codepoint, int *advanceWidth, int *leftSideBearing)
  2328. {
  2329. stbtt_GetGlyphHMetrics(info, stbtt_FindGlyphIndex(info,codepoint), advanceWidth, leftSideBearing);
  2330. }
  2331. STBTT_DEF void stbtt_GetFontVMetrics(const stbtt_fontinfo *info, int *ascent, int *descent, int *lineGap)
  2332. {
  2333. if (ascent ) *ascent = ttSHORT(info->data+info->hhea + 4);
  2334. if (descent) *descent = ttSHORT(info->data+info->hhea + 6);
  2335. if (lineGap) *lineGap = ttSHORT(info->data+info->hhea + 8);
  2336. }
  2337. STBTT_DEF int stbtt_GetFontVMetricsOS2(const stbtt_fontinfo *info, int *typoAscent, int *typoDescent, int *typoLineGap)
  2338. {
  2339. int tab = stbtt__find_table(info->data, info->fontstart, "OS/2");
  2340. if (!tab)
  2341. return 0;
  2342. if (typoAscent ) *typoAscent = ttSHORT(info->data+tab + 68);
  2343. if (typoDescent) *typoDescent = ttSHORT(info->data+tab + 70);
  2344. if (typoLineGap) *typoLineGap = ttSHORT(info->data+tab + 72);
  2345. return 1;
  2346. }
  2347. STBTT_DEF void stbtt_GetFontBoundingBox(const stbtt_fontinfo *info, int *x0, int *y0, int *x1, int *y1)
  2348. {
  2349. *x0 = ttSHORT(info->data + info->head + 36);
  2350. *y0 = ttSHORT(info->data + info->head + 38);
  2351. *x1 = ttSHORT(info->data + info->head + 40);
  2352. *y1 = ttSHORT(info->data + info->head + 42);
  2353. }
  2354. STBTT_DEF float stbtt_ScaleForPixelHeight(const stbtt_fontinfo *info, float height)
  2355. {
  2356. int fheight = ttSHORT(info->data + info->hhea + 4) - ttSHORT(info->data + info->hhea + 6);
  2357. return (float) height / fheight;
  2358. }
  2359. STBTT_DEF float stbtt_ScaleForMappingEmToPixels(const stbtt_fontinfo *info, float pixels)
  2360. {
  2361. int unitsPerEm = ttUSHORT(info->data + info->head + 18);
  2362. return pixels / unitsPerEm;
  2363. }
  2364. STBTT_DEF void stbtt_FreeShape(const stbtt_fontinfo *info, stbtt_vertex *v)
  2365. {
  2366. STBTT_free(v, info->userdata);
  2367. }
  2368. STBTT_DEF stbtt_uint8 *stbtt_FindSVGDoc(const stbtt_fontinfo *info, int gl)
  2369. {
  2370. int i;
  2371. stbtt_uint8 *data = info->data;
  2372. stbtt_uint8 *svg_doc_list = data + stbtt__get_svg((stbtt_fontinfo *) info);
  2373. int numEntries = ttUSHORT(svg_doc_list);
  2374. stbtt_uint8 *svg_docs = svg_doc_list + 2;
  2375. for(i=0; i<numEntries; i++) {
  2376. stbtt_uint8 *svg_doc = svg_docs + (12 * i);
  2377. if ((gl >= ttUSHORT(svg_doc)) && (gl <= ttUSHORT(svg_doc + 2)))
  2378. return svg_doc;
  2379. }
  2380. return 0;
  2381. }
  2382. STBTT_DEF int stbtt_GetGlyphSVG(const stbtt_fontinfo *info, int gl, const char **svg)
  2383. {
  2384. stbtt_uint8 *data = info->data;
  2385. stbtt_uint8 *svg_doc;
  2386. if (info->svg == 0)
  2387. return 0;
  2388. svg_doc = stbtt_FindSVGDoc(info, gl);
  2389. if (svg_doc != NULL) {
  2390. *svg = (char *) data + info->svg + ttULONG(svg_doc + 4);
  2391. return ttULONG(svg_doc + 8);
  2392. } else {
  2393. return 0;
  2394. }
  2395. }
  2396. STBTT_DEF int stbtt_GetCodepointSVG(const stbtt_fontinfo *info, int unicode_codepoint, const char **svg)
  2397. {
  2398. return stbtt_GetGlyphSVG(info, stbtt_FindGlyphIndex(info, unicode_codepoint), svg);
  2399. }
  2400. //////////////////////////////////////////////////////////////////////////////
  2401. //
  2402. // antialiasing software rasterizer
  2403. //
  2404. STBTT_DEF void stbtt_GetGlyphBitmapBoxSubpixel(const stbtt_fontinfo *font, int glyph, float scale_x, float scale_y,float shift_x, float shift_y, int *ix0, int *iy0, int *ix1, int *iy1)
  2405. {
  2406. int x0=0,y0=0,x1,y1; // =0 suppresses compiler warning
  2407. if (!stbtt_GetGlyphBox(font, glyph, &x0,&y0,&x1,&y1)) {
  2408. // e.g. space character
  2409. if (ix0) *ix0 = 0;
  2410. if (iy0) *iy0 = 0;
  2411. if (ix1) *ix1 = 0;
  2412. if (iy1) *iy1 = 0;
  2413. } else {
  2414. // move to integral bboxes (treating pixels as little squares, what pixels get touched)?
  2415. if (ix0) *ix0 = STBTT_ifloor( x0 * scale_x + shift_x);
  2416. if (iy0) *iy0 = STBTT_ifloor(-y1 * scale_y + shift_y);
  2417. if (ix1) *ix1 = STBTT_iceil ( x1 * scale_x + shift_x);
  2418. if (iy1) *iy1 = STBTT_iceil (-y0 * scale_y + shift_y);
  2419. }
  2420. }
  2421. STBTT_DEF void stbtt_GetGlyphBitmapBox(const stbtt_fontinfo *font, int glyph, float scale_x, float scale_y, int *ix0, int *iy0, int *ix1, int *iy1)
  2422. {
  2423. stbtt_GetGlyphBitmapBoxSubpixel(font, glyph, scale_x, scale_y,0.0f,0.0f, ix0, iy0, ix1, iy1);
  2424. }
  2425. STBTT_DEF void stbtt_GetCodepointBitmapBoxSubpixel(const stbtt_fontinfo *font, int codepoint, float scale_x, float scale_y, float shift_x, float shift_y, int *ix0, int *iy0, int *ix1, int *iy1)
  2426. {
  2427. stbtt_GetGlyphBitmapBoxSubpixel(font, stbtt_FindGlyphIndex(font,codepoint), scale_x, scale_y,shift_x,shift_y, ix0,iy0,ix1,iy1);
  2428. }
  2429. STBTT_DEF void stbtt_GetCodepointBitmapBox(const stbtt_fontinfo *font, int codepoint, float scale_x, float scale_y, int *ix0, int *iy0, int *ix1, int *iy1)
  2430. {
  2431. stbtt_GetCodepointBitmapBoxSubpixel(font, codepoint, scale_x, scale_y,0.0f,0.0f, ix0,iy0,ix1,iy1);
  2432. }
  2433. //////////////////////////////////////////////////////////////////////////////
  2434. //
  2435. // Rasterizer
  2436. typedef struct stbtt__hheap_chunk
  2437. {
  2438. struct stbtt__hheap_chunk *next;
  2439. } stbtt__hheap_chunk;
  2440. typedef struct stbtt__hheap
  2441. {
  2442. struct stbtt__hheap_chunk *head;
  2443. void *first_free;
  2444. int num_remaining_in_head_chunk;
  2445. } stbtt__hheap;
  2446. static void *stbtt__hheap_alloc(stbtt__hheap *hh, size_t size, void *userdata)
  2447. {
  2448. if (hh->first_free) {
  2449. void *p = hh->first_free;
  2450. hh->first_free = * (void **) p;
  2451. return p;
  2452. } else {
  2453. if (hh->num_remaining_in_head_chunk == 0) {
  2454. int count = (size < 32 ? 2000 : size < 128 ? 800 : 100);
  2455. stbtt__hheap_chunk *c = (stbtt__hheap_chunk *) STBTT_malloc(sizeof(stbtt__hheap_chunk) + size * count, userdata);
  2456. if (c == NULL)
  2457. return NULL;
  2458. c->next = hh->head;
  2459. hh->head = c;
  2460. hh->num_remaining_in_head_chunk = count;
  2461. }
  2462. --hh->num_remaining_in_head_chunk;
  2463. return (char *) (hh->head) + sizeof(stbtt__hheap_chunk) + size * hh->num_remaining_in_head_chunk;
  2464. }
  2465. }
  2466. static void stbtt__hheap_free(stbtt__hheap *hh, void *p)
  2467. {
  2468. *(void **) p = hh->first_free;
  2469. hh->first_free = p;
  2470. }
  2471. static void stbtt__hheap_cleanup(stbtt__hheap *hh, void *userdata)
  2472. {
  2473. stbtt__hheap_chunk *c = hh->head;
  2474. while (c) {
  2475. stbtt__hheap_chunk *n = c->next;
  2476. STBTT_free(c, userdata);
  2477. c = n;
  2478. }
  2479. }
  2480. typedef struct stbtt__edge {
  2481. float x0,y0, x1,y1;
  2482. int invert;
  2483. } stbtt__edge;
  2484. typedef struct stbtt__active_edge
  2485. {
  2486. struct stbtt__active_edge *next;
  2487. #if STBTT_RASTERIZER_VERSION==1
  2488. int x,dx;
  2489. float ey;
  2490. int direction;
  2491. #elif STBTT_RASTERIZER_VERSION==2
  2492. float fx,fdx,fdy;
  2493. float direction;
  2494. float sy;
  2495. float ey;
  2496. #else
  2497. #error "Unrecognized value of STBTT_RASTERIZER_VERSION"
  2498. #endif
  2499. } stbtt__active_edge;
  2500. #if STBTT_RASTERIZER_VERSION == 1
  2501. #define STBTT_FIXSHIFT 10
  2502. #define STBTT_FIX (1 << STBTT_FIXSHIFT)
  2503. #define STBTT_FIXMASK (STBTT_FIX-1)
  2504. static stbtt__active_edge *stbtt__new_active(stbtt__hheap *hh, stbtt__edge *e, int off_x, float start_point, void *userdata)
  2505. {
  2506. stbtt__active_edge *z = (stbtt__active_edge *) stbtt__hheap_alloc(hh, sizeof(*z), userdata);
  2507. float dxdy = (e->x1 - e->x0) / (e->y1 - e->y0);
  2508. STBTT_assert(z != NULL);
  2509. if (!z) return z;
  2510. // round dx down to avoid overshooting
  2511. if (dxdy < 0)
  2512. z->dx = -STBTT_ifloor(STBTT_FIX * -dxdy);
  2513. else
  2514. z->dx = STBTT_ifloor(STBTT_FIX * dxdy);
  2515. z->x = STBTT_ifloor(STBTT_FIX * e->x0 + z->dx * (start_point - e->y0)); // use z->dx so when we offset later it's by the same amount
  2516. z->x -= off_x * STBTT_FIX;
  2517. z->ey = e->y1;
  2518. z->next = 0;
  2519. z->direction = e->invert ? 1 : -1;
  2520. return z;
  2521. }
  2522. #elif STBTT_RASTERIZER_VERSION == 2
  2523. static stbtt__active_edge *stbtt__new_active(stbtt__hheap *hh, stbtt__edge *e, int off_x, float start_point, void *userdata)
  2524. {
  2525. stbtt__active_edge *z = (stbtt__active_edge *) stbtt__hheap_alloc(hh, sizeof(*z), userdata);
  2526. float dxdy = (e->x1 - e->x0) / (e->y1 - e->y0);
  2527. STBTT_assert(z != NULL);
  2528. //STBTT_assert(e->y0 <= start_point);
  2529. if (!z) return z;
  2530. z->fdx = dxdy;
  2531. z->fdy = dxdy != 0.0f ? (1.0f/dxdy) : 0.0f;
  2532. z->fx = e->x0 + dxdy * (start_point - e->y0);
  2533. z->fx -= off_x;
  2534. z->direction = e->invert ? 1.0f : -1.0f;
  2535. z->sy = e->y0;
  2536. z->ey = e->y1;
  2537. z->next = 0;
  2538. return z;
  2539. }
  2540. #else
  2541. #error "Unrecognized value of STBTT_RASTERIZER_VERSION"
  2542. #endif
  2543. #if STBTT_RASTERIZER_VERSION == 1
  2544. // note: this routine clips fills that extend off the edges... ideally this
  2545. // wouldn't happen, but it could happen if the truetype glyph bounding boxes
  2546. // are wrong, or if the user supplies a too-small bitmap
  2547. static void stbtt__fill_active_edges(unsigned char *scanline, int len, stbtt__active_edge *e, int max_weight)
  2548. {
  2549. // non-zero winding fill
  2550. int x0=0, w=0;
  2551. while (e) {
  2552. if (w == 0) {
  2553. // if we're currently at zero, we need to record the edge start point
  2554. x0 = e->x; w += e->direction;
  2555. } else {
  2556. int x1 = e->x; w += e->direction;
  2557. // if we went to zero, we need to draw
  2558. if (w == 0) {
  2559. int i = x0 >> STBTT_FIXSHIFT;
  2560. int j = x1 >> STBTT_FIXSHIFT;
  2561. if (i < len && j >= 0) {
  2562. if (i == j) {
  2563. // x0,x1 are the same pixel, so compute combined coverage
  2564. scanline[i] = scanline[i] + (stbtt_uint8) ((x1 - x0) * max_weight >> STBTT_FIXSHIFT);
  2565. } else {
  2566. if (i >= 0) // add antialiasing for x0
  2567. scanline[i] = scanline[i] + (stbtt_uint8) (((STBTT_FIX - (x0 & STBTT_FIXMASK)) * max_weight) >> STBTT_FIXSHIFT);
  2568. else
  2569. i = -1; // clip
  2570. if (j < len) // add antialiasing for x1
  2571. scanline[j] = scanline[j] + (stbtt_uint8) (((x1 & STBTT_FIXMASK) * max_weight) >> STBTT_FIXSHIFT);
  2572. else
  2573. j = len; // clip
  2574. for (++i; i < j; ++i) // fill pixels between x0 and x1
  2575. scanline[i] = scanline[i] + (stbtt_uint8) max_weight;
  2576. }
  2577. }
  2578. }
  2579. }
  2580. e = e->next;
  2581. }
  2582. }
  2583. static void stbtt__rasterize_sorted_edges(stbtt__bitmap *result, stbtt__edge *e, int n, int vsubsample, int off_x, int off_y, void *userdata)
  2584. {
  2585. stbtt__hheap hh = { 0, 0, 0 };
  2586. stbtt__active_edge *active = NULL;
  2587. int y,j=0;
  2588. int max_weight = (255 / vsubsample); // weight per vertical scanline
  2589. int s; // vertical subsample index
  2590. unsigned char scanline_data[512], *scanline;
  2591. if (result->w > 512)
  2592. scanline = (unsigned char *) STBTT_malloc(result->w, userdata);
  2593. else
  2594. scanline = scanline_data;
  2595. y = off_y * vsubsample;
  2596. e[n].y0 = (off_y + result->h) * (float) vsubsample + 1;
  2597. while (j < result->h) {
  2598. STBTT_memset(scanline, 0, result->w);
  2599. for (s=0; s < vsubsample; ++s) {
  2600. // find center of pixel for this scanline
  2601. float scan_y = y + 0.5f;
  2602. stbtt__active_edge **step = &active;
  2603. // update all active edges;
  2604. // remove all active edges that terminate before the center of this scanline
  2605. while (*step) {
  2606. stbtt__active_edge * z = *step;
  2607. if (z->ey <= scan_y) {
  2608. *step = z->next; // delete from list
  2609. STBTT_assert(z->direction);
  2610. z->direction = 0;
  2611. stbtt__hheap_free(&hh, z);
  2612. } else {
  2613. z->x += z->dx; // advance to position for current scanline
  2614. step = &((*step)->next); // advance through list
  2615. }
  2616. }
  2617. // resort the list if needed
  2618. for(;;) {
  2619. int changed=0;
  2620. step = &active;
  2621. while (*step && (*step)->next) {
  2622. if ((*step)->x > (*step)->next->x) {
  2623. stbtt__active_edge *t = *step;
  2624. stbtt__active_edge *q = t->next;
  2625. t->next = q->next;
  2626. q->next = t;
  2627. *step = q;
  2628. changed = 1;
  2629. }
  2630. step = &(*step)->next;
  2631. }
  2632. if (!changed) break;
  2633. }
  2634. // insert all edges that start before the center of this scanline -- omit ones that also end on this scanline
  2635. while (e->y0 <= scan_y) {
  2636. if (e->y1 > scan_y) {
  2637. stbtt__active_edge *z = stbtt__new_active(&hh, e, off_x, scan_y, userdata);
  2638. if (z != NULL) {
  2639. // find insertion point
  2640. if (active == NULL)
  2641. active = z;
  2642. else if (z->x < active->x) {
  2643. // insert at front
  2644. z->next = active;
  2645. active = z;
  2646. } else {
  2647. // find thing to insert AFTER
  2648. stbtt__active_edge *p = active;
  2649. while (p->next && p->next->x < z->x)
  2650. p = p->next;
  2651. // at this point, p->next->x is NOT < z->x
  2652. z->next = p->next;
  2653. p->next = z;
  2654. }
  2655. }
  2656. }
  2657. ++e;
  2658. }
  2659. // now process all active edges in XOR fashion
  2660. if (active)
  2661. stbtt__fill_active_edges(scanline, result->w, active, max_weight);
  2662. ++y;
  2663. }
  2664. STBTT_memcpy(result->pixels + j * result->stride, scanline, result->w);
  2665. ++j;
  2666. }
  2667. stbtt__hheap_cleanup(&hh, userdata);
  2668. if (scanline != scanline_data)
  2669. STBTT_free(scanline, userdata);
  2670. }
  2671. #elif STBTT_RASTERIZER_VERSION == 2
  2672. // the edge passed in here does not cross the vertical line at x or the vertical line at x+1
  2673. // (i.e. it has already been clipped to those)
  2674. static void stbtt__handle_clipped_edge(float *scanline, int x, stbtt__active_edge *e, float x0, float y0, float x1, float y1)
  2675. {
  2676. if (y0 == y1) return;
  2677. STBTT_assert(y0 < y1);
  2678. STBTT_assert(e->sy <= e->ey);
  2679. if (y0 > e->ey) return;
  2680. if (y1 < e->sy) return;
  2681. if (y0 < e->sy) {
  2682. x0 += (x1-x0) * (e->sy - y0) / (y1-y0);
  2683. y0 = e->sy;
  2684. }
  2685. if (y1 > e->ey) {
  2686. x1 += (x1-x0) * (e->ey - y1) / (y1-y0);
  2687. y1 = e->ey;
  2688. }
  2689. if (x0 == x)
  2690. STBTT_assert(x1 <= x+1);
  2691. else if (x0 == x+1)
  2692. STBTT_assert(x1 >= x);
  2693. else if (x0 <= x)
  2694. STBTT_assert(x1 <= x);
  2695. else if (x0 >= x+1)
  2696. STBTT_assert(x1 >= x+1);
  2697. else
  2698. STBTT_assert(x1 >= x && x1 <= x+1);
  2699. if (x0 <= x && x1 <= x)
  2700. scanline[x] += e->direction * (y1-y0);
  2701. else if (x0 >= x+1 && x1 >= x+1)
  2702. ;
  2703. else {
  2704. STBTT_assert(x0 >= x && x0 <= x+1 && x1 >= x && x1 <= x+1);
  2705. scanline[x] += e->direction * (y1-y0) * (1-((x0-x)+(x1-x))/2); // coverage = 1 - average x position
  2706. }
  2707. }
  2708. static float stbtt__sized_trapezoid_area(float height, float top_width, float bottom_width)
  2709. {
  2710. STBTT_assert(top_width >= 0);
  2711. STBTT_assert(bottom_width >= 0);
  2712. return (top_width + bottom_width) / 2.0f * height;
  2713. }
  2714. static float stbtt__position_trapezoid_area(float height, float tx0, float tx1, float bx0, float bx1)
  2715. {
  2716. return stbtt__sized_trapezoid_area(height, tx1 - tx0, bx1 - bx0);
  2717. }
  2718. static float stbtt__sized_triangle_area(float height, float width)
  2719. {
  2720. return height * width / 2;
  2721. }
  2722. static void stbtt__fill_active_edges_new(float *scanline, float *scanline_fill, int len, stbtt__active_edge *e, float y_top)
  2723. {
  2724. float y_bottom = y_top+1;
  2725. while (e) {
  2726. // brute force every pixel
  2727. // compute intersection points with top & bottom
  2728. STBTT_assert(e->ey >= y_top);
  2729. if (e->fdx == 0) {
  2730. float x0 = e->fx;
  2731. if (x0 < len) {
  2732. if (x0 >= 0) {
  2733. stbtt__handle_clipped_edge(scanline,(int) x0,e, x0,y_top, x0,y_bottom);
  2734. stbtt__handle_clipped_edge(scanline_fill-1,(int) x0+1,e, x0,y_top, x0,y_bottom);
  2735. } else {
  2736. stbtt__handle_clipped_edge(scanline_fill-1,0,e, x0,y_top, x0,y_bottom);
  2737. }
  2738. }
  2739. } else {
  2740. float x0 = e->fx;
  2741. float dx = e->fdx;
  2742. float xb = x0 + dx;
  2743. float x_top, x_bottom;
  2744. float sy0,sy1;
  2745. float dy = e->fdy;
  2746. STBTT_assert(e->sy <= y_bottom && e->ey >= y_top);
  2747. // compute endpoints of line segment clipped to this scanline (if the
  2748. // line segment starts on this scanline. x0 is the intersection of the
  2749. // line with y_top, but that may be off the line segment.
  2750. if (e->sy > y_top) {
  2751. x_top = x0 + dx * (e->sy - y_top);
  2752. sy0 = e->sy;
  2753. } else {
  2754. x_top = x0;
  2755. sy0 = y_top;
  2756. }
  2757. if (e->ey < y_bottom) {
  2758. x_bottom = x0 + dx * (e->ey - y_top);
  2759. sy1 = e->ey;
  2760. } else {
  2761. x_bottom = xb;
  2762. sy1 = y_bottom;
  2763. }
  2764. if (x_top >= 0 && x_bottom >= 0 && x_top < len && x_bottom < len) {
  2765. // from here on, we don't have to range check x values
  2766. if ((int) x_top == (int) x_bottom) {
  2767. float height;
  2768. // simple case, only spans one pixel
  2769. int x = (int) x_top;
  2770. height = (sy1 - sy0) * e->direction;
  2771. STBTT_assert(x >= 0 && x < len);
  2772. scanline[x] += stbtt__position_trapezoid_area(height, x_top, x+1.0f, x_bottom, x+1.0f);
  2773. scanline_fill[x] += height; // everything right of this pixel is filled
  2774. } else {
  2775. int x,x1,x2;
  2776. float y_crossing, y_final, step, sign, area;
  2777. // covers 2+ pixels
  2778. if (x_top > x_bottom) {
  2779. // flip scanline vertically; signed area is the same
  2780. float t;
  2781. sy0 = y_bottom - (sy0 - y_top);
  2782. sy1 = y_bottom - (sy1 - y_top);
  2783. t = sy0, sy0 = sy1, sy1 = t;
  2784. t = x_bottom, x_bottom = x_top, x_top = t;
  2785. dx = -dx;
  2786. dy = -dy;
  2787. t = x0, x0 = xb, xb = t;
  2788. }
  2789. STBTT_assert(dy >= 0);
  2790. STBTT_assert(dx >= 0);
  2791. x1 = (int) x_top;
  2792. x2 = (int) x_bottom;
  2793. // compute intersection with y axis at x1+1
  2794. y_crossing = y_top + dy * (x1+1 - x0);
  2795. // compute intersection with y axis at x2
  2796. y_final = y_top + dy * (x2 - x0);
  2797. // x1 x_top x2 x_bottom
  2798. // y_top +------|-----+------------+------------+--------|---+------------+
  2799. // | | | | | |
  2800. // | | | | | |
  2801. // sy0 | Txxxxx|............|............|............|............|
  2802. // y_crossing | *xxxxx.......|............|............|............|
  2803. // | | xxxxx..|............|............|............|
  2804. // | | /- xx*xxxx........|............|............|
  2805. // | | dy < | xxxxxx..|............|............|
  2806. // y_final | | \- | xx*xxx.........|............|
  2807. // sy1 | | | | xxxxxB...|............|
  2808. // | | | | | |
  2809. // | | | | | |
  2810. // y_bottom +------------+------------+------------+------------+------------+
  2811. //
  2812. // goal is to measure the area covered by '.' in each pixel
  2813. // if x2 is right at the right edge of x1, y_crossing can blow up, github #1057
  2814. // @TODO: maybe test against sy1 rather than y_bottom?
  2815. if (y_crossing > y_bottom)
  2816. y_crossing = y_bottom;
  2817. sign = e->direction;
  2818. // area of the rectangle covered from sy0..y_crossing
  2819. area = sign * (y_crossing-sy0);
  2820. // area of the triangle (x_top,sy0), (x1+1,sy0), (x1+1,y_crossing)
  2821. scanline[x1] += stbtt__sized_triangle_area(area, x1+1 - x_top);
  2822. // check if final y_crossing is blown up; no test case for this
  2823. if (y_final > y_bottom) {
  2824. y_final = y_bottom;
  2825. dy = (y_final - y_crossing ) / (x2 - (x1+1)); // if denom=0, y_final = y_crossing, so y_final <= y_bottom
  2826. }
  2827. // in second pixel, area covered by line segment found in first pixel
  2828. // is always a rectangle 1 wide * the height of that line segment; this
  2829. // is exactly what the variable 'area' stores. it also gets a contribution
  2830. // from the line segment within it. the THIRD pixel will get the first
  2831. // pixel's rectangle contribution, the second pixel's rectangle contribution,
  2832. // and its own contribution. the 'own contribution' is the same in every pixel except
  2833. // the leftmost and rightmost, a trapezoid that slides down in each pixel.
  2834. // the second pixel's contribution to the third pixel will be the
  2835. // rectangle 1 wide times the height change in the second pixel, which is dy.
  2836. step = sign * dy * 1; // dy is dy/dx, change in y for every 1 change in x,
  2837. // which multiplied by 1-pixel-width is how much pixel area changes for each step in x
  2838. // so the area advances by 'step' every time
  2839. for (x = x1+1; x < x2; ++x) {
  2840. scanline[x] += area + step/2; // area of trapezoid is 1*step/2
  2841. area += step;
  2842. }
  2843. STBTT_assert(STBTT_fabs(area) <= 1.01f); // accumulated error from area += step unless we round step down
  2844. STBTT_assert(sy1 > y_final-0.01f);
  2845. // area covered in the last pixel is the rectangle from all the pixels to the left,
  2846. // plus the trapezoid filled by the line segment in this pixel all the way to the right edge
  2847. scanline[x2] += area + sign * stbtt__position_trapezoid_area(sy1-y_final, (float) x2, x2+1.0f, x_bottom, x2+1.0f);
  2848. // the rest of the line is filled based on the total height of the line segment in this pixel
  2849. scanline_fill[x2] += sign * (sy1-sy0);
  2850. }
  2851. } else {
  2852. // if edge goes outside of box we're drawing, we require
  2853. // clipping logic. since this does not match the intended use
  2854. // of this library, we use a different, very slow brute
  2855. // force implementation
  2856. // note though that this does happen some of the time because
  2857. // x_top and x_bottom can be extrapolated at the top & bottom of
  2858. // the shape and actually lie outside the bounding box
  2859. int x;
  2860. for (x=0; x < len; ++x) {
  2861. // cases:
  2862. //
  2863. // there can be up to two intersections with the pixel. any intersection
  2864. // with left or right edges can be handled by splitting into two (or three)
  2865. // regions. intersections with top & bottom do not necessitate case-wise logic.
  2866. //
  2867. // the old way of doing this found the intersections with the left & right edges,
  2868. // then used some simple logic to produce up to three segments in sorted order
  2869. // from top-to-bottom. however, this had a problem: if an x edge was epsilon
  2870. // across the x border, then the corresponding y position might not be distinct
  2871. // from the other y segment, and it might ignored as an empty segment. to avoid
  2872. // that, we need to explicitly produce segments based on x positions.
  2873. // rename variables to clearly-defined pairs
  2874. float y0 = y_top;
  2875. float x1 = (float) (x);
  2876. float x2 = (float) (x+1);
  2877. float x3 = xb;
  2878. float y3 = y_bottom;
  2879. // x = e->x + e->dx * (y-y_top)
  2880. // (y-y_top) = (x - e->x) / e->dx
  2881. // y = (x - e->x) / e->dx + y_top
  2882. float y1 = (x - x0) / dx + y_top;
  2883. float y2 = (x+1 - x0) / dx + y_top;
  2884. if (x0 < x1 && x3 > x2) { // three segments descending down-right
  2885. stbtt__handle_clipped_edge(scanline,x,e, x0,y0, x1,y1);
  2886. stbtt__handle_clipped_edge(scanline,x,e, x1,y1, x2,y2);
  2887. stbtt__handle_clipped_edge(scanline,x,e, x2,y2, x3,y3);
  2888. } else if (x3 < x1 && x0 > x2) { // three segments descending down-left
  2889. stbtt__handle_clipped_edge(scanline,x,e, x0,y0, x2,y2);
  2890. stbtt__handle_clipped_edge(scanline,x,e, x2,y2, x1,y1);
  2891. stbtt__handle_clipped_edge(scanline,x,e, x1,y1, x3,y3);
  2892. } else if (x0 < x1 && x3 > x1) { // two segments across x, down-right
  2893. stbtt__handle_clipped_edge(scanline,x,e, x0,y0, x1,y1);
  2894. stbtt__handle_clipped_edge(scanline,x,e, x1,y1, x3,y3);
  2895. } else if (x3 < x1 && x0 > x1) { // two segments across x, down-left
  2896. stbtt__handle_clipped_edge(scanline,x,e, x0,y0, x1,y1);
  2897. stbtt__handle_clipped_edge(scanline,x,e, x1,y1, x3,y3);
  2898. } else if (x0 < x2 && x3 > x2) { // two segments across x+1, down-right
  2899. stbtt__handle_clipped_edge(scanline,x,e, x0,y0, x2,y2);
  2900. stbtt__handle_clipped_edge(scanline,x,e, x2,y2, x3,y3);
  2901. } else if (x3 < x2 && x0 > x2) { // two segments across x+1, down-left
  2902. stbtt__handle_clipped_edge(scanline,x,e, x0,y0, x2,y2);
  2903. stbtt__handle_clipped_edge(scanline,x,e, x2,y2, x3,y3);
  2904. } else { // one segment
  2905. stbtt__handle_clipped_edge(scanline,x,e, x0,y0, x3,y3);
  2906. }
  2907. }
  2908. }
  2909. }
  2910. e = e->next;
  2911. }
  2912. }
  2913. // directly AA rasterize edges w/o supersampling
  2914. static void stbtt__rasterize_sorted_edges(stbtt__bitmap *result, stbtt__edge *e, int n, int vsubsample, int off_x, int off_y, void *userdata)
  2915. {
  2916. stbtt__hheap hh = { 0, 0, 0 };
  2917. stbtt__active_edge *active = NULL;
  2918. int y,j=0, i;
  2919. float scanline_data[129], *scanline, *scanline2;
  2920. STBTT__NOTUSED(vsubsample);
  2921. if (result->w > 64)
  2922. scanline = (float *) STBTT_malloc((result->w*2+1) * sizeof(float), userdata);
  2923. else
  2924. scanline = scanline_data;
  2925. scanline2 = scanline + result->w;
  2926. y = off_y;
  2927. e[n].y0 = (float) (off_y + result->h) + 1;
  2928. while (j < result->h) {
  2929. // find center of pixel for this scanline
  2930. float scan_y_top = y + 0.0f;
  2931. float scan_y_bottom = y + 1.0f;
  2932. stbtt__active_edge **step = &active;
  2933. STBTT_memset(scanline , 0, result->w*sizeof(scanline[0]));
  2934. STBTT_memset(scanline2, 0, (result->w+1)*sizeof(scanline[0]));
  2935. // update all active edges;
  2936. // remove all active edges that terminate before the top of this scanline
  2937. while (*step) {
  2938. stbtt__active_edge * z = *step;
  2939. if (z->ey <= scan_y_top) {
  2940. *step = z->next; // delete from list
  2941. STBTT_assert(z->direction);
  2942. z->direction = 0;
  2943. stbtt__hheap_free(&hh, z);
  2944. } else {
  2945. step = &((*step)->next); // advance through list
  2946. }
  2947. }
  2948. // insert all edges that start before the bottom of this scanline
  2949. while (e->y0 <= scan_y_bottom) {
  2950. if (e->y0 != e->y1) {
  2951. stbtt__active_edge *z = stbtt__new_active(&hh, e, off_x, scan_y_top, userdata);
  2952. if (z != NULL) {
  2953. if (j == 0 && off_y != 0) {
  2954. if (z->ey < scan_y_top) {
  2955. // this can happen due to subpixel positioning and some kind of fp rounding error i think
  2956. z->ey = scan_y_top;
  2957. }
  2958. }
  2959. STBTT_assert(z->ey >= scan_y_top); // if we get really unlucky a tiny bit of an edge can be out of bounds
  2960. // insert at front
  2961. z->next = active;
  2962. active = z;
  2963. }
  2964. }
  2965. ++e;
  2966. }
  2967. // now process all active edges
  2968. if (active)
  2969. stbtt__fill_active_edges_new(scanline, scanline2+1, result->w, active, scan_y_top);
  2970. {
  2971. float sum = 0;
  2972. for (i=0; i < result->w; ++i) {
  2973. float k;
  2974. int m;
  2975. sum += scanline2[i];
  2976. k = scanline[i] + sum;
  2977. k = (float) STBTT_fabs(k)*255 + 0.5f;
  2978. m = (int) k;
  2979. if (m > 255) m = 255;
  2980. result->pixels[j*result->stride + i] = (unsigned char) m;
  2981. }
  2982. }
  2983. // advance all the edges
  2984. step = &active;
  2985. while (*step) {
  2986. stbtt__active_edge *z = *step;
  2987. z->fx += z->fdx; // advance to position for current scanline
  2988. step = &((*step)->next); // advance through list
  2989. }
  2990. ++y;
  2991. ++j;
  2992. }
  2993. stbtt__hheap_cleanup(&hh, userdata);
  2994. if (scanline != scanline_data)
  2995. STBTT_free(scanline, userdata);
  2996. }
  2997. #else
  2998. #error "Unrecognized value of STBTT_RASTERIZER_VERSION"
  2999. #endif
  3000. #define STBTT__COMPARE(a,b) ((a)->y0 < (b)->y0)
  3001. static void stbtt__sort_edges_ins_sort(stbtt__edge *p, int n)
  3002. {
  3003. int i,j;
  3004. for (i=1; i < n; ++i) {
  3005. stbtt__edge t = p[i], *a = &t;
  3006. j = i;
  3007. while (j > 0) {
  3008. stbtt__edge *b = &p[j-1];
  3009. int c = STBTT__COMPARE(a,b);
  3010. if (!c) break;
  3011. p[j] = p[j-1];
  3012. --j;
  3013. }
  3014. if (i != j)
  3015. p[j] = t;
  3016. }
  3017. }
  3018. static void stbtt__sort_edges_quicksort(stbtt__edge *p, int n)
  3019. {
  3020. /* threshold for transitioning to insertion sort */
  3021. while (n > 12) {
  3022. stbtt__edge t;
  3023. int c01,c12,c,m,i,j;
  3024. /* compute median of three */
  3025. m = n >> 1;
  3026. c01 = STBTT__COMPARE(&p[0],&p[m]);
  3027. c12 = STBTT__COMPARE(&p[m],&p[n-1]);
  3028. /* if 0 >= mid >= end, or 0 < mid < end, then use mid */
  3029. if (c01 != c12) {
  3030. /* otherwise, we'll need to swap something else to middle */
  3031. int z;
  3032. c = STBTT__COMPARE(&p[0],&p[n-1]);
  3033. /* 0>mid && mid<n: 0>n => n; 0<n => 0 */
  3034. /* 0<mid && mid>n: 0>n => 0; 0<n => n */
  3035. z = (c == c12) ? 0 : n-1;
  3036. t = p[z];
  3037. p[z] = p[m];
  3038. p[m] = t;
  3039. }
  3040. /* now p[m] is the median-of-three */
  3041. /* swap it to the beginning so it won't move around */
  3042. t = p[0];
  3043. p[0] = p[m];
  3044. p[m] = t;
  3045. /* partition loop */
  3046. i=1;
  3047. j=n-1;
  3048. for(;;) {
  3049. /* handling of equality is crucial here */
  3050. /* for sentinels & efficiency with duplicates */
  3051. for (;;++i) {
  3052. if (!STBTT__COMPARE(&p[i], &p[0])) break;
  3053. }
  3054. for (;;--j) {
  3055. if (!STBTT__COMPARE(&p[0], &p[j])) break;
  3056. }
  3057. /* make sure we haven't crossed */
  3058. if (i >= j) break;
  3059. t = p[i];
  3060. p[i] = p[j];
  3061. p[j] = t;
  3062. ++i;
  3063. --j;
  3064. }
  3065. /* recurse on smaller side, iterate on larger */
  3066. if (j < (n-i)) {
  3067. stbtt__sort_edges_quicksort(p,j);
  3068. p = p+i;
  3069. n = n-i;
  3070. } else {
  3071. stbtt__sort_edges_quicksort(p+i, n-i);
  3072. n = j;
  3073. }
  3074. }
  3075. }
  3076. static void stbtt__sort_edges(stbtt__edge *p, int n)
  3077. {
  3078. stbtt__sort_edges_quicksort(p, n);
  3079. stbtt__sort_edges_ins_sort(p, n);
  3080. }
  3081. typedef struct
  3082. {
  3083. float x,y;
  3084. } stbtt__point;
  3085. 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)
  3086. {
  3087. float y_scale_inv = invert ? -scale_y : scale_y;
  3088. stbtt__edge *e;
  3089. int n,i,j,k,m;
  3090. #if STBTT_RASTERIZER_VERSION == 1
  3091. int vsubsample = result->h < 8 ? 15 : 5;
  3092. #elif STBTT_RASTERIZER_VERSION == 2
  3093. int vsubsample = 1;
  3094. #else
  3095. #error "Unrecognized value of STBTT_RASTERIZER_VERSION"
  3096. #endif
  3097. // vsubsample should divide 255 evenly; otherwise we won't reach full opacity
  3098. // now we have to blow out the windings into explicit edge lists
  3099. n = 0;
  3100. for (i=0; i < windings; ++i)
  3101. n += wcount[i];
  3102. e = (stbtt__edge *) STBTT_malloc(sizeof(*e) * (n+1), userdata); // add an extra one as a sentinel
  3103. if (e == 0) return;
  3104. n = 0;
  3105. m=0;
  3106. for (i=0; i < windings; ++i) {
  3107. stbtt__point *p = pts + m;
  3108. m += wcount[i];
  3109. j = wcount[i]-1;
  3110. for (k=0; k < wcount[i]; j=k++) {
  3111. int a=k,b=j;
  3112. // skip the edge if horizontal
  3113. if (p[j].y == p[k].y)
  3114. continue;
  3115. // add edge from j to k to the list
  3116. e[n].invert = 0;
  3117. if (invert ? p[j].y > p[k].y : p[j].y < p[k].y) {
  3118. e[n].invert = 1;
  3119. a=j,b=k;
  3120. }
  3121. e[n].x0 = p[a].x * scale_x + shift_x;
  3122. e[n].y0 = (p[a].y * y_scale_inv + shift_y) * vsubsample;
  3123. e[n].x1 = p[b].x * scale_x + shift_x;
  3124. e[n].y1 = (p[b].y * y_scale_inv + shift_y) * vsubsample;
  3125. ++n;
  3126. }
  3127. }
  3128. // now sort the edges by their highest point (should snap to integer, and then by x)
  3129. //STBTT_sort(e, n, sizeof(e[0]), stbtt__edge_compare);
  3130. stbtt__sort_edges(e, n);
  3131. // now, traverse the scanlines and find the intersections on each scanline, use xor winding rule
  3132. stbtt__rasterize_sorted_edges(result, e, n, vsubsample, off_x, off_y, userdata);
  3133. STBTT_free(e, userdata);
  3134. }
  3135. static void stbtt__add_point(stbtt__point *points, int n, float x, float y)
  3136. {
  3137. if (!points) return; // during first pass, it's unallocated
  3138. points[n].x = x;
  3139. points[n].y = y;
  3140. }
  3141. // tessellate until threshold p is happy... @TODO warped to compensate for non-linear stretching
  3142. 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)
  3143. {
  3144. // midpoint
  3145. float mx = (x0 + 2*x1 + x2)/4;
  3146. float my = (y0 + 2*y1 + y2)/4;
  3147. // versus directly drawn line
  3148. float dx = (x0+x2)/2 - mx;
  3149. float dy = (y0+y2)/2 - my;
  3150. if (n > 16) // 65536 segments on one curve better be enough!
  3151. return 1;
  3152. if (dx*dx+dy*dy > objspace_flatness_squared) { // half-pixel error allowed... need to be smaller if AA
  3153. stbtt__tesselate_curve(points, num_points, x0,y0, (x0+x1)/2.0f,(y0+y1)/2.0f, mx,my, objspace_flatness_squared,n+1);
  3154. stbtt__tesselate_curve(points, num_points, mx,my, (x1+x2)/2.0f,(y1+y2)/2.0f, x2,y2, objspace_flatness_squared,n+1);
  3155. } else {
  3156. stbtt__add_point(points, *num_points,x2,y2);
  3157. *num_points = *num_points+1;
  3158. }
  3159. return 1;
  3160. }
  3161. static void stbtt__tesselate_cubic(stbtt__point *points, int *num_points, float x0, float y0, float x1, float y1, float x2, float y2, float x3, float y3, float objspace_flatness_squared, int n)
  3162. {
  3163. // @TODO this "flatness" calculation is just made-up nonsense that seems to work well enough
  3164. float dx0 = x1-x0;
  3165. float dy0 = y1-y0;
  3166. float dx1 = x2-x1;
  3167. float dy1 = y2-y1;
  3168. float dx2 = x3-x2;
  3169. float dy2 = y3-y2;
  3170. float dx = x3-x0;
  3171. float dy = y3-y0;
  3172. float longlen = (float) (STBTT_sqrt(dx0*dx0+dy0*dy0)+STBTT_sqrt(dx1*dx1+dy1*dy1)+STBTT_sqrt(dx2*dx2+dy2*dy2));
  3173. float shortlen = (float) STBTT_sqrt(dx*dx+dy*dy);
  3174. float flatness_squared = longlen*longlen-shortlen*shortlen;
  3175. if (n > 16) // 65536 segments on one curve better be enough!
  3176. return;
  3177. if (flatness_squared > objspace_flatness_squared) {
  3178. float x01 = (x0+x1)/2;
  3179. float y01 = (y0+y1)/2;
  3180. float x12 = (x1+x2)/2;
  3181. float y12 = (y1+y2)/2;
  3182. float x23 = (x2+x3)/2;
  3183. float y23 = (y2+y3)/2;
  3184. float xa = (x01+x12)/2;
  3185. float ya = (y01+y12)/2;
  3186. float xb = (x12+x23)/2;
  3187. float yb = (y12+y23)/2;
  3188. float mx = (xa+xb)/2;
  3189. float my = (ya+yb)/2;
  3190. stbtt__tesselate_cubic(points, num_points, x0,y0, x01,y01, xa,ya, mx,my, objspace_flatness_squared,n+1);
  3191. stbtt__tesselate_cubic(points, num_points, mx,my, xb,yb, x23,y23, x3,y3, objspace_flatness_squared,n+1);
  3192. } else {
  3193. stbtt__add_point(points, *num_points,x3,y3);
  3194. *num_points = *num_points+1;
  3195. }
  3196. }
  3197. // returns number of contours
  3198. static stbtt__point *stbtt_FlattenCurves(stbtt_vertex *vertices, int num_verts, float objspace_flatness, int **contour_lengths, int *num_contours, void *userdata)
  3199. {
  3200. stbtt__point *points=0;
  3201. int num_points=0;
  3202. float objspace_flatness_squared = objspace_flatness * objspace_flatness;
  3203. int i,n=0,start=0, pass;
  3204. // count how many "moves" there are to get the contour count
  3205. for (i=0; i < num_verts; ++i)
  3206. if (vertices[i].type == STBTT_vmove)
  3207. ++n;
  3208. *num_contours = n;
  3209. if (n == 0) return 0;
  3210. *contour_lengths = (int *) STBTT_malloc(sizeof(**contour_lengths) * n, userdata);
  3211. if (*contour_lengths == 0) {
  3212. *num_contours = 0;
  3213. return 0;
  3214. }
  3215. // make two passes through the points so we don't need to realloc
  3216. for (pass=0; pass < 2; ++pass) {
  3217. float x=0,y=0;
  3218. if (pass == 1) {
  3219. points = (stbtt__point *) STBTT_malloc(num_points * sizeof(points[0]), userdata);
  3220. if (points == NULL) goto error;
  3221. }
  3222. num_points = 0;
  3223. n= -1;
  3224. for (i=0; i < num_verts; ++i) {
  3225. switch (vertices[i].type) {
  3226. case STBTT_vmove:
  3227. // start the next contour
  3228. if (n >= 0)
  3229. (*contour_lengths)[n] = num_points - start;
  3230. ++n;
  3231. start = num_points;
  3232. x = vertices[i].x, y = vertices[i].y;
  3233. stbtt__add_point(points, num_points++, x,y);
  3234. break;
  3235. case STBTT_vline:
  3236. x = vertices[i].x, y = vertices[i].y;
  3237. stbtt__add_point(points, num_points++, x, y);
  3238. break;
  3239. case STBTT_vcurve:
  3240. stbtt__tesselate_curve(points, &num_points, x,y,
  3241. vertices[i].cx, vertices[i].cy,
  3242. vertices[i].x, vertices[i].y,
  3243. objspace_flatness_squared, 0);
  3244. x = vertices[i].x, y = vertices[i].y;
  3245. break;
  3246. case STBTT_vcubic:
  3247. stbtt__tesselate_cubic(points, &num_points, x,y,
  3248. vertices[i].cx, vertices[i].cy,
  3249. vertices[i].cx1, vertices[i].cy1,
  3250. vertices[i].x, vertices[i].y,
  3251. objspace_flatness_squared, 0);
  3252. x = vertices[i].x, y = vertices[i].y;
  3253. break;
  3254. }
  3255. }
  3256. (*contour_lengths)[n] = num_points - start;
  3257. }
  3258. return points;
  3259. error:
  3260. STBTT_free(points, userdata);
  3261. STBTT_free(*contour_lengths, userdata);
  3262. *contour_lengths = 0;
  3263. *num_contours = 0;
  3264. return NULL;
  3265. }
  3266. STBTT_DEF void stbtt_Rasterize(stbtt__bitmap *result, float flatness_in_pixels, stbtt_vertex *vertices, int num_verts, float scale_x, float scale_y, float shift_x, float shift_y, int x_off, int y_off, int invert, void *userdata)
  3267. {
  3268. float scale = scale_x > scale_y ? scale_y : scale_x;
  3269. int winding_count = 0;
  3270. int *winding_lengths = NULL;
  3271. stbtt__point *windings = stbtt_FlattenCurves(vertices, num_verts, flatness_in_pixels / scale, &winding_lengths, &winding_count, userdata);
  3272. if (windings) {
  3273. stbtt__rasterize(result, windings, winding_lengths, winding_count, scale_x, scale_y, shift_x, shift_y, x_off, y_off, invert, userdata);
  3274. STBTT_free(winding_lengths, userdata);
  3275. STBTT_free(windings, userdata);
  3276. }
  3277. }
  3278. STBTT_DEF void stbtt_FreeBitmap(unsigned char *bitmap, void *userdata)
  3279. {
  3280. STBTT_free(bitmap, userdata);
  3281. }
  3282. STBTT_DEF unsigned char *stbtt_GetGlyphBitmapSubpixel(const stbtt_fontinfo *info, float scale_x, float scale_y, float shift_x, float shift_y, int glyph, int *width, int *height, int *xoff, int *yoff)
  3283. {
  3284. int ix0,iy0,ix1,iy1;
  3285. stbtt__bitmap gbm;
  3286. stbtt_vertex *vertices;
  3287. int num_verts = stbtt_GetGlyphShape(info, glyph, &vertices);
  3288. if (scale_x == 0) scale_x = scale_y;
  3289. if (scale_y == 0) {
  3290. if (scale_x == 0) {
  3291. STBTT_free(vertices, info->userdata);
  3292. return NULL;
  3293. }
  3294. scale_y = scale_x;
  3295. }
  3296. stbtt_GetGlyphBitmapBoxSubpixel(info, glyph, scale_x, scale_y, shift_x, shift_y, &ix0,&iy0,&ix1,&iy1);
  3297. // now we get the size
  3298. gbm.w = (ix1 - ix0);
  3299. gbm.h = (iy1 - iy0);
  3300. gbm.pixels = NULL; // in case we error
  3301. if (width ) *width = gbm.w;
  3302. if (height) *height = gbm.h;
  3303. if (xoff ) *xoff = ix0;
  3304. if (yoff ) *yoff = iy0;
  3305. if (gbm.w && gbm.h) {
  3306. gbm.pixels = (unsigned char *) STBTT_malloc(gbm.w * gbm.h, info->userdata);
  3307. if (gbm.pixels) {
  3308. gbm.stride = gbm.w;
  3309. stbtt_Rasterize(&gbm, 0.35f, vertices, num_verts, scale_x, scale_y, shift_x, shift_y, ix0, iy0, 1, info->userdata);
  3310. }
  3311. }
  3312. STBTT_free(vertices, info->userdata);
  3313. return gbm.pixels;
  3314. }
  3315. STBTT_DEF unsigned char *stbtt_GetGlyphBitmap(const stbtt_fontinfo *info, float scale_x, float scale_y, int glyph, int *width, int *height, int *xoff, int *yoff)
  3316. {
  3317. return stbtt_GetGlyphBitmapSubpixel(info, scale_x, scale_y, 0.0f, 0.0f, glyph, width, height, xoff, yoff);
  3318. }
  3319. STBTT_DEF void stbtt_MakeGlyphBitmapSubpixel(const stbtt_fontinfo *info, unsigned char *output, int out_w, int out_h, int out_stride, float scale_x, float scale_y, float shift_x, float shift_y, int glyph)
  3320. {
  3321. int ix0,iy0;
  3322. stbtt_vertex *vertices;
  3323. int num_verts = stbtt_GetGlyphShape(info, glyph, &vertices);
  3324. stbtt__bitmap gbm;
  3325. stbtt_GetGlyphBitmapBoxSubpixel(info, glyph, scale_x, scale_y, shift_x, shift_y, &ix0,&iy0,0,0);
  3326. gbm.pixels = output;
  3327. gbm.w = out_w;
  3328. gbm.h = out_h;
  3329. gbm.stride = out_stride;
  3330. if (gbm.w && gbm.h)
  3331. stbtt_Rasterize(&gbm, 0.35f, vertices, num_verts, scale_x, scale_y, shift_x, shift_y, ix0,iy0, 1, info->userdata);
  3332. STBTT_free(vertices, info->userdata);
  3333. }
  3334. STBTT_DEF void stbtt_MakeGlyphBitmap(const stbtt_fontinfo *info, unsigned char *output, int out_w, int out_h, int out_stride, float scale_x, float scale_y, int glyph)
  3335. {
  3336. stbtt_MakeGlyphBitmapSubpixel(info, output, out_w, out_h, out_stride, scale_x, scale_y, 0.0f,0.0f, glyph);
  3337. }
  3338. STBTT_DEF unsigned char *stbtt_GetCodepointBitmapSubpixel(const stbtt_fontinfo *info, float scale_x, float scale_y, float shift_x, float shift_y, int codepoint, int *width, int *height, int *xoff, int *yoff)
  3339. {
  3340. return stbtt_GetGlyphBitmapSubpixel(info, scale_x, scale_y,shift_x,shift_y, stbtt_FindGlyphIndex(info,codepoint), width,height,xoff,yoff);
  3341. }
  3342. STBTT_DEF void stbtt_MakeCodepointBitmapSubpixelPrefilter(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 oversample_x, int oversample_y, float *sub_x, float *sub_y, int codepoint)
  3343. {
  3344. stbtt_MakeGlyphBitmapSubpixelPrefilter(info, output, out_w, out_h, out_stride, scale_x, scale_y, shift_x, shift_y, oversample_x, oversample_y, sub_x, sub_y, stbtt_FindGlyphIndex(info,codepoint));
  3345. }
  3346. STBTT_DEF void stbtt_MakeCodepointBitmapSubpixel(const stbtt_fontinfo *info, unsigned char *output, int out_w, int out_h, int out_stride, float scale_x, float scale_y, float shift_x, float shift_y, int codepoint)
  3347. {
  3348. stbtt_MakeGlyphBitmapSubpixel(info, output, out_w, out_h, out_stride, scale_x, scale_y, shift_x, shift_y, stbtt_FindGlyphIndex(info,codepoint));
  3349. }
  3350. STBTT_DEF unsigned char *stbtt_GetCodepointBitmap(const stbtt_fontinfo *info, float scale_x, float scale_y, int codepoint, int *width, int *height, int *xoff, int *yoff)
  3351. {
  3352. return stbtt_GetCodepointBitmapSubpixel(info, scale_x, scale_y, 0.0f,0.0f, codepoint, width,height,xoff,yoff);
  3353. }
  3354. STBTT_DEF void stbtt_MakeCodepointBitmap(const stbtt_fontinfo *info, unsigned char *output, int out_w, int out_h, int out_stride, float scale_x, float scale_y, int codepoint)
  3355. {
  3356. stbtt_MakeCodepointBitmapSubpixel(info, output, out_w, out_h, out_stride, scale_x, scale_y, 0.0f,0.0f, codepoint);
  3357. }
  3358. //////////////////////////////////////////////////////////////////////////////
  3359. //
  3360. // bitmap baking
  3361. //
  3362. // This is SUPER-CRAPPY packing to keep source code small
  3363. static int stbtt_BakeFontBitmap_internal(unsigned char *data, int offset, // font location (use offset=0 for plain .ttf)
  3364. float pixel_height, // height of font in pixels
  3365. unsigned char *pixels, int pw, int ph, // bitmap to be filled in
  3366. int first_char, int num_chars, // characters to bake
  3367. stbtt_bakedchar *chardata)
  3368. {
  3369. float scale;
  3370. int x,y,bottom_y, i;
  3371. stbtt_fontinfo f;
  3372. f.userdata = NULL;
  3373. if (!stbtt_InitFont(&f, data, offset))
  3374. return -1;
  3375. STBTT_memset(pixels, 0, pw*ph); // background of 0 around pixels
  3376. x=y=1;
  3377. bottom_y = 1;
  3378. scale = stbtt_ScaleForPixelHeight(&f, pixel_height);
  3379. for (i=0; i < num_chars; ++i) {
  3380. int advance, lsb, x0,y0,x1,y1,gw,gh;
  3381. int g = stbtt_FindGlyphIndex(&f, first_char + i);
  3382. stbtt_GetGlyphHMetrics(&f, g, &advance, &lsb);
  3383. stbtt_GetGlyphBitmapBox(&f, g, scale,scale, &x0,&y0,&x1,&y1);
  3384. gw = x1-x0;
  3385. gh = y1-y0;
  3386. if (x + gw + 1 >= pw)
  3387. y = bottom_y, x = 1; // advance to next row
  3388. if (y + gh + 1 >= ph) // check if it fits vertically AFTER potentially moving to next row
  3389. return -i;
  3390. STBTT_assert(x+gw < pw);
  3391. STBTT_assert(y+gh < ph);
  3392. stbtt_MakeGlyphBitmap(&f, pixels+x+y*pw, gw,gh,pw, scale,scale, g);
  3393. chardata[i].x0 = (stbtt_int16) x;
  3394. chardata[i].y0 = (stbtt_int16) y;
  3395. chardata[i].x1 = (stbtt_int16) (x + gw);
  3396. chardata[i].y1 = (stbtt_int16) (y + gh);
  3397. chardata[i].xadvance = scale * advance;
  3398. chardata[i].xoff = (float) x0;
  3399. chardata[i].yoff = (float) y0;
  3400. x = x + gw + 1;
  3401. if (y+gh+1 > bottom_y)
  3402. bottom_y = y+gh+1;
  3403. }
  3404. return bottom_y;
  3405. }
  3406. STBTT_DEF void stbtt_GetBakedQuad(const stbtt_bakedchar *chardata, int pw, int ph, int char_index, float *xpos, float *ypos, stbtt_aligned_quad *q, int opengl_fillrule)
  3407. {
  3408. float d3d_bias = opengl_fillrule ? 0 : -0.5f;
  3409. float ipw = 1.0f / pw, iph = 1.0f / ph;
  3410. const stbtt_bakedchar *b = chardata + char_index;
  3411. int round_x = STBTT_ifloor((*xpos + b->xoff) + 0.5f);
  3412. int round_y = STBTT_ifloor((*ypos + b->yoff) + 0.5f);
  3413. q->x0 = round_x + d3d_bias;
  3414. q->y0 = round_y + d3d_bias;
  3415. q->x1 = round_x + b->x1 - b->x0 + d3d_bias;
  3416. q->y1 = round_y + b->y1 - b->y0 + d3d_bias;
  3417. q->s0 = b->x0 * ipw;
  3418. q->t0 = b->y0 * iph;
  3419. q->s1 = b->x1 * ipw;
  3420. q->t1 = b->y1 * iph;
  3421. *xpos += b->xadvance;
  3422. }
  3423. //////////////////////////////////////////////////////////////////////////////
  3424. //
  3425. // rectangle packing replacement routines if you don't have stb_rect_pack.h
  3426. //
  3427. #ifndef STB_RECT_PACK_VERSION
  3428. typedef int stbrp_coord;
  3429. ////////////////////////////////////////////////////////////////////////////////////
  3430. // //
  3431. // //
  3432. // COMPILER WARNING ?!?!? //
  3433. // //
  3434. // //
  3435. // if you get a compile warning due to these symbols being defined more than //
  3436. // once, move #include "stb_rect_pack.h" before #include "stb_truetype.h" //
  3437. // //
  3438. ////////////////////////////////////////////////////////////////////////////////////
  3439. typedef struct
  3440. {
  3441. int width,height;
  3442. int x,y,bottom_y;
  3443. } stbrp_context;
  3444. typedef struct
  3445. {
  3446. unsigned char x;
  3447. } stbrp_node;
  3448. struct stbrp_rect
  3449. {
  3450. stbrp_coord x,y;
  3451. int id,w,h,was_packed;
  3452. };
  3453. static void stbrp_init_target(stbrp_context *con, int pw, int ph, stbrp_node *nodes, int num_nodes)
  3454. {
  3455. con->width = pw;
  3456. con->height = ph;
  3457. con->x = 0;
  3458. con->y = 0;
  3459. con->bottom_y = 0;
  3460. STBTT__NOTUSED(nodes);
  3461. STBTT__NOTUSED(num_nodes);
  3462. }
  3463. static void stbrp_pack_rects(stbrp_context *con, stbrp_rect *rects, int num_rects)
  3464. {
  3465. int i;
  3466. for (i=0; i < num_rects; ++i) {
  3467. if (con->x + rects[i].w > con->width) {
  3468. con->x = 0;
  3469. con->y = con->bottom_y;
  3470. }
  3471. if (con->y + rects[i].h > con->height)
  3472. break;
  3473. rects[i].x = con->x;
  3474. rects[i].y = con->y;
  3475. rects[i].was_packed = 1;
  3476. con->x += rects[i].w;
  3477. if (con->y + rects[i].h > con->bottom_y)
  3478. con->bottom_y = con->y + rects[i].h;
  3479. }
  3480. for ( ; i < num_rects; ++i)
  3481. rects[i].was_packed = 0;
  3482. }
  3483. #endif
  3484. //////////////////////////////////////////////////////////////////////////////
  3485. //
  3486. // bitmap baking
  3487. //
  3488. // This is SUPER-AWESOME (tm Ryan Gordon) packing using stb_rect_pack.h. If
  3489. // stb_rect_pack.h isn't available, it uses the BakeFontBitmap strategy.
  3490. STBTT_DEF int stbtt_PackBegin(stbtt_pack_context *spc, unsigned char *pixels, int pw, int ph, int stride_in_bytes, int padding, void *alloc_context)
  3491. {
  3492. stbrp_context *context = (stbrp_context *) STBTT_malloc(sizeof(*context) ,alloc_context);
  3493. int num_nodes = pw - padding;
  3494. stbrp_node *nodes = (stbrp_node *) STBTT_malloc(sizeof(*nodes ) * num_nodes,alloc_context);
  3495. if (context == NULL || nodes == NULL) {
  3496. if (context != NULL) STBTT_free(context, alloc_context);
  3497. if (nodes != NULL) STBTT_free(nodes , alloc_context);
  3498. return 0;
  3499. }
  3500. spc->user_allocator_context = alloc_context;
  3501. spc->width = pw;
  3502. spc->height = ph;
  3503. spc->pixels = pixels;
  3504. spc->pack_info = context;
  3505. spc->nodes = nodes;
  3506. spc->padding = padding;
  3507. spc->stride_in_bytes = stride_in_bytes != 0 ? stride_in_bytes : pw;
  3508. spc->h_oversample = 1;
  3509. spc->v_oversample = 1;
  3510. spc->skip_missing = 0;
  3511. stbrp_init_target(context, pw-padding, ph-padding, nodes, num_nodes);
  3512. if (pixels)
  3513. STBTT_memset(pixels, 0, pw*ph); // background of 0 around pixels
  3514. return 1;
  3515. }
  3516. STBTT_DEF void stbtt_PackEnd (stbtt_pack_context *spc)
  3517. {
  3518. STBTT_free(spc->nodes , spc->user_allocator_context);
  3519. STBTT_free(spc->pack_info, spc->user_allocator_context);
  3520. }
  3521. STBTT_DEF void stbtt_PackSetOversampling(stbtt_pack_context *spc, unsigned int h_oversample, unsigned int v_oversample)
  3522. {
  3523. STBTT_assert(h_oversample <= STBTT_MAX_OVERSAMPLE);
  3524. STBTT_assert(v_oversample <= STBTT_MAX_OVERSAMPLE);
  3525. if (h_oversample <= STBTT_MAX_OVERSAMPLE)
  3526. spc->h_oversample = h_oversample;
  3527. if (v_oversample <= STBTT_MAX_OVERSAMPLE)
  3528. spc->v_oversample = v_oversample;
  3529. }
  3530. STBTT_DEF void stbtt_PackSetSkipMissingCodepoints(stbtt_pack_context *spc, int skip)
  3531. {
  3532. spc->skip_missing = skip;
  3533. }
  3534. #define STBTT__OVER_MASK (STBTT_MAX_OVERSAMPLE-1)
  3535. static void stbtt__h_prefilter(unsigned char *pixels, int w, int h, int stride_in_bytes, unsigned int kernel_width)
  3536. {
  3537. unsigned char buffer[STBTT_MAX_OVERSAMPLE];
  3538. int safe_w = w - kernel_width;
  3539. int j;
  3540. STBTT_memset(buffer, 0, STBTT_MAX_OVERSAMPLE); // suppress bogus warning from VS2013 -analyze
  3541. for (j=0; j < h; ++j) {
  3542. int i;
  3543. unsigned int total;
  3544. STBTT_memset(buffer, 0, kernel_width);
  3545. total = 0;
  3546. // make kernel_width a constant in common cases so compiler can optimize out the divide
  3547. switch (kernel_width) {
  3548. case 2:
  3549. for (i=0; i <= safe_w; ++i) {
  3550. total += pixels[i] - buffer[i & STBTT__OVER_MASK];
  3551. buffer[(i+kernel_width) & STBTT__OVER_MASK] = pixels[i];
  3552. pixels[i] = (unsigned char) (total / 2);
  3553. }
  3554. break;
  3555. case 3:
  3556. for (i=0; i <= safe_w; ++i) {
  3557. total += pixels[i] - buffer[i & STBTT__OVER_MASK];
  3558. buffer[(i+kernel_width) & STBTT__OVER_MASK] = pixels[i];
  3559. pixels[i] = (unsigned char) (total / 3);
  3560. }
  3561. break;
  3562. case 4:
  3563. for (i=0; i <= safe_w; ++i) {
  3564. total += pixels[i] - buffer[i & STBTT__OVER_MASK];
  3565. buffer[(i+kernel_width) & STBTT__OVER_MASK] = pixels[i];
  3566. pixels[i] = (unsigned char) (total / 4);
  3567. }
  3568. break;
  3569. case 5:
  3570. for (i=0; i <= safe_w; ++i) {
  3571. total += pixels[i] - buffer[i & STBTT__OVER_MASK];
  3572. buffer[(i+kernel_width) & STBTT__OVER_MASK] = pixels[i];
  3573. pixels[i] = (unsigned char) (total / 5);
  3574. }
  3575. break;
  3576. default:
  3577. for (i=0; i <= safe_w; ++i) {
  3578. total += pixels[i] - buffer[i & STBTT__OVER_MASK];
  3579. buffer[(i+kernel_width) & STBTT__OVER_MASK] = pixels[i];
  3580. pixels[i] = (unsigned char) (total / kernel_width);
  3581. }
  3582. break;
  3583. }
  3584. for (; i < w; ++i) {
  3585. STBTT_assert(pixels[i] == 0);
  3586. total -= buffer[i & STBTT__OVER_MASK];
  3587. pixels[i] = (unsigned char) (total / kernel_width);
  3588. }
  3589. pixels += stride_in_bytes;
  3590. }
  3591. }
  3592. static void stbtt__v_prefilter(unsigned char *pixels, int w, int h, int stride_in_bytes, unsigned int kernel_width)
  3593. {
  3594. unsigned char buffer[STBTT_MAX_OVERSAMPLE];
  3595. int safe_h = h - kernel_width;
  3596. int j;
  3597. STBTT_memset(buffer, 0, STBTT_MAX_OVERSAMPLE); // suppress bogus warning from VS2013 -analyze
  3598. for (j=0; j < w; ++j) {
  3599. int i;
  3600. unsigned int total;
  3601. STBTT_memset(buffer, 0, kernel_width);
  3602. total = 0;
  3603. // make kernel_width a constant in common cases so compiler can optimize out the divide
  3604. switch (kernel_width) {
  3605. case 2:
  3606. for (i=0; i <= safe_h; ++i) {
  3607. total += pixels[i*stride_in_bytes] - buffer[i & STBTT__OVER_MASK];
  3608. buffer[(i+kernel_width) & STBTT__OVER_MASK] = pixels[i*stride_in_bytes];
  3609. pixels[i*stride_in_bytes] = (unsigned char) (total / 2);
  3610. }
  3611. break;
  3612. case 3:
  3613. for (i=0; i <= safe_h; ++i) {
  3614. total += pixels[i*stride_in_bytes] - buffer[i & STBTT__OVER_MASK];
  3615. buffer[(i+kernel_width) & STBTT__OVER_MASK] = pixels[i*stride_in_bytes];
  3616. pixels[i*stride_in_bytes] = (unsigned char) (total / 3);
  3617. }
  3618. break;
  3619. case 4:
  3620. for (i=0; i <= safe_h; ++i) {
  3621. total += pixels[i*stride_in_bytes] - buffer[i & STBTT__OVER_MASK];
  3622. buffer[(i+kernel_width) & STBTT__OVER_MASK] = pixels[i*stride_in_bytes];
  3623. pixels[i*stride_in_bytes] = (unsigned char) (total / 4);
  3624. }
  3625. break;
  3626. case 5:
  3627. for (i=0; i <= safe_h; ++i) {
  3628. total += pixels[i*stride_in_bytes] - buffer[i & STBTT__OVER_MASK];
  3629. buffer[(i+kernel_width) & STBTT__OVER_MASK] = pixels[i*stride_in_bytes];
  3630. pixels[i*stride_in_bytes] = (unsigned char) (total / 5);
  3631. }
  3632. break;
  3633. default:
  3634. for (i=0; i <= safe_h; ++i) {
  3635. total += pixels[i*stride_in_bytes] - buffer[i & STBTT__OVER_MASK];
  3636. buffer[(i+kernel_width) & STBTT__OVER_MASK] = pixels[i*stride_in_bytes];
  3637. pixels[i*stride_in_bytes] = (unsigned char) (total / kernel_width);
  3638. }
  3639. break;
  3640. }
  3641. for (; i < h; ++i) {
  3642. STBTT_assert(pixels[i*stride_in_bytes] == 0);
  3643. total -= buffer[i & STBTT__OVER_MASK];
  3644. pixels[i*stride_in_bytes] = (unsigned char) (total / kernel_width);
  3645. }
  3646. pixels += 1;
  3647. }
  3648. }
  3649. static float stbtt__oversample_shift(int oversample)
  3650. {
  3651. if (!oversample)
  3652. return 0.0f;
  3653. // The prefilter is a box filter of width "oversample",
  3654. // which shifts phase by (oversample - 1)/2 pixels in
  3655. // oversampled space. We want to shift in the opposite
  3656. // direction to counter this.
  3657. return (float)-(oversample - 1) / (2.0f * (float)oversample);
  3658. }
  3659. // rects array must be big enough to accommodate all characters in the given ranges
  3660. STBTT_DEF int stbtt_PackFontRangesGatherRects(stbtt_pack_context *spc, const stbtt_fontinfo *info, stbtt_pack_range *ranges, int num_ranges, stbrp_rect *rects)
  3661. {
  3662. int i,j,k;
  3663. int missing_glyph_added = 0;
  3664. k=0;
  3665. for (i=0; i < num_ranges; ++i) {
  3666. float fh = ranges[i].font_size;
  3667. float scale = fh > 0 ? stbtt_ScaleForPixelHeight(info, fh) : stbtt_ScaleForMappingEmToPixels(info, -fh);
  3668. ranges[i].h_oversample = (unsigned char) spc->h_oversample;
  3669. ranges[i].v_oversample = (unsigned char) spc->v_oversample;
  3670. for (j=0; j < ranges[i].num_chars; ++j) {
  3671. int x0,y0,x1,y1;
  3672. int codepoint = ranges[i].array_of_unicode_codepoints == NULL ? ranges[i].first_unicode_codepoint_in_range + j : ranges[i].array_of_unicode_codepoints[j];
  3673. int glyph = stbtt_FindGlyphIndex(info, codepoint);
  3674. if (glyph == 0 && (spc->skip_missing || missing_glyph_added)) {
  3675. rects[k].w = rects[k].h = 0;
  3676. } else {
  3677. stbtt_GetGlyphBitmapBoxSubpixel(info,glyph,
  3678. scale * spc->h_oversample,
  3679. scale * spc->v_oversample,
  3680. 0,0,
  3681. &x0,&y0,&x1,&y1);
  3682. rects[k].w = (stbrp_coord) (x1-x0 + spc->padding + spc->h_oversample-1);
  3683. rects[k].h = (stbrp_coord) (y1-y0 + spc->padding + spc->v_oversample-1);
  3684. if (glyph == 0)
  3685. missing_glyph_added = 1;
  3686. }
  3687. ++k;
  3688. }
  3689. }
  3690. return k;
  3691. }
  3692. STBTT_DEF void stbtt_MakeGlyphBitmapSubpixelPrefilter(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 prefilter_x, int prefilter_y, float *sub_x, float *sub_y, int glyph)
  3693. {
  3694. stbtt_MakeGlyphBitmapSubpixel(info,
  3695. output,
  3696. out_w - (prefilter_x - 1),
  3697. out_h - (prefilter_y - 1),
  3698. out_stride,
  3699. scale_x,
  3700. scale_y,
  3701. shift_x,
  3702. shift_y,
  3703. glyph);
  3704. if (prefilter_x > 1)
  3705. stbtt__h_prefilter(output, out_w, out_h, out_stride, prefilter_x);
  3706. if (prefilter_y > 1)
  3707. stbtt__v_prefilter(output, out_w, out_h, out_stride, prefilter_y);
  3708. *sub_x = stbtt__oversample_shift(prefilter_x);
  3709. *sub_y = stbtt__oversample_shift(prefilter_y);
  3710. }
  3711. // rects array must be big enough to accommodate all characters in the given ranges
  3712. STBTT_DEF int stbtt_PackFontRangesRenderIntoRects(stbtt_pack_context *spc, const stbtt_fontinfo *info, stbtt_pack_range *ranges, int num_ranges, stbrp_rect *rects)
  3713. {
  3714. int i,j,k, missing_glyph = -1, return_value = 1;
  3715. // save current values
  3716. int old_h_over = spc->h_oversample;
  3717. int old_v_over = spc->v_oversample;
  3718. k = 0;
  3719. for (i=0; i < num_ranges; ++i) {
  3720. float fh = ranges[i].font_size;
  3721. float scale = fh > 0 ? stbtt_ScaleForPixelHeight(info, fh) : stbtt_ScaleForMappingEmToPixels(info, -fh);
  3722. float recip_h,recip_v,sub_x,sub_y;
  3723. spc->h_oversample = ranges[i].h_oversample;
  3724. spc->v_oversample = ranges[i].v_oversample;
  3725. recip_h = 1.0f / spc->h_oversample;
  3726. recip_v = 1.0f / spc->v_oversample;
  3727. sub_x = stbtt__oversample_shift(spc->h_oversample);
  3728. sub_y = stbtt__oversample_shift(spc->v_oversample);
  3729. for (j=0; j < ranges[i].num_chars; ++j) {
  3730. stbrp_rect *r = &rects[k];
  3731. if (r->was_packed && r->w != 0 && r->h != 0) {
  3732. stbtt_packedchar *bc = &ranges[i].chardata_for_range[j];
  3733. int advance, lsb, x0,y0,x1,y1;
  3734. int codepoint = ranges[i].array_of_unicode_codepoints == NULL ? ranges[i].first_unicode_codepoint_in_range + j : ranges[i].array_of_unicode_codepoints[j];
  3735. int glyph = stbtt_FindGlyphIndex(info, codepoint);
  3736. stbrp_coord pad = (stbrp_coord) spc->padding;
  3737. // pad on left and top
  3738. r->x += pad;
  3739. r->y += pad;
  3740. r->w -= pad;
  3741. r->h -= pad;
  3742. stbtt_GetGlyphHMetrics(info, glyph, &advance, &lsb);
  3743. stbtt_GetGlyphBitmapBox(info, glyph,
  3744. scale * spc->h_oversample,
  3745. scale * spc->v_oversample,
  3746. &x0,&y0,&x1,&y1);
  3747. stbtt_MakeGlyphBitmapSubpixel(info,
  3748. spc->pixels + r->x + r->y*spc->stride_in_bytes,
  3749. r->w - spc->h_oversample+1,
  3750. r->h - spc->v_oversample+1,
  3751. spc->stride_in_bytes,
  3752. scale * spc->h_oversample,
  3753. scale * spc->v_oversample,
  3754. 0,0,
  3755. glyph);
  3756. if (spc->h_oversample > 1)
  3757. stbtt__h_prefilter(spc->pixels + r->x + r->y*spc->stride_in_bytes,
  3758. r->w, r->h, spc->stride_in_bytes,
  3759. spc->h_oversample);
  3760. if (spc->v_oversample > 1)
  3761. stbtt__v_prefilter(spc->pixels + r->x + r->y*spc->stride_in_bytes,
  3762. r->w, r->h, spc->stride_in_bytes,
  3763. spc->v_oversample);
  3764. bc->x0 = (stbtt_int16) r->x;
  3765. bc->y0 = (stbtt_int16) r->y;
  3766. bc->x1 = (stbtt_int16) (r->x + r->w);
  3767. bc->y1 = (stbtt_int16) (r->y + r->h);
  3768. bc->xadvance = scale * advance;
  3769. bc->xoff = (float) x0 * recip_h + sub_x;
  3770. bc->yoff = (float) y0 * recip_v + sub_y;
  3771. bc->xoff2 = (x0 + r->w) * recip_h + sub_x;
  3772. bc->yoff2 = (y0 + r->h) * recip_v + sub_y;
  3773. if (glyph == 0)
  3774. missing_glyph = j;
  3775. } else if (spc->skip_missing) {
  3776. return_value = 0;
  3777. } else if (r->was_packed && r->w == 0 && r->h == 0 && missing_glyph >= 0) {
  3778. ranges[i].chardata_for_range[j] = ranges[i].chardata_for_range[missing_glyph];
  3779. } else {
  3780. return_value = 0; // if any fail, report failure
  3781. }
  3782. ++k;
  3783. }
  3784. }
  3785. // restore original values
  3786. spc->h_oversample = old_h_over;
  3787. spc->v_oversample = old_v_over;
  3788. return return_value;
  3789. }
  3790. STBTT_DEF void stbtt_PackFontRangesPackRects(stbtt_pack_context *spc, stbrp_rect *rects, int num_rects)
  3791. {
  3792. stbrp_pack_rects((stbrp_context *) spc->pack_info, rects, num_rects);
  3793. }
  3794. STBTT_DEF int stbtt_PackFontRanges(stbtt_pack_context *spc, const unsigned char *fontdata, int font_index, stbtt_pack_range *ranges, int num_ranges)
  3795. {
  3796. stbtt_fontinfo info;
  3797. int i,j,n, return_value = 1;
  3798. //stbrp_context *context = (stbrp_context *) spc->pack_info;
  3799. stbrp_rect *rects;
  3800. // flag all characters as NOT packed
  3801. for (i=0; i < num_ranges; ++i)
  3802. for (j=0; j < ranges[i].num_chars; ++j)
  3803. ranges[i].chardata_for_range[j].x0 =
  3804. ranges[i].chardata_for_range[j].y0 =
  3805. ranges[i].chardata_for_range[j].x1 =
  3806. ranges[i].chardata_for_range[j].y1 = 0;
  3807. n = 0;
  3808. for (i=0; i < num_ranges; ++i)
  3809. n += ranges[i].num_chars;
  3810. rects = (stbrp_rect *) STBTT_malloc(sizeof(*rects) * n, spc->user_allocator_context);
  3811. if (rects == NULL)
  3812. return 0;
  3813. info.userdata = spc->user_allocator_context;
  3814. stbtt_InitFont(&info, fontdata, stbtt_GetFontOffsetForIndex(fontdata,font_index));
  3815. n = stbtt_PackFontRangesGatherRects(spc, &info, ranges, num_ranges, rects);
  3816. stbtt_PackFontRangesPackRects(spc, rects, n);
  3817. return_value = stbtt_PackFontRangesRenderIntoRects(spc, &info, ranges, num_ranges, rects);
  3818. STBTT_free(rects, spc->user_allocator_context);
  3819. return return_value;
  3820. }
  3821. STBTT_DEF int stbtt_PackFontRange(stbtt_pack_context *spc, const unsigned char *fontdata, int font_index, float font_size,
  3822. int first_unicode_codepoint_in_range, int num_chars_in_range, stbtt_packedchar *chardata_for_range)
  3823. {
  3824. stbtt_pack_range range;
  3825. range.first_unicode_codepoint_in_range = first_unicode_codepoint_in_range;
  3826. range.array_of_unicode_codepoints = NULL;
  3827. range.num_chars = num_chars_in_range;
  3828. range.chardata_for_range = chardata_for_range;
  3829. range.font_size = font_size;
  3830. return stbtt_PackFontRanges(spc, fontdata, font_index, &range, 1);
  3831. }
  3832. STBTT_DEF void stbtt_GetScaledFontVMetrics(const unsigned char *fontdata, int index, float size, float *ascent, float *descent, float *lineGap)
  3833. {
  3834. int i_ascent, i_descent, i_lineGap;
  3835. float scale;
  3836. stbtt_fontinfo info;
  3837. stbtt_InitFont(&info, fontdata, stbtt_GetFontOffsetForIndex(fontdata, index));
  3838. scale = size > 0 ? stbtt_ScaleForPixelHeight(&info, size) : stbtt_ScaleForMappingEmToPixels(&info, -size);
  3839. stbtt_GetFontVMetrics(&info, &i_ascent, &i_descent, &i_lineGap);
  3840. *ascent = (float) i_ascent * scale;
  3841. *descent = (float) i_descent * scale;
  3842. *lineGap = (float) i_lineGap * scale;
  3843. }
  3844. STBTT_DEF void stbtt_GetPackedQuad(const stbtt_packedchar *chardata, int pw, int ph, int char_index, float *xpos, float *ypos, stbtt_aligned_quad *q, int align_to_integer)
  3845. {
  3846. float ipw = 1.0f / pw, iph = 1.0f / ph;
  3847. const stbtt_packedchar *b = chardata + char_index;
  3848. if (align_to_integer) {
  3849. float x = (float) STBTT_ifloor((*xpos + b->xoff) + 0.5f);
  3850. float y = (float) STBTT_ifloor((*ypos + b->yoff) + 0.5f);
  3851. q->x0 = x;
  3852. q->y0 = y;
  3853. q->x1 = x + b->xoff2 - b->xoff;
  3854. q->y1 = y + b->yoff2 - b->yoff;
  3855. } else {
  3856. q->x0 = *xpos + b->xoff;
  3857. q->y0 = *ypos + b->yoff;
  3858. q->x1 = *xpos + b->xoff2;
  3859. q->y1 = *ypos + b->yoff2;
  3860. }
  3861. q->s0 = b->x0 * ipw;
  3862. q->t0 = b->y0 * iph;
  3863. q->s1 = b->x1 * ipw;
  3864. q->t1 = b->y1 * iph;
  3865. *xpos += b->xadvance;
  3866. }
  3867. //////////////////////////////////////////////////////////////////////////////
  3868. //
  3869. // sdf computation
  3870. //
  3871. #define STBTT_min(a,b) ((a) < (b) ? (a) : (b))
  3872. #define STBTT_max(a,b) ((a) < (b) ? (b) : (a))
  3873. static int stbtt__ray_intersect_bezier(float orig[2], float ray[2], float q0[2], float q1[2], float q2[2], float hits[2][2])
  3874. {
  3875. float q0perp = q0[1]*ray[0] - q0[0]*ray[1];
  3876. float q1perp = q1[1]*ray[0] - q1[0]*ray[1];
  3877. float q2perp = q2[1]*ray[0] - q2[0]*ray[1];
  3878. float roperp = orig[1]*ray[0] - orig[0]*ray[1];
  3879. float a = q0perp - 2*q1perp + q2perp;
  3880. float b = q1perp - q0perp;
  3881. float c = q0perp - roperp;
  3882. float s0 = 0., s1 = 0.;
  3883. int num_s = 0;
  3884. if (a != 0.0) {
  3885. float discr = b*b - a*c;
  3886. if (discr > 0.0) {
  3887. float rcpna = -1 / a;
  3888. float d = (float) STBTT_sqrt(discr);
  3889. s0 = (b+d) * rcpna;
  3890. s1 = (b-d) * rcpna;
  3891. if (s0 >= 0.0 && s0 <= 1.0)
  3892. num_s = 1;
  3893. if (d > 0.0 && s1 >= 0.0 && s1 <= 1.0) {
  3894. if (num_s == 0) s0 = s1;
  3895. ++num_s;
  3896. }
  3897. }
  3898. } else {
  3899. // 2*b*s + c = 0
  3900. // s = -c / (2*b)
  3901. s0 = c / (-2 * b);
  3902. if (s0 >= 0.0 && s0 <= 1.0)
  3903. num_s = 1;
  3904. }
  3905. if (num_s == 0)
  3906. return 0;
  3907. else {
  3908. float rcp_len2 = 1 / (ray[0]*ray[0] + ray[1]*ray[1]);
  3909. float rayn_x = ray[0] * rcp_len2, rayn_y = ray[1] * rcp_len2;
  3910. float q0d = q0[0]*rayn_x + q0[1]*rayn_y;
  3911. float q1d = q1[0]*rayn_x + q1[1]*rayn_y;
  3912. float q2d = q2[0]*rayn_x + q2[1]*rayn_y;
  3913. float rod = orig[0]*rayn_x + orig[1]*rayn_y;
  3914. float q10d = q1d - q0d;
  3915. float q20d = q2d - q0d;
  3916. float q0rd = q0d - rod;
  3917. hits[0][0] = q0rd + s0*(2.0f - 2.0f*s0)*q10d + s0*s0*q20d;
  3918. hits[0][1] = a*s0+b;
  3919. if (num_s > 1) {
  3920. hits[1][0] = q0rd + s1*(2.0f - 2.0f*s1)*q10d + s1*s1*q20d;
  3921. hits[1][1] = a*s1+b;
  3922. return 2;
  3923. } else {
  3924. return 1;
  3925. }
  3926. }
  3927. }
  3928. static int equal(float *a, float *b)
  3929. {
  3930. return (a[0] == b[0] && a[1] == b[1]);
  3931. }
  3932. static int stbtt__compute_crossings_x(float x, float y, int nverts, stbtt_vertex *verts)
  3933. {
  3934. int i;
  3935. float orig[2], ray[2] = { 1, 0 };
  3936. float y_frac;
  3937. int winding = 0;
  3938. // make sure y never passes through a vertex of the shape
  3939. y_frac = (float) STBTT_fmod(y, 1.0f);
  3940. if (y_frac < 0.01f)
  3941. y += 0.01f;
  3942. else if (y_frac > 0.99f)
  3943. y -= 0.01f;
  3944. orig[0] = x;
  3945. orig[1] = y;
  3946. // test a ray from (-infinity,y) to (x,y)
  3947. for (i=0; i < nverts; ++i) {
  3948. if (verts[i].type == STBTT_vline) {
  3949. int x0 = (int) verts[i-1].x, y0 = (int) verts[i-1].y;
  3950. int x1 = (int) verts[i ].x, y1 = (int) verts[i ].y;
  3951. if (y > STBTT_min(y0,y1) && y < STBTT_max(y0,y1) && x > STBTT_min(x0,x1)) {
  3952. float x_inter = (y - y0) / (y1 - y0) * (x1-x0) + x0;
  3953. if (x_inter < x)
  3954. winding += (y0 < y1) ? 1 : -1;
  3955. }
  3956. }
  3957. if (verts[i].type == STBTT_vcurve) {
  3958. int x0 = (int) verts[i-1].x , y0 = (int) verts[i-1].y ;
  3959. int x1 = (int) verts[i ].cx, y1 = (int) verts[i ].cy;
  3960. int x2 = (int) verts[i ].x , y2 = (int) verts[i ].y ;
  3961. int ax = STBTT_min(x0,STBTT_min(x1,x2)), ay = STBTT_min(y0,STBTT_min(y1,y2));
  3962. int by = STBTT_max(y0,STBTT_max(y1,y2));
  3963. if (y > ay && y < by && x > ax) {
  3964. float q0[2],q1[2],q2[2];
  3965. float hits[2][2];
  3966. q0[0] = (float)x0;
  3967. q0[1] = (float)y0;
  3968. q1[0] = (float)x1;
  3969. q1[1] = (float)y1;
  3970. q2[0] = (float)x2;
  3971. q2[1] = (float)y2;
  3972. if (equal(q0,q1) || equal(q1,q2)) {
  3973. x0 = (int)verts[i-1].x;
  3974. y0 = (int)verts[i-1].y;
  3975. x1 = (int)verts[i ].x;
  3976. y1 = (int)verts[i ].y;
  3977. if (y > STBTT_min(y0,y1) && y < STBTT_max(y0,y1) && x > STBTT_min(x0,x1)) {
  3978. float x_inter = (y - y0) / (y1 - y0) * (x1-x0) + x0;
  3979. if (x_inter < x)
  3980. winding += (y0 < y1) ? 1 : -1;
  3981. }
  3982. } else {
  3983. int num_hits = stbtt__ray_intersect_bezier(orig, ray, q0, q1, q2, hits);
  3984. if (num_hits >= 1)
  3985. if (hits[0][0] < 0)
  3986. winding += (hits[0][1] < 0 ? -1 : 1);
  3987. if (num_hits >= 2)
  3988. if (hits[1][0] < 0)
  3989. winding += (hits[1][1] < 0 ? -1 : 1);
  3990. }
  3991. }
  3992. }
  3993. }
  3994. return winding;
  3995. }
  3996. static float stbtt__cuberoot( float x )
  3997. {
  3998. if (x<0)
  3999. return -(float) STBTT_pow(-x,1.0f/3.0f);
  4000. else
  4001. return (float) STBTT_pow( x,1.0f/3.0f);
  4002. }
  4003. // x^3 + a*x^2 + b*x + c = 0
  4004. static int stbtt__solve_cubic(float a, float b, float c, float* r)
  4005. {
  4006. float s = -a / 3;
  4007. float p = b - a*a / 3;
  4008. float q = a * (2*a*a - 9*b) / 27 + c;
  4009. float p3 = p*p*p;
  4010. float d = q*q + 4*p3 / 27;
  4011. if (d >= 0) {
  4012. float z = (float) STBTT_sqrt(d);
  4013. float u = (-q + z) / 2;
  4014. float v = (-q - z) / 2;
  4015. u = stbtt__cuberoot(u);
  4016. v = stbtt__cuberoot(v);
  4017. r[0] = s + u + v;
  4018. return 1;
  4019. } else {
  4020. float u = (float) STBTT_sqrt(-p/3);
  4021. float v = (float) STBTT_acos(-STBTT_sqrt(-27/p3) * q / 2) / 3; // p3 must be negative, since d is negative
  4022. float m = (float) STBTT_cos(v);
  4023. float n = (float) STBTT_cos(v-3.141592/2)*1.732050808f;
  4024. r[0] = s + u * 2 * m;
  4025. r[1] = s - u * (m + n);
  4026. r[2] = s - u * (m - n);
  4027. //STBTT_assert( STBTT_fabs(((r[0]+a)*r[0]+b)*r[0]+c) < 0.05f); // these asserts may not be safe at all scales, though they're in bezier t parameter units so maybe?
  4028. //STBTT_assert( STBTT_fabs(((r[1]+a)*r[1]+b)*r[1]+c) < 0.05f);
  4029. //STBTT_assert( STBTT_fabs(((r[2]+a)*r[2]+b)*r[2]+c) < 0.05f);
  4030. return 3;
  4031. }
  4032. }
  4033. STBTT_DEF unsigned char * stbtt_GetGlyphSDF(const stbtt_fontinfo *info, float scale, int glyph, int padding, unsigned char onedge_value, float pixel_dist_scale, int *width, int *height, int *xoff, int *yoff)
  4034. {
  4035. float scale_x = scale, scale_y = scale;
  4036. int ix0,iy0,ix1,iy1;
  4037. int w,h;
  4038. unsigned char *data;
  4039. if (scale == 0) return NULL;
  4040. stbtt_GetGlyphBitmapBoxSubpixel(info, glyph, scale, scale, 0.0f,0.0f, &ix0,&iy0,&ix1,&iy1);
  4041. // if empty, return NULL
  4042. if (ix0 == ix1 || iy0 == iy1)
  4043. return NULL;
  4044. ix0 -= padding;
  4045. iy0 -= padding;
  4046. ix1 += padding;
  4047. iy1 += padding;
  4048. w = (ix1 - ix0);
  4049. h = (iy1 - iy0);
  4050. if (width ) *width = w;
  4051. if (height) *height = h;
  4052. if (xoff ) *xoff = ix0;
  4053. if (yoff ) *yoff = iy0;
  4054. // invert for y-downwards bitmaps
  4055. scale_y = -scale_y;
  4056. {
  4057. int x,y,i,j;
  4058. float *precompute;
  4059. stbtt_vertex *verts;
  4060. int num_verts = stbtt_GetGlyphShape(info, glyph, &verts);
  4061. data = (unsigned char *) STBTT_malloc(w * h, info->userdata);
  4062. precompute = (float *) STBTT_malloc(num_verts * sizeof(float), info->userdata);
  4063. for (i=0,j=num_verts-1; i < num_verts; j=i++) {
  4064. if (verts[i].type == STBTT_vline) {
  4065. float x0 = verts[i].x*scale_x, y0 = verts[i].y*scale_y;
  4066. float x1 = verts[j].x*scale_x, y1 = verts[j].y*scale_y;
  4067. float dist = (float) STBTT_sqrt((x1-x0)*(x1-x0) + (y1-y0)*(y1-y0));
  4068. precompute[i] = (dist == 0) ? 0.0f : 1.0f / dist;
  4069. } else if (verts[i].type == STBTT_vcurve) {
  4070. float x2 = verts[j].x *scale_x, y2 = verts[j].y *scale_y;
  4071. float x1 = verts[i].cx*scale_x, y1 = verts[i].cy*scale_y;
  4072. float x0 = verts[i].x *scale_x, y0 = verts[i].y *scale_y;
  4073. float bx = x0 - 2*x1 + x2, by = y0 - 2*y1 + y2;
  4074. float len2 = bx*bx + by*by;
  4075. if (len2 != 0.0f)
  4076. precompute[i] = 1.0f / (bx*bx + by*by);
  4077. else
  4078. precompute[i] = 0.0f;
  4079. } else
  4080. precompute[i] = 0.0f;
  4081. }
  4082. for (y=iy0; y < iy1; ++y) {
  4083. for (x=ix0; x < ix1; ++x) {
  4084. float val;
  4085. float min_dist = 999999.0f;
  4086. float sx = (float) x + 0.5f;
  4087. float sy = (float) y + 0.5f;
  4088. float x_gspace = (sx / scale_x);
  4089. float y_gspace = (sy / scale_y);
  4090. int winding = stbtt__compute_crossings_x(x_gspace, y_gspace, num_verts, verts); // @OPTIMIZE: this could just be a rasterization, but needs to be line vs. non-tesselated curves so a new path
  4091. for (i=0; i < num_verts; ++i) {
  4092. float x0 = verts[i].x*scale_x, y0 = verts[i].y*scale_y;
  4093. if (verts[i].type == STBTT_vline && precompute[i] != 0.0f) {
  4094. float x1 = verts[i-1].x*scale_x, y1 = verts[i-1].y*scale_y;
  4095. float dist,dist2 = (x0-sx)*(x0-sx) + (y0-sy)*(y0-sy);
  4096. if (dist2 < min_dist*min_dist)
  4097. min_dist = (float) STBTT_sqrt(dist2);
  4098. // coarse culling against bbox
  4099. //if (sx > STBTT_min(x0,x1)-min_dist && sx < STBTT_max(x0,x1)+min_dist &&
  4100. // sy > STBTT_min(y0,y1)-min_dist && sy < STBTT_max(y0,y1)+min_dist)
  4101. dist = (float) STBTT_fabs((x1-x0)*(y0-sy) - (y1-y0)*(x0-sx)) * precompute[i];
  4102. STBTT_assert(i != 0);
  4103. if (dist < min_dist) {
  4104. // check position along line
  4105. // x' = x0 + t*(x1-x0), y' = y0 + t*(y1-y0)
  4106. // minimize (x'-sx)*(x'-sx)+(y'-sy)*(y'-sy)
  4107. float dx = x1-x0, dy = y1-y0;
  4108. float px = x0-sx, py = y0-sy;
  4109. // minimize (px+t*dx)^2 + (py+t*dy)^2 = px*px + 2*px*dx*t + t^2*dx*dx + py*py + 2*py*dy*t + t^2*dy*dy
  4110. // derivative: 2*px*dx + 2*py*dy + (2*dx*dx+2*dy*dy)*t, set to 0 and solve
  4111. float t = -(px*dx + py*dy) / (dx*dx + dy*dy);
  4112. if (t >= 0.0f && t <= 1.0f)
  4113. min_dist = dist;
  4114. }
  4115. } else if (verts[i].type == STBTT_vcurve) {
  4116. float x2 = verts[i-1].x *scale_x, y2 = verts[i-1].y *scale_y;
  4117. float x1 = verts[i ].cx*scale_x, y1 = verts[i ].cy*scale_y;
  4118. float box_x0 = STBTT_min(STBTT_min(x0,x1),x2);
  4119. float box_y0 = STBTT_min(STBTT_min(y0,y1),y2);
  4120. float box_x1 = STBTT_max(STBTT_max(x0,x1),x2);
  4121. float box_y1 = STBTT_max(STBTT_max(y0,y1),y2);
  4122. // coarse culling against bbox to avoid computing cubic unnecessarily
  4123. if (sx > box_x0-min_dist && sx < box_x1+min_dist && sy > box_y0-min_dist && sy < box_y1+min_dist) {
  4124. int num=0;
  4125. float ax = x1-x0, ay = y1-y0;
  4126. float bx = x0 - 2*x1 + x2, by = y0 - 2*y1 + y2;
  4127. float mx = x0 - sx, my = y0 - sy;
  4128. float res[3] = {0.f,0.f,0.f};
  4129. float px,py,t,it,dist2;
  4130. float a_inv = precompute[i];
  4131. if (a_inv == 0.0) { // if a_inv is 0, it's 2nd degree so use quadratic formula
  4132. float a = 3*(ax*bx + ay*by);
  4133. float b = 2*(ax*ax + ay*ay) + (mx*bx+my*by);
  4134. float c = mx*ax+my*ay;
  4135. if (a == 0.0) { // if a is 0, it's linear
  4136. if (b != 0.0) {
  4137. res[num++] = -c/b;
  4138. }
  4139. } else {
  4140. float discriminant = b*b - 4*a*c;
  4141. if (discriminant < 0)
  4142. num = 0;
  4143. else {
  4144. float root = (float) STBTT_sqrt(discriminant);
  4145. res[0] = (-b - root)/(2*a);
  4146. res[1] = (-b + root)/(2*a);
  4147. num = 2; // don't bother distinguishing 1-solution case, as code below will still work
  4148. }
  4149. }
  4150. } else {
  4151. float b = 3*(ax*bx + ay*by) * a_inv; // could precompute this as it doesn't depend on sample point
  4152. float c = (2*(ax*ax + ay*ay) + (mx*bx+my*by)) * a_inv;
  4153. float d = (mx*ax+my*ay) * a_inv;
  4154. num = stbtt__solve_cubic(b, c, d, res);
  4155. }
  4156. dist2 = (x0-sx)*(x0-sx) + (y0-sy)*(y0-sy);
  4157. if (dist2 < min_dist*min_dist)
  4158. min_dist = (float) STBTT_sqrt(dist2);
  4159. if (num >= 1 && res[0] >= 0.0f && res[0] <= 1.0f) {
  4160. t = res[0], it = 1.0f - t;
  4161. px = it*it*x0 + 2*t*it*x1 + t*t*x2;
  4162. py = it*it*y0 + 2*t*it*y1 + t*t*y2;
  4163. dist2 = (px-sx)*(px-sx) + (py-sy)*(py-sy);
  4164. if (dist2 < min_dist * min_dist)
  4165. min_dist = (float) STBTT_sqrt(dist2);
  4166. }
  4167. if (num >= 2 && res[1] >= 0.0f && res[1] <= 1.0f) {
  4168. t = res[1], it = 1.0f - t;
  4169. px = it*it*x0 + 2*t*it*x1 + t*t*x2;
  4170. py = it*it*y0 + 2*t*it*y1 + t*t*y2;
  4171. dist2 = (px-sx)*(px-sx) + (py-sy)*(py-sy);
  4172. if (dist2 < min_dist * min_dist)
  4173. min_dist = (float) STBTT_sqrt(dist2);
  4174. }
  4175. if (num >= 3 && res[2] >= 0.0f && res[2] <= 1.0f) {
  4176. t = res[2], it = 1.0f - t;
  4177. px = it*it*x0 + 2*t*it*x1 + t*t*x2;
  4178. py = it*it*y0 + 2*t*it*y1 + t*t*y2;
  4179. dist2 = (px-sx)*(px-sx) + (py-sy)*(py-sy);
  4180. if (dist2 < min_dist * min_dist)
  4181. min_dist = (float) STBTT_sqrt(dist2);
  4182. }
  4183. }
  4184. }
  4185. }
  4186. if (winding == 0)
  4187. min_dist = -min_dist; // if outside the shape, value is negative
  4188. val = onedge_value + pixel_dist_scale * min_dist;
  4189. if (val < 0)
  4190. val = 0;
  4191. else if (val > 255)
  4192. val = 255;
  4193. data[(y-iy0)*w+(x-ix0)] = (unsigned char) val;
  4194. }
  4195. }
  4196. STBTT_free(precompute, info->userdata);
  4197. STBTT_free(verts, info->userdata);
  4198. }
  4199. return data;
  4200. }
  4201. STBTT_DEF unsigned char * stbtt_GetCodepointSDF(const stbtt_fontinfo *info, float scale, int codepoint, int padding, unsigned char onedge_value, float pixel_dist_scale, int *width, int *height, int *xoff, int *yoff)
  4202. {
  4203. return stbtt_GetGlyphSDF(info, scale, stbtt_FindGlyphIndex(info, codepoint), padding, onedge_value, pixel_dist_scale, width, height, xoff, yoff);
  4204. }
  4205. STBTT_DEF void stbtt_FreeSDF(unsigned char *bitmap, void *userdata)
  4206. {
  4207. STBTT_free(bitmap, userdata);
  4208. }
  4209. //////////////////////////////////////////////////////////////////////////////
  4210. //
  4211. // font name matching -- recommended not to use this
  4212. //
  4213. // check if a utf8 string contains a prefix which is the utf16 string; if so return length of matching utf8 string
  4214. static stbtt_int32 stbtt__CompareUTF8toUTF16_bigendian_prefix(stbtt_uint8 *s1, stbtt_int32 len1, stbtt_uint8 *s2, stbtt_int32 len2)
  4215. {
  4216. stbtt_int32 i=0;
  4217. // convert utf16 to utf8 and compare the results while converting
  4218. while (len2) {
  4219. stbtt_uint16 ch = s2[0]*256 + s2[1];
  4220. if (ch < 0x80) {
  4221. if (i >= len1) return -1;
  4222. if (s1[i++] != ch) return -1;
  4223. } else if (ch < 0x800) {
  4224. if (i+1 >= len1) return -1;
  4225. if (s1[i++] != 0xc0 + (ch >> 6)) return -1;
  4226. if (s1[i++] != 0x80 + (ch & 0x3f)) return -1;
  4227. } else if (ch >= 0xd800 && ch < 0xdc00) {
  4228. stbtt_uint32 c;
  4229. stbtt_uint16 ch2 = s2[2]*256 + s2[3];
  4230. if (i+3 >= len1) return -1;
  4231. c = ((ch - 0xd800) << 10) + (ch2 - 0xdc00) + 0x10000;
  4232. if (s1[i++] != 0xf0 + (c >> 18)) return -1;
  4233. if (s1[i++] != 0x80 + ((c >> 12) & 0x3f)) return -1;
  4234. if (s1[i++] != 0x80 + ((c >> 6) & 0x3f)) return -1;
  4235. if (s1[i++] != 0x80 + ((c ) & 0x3f)) return -1;
  4236. s2 += 2; // plus another 2 below
  4237. len2 -= 2;
  4238. } else if (ch >= 0xdc00 && ch < 0xe000) {
  4239. return -1;
  4240. } else {
  4241. if (i+2 >= len1) return -1;
  4242. if (s1[i++] != 0xe0 + (ch >> 12)) return -1;
  4243. if (s1[i++] != 0x80 + ((ch >> 6) & 0x3f)) return -1;
  4244. if (s1[i++] != 0x80 + ((ch ) & 0x3f)) return -1;
  4245. }
  4246. s2 += 2;
  4247. len2 -= 2;
  4248. }
  4249. return i;
  4250. }
  4251. static int stbtt_CompareUTF8toUTF16_bigendian_internal(char *s1, int len1, char *s2, int len2)
  4252. {
  4253. return len1 == stbtt__CompareUTF8toUTF16_bigendian_prefix((stbtt_uint8*) s1, len1, (stbtt_uint8*) s2, len2);
  4254. }
  4255. // returns results in whatever encoding you request... but note that 2-byte encodings
  4256. // will be BIG-ENDIAN... use stbtt_CompareUTF8toUTF16_bigendian() to compare
  4257. STBTT_DEF const char *stbtt_GetFontNameString(const stbtt_fontinfo *font, int *length, int platformID, int encodingID, int languageID, int nameID)
  4258. {
  4259. stbtt_int32 i,count,stringOffset;
  4260. stbtt_uint8 *fc = font->data;
  4261. stbtt_uint32 offset = font->fontstart;
  4262. stbtt_uint32 nm = stbtt__find_table(fc, offset, "name");
  4263. if (!nm) return NULL;
  4264. count = ttUSHORT(fc+nm+2);
  4265. stringOffset = nm + ttUSHORT(fc+nm+4);
  4266. for (i=0; i < count; ++i) {
  4267. stbtt_uint32 loc = nm + 6 + 12 * i;
  4268. if (platformID == ttUSHORT(fc+loc+0) && encodingID == ttUSHORT(fc+loc+2)
  4269. && languageID == ttUSHORT(fc+loc+4) && nameID == ttUSHORT(fc+loc+6)) {
  4270. *length = ttUSHORT(fc+loc+8);
  4271. return (const char *) (fc+stringOffset+ttUSHORT(fc+loc+10));
  4272. }
  4273. }
  4274. return NULL;
  4275. }
  4276. static int stbtt__matchpair(stbtt_uint8 *fc, stbtt_uint32 nm, stbtt_uint8 *name, stbtt_int32 nlen, stbtt_int32 target_id, stbtt_int32 next_id)
  4277. {
  4278. stbtt_int32 i;
  4279. stbtt_int32 count = ttUSHORT(fc+nm+2);
  4280. stbtt_int32 stringOffset = nm + ttUSHORT(fc+nm+4);
  4281. for (i=0; i < count; ++i) {
  4282. stbtt_uint32 loc = nm + 6 + 12 * i;
  4283. stbtt_int32 id = ttUSHORT(fc+loc+6);
  4284. if (id == target_id) {
  4285. // find the encoding
  4286. stbtt_int32 platform = ttUSHORT(fc+loc+0), encoding = ttUSHORT(fc+loc+2), language = ttUSHORT(fc+loc+4);
  4287. // is this a Unicode encoding?
  4288. if (platform == 0 || (platform == 3 && encoding == 1) || (platform == 3 && encoding == 10)) {
  4289. stbtt_int32 slen = ttUSHORT(fc+loc+8);
  4290. stbtt_int32 off = ttUSHORT(fc+loc+10);
  4291. // check if there's a prefix match
  4292. stbtt_int32 matchlen = stbtt__CompareUTF8toUTF16_bigendian_prefix(name, nlen, fc+stringOffset+off,slen);
  4293. if (matchlen >= 0) {
  4294. // check for target_id+1 immediately following, with same encoding & language
  4295. 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) {
  4296. slen = ttUSHORT(fc+loc+12+8);
  4297. off = ttUSHORT(fc+loc+12+10);
  4298. if (slen == 0) {
  4299. if (matchlen == nlen)
  4300. return 1;
  4301. } else if (matchlen < nlen && name[matchlen] == ' ') {
  4302. ++matchlen;
  4303. if (stbtt_CompareUTF8toUTF16_bigendian_internal((char*) (name+matchlen), nlen-matchlen, (char*)(fc+stringOffset+off),slen))
  4304. return 1;
  4305. }
  4306. } else {
  4307. // if nothing immediately following
  4308. if (matchlen == nlen)
  4309. return 1;
  4310. }
  4311. }
  4312. }
  4313. // @TODO handle other encodings
  4314. }
  4315. }
  4316. return 0;
  4317. }
  4318. static int stbtt__matches(stbtt_uint8 *fc, stbtt_uint32 offset, stbtt_uint8 *name, stbtt_int32 flags)
  4319. {
  4320. stbtt_int32 nlen = (stbtt_int32) STBTT_strlen((char *) name);
  4321. stbtt_uint32 nm,hd;
  4322. if (!stbtt__isfont(fc+offset)) return 0;
  4323. // check italics/bold/underline flags in macStyle...
  4324. if (flags) {
  4325. hd = stbtt__find_table(fc, offset, "head");
  4326. if ((ttUSHORT(fc+hd+44) & 7) != (flags & 7)) return 0;
  4327. }
  4328. nm = stbtt__find_table(fc, offset, "name");
  4329. if (!nm) return 0;
  4330. if (flags) {
  4331. // if we checked the macStyle flags, then just check the family and ignore the subfamily
  4332. if (stbtt__matchpair(fc, nm, name, nlen, 16, -1)) return 1;
  4333. if (stbtt__matchpair(fc, nm, name, nlen, 1, -1)) return 1;
  4334. if (stbtt__matchpair(fc, nm, name, nlen, 3, -1)) return 1;
  4335. } else {
  4336. if (stbtt__matchpair(fc, nm, name, nlen, 16, 17)) return 1;
  4337. if (stbtt__matchpair(fc, nm, name, nlen, 1, 2)) return 1;
  4338. if (stbtt__matchpair(fc, nm, name, nlen, 3, -1)) return 1;
  4339. }
  4340. return 0;
  4341. }
  4342. static int stbtt_FindMatchingFont_internal(unsigned char *font_collection, char *name_utf8, stbtt_int32 flags)
  4343. {
  4344. stbtt_int32 i;
  4345. for (i=0;;++i) {
  4346. stbtt_int32 off = stbtt_GetFontOffsetForIndex(font_collection, i);
  4347. if (off < 0) return off;
  4348. if (stbtt__matches((stbtt_uint8 *) font_collection, off, (stbtt_uint8*) name_utf8, flags))
  4349. return off;
  4350. }
  4351. }
  4352. #if defined(__GNUC__) || defined(__clang__)
  4353. #pragma GCC diagnostic push
  4354. #pragma GCC diagnostic ignored "-Wcast-qual"
  4355. #endif
  4356. STBTT_DEF int stbtt_BakeFontBitmap(const unsigned char *data, int offset,
  4357. float pixel_height, unsigned char *pixels, int pw, int ph,
  4358. int first_char, int num_chars, stbtt_bakedchar *chardata)
  4359. {
  4360. return stbtt_BakeFontBitmap_internal((unsigned char *) data, offset, pixel_height, pixels, pw, ph, first_char, num_chars, chardata);
  4361. }
  4362. STBTT_DEF int stbtt_GetFontOffsetForIndex(const unsigned char *data, int index)
  4363. {
  4364. return stbtt_GetFontOffsetForIndex_internal((unsigned char *) data, index);
  4365. }
  4366. STBTT_DEF int stbtt_GetNumberOfFonts(const unsigned char *data)
  4367. {
  4368. return stbtt_GetNumberOfFonts_internal((unsigned char *) data);
  4369. }
  4370. STBTT_DEF int stbtt_InitFont(stbtt_fontinfo *info, const unsigned char *data, int offset)
  4371. {
  4372. return stbtt_InitFont_internal(info, (unsigned char *) data, offset);
  4373. }
  4374. STBTT_DEF int stbtt_FindMatchingFont(const unsigned char *fontdata, const char *name, int flags)
  4375. {
  4376. return stbtt_FindMatchingFont_internal((unsigned char *) fontdata, (char *) name, flags);
  4377. }
  4378. STBTT_DEF int stbtt_CompareUTF8toUTF16_bigendian(const char *s1, int len1, const char *s2, int len2)
  4379. {
  4380. return stbtt_CompareUTF8toUTF16_bigendian_internal((char *) s1, len1, (char *) s2, len2);
  4381. }
  4382. #if defined(__GNUC__) || defined(__clang__)
  4383. #pragma GCC diagnostic pop
  4384. #endif
  4385. #endif // STB_TRUETYPE_IMPLEMENTATION
  4386. // FULL VERSION HISTORY
  4387. //
  4388. // 1.25 (2021-07-11) many fixes
  4389. // 1.24 (2020-02-05) fix warning
  4390. // 1.23 (2020-02-02) query SVG data for glyphs; query whole kerning table (but only kern not GPOS)
  4391. // 1.22 (2019-08-11) minimize missing-glyph duplication; fix kerning if both 'GPOS' and 'kern' are defined
  4392. // 1.21 (2019-02-25) fix warning
  4393. // 1.20 (2019-02-07) PackFontRange skips missing codepoints; GetScaleFontVMetrics()
  4394. // 1.19 (2018-02-11) OpenType GPOS kerning (horizontal only), STBTT_fmod
  4395. // 1.18 (2018-01-29) add missing function
  4396. // 1.17 (2017-07-23) make more arguments const; doc fix
  4397. // 1.16 (2017-07-12) SDF support
  4398. // 1.15 (2017-03-03) make more arguments const
  4399. // 1.14 (2017-01-16) num-fonts-in-TTC function
  4400. // 1.13 (2017-01-02) support OpenType fonts, certain Apple fonts
  4401. // 1.12 (2016-10-25) suppress warnings about casting away const with -Wcast-qual
  4402. // 1.11 (2016-04-02) fix unused-variable warning
  4403. // 1.10 (2016-04-02) allow user-defined fabs() replacement
  4404. // fix memory leak if fontsize=0.0
  4405. // fix warning from duplicate typedef
  4406. // 1.09 (2016-01-16) warning fix; avoid crash on outofmem; use alloc userdata for PackFontRanges
  4407. // 1.08 (2015-09-13) document stbtt_Rasterize(); fixes for vertical & horizontal edges
  4408. // 1.07 (2015-08-01) allow PackFontRanges to accept arrays of sparse codepoints;
  4409. // allow PackFontRanges to pack and render in separate phases;
  4410. // fix stbtt_GetFontOFfsetForIndex (never worked for non-0 input?);
  4411. // fixed an assert() bug in the new rasterizer
  4412. // replace assert() with STBTT_assert() in new rasterizer
  4413. // 1.06 (2015-07-14) performance improvements (~35% faster on x86 and x64 on test machine)
  4414. // also more precise AA rasterizer, except if shapes overlap
  4415. // remove need for STBTT_sort
  4416. // 1.05 (2015-04-15) fix misplaced definitions for STBTT_STATIC
  4417. // 1.04 (2015-04-15) typo in example
  4418. // 1.03 (2015-04-12) STBTT_STATIC, fix memory leak in new packing, various fixes
  4419. // 1.02 (2014-12-10) fix various warnings & compile issues w/ stb_rect_pack, C++
  4420. // 1.01 (2014-12-08) fix subpixel position when oversampling to exactly match
  4421. // non-oversampled; STBTT_POINT_SIZE for packed case only
  4422. // 1.00 (2014-12-06) add new PackBegin etc. API, w/ support for oversampling
  4423. // 0.99 (2014-09-18) fix multiple bugs with subpixel rendering (ryg)
  4424. // 0.9 (2014-08-07) support certain mac/iOS fonts without an MS platformID
  4425. // 0.8b (2014-07-07) fix a warning
  4426. // 0.8 (2014-05-25) fix a few more warnings
  4427. // 0.7 (2013-09-25) bugfix: subpixel glyph bug fixed in 0.5 had come back
  4428. // 0.6c (2012-07-24) improve documentation
  4429. // 0.6b (2012-07-20) fix a few more warnings
  4430. // 0.6 (2012-07-17) fix warnings; added stbtt_ScaleForMappingEmToPixels,
  4431. // stbtt_GetFontBoundingBox, stbtt_IsGlyphEmpty
  4432. // 0.5 (2011-12-09) bugfixes:
  4433. // subpixel glyph renderer computed wrong bounding box
  4434. // first vertex of shape can be off-curve (FreeSans)
  4435. // 0.4b (2011-12-03) fixed an error in the font baking example
  4436. // 0.4 (2011-12-01) kerning, subpixel rendering (tor)
  4437. // bugfixes for:
  4438. // codepoint-to-glyph conversion using table fmt=12
  4439. // codepoint-to-glyph conversion using table fmt=4
  4440. // stbtt_GetBakedQuad with non-square texture (Zer)
  4441. // updated Hello World! sample to use kerning and subpixel
  4442. // fixed some warnings
  4443. // 0.3 (2009-06-24) cmap fmt=12, compound shapes (MM)
  4444. // userdata, malloc-from-userdata, non-zero fill (stb)
  4445. // 0.2 (2009-03-11) Fix unsigned/signed char warnings
  4446. // 0.1 (2009-03-09) First public release
  4447. //
  4448. /*
  4449. ------------------------------------------------------------------------------
  4450. This software is available under 2 licenses -- choose whichever you prefer.
  4451. ------------------------------------------------------------------------------
  4452. ALTERNATIVE A - MIT License
  4453. Copyright (c) 2017 Sean Barrett
  4454. Permission is hereby granted, free of charge, to any person obtaining a copy of
  4455. this software and associated documentation files (the "Software"), to deal in
  4456. the Software without restriction, including without limitation the rights to
  4457. use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies
  4458. of the Software, and to permit persons to whom the Software is furnished to do
  4459. so, subject to the following conditions:
  4460. The above copyright notice and this permission notice shall be included in all
  4461. copies or substantial portions of the Software.
  4462. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
  4463. IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
  4464. FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
  4465. AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
  4466. LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
  4467. OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
  4468. SOFTWARE.
  4469. ------------------------------------------------------------------------------
  4470. ALTERNATIVE B - Public Domain (www.unlicense.org)
  4471. This is free and unencumbered software released into the public domain.
  4472. Anyone is free to copy, modify, publish, use, compile, sell, or distribute this
  4473. software, either in source code form or as a compiled binary, for any purpose,
  4474. commercial or non-commercial, and by any means.
  4475. In jurisdictions that recognize copyright laws, the author or authors of this
  4476. software dedicate any and all copyright interest in the software to the public
  4477. domain. We make this dedication for the benefit of the public at large and to
  4478. the detriment of our heirs and successors. We intend this dedication to be an
  4479. overt act of relinquishment in perpetuity of all present and future rights to
  4480. this software under copyright law.
  4481. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
  4482. IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
  4483. FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
  4484. AUTHORS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN
  4485. ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
  4486. WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
  4487. ------------------------------------------------------------------------------
  4488. */