🛠️🐜 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.

1048 lines
37 KiB

  1. /* stb_image_write - v1.02 - public domain - http://nothings.org/stb/stb_image_write.h
  2. writes out PNG/BMP/TGA images to C stdio - Sean Barrett 2010-2015
  3. no warranty implied; use at your own risk
  4. Before #including,
  5. #define STB_IMAGE_WRITE_IMPLEMENTATION
  6. in the file that you want to have the implementation.
  7. Will probably not work correctly with strict-aliasing optimizations.
  8. ABOUT:
  9. This header file is a library for writing images to C stdio. It could be
  10. adapted to write to memory or a general streaming interface; let me know.
  11. The PNG output is not optimal; it is 20-50% larger than the file
  12. written by a decent optimizing implementation. This library is designed
  13. for source code compactness and simplicity, not optimal image file size
  14. or run-time performance.
  15. BUILDING:
  16. You can #define STBIW_ASSERT(x) before the #include to avoid using assert.h.
  17. You can #define STBIW_MALLOC(), STBIW_REALLOC(), and STBIW_FREE() to replace
  18. malloc,realloc,free.
  19. You can define STBIW_MEMMOVE() to replace memmove()
  20. USAGE:
  21. There are four functions, one for each image file format:
  22. int stbi_write_png(char const *filename, int w, int h, int comp, const void *data, int stride_in_bytes);
  23. int stbi_write_bmp(char const *filename, int w, int h, int comp, const void *data);
  24. int stbi_write_tga(char const *filename, int w, int h, int comp, const void *data);
  25. int stbi_write_hdr(char const *filename, int w, int h, int comp, const float *data);
  26. There are also four equivalent functions that use an arbitrary write function. You are
  27. expected to open/close your file-equivalent before and after calling these:
  28. int stbi_write_png_to_func(stbi_write_func *func, void *context, int w, int h, int comp, const void *data, int stride_in_bytes);
  29. int stbi_write_bmp_to_func(stbi_write_func *func, void *context, int w, int h, int comp, const void *data);
  30. int stbi_write_tga_to_func(stbi_write_func *func, void *context, int w, int h, int comp, const void *data);
  31. int stbi_write_hdr_to_func(stbi_write_func *func, void *context, int w, int h, int comp, const float *data);
  32. where the callback is:
  33. void stbi_write_func(void *context, void *data, int size);
  34. You can define STBI_WRITE_NO_STDIO to disable the file variant of these
  35. functions, so the library will not use stdio.h at all. However, this will
  36. also disable HDR writing, because it requires stdio for formatted output.
  37. Each function returns 0 on failure and non-0 on success.
  38. The functions create an image file defined by the parameters. The image
  39. is a rectangle of pixels stored from left-to-right, top-to-bottom.
  40. Each pixel contains 'comp' channels of data stored interleaved with 8-bits
  41. per channel, in the following order: 1=Y, 2=YA, 3=RGB, 4=RGBA. (Y is
  42. monochrome color.) The rectangle is 'w' pixels wide and 'h' pixels tall.
  43. The *data pointer points to the first byte of the top-left-most pixel.
  44. For PNG, "stride_in_bytes" is the distance in bytes from the first byte of
  45. a row of pixels to the first byte of the next row of pixels.
  46. PNG creates output files with the same number of components as the input.
  47. The BMP format expands Y to RGB in the file format and does not
  48. output alpha.
  49. PNG supports writing rectangles of data even when the bytes storing rows of
  50. data are not consecutive in memory (e.g. sub-rectangles of a larger image),
  51. by supplying the stride between the beginning of adjacent rows. The other
  52. formats do not. (Thus you cannot write a native-format BMP through the BMP
  53. writer, both because it is in BGR order and because it may have padding
  54. at the end of the line.)
  55. HDR expects linear float data. Since the format is always 32-bit rgb(e)
  56. data, alpha (if provided) is discarded, and for monochrome data it is
  57. replicated across all three channels.
  58. TGA supports RLE or non-RLE compressed data. To use non-RLE-compressed
  59. data, set the global variable 'stbi_write_tga_with_rle' to 0.
  60. CREDITS:
  61. PNG/BMP/TGA
  62. Sean Barrett
  63. HDR
  64. Baldur Karlsson
  65. TGA monochrome:
  66. Jean-Sebastien Guay
  67. misc enhancements:
  68. Tim Kelsey
  69. TGA RLE
  70. Alan Hickman
  71. initial file IO callback implementation
  72. Emmanuel Julien
  73. bugfixes:
  74. github:Chribba
  75. Guillaume Chereau
  76. github:jry2
  77. github:romigrou
  78. Sergio Gonzalez
  79. Jonas Karlsson
  80. Filip Wasil
  81. Thatcher Ulrich
  82. LICENSE
  83. This software is dual-licensed to the public domain and under the following
  84. license: you are granted a perpetual, irrevocable license to copy, modify,
  85. publish, and distribute this file as you see fit.
  86. */
  87. #ifndef INCLUDE_STB_IMAGE_WRITE_H
  88. #define INCLUDE_STB_IMAGE_WRITE_H
  89. #ifdef __cplusplus
  90. extern "C" {
  91. #endif
  92. #ifdef STB_IMAGE_WRITE_STATIC
  93. #define STBIWDEF static
  94. #else
  95. #define STBIWDEF extern
  96. extern int stbi_write_tga_with_rle;
  97. #endif
  98. #ifndef STBI_WRITE_NO_STDIO
  99. STBIWDEF int stbi_write_png(char const *filename, int w, int h, int comp, const void *data, int stride_in_bytes);
  100. STBIWDEF int stbi_write_bmp(char const *filename, int w, int h, int comp, const void *data);
  101. STBIWDEF int stbi_write_tga(char const *filename, int w, int h, int comp, const void *data);
  102. STBIWDEF int stbi_write_hdr(char const *filename, int w, int h, int comp, const float *data);
  103. #endif
  104. typedef void stbi_write_func(void *context, void *data, int size);
  105. STBIWDEF int stbi_write_png_to_func(stbi_write_func *func, void *context, int w, int h, int comp, const void *data, int stride_in_bytes);
  106. STBIWDEF int stbi_write_bmp_to_func(stbi_write_func *func, void *context, int w, int h, int comp, const void *data);
  107. STBIWDEF int stbi_write_tga_to_func(stbi_write_func *func, void *context, int w, int h, int comp, const void *data);
  108. STBIWDEF int stbi_write_hdr_to_func(stbi_write_func *func, void *context, int w, int h, int comp, const float *data);
  109. #ifdef __cplusplus
  110. }
  111. #endif
  112. #endif//INCLUDE_STB_IMAGE_WRITE_H
  113. #ifdef STB_IMAGE_WRITE_IMPLEMENTATION
  114. #ifdef _WIN32
  115. #ifndef _CRT_SECURE_NO_WARNINGS
  116. #define _CRT_SECURE_NO_WARNINGS
  117. #endif
  118. #ifndef _CRT_NONSTDC_NO_DEPRECATE
  119. #define _CRT_NONSTDC_NO_DEPRECATE
  120. #endif
  121. #endif
  122. #ifndef STBI_WRITE_NO_STDIO
  123. #include <stdio.h>
  124. #endif // STBI_WRITE_NO_STDIO
  125. #include <stdarg.h>
  126. #include <stdlib.h>
  127. #include <string.h>
  128. #include <math.h>
  129. #if defined(STBIW_MALLOC) && defined(STBIW_FREE) && (defined(STBIW_REALLOC) || defined(STBIW_REALLOC_SIZED))
  130. // ok
  131. #elif !defined(STBIW_MALLOC) && !defined(STBIW_FREE) && !defined(STBIW_REALLOC) && !defined(STBIW_REALLOC_SIZED)
  132. // ok
  133. #else
  134. #error "Must define all or none of STBIW_MALLOC, STBIW_FREE, and STBIW_REALLOC (or STBIW_REALLOC_SIZED)."
  135. #endif
  136. #ifndef STBIW_MALLOC
  137. #define STBIW_MALLOC(sz) malloc(sz)
  138. #define STBIW_REALLOC(p,newsz) realloc(p,newsz)
  139. #define STBIW_FREE(p) free(p)
  140. #endif
  141. #ifndef STBIW_REALLOC_SIZED
  142. #define STBIW_REALLOC_SIZED(p,oldsz,newsz) STBIW_REALLOC(p,newsz)
  143. #endif
  144. #ifndef STBIW_MEMMOVE
  145. #define STBIW_MEMMOVE(a,b,sz) memmove(a,b,sz)
  146. #endif
  147. #ifndef STBIW_ASSERT
  148. #include <assert.h>
  149. #define STBIW_ASSERT(x) assert(x)
  150. #endif
  151. #define STBIW_UCHAR(x) (unsigned char) ((x) & 0xff)
  152. typedef struct
  153. {
  154. stbi_write_func *func;
  155. void *context;
  156. } stbi__write_context;
  157. // initialize a callback-based context
  158. static void stbi__start_write_callbacks(stbi__write_context *s, stbi_write_func *c, void *context)
  159. {
  160. s->func = c;
  161. s->context = context;
  162. }
  163. #ifndef STBI_WRITE_NO_STDIO
  164. static void stbi__stdio_write(void *context, void *data, int size)
  165. {
  166. fwrite(data,1,size,(FILE*) context);
  167. }
  168. static int stbi__start_write_file(stbi__write_context *s, const char *filename)
  169. {
  170. FILE *f = fopen(filename, "wb");
  171. stbi__start_write_callbacks(s, stbi__stdio_write, (void *) f);
  172. return f != NULL;
  173. }
  174. static void stbi__end_write_file(stbi__write_context *s)
  175. {
  176. fclose((FILE *)s->context);
  177. }
  178. #endif // !STBI_WRITE_NO_STDIO
  179. typedef unsigned int stbiw_uint32;
  180. typedef int stb_image_write_test[sizeof(stbiw_uint32)==4 ? 1 : -1];
  181. #ifdef STB_IMAGE_WRITE_STATIC
  182. static int stbi_write_tga_with_rle = 1;
  183. #else
  184. int stbi_write_tga_with_rle = 1;
  185. #endif
  186. static void stbiw__writefv(stbi__write_context *s, const char *fmt, va_list v)
  187. {
  188. while (*fmt) {
  189. switch (*fmt++) {
  190. case ' ': break;
  191. case '1': { unsigned char x = STBIW_UCHAR(va_arg(v, int));
  192. s->func(s->context,&x,1);
  193. break; }
  194. case '2': { int x = va_arg(v,int);
  195. unsigned char b[2];
  196. b[0] = STBIW_UCHAR(x);
  197. b[1] = STBIW_UCHAR(x>>8);
  198. s->func(s->context,b,2);
  199. break; }
  200. case '4': { stbiw_uint32 x = va_arg(v,int);
  201. unsigned char b[4];
  202. b[0]=STBIW_UCHAR(x);
  203. b[1]=STBIW_UCHAR(x>>8);
  204. b[2]=STBIW_UCHAR(x>>16);
  205. b[3]=STBIW_UCHAR(x>>24);
  206. s->func(s->context,b,4);
  207. break; }
  208. default:
  209. STBIW_ASSERT(0);
  210. return;
  211. }
  212. }
  213. }
  214. static void stbiw__writef(stbi__write_context *s, const char *fmt, ...)
  215. {
  216. va_list v;
  217. va_start(v, fmt);
  218. stbiw__writefv(s, fmt, v);
  219. va_end(v);
  220. }
  221. static void stbiw__write3(stbi__write_context *s, unsigned char a, unsigned char b, unsigned char c)
  222. {
  223. unsigned char arr[3];
  224. arr[0] = a, arr[1] = b, arr[2] = c;
  225. s->func(s->context, arr, 3);
  226. }
  227. static void stbiw__write_pixel(stbi__write_context *s, int rgb_dir, int comp, int write_alpha, int expand_mono, unsigned char *d)
  228. {
  229. unsigned char bg[3] = { 255, 0, 255}, px[3];
  230. int k;
  231. if (write_alpha < 0)
  232. s->func(s->context, &d[comp - 1], 1);
  233. switch (comp) {
  234. case 1:
  235. s->func(s->context,d,1);
  236. break;
  237. case 2:
  238. if (expand_mono)
  239. stbiw__write3(s, d[0], d[0], d[0]); // monochrome bmp
  240. else
  241. s->func(s->context, d, 1); // monochrome TGA
  242. break;
  243. case 4:
  244. if (!write_alpha) {
  245. // composite against pink background
  246. for (k = 0; k < 3; ++k)
  247. px[k] = bg[k] + ((d[k] - bg[k]) * d[3]) / 255;
  248. stbiw__write3(s, px[1 - rgb_dir], px[1], px[1 + rgb_dir]);
  249. break;
  250. }
  251. /* FALLTHROUGH */
  252. case 3:
  253. stbiw__write3(s, d[1 - rgb_dir], d[1], d[1 + rgb_dir]);
  254. break;
  255. }
  256. if (write_alpha > 0)
  257. s->func(s->context, &d[comp - 1], 1);
  258. }
  259. static void stbiw__write_pixels(stbi__write_context *s, int rgb_dir, int vdir, int x, int y, int comp, void *data, int write_alpha, int scanline_pad, int expand_mono)
  260. {
  261. stbiw_uint32 zero = 0;
  262. int i,j, j_end;
  263. if (y <= 0)
  264. return;
  265. if (vdir < 0)
  266. j_end = -1, j = y-1;
  267. else
  268. j_end = y, j = 0;
  269. for (; j != j_end; j += vdir) {
  270. for (i=0; i < x; ++i) {
  271. unsigned char *d = (unsigned char *) data + (j*x+i)*comp;
  272. stbiw__write_pixel(s, rgb_dir, comp, write_alpha, expand_mono, d);
  273. }
  274. s->func(s->context, &zero, scanline_pad);
  275. }
  276. }
  277. static int stbiw__outfile(stbi__write_context *s, int rgb_dir, int vdir, int x, int y, int comp, int expand_mono, void *data, int alpha, int pad, const char *fmt, ...)
  278. {
  279. if (y < 0 || x < 0) {
  280. return 0;
  281. } else {
  282. va_list v;
  283. va_start(v, fmt);
  284. stbiw__writefv(s, fmt, v);
  285. va_end(v);
  286. stbiw__write_pixels(s,rgb_dir,vdir,x,y,comp,data,alpha,pad, expand_mono);
  287. return 1;
  288. }
  289. }
  290. static int stbi_write_bmp_core(stbi__write_context *s, int x, int y, int comp, const void *data)
  291. {
  292. int pad = (-x*3) & 3;
  293. return stbiw__outfile(s,-1,-1,x,y,comp,1,(void *) data,0,pad,
  294. "11 4 22 4" "4 44 22 444444",
  295. 'B', 'M', 14+40+(x*3+pad)*y, 0,0, 14+40, // file header
  296. 40, x,y, 1,24, 0,0,0,0,0,0); // bitmap header
  297. }
  298. STBIWDEF int stbi_write_bmp_to_func(stbi_write_func *func, void *context, int x, int y, int comp, const void *data)
  299. {
  300. stbi__write_context s;
  301. stbi__start_write_callbacks(&s, func, context);
  302. return stbi_write_bmp_core(&s, x, y, comp, data);
  303. }
  304. #ifndef STBI_WRITE_NO_STDIO
  305. STBIWDEF int stbi_write_bmp(char const *filename, int x, int y, int comp, const void *data)
  306. {
  307. stbi__write_context s;
  308. if (stbi__start_write_file(&s,filename)) {
  309. int r = stbi_write_bmp_core(&s, x, y, comp, data);
  310. stbi__end_write_file(&s);
  311. return r;
  312. } else
  313. return 0;
  314. }
  315. #endif //!STBI_WRITE_NO_STDIO
  316. static int stbi_write_tga_core(stbi__write_context *s, int x, int y, int comp, void *data)
  317. {
  318. int has_alpha = (comp == 2 || comp == 4);
  319. int colorbytes = has_alpha ? comp-1 : comp;
  320. int format = colorbytes < 2 ? 3 : 2; // 3 color channels (RGB/RGBA) = 2, 1 color channel (Y/YA) = 3
  321. if (y < 0 || x < 0)
  322. return 0;
  323. if (!stbi_write_tga_with_rle) {
  324. return stbiw__outfile(s, -1, -1, x, y, comp, 0, (void *) data, has_alpha, 0,
  325. "111 221 2222 11", 0, 0, format, 0, 0, 0, 0, 0, x, y, (colorbytes + has_alpha) * 8, has_alpha * 8);
  326. } else {
  327. int i,j,k;
  328. stbiw__writef(s, "111 221 2222 11", 0,0,format+8, 0,0,0, 0,0,x,y, (colorbytes + has_alpha) * 8, has_alpha * 8);
  329. for (j = y - 1; j >= 0; --j) {
  330. unsigned char *row = (unsigned char *) data + j * x * comp;
  331. int len;
  332. for (i = 0; i < x; i += len) {
  333. unsigned char *begin = row + i * comp;
  334. int diff = 1;
  335. len = 1;
  336. if (i < x - 1) {
  337. ++len;
  338. diff = memcmp(begin, row + (i + 1) * comp, comp);
  339. if (diff) {
  340. const unsigned char *prev = begin;
  341. for (k = i + 2; k < x && len < 128; ++k) {
  342. if (memcmp(prev, row + k * comp, comp)) {
  343. prev += comp;
  344. ++len;
  345. } else {
  346. --len;
  347. break;
  348. }
  349. }
  350. } else {
  351. for (k = i + 2; k < x && len < 128; ++k) {
  352. if (!memcmp(begin, row + k * comp, comp)) {
  353. ++len;
  354. } else {
  355. break;
  356. }
  357. }
  358. }
  359. }
  360. if (diff) {
  361. unsigned char header = STBIW_UCHAR(len - 1);
  362. s->func(s->context, &header, 1);
  363. for (k = 0; k < len; ++k) {
  364. stbiw__write_pixel(s, -1, comp, has_alpha, 0, begin + k * comp);
  365. }
  366. } else {
  367. unsigned char header = STBIW_UCHAR(len - 129);
  368. s->func(s->context, &header, 1);
  369. stbiw__write_pixel(s, -1, comp, has_alpha, 0, begin);
  370. }
  371. }
  372. }
  373. }
  374. return 1;
  375. }
  376. int stbi_write_tga_to_func(stbi_write_func *func, void *context, int x, int y, int comp, const void *data)
  377. {
  378. stbi__write_context s;
  379. stbi__start_write_callbacks(&s, func, context);
  380. return stbi_write_tga_core(&s, x, y, comp, (void *) data);
  381. }
  382. #ifndef STBI_WRITE_NO_STDIO
  383. int stbi_write_tga(char const *filename, int x, int y, int comp, const void *data)
  384. {
  385. stbi__write_context s;
  386. if (stbi__start_write_file(&s,filename)) {
  387. int r = stbi_write_tga_core(&s, x, y, comp, (void *) data);
  388. stbi__end_write_file(&s);
  389. return r;
  390. } else
  391. return 0;
  392. }
  393. #endif
  394. // *************************************************************************************************
  395. // Radiance RGBE HDR writer
  396. // by Baldur Karlsson
  397. #ifndef STBI_WRITE_NO_STDIO
  398. #define stbiw__max(a, b) ((a) > (b) ? (a) : (b))
  399. void stbiw__linear_to_rgbe(unsigned char *rgbe, float *linear)
  400. {
  401. int exponent;
  402. float maxcomp = stbiw__max(linear[0], stbiw__max(linear[1], linear[2]));
  403. if (maxcomp < 1e-32f) {
  404. rgbe[0] = rgbe[1] = rgbe[2] = rgbe[3] = 0;
  405. } else {
  406. float normalize = (float) frexp(maxcomp, &exponent) * 256.0f/maxcomp;
  407. rgbe[0] = (unsigned char)(linear[0] * normalize);
  408. rgbe[1] = (unsigned char)(linear[1] * normalize);
  409. rgbe[2] = (unsigned char)(linear[2] * normalize);
  410. rgbe[3] = (unsigned char)(exponent + 128);
  411. }
  412. }
  413. void stbiw__write_run_data(stbi__write_context *s, int length, unsigned char databyte)
  414. {
  415. unsigned char lengthbyte = STBIW_UCHAR(length+128);
  416. STBIW_ASSERT(length+128 <= 255);
  417. s->func(s->context, &lengthbyte, 1);
  418. s->func(s->context, &databyte, 1);
  419. }
  420. void stbiw__write_dump_data(stbi__write_context *s, int length, unsigned char *data)
  421. {
  422. unsigned char lengthbyte = STBIW_UCHAR(length);
  423. STBIW_ASSERT(length <= 128); // inconsistent with spec but consistent with official code
  424. s->func(s->context, &lengthbyte, 1);
  425. s->func(s->context, data, length);
  426. }
  427. void stbiw__write_hdr_scanline(stbi__write_context *s, int width, int ncomp, unsigned char *scratch, float *scanline)
  428. {
  429. unsigned char scanlineheader[4] = { 2, 2, 0, 0 };
  430. unsigned char rgbe[4];
  431. float linear[3];
  432. int x;
  433. scanlineheader[2] = (width&0xff00)>>8;
  434. scanlineheader[3] = (width&0x00ff);
  435. /* skip RLE for images too small or large */
  436. if (width < 8 || width >= 32768) {
  437. for (x=0; x < width; x++) {
  438. switch (ncomp) {
  439. case 4: /* fallthrough */
  440. case 3: linear[2] = scanline[x*ncomp + 2];
  441. linear[1] = scanline[x*ncomp + 1];
  442. linear[0] = scanline[x*ncomp + 0];
  443. break;
  444. default:
  445. linear[0] = linear[1] = linear[2] = scanline[x*ncomp + 0];
  446. break;
  447. }
  448. stbiw__linear_to_rgbe(rgbe, linear);
  449. s->func(s->context, rgbe, 4);
  450. }
  451. } else {
  452. int c,r;
  453. /* encode into scratch buffer */
  454. for (x=0; x < width; x++) {
  455. switch(ncomp) {
  456. case 4: /* fallthrough */
  457. case 3: linear[2] = scanline[x*ncomp + 2];
  458. linear[1] = scanline[x*ncomp + 1];
  459. linear[0] = scanline[x*ncomp + 0];
  460. break;
  461. default:
  462. linear[0] = linear[1] = linear[2] = scanline[x*ncomp + 0];
  463. break;
  464. }
  465. stbiw__linear_to_rgbe(rgbe, linear);
  466. scratch[x + width*0] = rgbe[0];
  467. scratch[x + width*1] = rgbe[1];
  468. scratch[x + width*2] = rgbe[2];
  469. scratch[x + width*3] = rgbe[3];
  470. }
  471. s->func(s->context, scanlineheader, 4);
  472. /* RLE each component separately */
  473. for (c=0; c < 4; c++) {
  474. unsigned char *comp = &scratch[width*c];
  475. x = 0;
  476. while (x < width) {
  477. // find first run
  478. r = x;
  479. while (r+2 < width) {
  480. if (comp[r] == comp[r+1] && comp[r] == comp[r+2])
  481. break;
  482. ++r;
  483. }
  484. if (r+2 >= width)
  485. r = width;
  486. // dump up to first run
  487. while (x < r) {
  488. int len = r-x;
  489. if (len > 128) len = 128;
  490. stbiw__write_dump_data(s, len, &comp[x]);
  491. x += len;
  492. }
  493. // if there's a run, output it
  494. if (r+2 < width) { // same test as what we break out of in search loop, so only true if we break'd
  495. // find next byte after run
  496. while (r < width && comp[r] == comp[x])
  497. ++r;
  498. // output run up to r
  499. while (x < r) {
  500. int len = r-x;
  501. if (len > 127) len = 127;
  502. stbiw__write_run_data(s, len, comp[x]);
  503. x += len;
  504. }
  505. }
  506. }
  507. }
  508. }
  509. }
  510. static int stbi_write_hdr_core(stbi__write_context *s, int x, int y, int comp, float *data)
  511. {
  512. if (y <= 0 || x <= 0 || data == NULL)
  513. return 0;
  514. else {
  515. // Each component is stored separately. Allocate scratch space for full output scanline.
  516. unsigned char *scratch = (unsigned char *) STBIW_MALLOC(x*4);
  517. int i, len;
  518. char buffer[128];
  519. char header[] = "#?RADIANCE\n# Written by stb_image_write.h\nFORMAT=32-bit_rle_rgbe\n";
  520. s->func(s->context, header, sizeof(header)-1);
  521. len = sprintf(buffer, "EXPOSURE= 1.0000000000000\n\n-Y %d +X %d\n", y, x);
  522. s->func(s->context, buffer, len);
  523. for(i=0; i < y; i++)
  524. stbiw__write_hdr_scanline(s, x, comp, scratch, data + comp*i*x);
  525. STBIW_FREE(scratch);
  526. return 1;
  527. }
  528. }
  529. int stbi_write_hdr_to_func(stbi_write_func *func, void *context, int x, int y, int comp, const float *data)
  530. {
  531. stbi__write_context s;
  532. stbi__start_write_callbacks(&s, func, context);
  533. return stbi_write_hdr_core(&s, x, y, comp, (float *) data);
  534. }
  535. int stbi_write_hdr(char const *filename, int x, int y, int comp, const float *data)
  536. {
  537. stbi__write_context s;
  538. if (stbi__start_write_file(&s,filename)) {
  539. int r = stbi_write_hdr_core(&s, x, y, comp, (float *) data);
  540. stbi__end_write_file(&s);
  541. return r;
  542. } else
  543. return 0;
  544. }
  545. #endif // STBI_WRITE_NO_STDIO
  546. //////////////////////////////////////////////////////////////////////////////
  547. //
  548. // PNG writer
  549. //
  550. // stretchy buffer; stbiw__sbpush() == vector<>::push_back() -- stbiw__sbcount() == vector<>::size()
  551. #define stbiw__sbraw(a) ((int *) (a) - 2)
  552. #define stbiw__sbm(a) stbiw__sbraw(a)[0]
  553. #define stbiw__sbn(a) stbiw__sbraw(a)[1]
  554. #define stbiw__sbneedgrow(a,n) ((a)==0 || stbiw__sbn(a)+n >= stbiw__sbm(a))
  555. #define stbiw__sbmaybegrow(a,n) (stbiw__sbneedgrow(a,(n)) ? stbiw__sbgrow(a,n) : 0)
  556. #define stbiw__sbgrow(a,n) stbiw__sbgrowf((void **) &(a), (n), sizeof(*(a)))
  557. #define stbiw__sbpush(a, v) (stbiw__sbmaybegrow(a,1), (a)[stbiw__sbn(a)++] = (v))
  558. #define stbiw__sbcount(a) ((a) ? stbiw__sbn(a) : 0)
  559. #define stbiw__sbfree(a) ((a) ? STBIW_FREE(stbiw__sbraw(a)),0 : 0)
  560. static void *stbiw__sbgrowf(void **arr, int increment, int itemsize)
  561. {
  562. int m = *arr ? 2*stbiw__sbm(*arr)+increment : increment+1;
  563. void *p = STBIW_REALLOC_SIZED(*arr ? stbiw__sbraw(*arr) : 0, *arr ? (stbiw__sbm(*arr)*itemsize + sizeof(int)*2) : 0, itemsize * m + sizeof(int)*2);
  564. STBIW_ASSERT(p);
  565. if (p) {
  566. if (!*arr) ((int *) p)[1] = 0;
  567. *arr = (void *) ((int *) p + 2);
  568. stbiw__sbm(*arr) = m;
  569. }
  570. return *arr;
  571. }
  572. static unsigned char *stbiw__zlib_flushf(unsigned char *data, unsigned int *bitbuffer, int *bitcount)
  573. {
  574. while (*bitcount >= 8) {
  575. stbiw__sbpush(data, STBIW_UCHAR(*bitbuffer));
  576. *bitbuffer >>= 8;
  577. *bitcount -= 8;
  578. }
  579. return data;
  580. }
  581. static int stbiw__zlib_bitrev(int code, int codebits)
  582. {
  583. int res=0;
  584. while (codebits--) {
  585. res = (res << 1) | (code & 1);
  586. code >>= 1;
  587. }
  588. return res;
  589. }
  590. static unsigned int stbiw__zlib_countm(unsigned char *a, unsigned char *b, int limit)
  591. {
  592. int i;
  593. for (i=0; i < limit && i < 258; ++i)
  594. if (a[i] != b[i]) break;
  595. return i;
  596. }
  597. static unsigned int stbiw__zhash(unsigned char *data)
  598. {
  599. stbiw_uint32 hash = data[0] + (data[1] << 8) + (data[2] << 16);
  600. hash ^= hash << 3;
  601. hash += hash >> 5;
  602. hash ^= hash << 4;
  603. hash += hash >> 17;
  604. hash ^= hash << 25;
  605. hash += hash >> 6;
  606. return hash;
  607. }
  608. #define stbiw__zlib_flush() (out = stbiw__zlib_flushf(out, &bitbuf, &bitcount))
  609. #define stbiw__zlib_add(code,codebits) \
  610. (bitbuf |= (code) << bitcount, bitcount += (codebits), stbiw__zlib_flush())
  611. #define stbiw__zlib_huffa(b,c) stbiw__zlib_add(stbiw__zlib_bitrev(b,c),c)
  612. // default huffman tables
  613. #define stbiw__zlib_huff1(n) stbiw__zlib_huffa(0x30 + (n), 8)
  614. #define stbiw__zlib_huff2(n) stbiw__zlib_huffa(0x190 + (n)-144, 9)
  615. #define stbiw__zlib_huff3(n) stbiw__zlib_huffa(0 + (n)-256,7)
  616. #define stbiw__zlib_huff4(n) stbiw__zlib_huffa(0xc0 + (n)-280,8)
  617. #define stbiw__zlib_huff(n) ((n) <= 143 ? stbiw__zlib_huff1(n) : (n) <= 255 ? stbiw__zlib_huff2(n) : (n) <= 279 ? stbiw__zlib_huff3(n) : stbiw__zlib_huff4(n))
  618. #define stbiw__zlib_huffb(n) ((n) <= 143 ? stbiw__zlib_huff1(n) : stbiw__zlib_huff2(n))
  619. #define stbiw__ZHASH 16384
  620. unsigned char * stbi_zlib_compress(unsigned char *data, int data_len, int *out_len, int quality)
  621. {
  622. static unsigned short lengthc[] = { 3,4,5,6,7,8,9,10,11,13,15,17,19,23,27,31,35,43,51,59,67,83,99,115,131,163,195,227,258, 259 };
  623. static unsigned char lengtheb[]= { 0,0,0,0,0,0,0, 0, 1, 1, 1, 1, 2, 2, 2, 2, 3, 3, 3, 3, 4, 4, 4, 4, 5, 5, 5, 5, 0 };
  624. static unsigned short distc[] = { 1,2,3,4,5,7,9,13,17,25,33,49,65,97,129,193,257,385,513,769,1025,1537,2049,3073,4097,6145,8193,12289,16385,24577, 32768 };
  625. static unsigned char disteb[] = { 0,0,0,0,1,1,2,2,3,3,4,4,5,5,6,6,7,7,8,8,9,9,10,10,11,11,12,12,13,13 };
  626. unsigned int bitbuf=0;
  627. int i,j, bitcount=0;
  628. unsigned char *out = NULL;
  629. unsigned char ***hash_table = (unsigned char***) STBIW_MALLOC(stbiw__ZHASH * sizeof(char**));
  630. if (quality < 5) quality = 5;
  631. stbiw__sbpush(out, 0x78); // DEFLATE 32K window
  632. stbiw__sbpush(out, 0x5e); // FLEVEL = 1
  633. stbiw__zlib_add(1,1); // BFINAL = 1
  634. stbiw__zlib_add(1,2); // BTYPE = 1 -- fixed huffman
  635. for (i=0; i < stbiw__ZHASH; ++i)
  636. hash_table[i] = NULL;
  637. i=0;
  638. while (i < data_len-3) {
  639. // hash next 3 bytes of data to be compressed
  640. int h = stbiw__zhash(data+i)&(stbiw__ZHASH-1), best=3;
  641. unsigned char *bestloc = 0;
  642. unsigned char **hlist = hash_table[h];
  643. int n = stbiw__sbcount(hlist);
  644. for (j=0; j < n; ++j) {
  645. if (hlist[j]-data > i-32768) { // if entry lies within window
  646. int d = stbiw__zlib_countm(hlist[j], data+i, data_len-i);
  647. if (d >= best) best=d,bestloc=hlist[j];
  648. }
  649. }
  650. // when hash table entry is too long, delete half the entries
  651. if (hash_table[h] && stbiw__sbn(hash_table[h]) == 2*quality) {
  652. STBIW_MEMMOVE(hash_table[h], hash_table[h]+quality, sizeof(hash_table[h][0])*quality);
  653. stbiw__sbn(hash_table[h]) = quality;
  654. }
  655. stbiw__sbpush(hash_table[h],data+i);
  656. if (bestloc) {
  657. // "lazy matching" - check match at *next* byte, and if it's better, do cur byte as literal
  658. h = stbiw__zhash(data+i+1)&(stbiw__ZHASH-1);
  659. hlist = hash_table[h];
  660. n = stbiw__sbcount(hlist);
  661. for (j=0; j < n; ++j) {
  662. if (hlist[j]-data > i-32767) {
  663. int e = stbiw__zlib_countm(hlist[j], data+i+1, data_len-i-1);
  664. if (e > best) { // if next match is better, bail on current match
  665. bestloc = NULL;
  666. break;
  667. }
  668. }
  669. }
  670. }
  671. if (bestloc) {
  672. int d = (int) (data+i - bestloc); // distance back
  673. STBIW_ASSERT(d <= 32767 && best <= 258);
  674. for (j=0; best > lengthc[j+1]-1; ++j);
  675. stbiw__zlib_huff(j+257);
  676. if (lengtheb[j]) stbiw__zlib_add(best - lengthc[j], lengtheb[j]);
  677. for (j=0; d > distc[j+1]-1; ++j);
  678. stbiw__zlib_add(stbiw__zlib_bitrev(j,5),5);
  679. if (disteb[j]) stbiw__zlib_add(d - distc[j], disteb[j]);
  680. i += best;
  681. } else {
  682. stbiw__zlib_huffb(data[i]);
  683. ++i;
  684. }
  685. }
  686. // write out final bytes
  687. for (;i < data_len; ++i)
  688. stbiw__zlib_huffb(data[i]);
  689. stbiw__zlib_huff(256); // end of block
  690. // pad with 0 bits to byte boundary
  691. while (bitcount)
  692. stbiw__zlib_add(0,1);
  693. for (i=0; i < stbiw__ZHASH; ++i)
  694. (void) stbiw__sbfree(hash_table[i]);
  695. STBIW_FREE(hash_table);
  696. {
  697. // compute adler32 on input
  698. unsigned int s1=1, s2=0;
  699. int blocklen = (int) (data_len % 5552);
  700. j=0;
  701. while (j < data_len) {
  702. for (i=0; i < blocklen; ++i) s1 += data[j+i], s2 += s1;
  703. s1 %= 65521, s2 %= 65521;
  704. j += blocklen;
  705. blocklen = 5552;
  706. }
  707. stbiw__sbpush(out, STBIW_UCHAR(s2 >> 8));
  708. stbiw__sbpush(out, STBIW_UCHAR(s2));
  709. stbiw__sbpush(out, STBIW_UCHAR(s1 >> 8));
  710. stbiw__sbpush(out, STBIW_UCHAR(s1));
  711. }
  712. *out_len = stbiw__sbn(out);
  713. // make returned pointer freeable
  714. STBIW_MEMMOVE(stbiw__sbraw(out), out, *out_len);
  715. return (unsigned char *) stbiw__sbraw(out);
  716. }
  717. static unsigned int stbiw__crc32(unsigned char *buffer, int len)
  718. {
  719. static unsigned int crc_table[256] =
  720. {
  721. 0x00000000, 0x77073096, 0xEE0E612C, 0x990951BA, 0x076DC419, 0x706AF48F, 0xE963A535, 0x9E6495A3,
  722. 0x0eDB8832, 0x79DCB8A4, 0xE0D5E91E, 0x97D2D988, 0x09B64C2B, 0x7EB17CBD, 0xE7B82D07, 0x90BF1D91,
  723. 0x1DB71064, 0x6AB020F2, 0xF3B97148, 0x84BE41DE, 0x1ADAD47D, 0x6DDDE4EB, 0xF4D4B551, 0x83D385C7,
  724. 0x136C9856, 0x646BA8C0, 0xFD62F97A, 0x8A65C9EC, 0x14015C4F, 0x63066CD9, 0xFA0F3D63, 0x8D080DF5,
  725. 0x3B6E20C8, 0x4C69105E, 0xD56041E4, 0xA2677172, 0x3C03E4D1, 0x4B04D447, 0xD20D85FD, 0xA50AB56B,
  726. 0x35B5A8FA, 0x42B2986C, 0xDBBBC9D6, 0xACBCF940, 0x32D86CE3, 0x45DF5C75, 0xDCD60DCF, 0xABD13D59,
  727. 0x26D930AC, 0x51DE003A, 0xC8D75180, 0xBFD06116, 0x21B4F4B5, 0x56B3C423, 0xCFBA9599, 0xB8BDA50F,
  728. 0x2802B89E, 0x5F058808, 0xC60CD9B2, 0xB10BE924, 0x2F6F7C87, 0x58684C11, 0xC1611DAB, 0xB6662D3D,
  729. 0x76DC4190, 0x01DB7106, 0x98D220BC, 0xEFD5102A, 0x71B18589, 0x06B6B51F, 0x9FBFE4A5, 0xE8B8D433,
  730. 0x7807C9A2, 0x0F00F934, 0x9609A88E, 0xE10E9818, 0x7F6A0DBB, 0x086D3D2D, 0x91646C97, 0xE6635C01,
  731. 0x6B6B51F4, 0x1C6C6162, 0x856530D8, 0xF262004E, 0x6C0695ED, 0x1B01A57B, 0x8208F4C1, 0xF50FC457,
  732. 0x65B0D9C6, 0x12B7E950, 0x8BBEB8EA, 0xFCB9887C, 0x62DD1DDF, 0x15DA2D49, 0x8CD37CF3, 0xFBD44C65,
  733. 0x4DB26158, 0x3AB551CE, 0xA3BC0074, 0xD4BB30E2, 0x4ADFA541, 0x3DD895D7, 0xA4D1C46D, 0xD3D6F4FB,
  734. 0x4369E96A, 0x346ED9FC, 0xAD678846, 0xDA60B8D0, 0x44042D73, 0x33031DE5, 0xAA0A4C5F, 0xDD0D7CC9,
  735. 0x5005713C, 0x270241AA, 0xBE0B1010, 0xC90C2086, 0x5768B525, 0x206F85B3, 0xB966D409, 0xCE61E49F,
  736. 0x5EDEF90E, 0x29D9C998, 0xB0D09822, 0xC7D7A8B4, 0x59B33D17, 0x2EB40D81, 0xB7BD5C3B, 0xC0BA6CAD,
  737. 0xEDB88320, 0x9ABFB3B6, 0x03B6E20C, 0x74B1D29A, 0xEAD54739, 0x9DD277AF, 0x04DB2615, 0x73DC1683,
  738. 0xE3630B12, 0x94643B84, 0x0D6D6A3E, 0x7A6A5AA8, 0xE40ECF0B, 0x9309FF9D, 0x0A00AE27, 0x7D079EB1,
  739. 0xF00F9344, 0x8708A3D2, 0x1E01F268, 0x6906C2FE, 0xF762575D, 0x806567CB, 0x196C3671, 0x6E6B06E7,
  740. 0xFED41B76, 0x89D32BE0, 0x10DA7A5A, 0x67DD4ACC, 0xF9B9DF6F, 0x8EBEEFF9, 0x17B7BE43, 0x60B08ED5,
  741. 0xD6D6A3E8, 0xA1D1937E, 0x38D8C2C4, 0x4FDFF252, 0xD1BB67F1, 0xA6BC5767, 0x3FB506DD, 0x48B2364B,
  742. 0xD80D2BDA, 0xAF0A1B4C, 0x36034AF6, 0x41047A60, 0xDF60EFC3, 0xA867DF55, 0x316E8EEF, 0x4669BE79,
  743. 0xCB61B38C, 0xBC66831A, 0x256FD2A0, 0x5268E236, 0xCC0C7795, 0xBB0B4703, 0x220216B9, 0x5505262F,
  744. 0xC5BA3BBE, 0xB2BD0B28, 0x2BB45A92, 0x5CB36A04, 0xC2D7FFA7, 0xB5D0CF31, 0x2CD99E8B, 0x5BDEAE1D,
  745. 0x9B64C2B0, 0xEC63F226, 0x756AA39C, 0x026D930A, 0x9C0906A9, 0xEB0E363F, 0x72076785, 0x05005713,
  746. 0x95BF4A82, 0xE2B87A14, 0x7BB12BAE, 0x0CB61B38, 0x92D28E9B, 0xE5D5BE0D, 0x7CDCEFB7, 0x0BDBDF21,
  747. 0x86D3D2D4, 0xF1D4E242, 0x68DDB3F8, 0x1FDA836E, 0x81BE16CD, 0xF6B9265B, 0x6FB077E1, 0x18B74777,
  748. 0x88085AE6, 0xFF0F6A70, 0x66063BCA, 0x11010B5C, 0x8F659EFF, 0xF862AE69, 0x616BFFD3, 0x166CCF45,
  749. 0xA00AE278, 0xD70DD2EE, 0x4E048354, 0x3903B3C2, 0xA7672661, 0xD06016F7, 0x4969474D, 0x3E6E77DB,
  750. 0xAED16A4A, 0xD9D65ADC, 0x40DF0B66, 0x37D83BF0, 0xA9BCAE53, 0xDEBB9EC5, 0x47B2CF7F, 0x30B5FFE9,
  751. 0xBDBDF21C, 0xCABAC28A, 0x53B39330, 0x24B4A3A6, 0xBAD03605, 0xCDD70693, 0x54DE5729, 0x23D967BF,
  752. 0xB3667A2E, 0xC4614AB8, 0x5D681B02, 0x2A6F2B94, 0xB40BBE37, 0xC30C8EA1, 0x5A05DF1B, 0x2D02EF8D
  753. };
  754. unsigned int crc = ~0u;
  755. int i;
  756. for (i=0; i < len; ++i)
  757. crc = (crc >> 8) ^ crc_table[buffer[i] ^ (crc & 0xff)];
  758. return ~crc;
  759. }
  760. #define stbiw__wpng4(o,a,b,c,d) ((o)[0]=STBIW_UCHAR(a),(o)[1]=STBIW_UCHAR(b),(o)[2]=STBIW_UCHAR(c),(o)[3]=STBIW_UCHAR(d),(o)+=4)
  761. #define stbiw__wp32(data,v) stbiw__wpng4(data, (v)>>24,(v)>>16,(v)>>8,(v));
  762. #define stbiw__wptag(data,s) stbiw__wpng4(data, s[0],s[1],s[2],s[3])
  763. static void stbiw__wpcrc(unsigned char **data, int len)
  764. {
  765. unsigned int crc = stbiw__crc32(*data - len - 4, len+4);
  766. stbiw__wp32(*data, crc);
  767. }
  768. static unsigned char stbiw__paeth(int a, int b, int c)
  769. {
  770. int p = a + b - c, pa = abs(p-a), pb = abs(p-b), pc = abs(p-c);
  771. if (pa <= pb && pa <= pc) return STBIW_UCHAR(a);
  772. if (pb <= pc) return STBIW_UCHAR(b);
  773. return STBIW_UCHAR(c);
  774. }
  775. unsigned char *stbi_write_png_to_mem(unsigned char *pixels, int stride_bytes, int x, int y, int n, int *out_len)
  776. {
  777. int ctype[5] = { -1, 0, 4, 2, 6 };
  778. unsigned char sig[8] = { 137,80,78,71,13,10,26,10 };
  779. unsigned char *out,*o, *filt, *zlib;
  780. signed char *line_buffer;
  781. int i,j,k,p,zlen;
  782. if (stride_bytes == 0)
  783. stride_bytes = x * n;
  784. filt = (unsigned char *) STBIW_MALLOC((x*n+1) * y); if (!filt) return 0;
  785. line_buffer = (signed char *) STBIW_MALLOC(x * n); if (!line_buffer) { STBIW_FREE(filt); return 0; }
  786. for (j=0; j < y; ++j) {
  787. static int mapping[] = { 0,1,2,3,4 };
  788. static int firstmap[] = { 0,1,0,5,6 };
  789. int *mymap = j ? mapping : firstmap;
  790. int best = 0, bestval = 0x7fffffff;
  791. for (p=0; p < 2; ++p) {
  792. for (k= p?best:0; k < 5; ++k) {
  793. int type = mymap[k],est=0;
  794. unsigned char *z = pixels + stride_bytes*j;
  795. for (i=0; i < n; ++i)
  796. switch (type) {
  797. case 0: line_buffer[i] = z[i]; break;
  798. case 1: line_buffer[i] = z[i]; break;
  799. case 2: line_buffer[i] = z[i] - z[i-stride_bytes]; break;
  800. case 3: line_buffer[i] = z[i] - (z[i-stride_bytes]>>1); break;
  801. case 4: line_buffer[i] = (signed char) (z[i] - stbiw__paeth(0,z[i-stride_bytes],0)); break;
  802. case 5: line_buffer[i] = z[i]; break;
  803. case 6: line_buffer[i] = z[i]; break;
  804. }
  805. for (i=n; i < x*n; ++i) {
  806. switch (type) {
  807. case 0: line_buffer[i] = z[i]; break;
  808. case 1: line_buffer[i] = z[i] - z[i-n]; break;
  809. case 2: line_buffer[i] = z[i] - z[i-stride_bytes]; break;
  810. case 3: line_buffer[i] = z[i] - ((z[i-n] + z[i-stride_bytes])>>1); break;
  811. case 4: line_buffer[i] = z[i] - stbiw__paeth(z[i-n], z[i-stride_bytes], z[i-stride_bytes-n]); break;
  812. case 5: line_buffer[i] = z[i] - (z[i-n]>>1); break;
  813. case 6: line_buffer[i] = z[i] - stbiw__paeth(z[i-n], 0,0); break;
  814. }
  815. }
  816. if (p) break;
  817. for (i=0; i < x*n; ++i)
  818. est += abs((signed char) line_buffer[i]);
  819. if (est < bestval) { bestval = est; best = k; }
  820. }
  821. }
  822. // when we get here, best contains the filter type, and line_buffer contains the data
  823. filt[j*(x*n+1)] = (unsigned char) best;
  824. STBIW_MEMMOVE(filt+j*(x*n+1)+1, line_buffer, x*n);
  825. }
  826. STBIW_FREE(line_buffer);
  827. zlib = stbi_zlib_compress(filt, y*( x*n+1), &zlen, 8); // increase 8 to get smaller but use more memory
  828. STBIW_FREE(filt);
  829. if (!zlib) return 0;
  830. // each tag requires 12 bytes of overhead
  831. out = (unsigned char *) STBIW_MALLOC(8 + 12+13 + 12+zlen + 12);
  832. if (!out) return 0;
  833. *out_len = 8 + 12+13 + 12+zlen + 12;
  834. o=out;
  835. STBIW_MEMMOVE(o,sig,8); o+= 8;
  836. stbiw__wp32(o, 13); // header length
  837. stbiw__wptag(o, "IHDR");
  838. stbiw__wp32(o, x);
  839. stbiw__wp32(o, y);
  840. *o++ = 8;
  841. *o++ = STBIW_UCHAR(ctype[n]);
  842. *o++ = 0;
  843. *o++ = 0;
  844. *o++ = 0;
  845. stbiw__wpcrc(&o,13);
  846. stbiw__wp32(o, zlen);
  847. stbiw__wptag(o, "IDAT");
  848. STBIW_MEMMOVE(o, zlib, zlen);
  849. o += zlen;
  850. STBIW_FREE(zlib);
  851. stbiw__wpcrc(&o, zlen);
  852. stbiw__wp32(o,0);
  853. stbiw__wptag(o, "IEND");
  854. stbiw__wpcrc(&o,0);
  855. STBIW_ASSERT(o == out + *out_len);
  856. return out;
  857. }
  858. #ifndef STBI_WRITE_NO_STDIO
  859. STBIWDEF int stbi_write_png(char const *filename, int x, int y, int comp, const void *data, int stride_bytes)
  860. {
  861. FILE *f;
  862. int len;
  863. unsigned char *png = stbi_write_png_to_mem((unsigned char *) data, stride_bytes, x, y, comp, &len);
  864. if (png == NULL) return 0;
  865. f = fopen(filename, "wb");
  866. if (!f) { STBIW_FREE(png); return 0; }
  867. fwrite(png, 1, len, f);
  868. fclose(f);
  869. STBIW_FREE(png);
  870. return 1;
  871. }
  872. #endif
  873. STBIWDEF int stbi_write_png_to_func(stbi_write_func *func, void *context, int x, int y, int comp, const void *data, int stride_bytes)
  874. {
  875. int len;
  876. unsigned char *png = stbi_write_png_to_mem((unsigned char *) data, stride_bytes, x, y, comp, &len);
  877. if (png == NULL) return 0;
  878. func(context, png, len);
  879. STBIW_FREE(png);
  880. return 1;
  881. }
  882. #endif // STB_IMAGE_WRITE_IMPLEMENTATION
  883. /* Revision history
  884. 1.02 (2016-04-02)
  885. avoid allocating large structures on the stack
  886. 1.01 (2016-01-16)
  887. STBIW_REALLOC_SIZED: support allocators with no realloc support
  888. avoid race-condition in crc initialization
  889. minor compile issues
  890. 1.00 (2015-09-14)
  891. installable file IO function
  892. 0.99 (2015-09-13)
  893. warning fixes; TGA rle support
  894. 0.98 (2015-04-08)
  895. added STBIW_MALLOC, STBIW_ASSERT etc
  896. 0.97 (2015-01-18)
  897. fixed HDR asserts, rewrote HDR rle logic
  898. 0.96 (2015-01-17)
  899. add HDR output
  900. fix monochrome BMP
  901. 0.95 (2014-08-17)
  902. add monochrome TGA output
  903. 0.94 (2014-05-31)
  904. rename private functions to avoid conflicts with stb_image.h
  905. 0.93 (2014-05-27)
  906. warning fixes
  907. 0.92 (2010-08-01)
  908. casts to unsigned char to fix warnings
  909. 0.91 (2010-07-17)
  910. first public release
  911. 0.90 first internal release
  912. */