stb_image_write.cpp 68 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038103910401041104210431044104510461047104810491050105110521053105410551056105710581059106010611062106310641065106610671068106910701071107210731074107510761077107810791080108110821083108410851086108710881089109010911092109310941095109610971098109911001101110211031104110511061107110811091110111111121113111411151116111711181119112011211122112311241125112611271128112911301131113211331134113511361137113811391140114111421143114411451146114711481149115011511152115311541155115611571158115911601161116211631164116511661167116811691170117111721173117411751176117711781179118011811182118311841185118611871188118911901191119211931194119511961197119811991200120112021203120412051206120712081209121012111212121312141215121612171218121912201221122212231224122512261227122812291230123112321233123412351236123712381239124012411242124312441245124612471248124912501251125212531254125512561257125812591260126112621263126412651266126712681269127012711272127312741275127612771278127912801281128212831284128512861287128812891290129112921293129412951296129712981299130013011302130313041305130613071308130913101311131213131314131513161317131813191320132113221323132413251326132713281329133013311332133313341335133613371338133913401341134213431344134513461347134813491350135113521353135413551356135713581359136013611362136313641365136613671368136913701371137213731374137513761377137813791380138113821383138413851386138713881389139013911392139313941395139613971398139914001401140214031404140514061407140814091410141114121413141414151416141714181419142014211422142314241425142614271428142914301431143214331434143514361437143814391440144114421443144414451446144714481449145014511452145314541455145614571458145914601461146214631464146514661467146814691470147114721473147414751476147714781479148014811482148314841485148614871488148914901491149214931494149514961497149814991500150115021503150415051506150715081509151015111512151315141515151615171518151915201521152215231524152515261527152815291530153115321533153415351536153715381539154015411542154315441545154615471548154915501551155215531554155515561557155815591560156115621563156415651566156715681569157015711572157315741575157615771578157915801581158215831584158515861587158815891590159115921593159415951596159715981599160016011602160316041605160616071608160916101611161216131614161516161617161816191620162116221623162416251626162716281629163016311632163316341635163616371638163916401641164216431644164516461647164816491650165116521653165416551656165716581659166016611662166316641665166616671668166916701671167216731674167516761677
  1. // SPDX-FileCopyrightText: stb http://nothings.org/stb
  2. // SPDX-License-Identifier: MIT
  3. /* stb_image_write - v1.16 - public domain - http://nothings.org/stb
  4. writes out PNG/BMP/TGA/JPEG/HDR images to C stdio - Sean Barrett 2010-2015
  5. no warranty implied; use at your own risk
  6. Before #including,
  7. #define STB_IMAGE_WRITE_IMPLEMENTATION
  8. in the file that you want to have the implementation.
  9. Will probably not work correctly with strict-aliasing optimizations.
  10. ABOUT:
  11. This header file is a library for writing images to C stdio or a callback.
  12. The PNG output is not optimal; it is 20-50% larger than the file
  13. written by a decent optimizing implementation; though providing a custom
  14. zlib compress function (see STBIW_ZLIB_COMPRESS) can mitigate that.
  15. This library is designed for source code compactness and simplicity,
  16. not optimal image file size or run-time performance.
  17. BUILDING:
  18. You can #define STBIW_ASSERT(x) before the #include to avoid using assert.h.
  19. You can #define STBIW_MALLOC(), STBIW_REALLOC(), and STBIW_FREE() to replace
  20. malloc,realloc,free.
  21. You can #define STBIW_MEMMOVE() to replace memmove()
  22. You can #define STBIW_ZLIB_COMPRESS to use a custom zlib-style compress function
  23. for PNG compression (instead of the builtin one), it must have the following signature:
  24. unsigned char * my_compress(unsigned char *data, int data_len, int *out_len, int quality);
  25. The returned data will be freed with STBIW_FREE() (free() by default),
  26. so it must be heap allocated with STBIW_MALLOC() (malloc() by default),
  27. UNICODE:
  28. If compiling for Windows and you wish to use Unicode filenames, compile
  29. with
  30. #define STBIW_WINDOWS_UTF8
  31. and pass utf8-encoded filenames. Call stbiw_convert_wchar_to_utf8 to convert
  32. Windows wchar_t filenames to utf8.
  33. USAGE:
  34. There are five functions, one for each image file format:
  35. int stbi_write_png(char const *filename, int w, int h, int comp, const void *data, int stride_in_bytes);
  36. int stbi_write_bmp(char const *filename, int w, int h, int comp, const void *data);
  37. int stbi_write_tga(char const *filename, int w, int h, int comp, const void *data);
  38. int stbi_write_jpg(char const *filename, int w, int h, int comp, const void *data, int quality);
  39. int stbi_write_hdr(char const *filename, int w, int h, int comp, const float *data);
  40. void stbi_flip_vertically_on_write(int flag); // flag is non-zero to flip data vertically
  41. There are also five equivalent functions that use an arbitrary write function. You are
  42. expected to open/close your file-equivalent before and after calling these:
  43. 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);
  44. int stbi_write_bmp_to_func(stbi_write_func *func, void *context, int w, int h, int comp, const void *data);
  45. int stbi_write_tga_to_func(stbi_write_func *func, void *context, int w, int h, int comp, const void *data);
  46. int stbi_write_hdr_to_func(stbi_write_func *func, void *context, int w, int h, int comp, const float *data);
  47. int stbi_write_jpg_to_func(stbi_write_func *func, void *context, int x, int y, int comp, const void *data, int quality);
  48. where the callback is:
  49. void stbi_write_func(void *context, void *data, int size);
  50. You can configure it with these global variables:
  51. int stbi_write_tga_with_rle; // defaults to true; set to 0 to disable RLE
  52. int stbi_write_png_compression_level; // defaults to 8; set to higher for more compression
  53. int stbi_write_force_png_filter; // defaults to -1; set to 0..5 to force a filter mode
  54. You can define STBI_WRITE_NO_STDIO to disable the file variant of these
  55. functions, so the library will not use stdio.h at all. However, this will
  56. also disable HDR writing, because it requires stdio for formatted output.
  57. Each function returns 0 on failure and non-0 on success.
  58. The functions create an image file defined by the parameters. The image
  59. is a rectangle of pixels stored from left-to-right, top-to-bottom.
  60. Each pixel contains 'comp' channels of data stored interleaved with 8-bits
  61. per channel, in the following order: 1=Y, 2=YA, 3=RGB, 4=RGBA. (Y is
  62. monochrome color.) The rectangle is 'w' pixels wide and 'h' pixels tall.
  63. The *data pointer points to the first byte of the top-left-most pixel.
  64. For PNG, "stride_in_bytes" is the distance in bytes from the first byte of
  65. a row of pixels to the first byte of the next row of pixels.
  66. PNG creates output files with the same number of components as the input.
  67. The BMP format expands Y to RGB in the file format and does not
  68. output alpha.
  69. PNG supports writing rectangles of data even when the bytes storing rows of
  70. data are not consecutive in memory (e.g. sub-rectangles of a larger image),
  71. by supplying the stride between the beginning of adjacent rows. The other
  72. formats do not. (Thus you cannot write a native-format BMP through the BMP
  73. writer, both because it is in BGR order and because it may have padding
  74. at the end of the line.)
  75. PNG allows you to set the deflate compression level by setting the global
  76. variable 'stbi_write_png_compression_level' (it defaults to 8).
  77. HDR expects linear float data. Since the format is always 32-bit rgb(e)
  78. data, alpha (if provided) is discarded, and for monochrome data it is
  79. replicated across all three channels.
  80. TGA supports RLE or non-RLE compressed data. To use non-RLE-compressed
  81. data, set the global variable 'stbi_write_tga_with_rle' to 0.
  82. JPEG does ignore alpha channels in input data; quality is between 1 and 100.
  83. Higher quality looks better but results in a bigger image.
  84. JPEG baseline (no JPEG progressive).
  85. CREDITS:
  86. Sean Barrett - PNG/BMP/TGA
  87. Baldur Karlsson - HDR
  88. Jean-Sebastien Guay - TGA monochrome
  89. Tim Kelsey - misc enhancements
  90. Alan Hickman - TGA RLE
  91. Emmanuel Julien - initial file IO callback implementation
  92. Jon Olick - original jo_jpeg.cpp code
  93. Daniel Gibson - integrate JPEG, allow external zlib
  94. Aarni Koskela - allow choosing PNG filter
  95. bugfixes:
  96. github:Chribba
  97. Guillaume Chereau
  98. github:jry2
  99. github:romigrou
  100. Sergio Gonzalez
  101. Jonas Karlsson
  102. Filip Wasil
  103. Thatcher Ulrich
  104. github:poppolopoppo
  105. Patrick Boettcher
  106. github:xeekworx
  107. Cap Petschulat
  108. Simon Rodriguez
  109. Ivan Tikhonov
  110. github:ignotion
  111. Adam Schackart
  112. Andrew Kensler
  113. LICENSE
  114. See end of file for license information.
  115. */
  116. #include <stb_image_write.h>
  117. #ifdef _WIN32
  118. #ifndef _CRT_SECURE_NO_WARNINGS
  119. #define _CRT_SECURE_NO_WARNINGS
  120. #endif
  121. #ifndef _CRT_NONSTDC_NO_DEPRECATE
  122. #define _CRT_NONSTDC_NO_DEPRECATE
  123. #endif
  124. #endif
  125. #ifndef STBI_WRITE_NO_STDIO
  126. #include <stdio.h>
  127. #endif // STBI_WRITE_NO_STDIO
  128. #include <stdarg.h>
  129. #include <stdlib.h>
  130. #include <string.h>
  131. #include <math.h>
  132. #if defined(STBIW_MALLOC) && defined(STBIW_FREE) && (defined(STBIW_REALLOC) || defined(STBIW_REALLOC_SIZED))
  133. // ok
  134. #elif !defined(STBIW_MALLOC) && !defined(STBIW_FREE) && !defined(STBIW_REALLOC) && !defined(STBIW_REALLOC_SIZED)
  135. // ok
  136. #else
  137. #error "Must define all or none of STBIW_MALLOC, STBIW_FREE, and STBIW_REALLOC (or STBIW_REALLOC_SIZED)."
  138. #endif
  139. #ifndef STBIW_MALLOC
  140. #define STBIW_MALLOC(sz) malloc(sz)
  141. #define STBIW_REALLOC(p,newsz) realloc(p,newsz)
  142. #define STBIW_FREE(p) free(p)
  143. #endif
  144. #ifndef STBIW_REALLOC_SIZED
  145. #define STBIW_REALLOC_SIZED(p,oldsz,newsz) STBIW_REALLOC(p,newsz)
  146. #endif
  147. #ifndef STBIW_MEMMOVE
  148. #define STBIW_MEMMOVE(a,b,sz) memmove(a,b,sz)
  149. #endif
  150. #ifndef STBIW_ASSERT
  151. #include <assert.h>
  152. #define STBIW_ASSERT(x) assert(x)
  153. #endif
  154. #define STBIW_UCHAR(x) (unsigned char) ((x) & 0xff)
  155. #ifdef STB_IMAGE_WRITE_STATIC
  156. static int stbi_write_png_compression_level = 8;
  157. static int stbi_write_tga_with_rle = 1;
  158. static int stbi_write_force_png_filter = -1;
  159. #else
  160. int stbi_write_png_compression_level = 8;
  161. int stbi_write_tga_with_rle = 1;
  162. int stbi_write_force_png_filter = -1;
  163. #endif
  164. static int stbi__flip_vertically_on_write = 0;
  165. STBIWDEF void stbi_flip_vertically_on_write(int flag)
  166. {
  167. stbi__flip_vertically_on_write = flag;
  168. }
  169. typedef struct
  170. {
  171. stbi_write_func *func;
  172. void *context;
  173. unsigned char buffer[64];
  174. int buf_used;
  175. } stbi__write_context;
  176. // initialize a callback-based context
  177. static void stbi__start_write_callbacks(stbi__write_context *s, stbi_write_func *c, void *context)
  178. {
  179. s->func = c;
  180. s->context = context;
  181. }
  182. #ifndef STBI_WRITE_NO_STDIO
  183. static void stbi__stdio_write(void *context, void *data, int size)
  184. {
  185. fwrite(data,1,size,(FILE*) context);
  186. }
  187. #if defined(_WIN32) && defined(STBIW_WINDOWS_UTF8)
  188. #ifdef __cplusplus
  189. #define STBIW_EXTERN extern "C"
  190. #else
  191. #define STBIW_EXTERN extern
  192. #endif
  193. STBIW_EXTERN __declspec(dllimport) int __stdcall MultiByteToWideChar(unsigned int cp, unsigned long flags, const char *str, int cbmb, wchar_t *widestr, int cchwide);
  194. STBIW_EXTERN __declspec(dllimport) int __stdcall WideCharToMultiByte(unsigned int cp, unsigned long flags, const wchar_t *widestr, int cchwide, char *str, int cbmb, const char *defchar, int *used_default);
  195. STBIWDEF int stbiw_convert_wchar_to_utf8(char *buffer, size_t bufferlen, const wchar_t* input)
  196. {
  197. return WideCharToMultiByte(65001 /* UTF8 */, 0, input, -1, buffer, (int) bufferlen, NULL, NULL);
  198. }
  199. #endif
  200. static FILE *stbiw__fopen(char const *filename, char const *mode)
  201. {
  202. FILE *f;
  203. #if defined(_WIN32) && defined(STBIW_WINDOWS_UTF8)
  204. wchar_t wMode[64];
  205. wchar_t wFilename[1024];
  206. if (0 == MultiByteToWideChar(65001 /* UTF8 */, 0, filename, -1, wFilename, sizeof(wFilename)/sizeof(*wFilename)))
  207. return 0;
  208. if (0 == MultiByteToWideChar(65001 /* UTF8 */, 0, mode, -1, wMode, sizeof(wMode)/sizeof(*wMode)))
  209. return 0;
  210. #if defined(_MSC_VER) && _MSC_VER >= 1400
  211. if (0 != _wfopen_s(&f, wFilename, wMode))
  212. f = 0;
  213. #else
  214. f = _wfopen(wFilename, wMode);
  215. #endif
  216. #elif defined(_MSC_VER) && _MSC_VER >= 1400
  217. if (0 != fopen_s(&f, filename, mode))
  218. f=0;
  219. #else
  220. f = fopen(filename, mode);
  221. #endif
  222. return f;
  223. }
  224. static int stbi__start_write_file(stbi__write_context *s, const char *filename)
  225. {
  226. FILE *f = stbiw__fopen(filename, "wb");
  227. stbi__start_write_callbacks(s, stbi__stdio_write, (void *) f);
  228. return f != NULL;
  229. }
  230. static void stbi__end_write_file(stbi__write_context *s)
  231. {
  232. fclose((FILE *)s->context);
  233. }
  234. #endif // !STBI_WRITE_NO_STDIO
  235. typedef unsigned int stbiw_uint32;
  236. typedef int stb_image_write_test[sizeof(stbiw_uint32)==4 ? 1 : -1];
  237. static void stbiw__writefv(stbi__write_context *s, const char *fmt, va_list v)
  238. {
  239. while (*fmt) {
  240. switch (*fmt++) {
  241. case ' ': break;
  242. case '1': { unsigned char x = STBIW_UCHAR(va_arg(v, int));
  243. s->func(s->context,&x,1);
  244. break; }
  245. case '2': { int x = va_arg(v,int);
  246. unsigned char b[2];
  247. b[0] = STBIW_UCHAR(x);
  248. b[1] = STBIW_UCHAR(x>>8);
  249. s->func(s->context,b,2);
  250. break; }
  251. case '4': { stbiw_uint32 x = va_arg(v,int);
  252. unsigned char b[4];
  253. b[0]=STBIW_UCHAR(x);
  254. b[1]=STBIW_UCHAR(x>>8);
  255. b[2]=STBIW_UCHAR(x>>16);
  256. b[3]=STBIW_UCHAR(x>>24);
  257. s->func(s->context,b,4);
  258. break; }
  259. default:
  260. STBIW_ASSERT(0);
  261. return;
  262. }
  263. }
  264. }
  265. static void stbiw__writef(stbi__write_context *s, const char *fmt, ...)
  266. {
  267. va_list v;
  268. va_start(v, fmt);
  269. stbiw__writefv(s, fmt, v);
  270. va_end(v);
  271. }
  272. static void stbiw__write_flush(stbi__write_context *s)
  273. {
  274. if (s->buf_used) {
  275. s->func(s->context, &s->buffer, s->buf_used);
  276. s->buf_used = 0;
  277. }
  278. }
  279. static void stbiw__putc(stbi__write_context *s, unsigned char c)
  280. {
  281. s->func(s->context, &c, 1);
  282. }
  283. static void stbiw__write1(stbi__write_context *s, unsigned char a)
  284. {
  285. if ((size_t)s->buf_used + 1 > sizeof(s->buffer))
  286. stbiw__write_flush(s);
  287. s->buffer[s->buf_used++] = a;
  288. }
  289. static void stbiw__write3(stbi__write_context *s, unsigned char a, unsigned char b, unsigned char c)
  290. {
  291. int n;
  292. if ((size_t)s->buf_used + 3 > sizeof(s->buffer))
  293. stbiw__write_flush(s);
  294. n = s->buf_used;
  295. s->buf_used = n+3;
  296. s->buffer[n+0] = a;
  297. s->buffer[n+1] = b;
  298. s->buffer[n+2] = c;
  299. }
  300. static void stbiw__write_pixel(stbi__write_context *s, int rgb_dir, int comp, int write_alpha, int expand_mono, unsigned char *d)
  301. {
  302. unsigned char bg[3] = { 255, 0, 255}, px[3];
  303. int k;
  304. if (write_alpha < 0)
  305. stbiw__write1(s, d[comp - 1]);
  306. switch (comp) {
  307. case 2: // 2 pixels = mono + alpha, alpha is written separately, so same as 1-channel case
  308. case 1:
  309. if (expand_mono)
  310. stbiw__write3(s, d[0], d[0], d[0]); // monochrome bmp
  311. else
  312. stbiw__write1(s, d[0]); // monochrome TGA
  313. break;
  314. case 4:
  315. if (!write_alpha) {
  316. // composite against pink background
  317. for (k = 0; k < 3; ++k)
  318. px[k] = bg[k] + ((d[k] - bg[k]) * d[3]) / 255;
  319. stbiw__write3(s, px[1 - rgb_dir], px[1], px[1 + rgb_dir]);
  320. break;
  321. }
  322. /* FALLTHROUGH */
  323. case 3:
  324. stbiw__write3(s, d[1 - rgb_dir], d[1], d[1 + rgb_dir]);
  325. break;
  326. }
  327. if (write_alpha > 0)
  328. stbiw__write1(s, d[comp - 1]);
  329. }
  330. 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)
  331. {
  332. stbiw_uint32 zero = 0;
  333. int i,j, j_end;
  334. if (y <= 0)
  335. return;
  336. if (stbi__flip_vertically_on_write)
  337. vdir *= -1;
  338. if (vdir < 0) {
  339. j_end = -1; j = y-1;
  340. } else {
  341. j_end = y; j = 0;
  342. }
  343. for (; j != j_end; j += vdir) {
  344. for (i=0; i < x; ++i) {
  345. unsigned char *d = (unsigned char *) data + (j*x+i)*comp;
  346. stbiw__write_pixel(s, rgb_dir, comp, write_alpha, expand_mono, d);
  347. }
  348. stbiw__write_flush(s);
  349. s->func(s->context, &zero, scanline_pad);
  350. }
  351. }
  352. 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, ...)
  353. {
  354. if (y < 0 || x < 0) {
  355. return 0;
  356. } else {
  357. va_list v;
  358. va_start(v, fmt);
  359. stbiw__writefv(s, fmt, v);
  360. va_end(v);
  361. stbiw__write_pixels(s,rgb_dir,vdir,x,y,comp,data,alpha,pad, expand_mono);
  362. return 1;
  363. }
  364. }
  365. static int stbi_write_bmp_core(stbi__write_context *s, int x, int y, int comp, const void *data)
  366. {
  367. if (comp != 4) {
  368. // write RGB bitmap
  369. int pad = (-x*3) & 3;
  370. return stbiw__outfile(s,-1,-1,x,y,comp,1,(void *) data,0,pad,
  371. "11 4 22 4" "4 44 22 444444",
  372. 'B', 'M', 14+40+(x*3+pad)*y, 0,0, 14+40, // file header
  373. 40, x,y, 1,24, 0,0,0,0,0,0); // bitmap header
  374. } else {
  375. // RGBA bitmaps need a v4 header
  376. // use BI_BITFIELDS mode with 32bpp and alpha mask
  377. // (straight BI_RGB with alpha mask doesn't work in most readers)
  378. return stbiw__outfile(s,-1,-1,x,y,comp,1,(void *)data,1,0,
  379. "11 4 22 4" "4 44 22 444444 4444 4 444 444 444 444",
  380. 'B', 'M', 14+108+x*y*4, 0, 0, 14+108, // file header
  381. 108, x,y, 1,32, 3,0,0,0,0,0, 0xff0000,0xff00,0xff,0xff000000u, 0, 0,0,0, 0,0,0, 0,0,0, 0,0,0); // bitmap V4 header
  382. }
  383. }
  384. STBIWDEF int stbi_write_bmp_to_func(stbi_write_func *func, void *context, int x, int y, int comp, const void *data)
  385. {
  386. stbi__write_context s = { 0 };
  387. stbi__start_write_callbacks(&s, func, context);
  388. return stbi_write_bmp_core(&s, x, y, comp, data);
  389. }
  390. #ifndef STBI_WRITE_NO_STDIO
  391. STBIWDEF int stbi_write_bmp(char const *filename, int x, int y, int comp, const void *data)
  392. {
  393. stbi__write_context s = { 0 };
  394. if (stbi__start_write_file(&s,filename)) {
  395. int r = stbi_write_bmp_core(&s, x, y, comp, data);
  396. stbi__end_write_file(&s);
  397. return r;
  398. } else
  399. return 0;
  400. }
  401. #endif //!STBI_WRITE_NO_STDIO
  402. static int stbi_write_tga_core(stbi__write_context *s, int x, int y, int comp, void *data)
  403. {
  404. int has_alpha = (comp == 2 || comp == 4);
  405. int colorbytes = has_alpha ? comp-1 : comp;
  406. int format = colorbytes < 2 ? 3 : 2; // 3 color channels (RGB/RGBA) = 2, 1 color channel (Y/YA) = 3
  407. if (y < 0 || x < 0)
  408. return 0;
  409. if (!stbi_write_tga_with_rle) {
  410. return stbiw__outfile(s, -1, -1, x, y, comp, 0, (void *) data, has_alpha, 0,
  411. "111 221 2222 11", 0, 0, format, 0, 0, 0, 0, 0, x, y, (colorbytes + has_alpha) * 8, has_alpha * 8);
  412. } else {
  413. int i,j,k;
  414. int jend, jdir;
  415. 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);
  416. if (stbi__flip_vertically_on_write) {
  417. j = 0;
  418. jend = y;
  419. jdir = 1;
  420. } else {
  421. j = y-1;
  422. jend = -1;
  423. jdir = -1;
  424. }
  425. for (; j != jend; j += jdir) {
  426. unsigned char *row = (unsigned char *) data + j * x * comp;
  427. int len;
  428. for (i = 0; i < x; i += len) {
  429. unsigned char *begin = row + i * comp;
  430. int diff = 1;
  431. len = 1;
  432. if (i < x - 1) {
  433. ++len;
  434. diff = memcmp(begin, row + (i + 1) * comp, comp);
  435. if (diff) {
  436. const unsigned char *prev = begin;
  437. for (k = i + 2; k < x && len < 128; ++k) {
  438. if (memcmp(prev, row + k * comp, comp)) {
  439. prev += comp;
  440. ++len;
  441. } else {
  442. --len;
  443. break;
  444. }
  445. }
  446. } else {
  447. for (k = i + 2; k < x && len < 128; ++k) {
  448. if (!memcmp(begin, row + k * comp, comp)) {
  449. ++len;
  450. } else {
  451. break;
  452. }
  453. }
  454. }
  455. }
  456. if (diff) {
  457. unsigned char header = STBIW_UCHAR(len - 1);
  458. stbiw__write1(s, header);
  459. for (k = 0; k < len; ++k) {
  460. stbiw__write_pixel(s, -1, comp, has_alpha, 0, begin + k * comp);
  461. }
  462. } else {
  463. unsigned char header = STBIW_UCHAR(len - 129);
  464. stbiw__write1(s, header);
  465. stbiw__write_pixel(s, -1, comp, has_alpha, 0, begin);
  466. }
  467. }
  468. }
  469. stbiw__write_flush(s);
  470. }
  471. return 1;
  472. }
  473. STBIWDEF int stbi_write_tga_to_func(stbi_write_func *func, void *context, int x, int y, int comp, const void *data)
  474. {
  475. stbi__write_context s = { 0 };
  476. stbi__start_write_callbacks(&s, func, context);
  477. return stbi_write_tga_core(&s, x, y, comp, (void *) data);
  478. }
  479. #ifndef STBI_WRITE_NO_STDIO
  480. STBIWDEF int stbi_write_tga(char const *filename, int x, int y, int comp, const void *data)
  481. {
  482. stbi__write_context s = { 0 };
  483. if (stbi__start_write_file(&s,filename)) {
  484. int r = stbi_write_tga_core(&s, x, y, comp, (void *) data);
  485. stbi__end_write_file(&s);
  486. return r;
  487. } else
  488. return 0;
  489. }
  490. #endif
  491. // *************************************************************************************************
  492. // Radiance RGBE HDR writer
  493. // by Baldur Karlsson
  494. #define stbiw__max(a, b) ((a) > (b) ? (a) : (b))
  495. #ifndef STBI_WRITE_NO_STDIO
  496. static void stbiw__linear_to_rgbe(unsigned char *rgbe, float *linear)
  497. {
  498. int exponent;
  499. float maxcomp = stbiw__max(linear[0], stbiw__max(linear[1], linear[2]));
  500. if (maxcomp < 1e-32f) {
  501. rgbe[0] = rgbe[1] = rgbe[2] = rgbe[3] = 0;
  502. } else {
  503. float normalize = (float) frexp(maxcomp, &exponent) * 256.0f/maxcomp;
  504. rgbe[0] = (unsigned char)(linear[0] * normalize);
  505. rgbe[1] = (unsigned char)(linear[1] * normalize);
  506. rgbe[2] = (unsigned char)(linear[2] * normalize);
  507. rgbe[3] = (unsigned char)(exponent + 128);
  508. }
  509. }
  510. static void stbiw__write_run_data(stbi__write_context *s, int length, unsigned char databyte)
  511. {
  512. unsigned char lengthbyte = STBIW_UCHAR(length+128);
  513. STBIW_ASSERT(length+128 <= 255);
  514. s->func(s->context, &lengthbyte, 1);
  515. s->func(s->context, &databyte, 1);
  516. }
  517. static void stbiw__write_dump_data(stbi__write_context *s, int length, unsigned char *data)
  518. {
  519. unsigned char lengthbyte = STBIW_UCHAR(length);
  520. STBIW_ASSERT(length <= 128); // inconsistent with spec but consistent with official code
  521. s->func(s->context, &lengthbyte, 1);
  522. s->func(s->context, data, length);
  523. }
  524. static void stbiw__write_hdr_scanline(stbi__write_context *s, int width, int ncomp, unsigned char *scratch, float *scanline)
  525. {
  526. unsigned char scanlineheader[4] = { 2, 2, 0, 0 };
  527. unsigned char rgbe[4];
  528. float linear[3];
  529. int x;
  530. scanlineheader[2] = (width&0xff00)>>8;
  531. scanlineheader[3] = (width&0x00ff);
  532. /* skip RLE for images too small or large */
  533. if (width < 8 || width >= 32768) {
  534. for (x=0; x < width; x++) {
  535. switch (ncomp) {
  536. case 4: /* fallthrough */
  537. case 3: linear[2] = scanline[x*ncomp + 2];
  538. linear[1] = scanline[x*ncomp + 1];
  539. linear[0] = scanline[x*ncomp + 0];
  540. break;
  541. default:
  542. linear[0] = linear[1] = linear[2] = scanline[x*ncomp + 0];
  543. break;
  544. }
  545. stbiw__linear_to_rgbe(rgbe, linear);
  546. s->func(s->context, rgbe, 4);
  547. }
  548. } else {
  549. int c,r;
  550. /* encode into scratch buffer */
  551. for (x=0; x < width; x++) {
  552. switch(ncomp) {
  553. case 4: /* fallthrough */
  554. case 3: linear[2] = scanline[x*ncomp + 2];
  555. linear[1] = scanline[x*ncomp + 1];
  556. linear[0] = scanline[x*ncomp + 0];
  557. break;
  558. default:
  559. linear[0] = linear[1] = linear[2] = scanline[x*ncomp + 0];
  560. break;
  561. }
  562. stbiw__linear_to_rgbe(rgbe, linear);
  563. scratch[x + width*0] = rgbe[0];
  564. scratch[x + width*1] = rgbe[1];
  565. scratch[x + width*2] = rgbe[2];
  566. scratch[x + width*3] = rgbe[3];
  567. }
  568. s->func(s->context, scanlineheader, 4);
  569. /* RLE each component separately */
  570. for (c=0; c < 4; c++) {
  571. unsigned char *comp = &scratch[width*c];
  572. x = 0;
  573. while (x < width) {
  574. // find first run
  575. r = x;
  576. while (r+2 < width) {
  577. if (comp[r] == comp[r+1] && comp[r] == comp[r+2])
  578. break;
  579. ++r;
  580. }
  581. if (r+2 >= width)
  582. r = width;
  583. // dump up to first run
  584. while (x < r) {
  585. int len = r-x;
  586. if (len > 128) len = 128;
  587. stbiw__write_dump_data(s, len, &comp[x]);
  588. x += len;
  589. }
  590. // if there's a run, output it
  591. if (r+2 < width) { // same test as what we break out of in search loop, so only true if we break'd
  592. // find next byte after run
  593. while (r < width && comp[r] == comp[x])
  594. ++r;
  595. // output run up to r
  596. while (x < r) {
  597. int len = r-x;
  598. if (len > 127) len = 127;
  599. stbiw__write_run_data(s, len, comp[x]);
  600. x += len;
  601. }
  602. }
  603. }
  604. }
  605. }
  606. }
  607. static int stbi_write_hdr_core(stbi__write_context *s, int x, int y, int comp, float *data)
  608. {
  609. if (y <= 0 || x <= 0 || data == NULL)
  610. return 0;
  611. else {
  612. // Each component is stored separately. Allocate scratch space for full output scanline.
  613. unsigned char *scratch = (unsigned char *) STBIW_MALLOC(x*4);
  614. int i, len;
  615. char buffer[128];
  616. char header[] = "#?RADIANCE\n# Written by stb_image_write.h\nFORMAT=32-bit_rle_rgbe\n";
  617. s->func(s->context, header, sizeof(header)-1);
  618. #ifdef __STDC_LIB_EXT1__
  619. len = sprintf_s(buffer, sizeof(buffer), "EXPOSURE= 1.0000000000000\n\n-Y %d +X %d\n", y, x);
  620. #else
  621. len = sprintf(buffer, "EXPOSURE= 1.0000000000000\n\n-Y %d +X %d\n", y, x);
  622. #endif
  623. s->func(s->context, buffer, len);
  624. for(i=0; i < y; i++)
  625. stbiw__write_hdr_scanline(s, x, comp, scratch, data + comp*x*(stbi__flip_vertically_on_write ? y-1-i : i));
  626. STBIW_FREE(scratch);
  627. return 1;
  628. }
  629. }
  630. STBIWDEF int stbi_write_hdr_to_func(stbi_write_func *func, void *context, int x, int y, int comp, const float *data)
  631. {
  632. stbi__write_context s = { 0 };
  633. stbi__start_write_callbacks(&s, func, context);
  634. return stbi_write_hdr_core(&s, x, y, comp, (float *) data);
  635. }
  636. STBIWDEF int stbi_write_hdr(char const *filename, int x, int y, int comp, const float *data)
  637. {
  638. stbi__write_context s = { 0 };
  639. if (stbi__start_write_file(&s,filename)) {
  640. int r = stbi_write_hdr_core(&s, x, y, comp, (float *) data);
  641. stbi__end_write_file(&s);
  642. return r;
  643. } else
  644. return 0;
  645. }
  646. #endif // STBI_WRITE_NO_STDIO
  647. //////////////////////////////////////////////////////////////////////////////
  648. //
  649. // PNG writer
  650. //
  651. #ifndef STBIW_ZLIB_COMPRESS
  652. // stretchy buffer; stbiw__sbpush() == vector<>::push_back() -- stbiw__sbcount() == vector<>::size()
  653. #define stbiw__sbraw(a) ((int *) (void *) (a) - 2)
  654. #define stbiw__sbm(a) stbiw__sbraw(a)[0]
  655. #define stbiw__sbn(a) stbiw__sbraw(a)[1]
  656. #define stbiw__sbneedgrow(a,n) ((a)==0 || stbiw__sbn(a)+n >= stbiw__sbm(a))
  657. #define stbiw__sbmaybegrow(a,n) (stbiw__sbneedgrow(a,(n)) ? stbiw__sbgrow(a,n) : 0)
  658. #define stbiw__sbgrow(a,n) stbiw__sbgrowf((void **) &(a), (n), sizeof(*(a)))
  659. #define stbiw__sbpush(a, v) (stbiw__sbmaybegrow(a,1), (a)[stbiw__sbn(a)++] = (v))
  660. #define stbiw__sbcount(a) ((a) ? stbiw__sbn(a) : 0)
  661. #define stbiw__sbfree(a) ((a) ? STBIW_FREE(stbiw__sbraw(a)),0 : 0)
  662. static void *stbiw__sbgrowf(void **arr, int increment, int itemsize)
  663. {
  664. int m = *arr ? 2*stbiw__sbm(*arr)+increment : increment+1;
  665. void *p = STBIW_REALLOC_SIZED(*arr ? stbiw__sbraw(*arr) : 0, *arr ? (stbiw__sbm(*arr)*itemsize + sizeof(int)*2) : 0, itemsize * m + sizeof(int)*2);
  666. STBIW_ASSERT(p);
  667. if (p) {
  668. if (!*arr) ((int *) p)[1] = 0;
  669. *arr = (void *) ((int *) p + 2);
  670. stbiw__sbm(*arr) = m;
  671. }
  672. return *arr;
  673. }
  674. static unsigned char *stbiw__zlib_flushf(unsigned char *data, unsigned int *bitbuffer, int *bitcount)
  675. {
  676. while (*bitcount >= 8) {
  677. stbiw__sbpush(data, STBIW_UCHAR(*bitbuffer));
  678. *bitbuffer >>= 8;
  679. *bitcount -= 8;
  680. }
  681. return data;
  682. }
  683. static int stbiw__zlib_bitrev(int code, int codebits)
  684. {
  685. int res=0;
  686. while (codebits--) {
  687. res = (res << 1) | (code & 1);
  688. code >>= 1;
  689. }
  690. return res;
  691. }
  692. static unsigned int stbiw__zlib_countm(unsigned char *a, unsigned char *b, int limit)
  693. {
  694. int i;
  695. for (i=0; i < limit && i < 258; ++i)
  696. if (a[i] != b[i]) break;
  697. return i;
  698. }
  699. static unsigned int stbiw__zhash(unsigned char *data)
  700. {
  701. stbiw_uint32 hash = data[0] + (data[1] << 8) + (data[2] << 16);
  702. hash ^= hash << 3;
  703. hash += hash >> 5;
  704. hash ^= hash << 4;
  705. hash += hash >> 17;
  706. hash ^= hash << 25;
  707. hash += hash >> 6;
  708. return hash;
  709. }
  710. #define stbiw__zlib_flush() (out = stbiw__zlib_flushf(out, &bitbuf, &bitcount))
  711. #define stbiw__zlib_add(code,codebits) \
  712. (bitbuf |= (code) << bitcount, bitcount += (codebits), stbiw__zlib_flush())
  713. #define stbiw__zlib_huffa(b,c) stbiw__zlib_add(stbiw__zlib_bitrev(b,c),c)
  714. // default huffman tables
  715. #define stbiw__zlib_huff1(n) stbiw__zlib_huffa(0x30 + (n), 8)
  716. #define stbiw__zlib_huff2(n) stbiw__zlib_huffa(0x190 + (n)-144, 9)
  717. #define stbiw__zlib_huff3(n) stbiw__zlib_huffa(0 + (n)-256,7)
  718. #define stbiw__zlib_huff4(n) stbiw__zlib_huffa(0xc0 + (n)-280,8)
  719. #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))
  720. #define stbiw__zlib_huffb(n) ((n) <= 143 ? stbiw__zlib_huff1(n) : stbiw__zlib_huff2(n))
  721. #define stbiw__ZHASH 16384
  722. #endif // STBIW_ZLIB_COMPRESS
  723. STBIWDEF unsigned char * stbi_zlib_compress(unsigned char *data, int data_len, int *out_len, int quality)
  724. {
  725. #ifdef STBIW_ZLIB_COMPRESS
  726. // user provided a zlib compress implementation, use that
  727. return STBIW_ZLIB_COMPRESS(data, data_len, out_len, quality);
  728. #else // use builtin
  729. 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 };
  730. 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 };
  731. 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 };
  732. 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 };
  733. unsigned int bitbuf=0;
  734. int i,j, bitcount=0;
  735. unsigned char *out = NULL;
  736. unsigned char ***hash_table = (unsigned char***) STBIW_MALLOC(stbiw__ZHASH * sizeof(unsigned char**));
  737. if (hash_table == NULL)
  738. return NULL;
  739. if (quality < 5) quality = 5;
  740. stbiw__sbpush(out, 0x78); // DEFLATE 32K window
  741. stbiw__sbpush(out, 0x5e); // FLEVEL = 1
  742. stbiw__zlib_add(1,1); // BFINAL = 1
  743. stbiw__zlib_add(1,2); // BTYPE = 1 -- fixed huffman
  744. for (i=0; i < stbiw__ZHASH; ++i)
  745. hash_table[i] = NULL;
  746. i=0;
  747. while (i < data_len-3) {
  748. // hash next 3 bytes of data to be compressed
  749. int h = stbiw__zhash(data+i)&(stbiw__ZHASH-1), best=3;
  750. unsigned char *bestloc = 0;
  751. unsigned char **hlist = hash_table[h];
  752. int n = stbiw__sbcount(hlist);
  753. for (j=0; j < n; ++j) {
  754. if (hlist[j]-data > i-32768) { // if entry lies within window
  755. int d = stbiw__zlib_countm(hlist[j], data+i, data_len-i);
  756. if (d >= best) { best=d; bestloc=hlist[j]; }
  757. }
  758. }
  759. // when hash table entry is too long, delete half the entries
  760. if (hash_table[h] && stbiw__sbn(hash_table[h]) == 2*quality) {
  761. STBIW_MEMMOVE(hash_table[h], hash_table[h]+quality, sizeof(hash_table[h][0])*quality);
  762. stbiw__sbn(hash_table[h]) = quality;
  763. }
  764. stbiw__sbpush(hash_table[h],data+i);
  765. if (bestloc) {
  766. // "lazy matching" - check match at *next* byte, and if it's better, do cur byte as literal
  767. h = stbiw__zhash(data+i+1)&(stbiw__ZHASH-1);
  768. hlist = hash_table[h];
  769. n = stbiw__sbcount(hlist);
  770. for (j=0; j < n; ++j) {
  771. if (hlist[j]-data > i-32767) {
  772. int e = stbiw__zlib_countm(hlist[j], data+i+1, data_len-i-1);
  773. if (e > best) { // if next match is better, bail on current match
  774. bestloc = NULL;
  775. break;
  776. }
  777. }
  778. }
  779. }
  780. if (bestloc) {
  781. int d = (int) (data+i - bestloc); // distance back
  782. STBIW_ASSERT(d <= 32767 && best <= 258);
  783. for (j=0; best > lengthc[j+1]-1; ++j);
  784. stbiw__zlib_huff(j+257);
  785. if (lengtheb[j]) stbiw__zlib_add(best - lengthc[j], lengtheb[j]);
  786. for (j=0; d > distc[j+1]-1; ++j);
  787. stbiw__zlib_add(stbiw__zlib_bitrev(j,5),5);
  788. if (disteb[j]) stbiw__zlib_add(d - distc[j], disteb[j]);
  789. i += best;
  790. } else {
  791. stbiw__zlib_huffb(data[i]);
  792. ++i;
  793. }
  794. }
  795. // write out final bytes
  796. for (;i < data_len; ++i)
  797. stbiw__zlib_huffb(data[i]);
  798. stbiw__zlib_huff(256); // end of block
  799. // pad with 0 bits to byte boundary
  800. while (bitcount)
  801. stbiw__zlib_add(0,1);
  802. for (i=0; i < stbiw__ZHASH; ++i)
  803. (void) stbiw__sbfree(hash_table[i]);
  804. STBIW_FREE(hash_table);
  805. // store uncompressed instead if compression was worse
  806. if (stbiw__sbn(out) > data_len + 2 + ((data_len+32766)/32767)*5) {
  807. stbiw__sbn(out) = 2; // truncate to DEFLATE 32K window and FLEVEL = 1
  808. for (j = 0; j < data_len;) {
  809. int blocklen = data_len - j;
  810. if (blocklen > 32767) blocklen = 32767;
  811. stbiw__sbpush(out, data_len - j == blocklen); // BFINAL = ?, BTYPE = 0 -- no compression
  812. stbiw__sbpush(out, STBIW_UCHAR(blocklen)); // LEN
  813. stbiw__sbpush(out, STBIW_UCHAR(blocklen >> 8));
  814. stbiw__sbpush(out, STBIW_UCHAR(~blocklen)); // NLEN
  815. stbiw__sbpush(out, STBIW_UCHAR(~blocklen >> 8));
  816. memcpy(out+stbiw__sbn(out), data+j, blocklen);
  817. stbiw__sbn(out) += blocklen;
  818. j += blocklen;
  819. }
  820. }
  821. {
  822. // compute adler32 on input
  823. unsigned int s1=1, s2=0;
  824. int blocklen = (int) (data_len % 5552);
  825. j=0;
  826. while (j < data_len) {
  827. for (i=0; i < blocklen; ++i) { s1 += data[j+i]; s2 += s1; }
  828. s1 %= 65521; s2 %= 65521;
  829. j += blocklen;
  830. blocklen = 5552;
  831. }
  832. stbiw__sbpush(out, STBIW_UCHAR(s2 >> 8));
  833. stbiw__sbpush(out, STBIW_UCHAR(s2));
  834. stbiw__sbpush(out, STBIW_UCHAR(s1 >> 8));
  835. stbiw__sbpush(out, STBIW_UCHAR(s1));
  836. }
  837. *out_len = stbiw__sbn(out);
  838. // make returned pointer freeable
  839. STBIW_MEMMOVE(stbiw__sbraw(out), out, *out_len);
  840. return (unsigned char *) stbiw__sbraw(out);
  841. #endif // STBIW_ZLIB_COMPRESS
  842. }
  843. static unsigned int stbiw__crc32(unsigned char *buffer, int len)
  844. {
  845. #ifdef STBIW_CRC32
  846. return STBIW_CRC32(buffer, len);
  847. #else
  848. static unsigned int crc_table[256] =
  849. {
  850. 0x00000000, 0x77073096, 0xEE0E612C, 0x990951BA, 0x076DC419, 0x706AF48F, 0xE963A535, 0x9E6495A3,
  851. 0x0eDB8832, 0x79DCB8A4, 0xE0D5E91E, 0x97D2D988, 0x09B64C2B, 0x7EB17CBD, 0xE7B82D07, 0x90BF1D91,
  852. 0x1DB71064, 0x6AB020F2, 0xF3B97148, 0x84BE41DE, 0x1ADAD47D, 0x6DDDE4EB, 0xF4D4B551, 0x83D385C7,
  853. 0x136C9856, 0x646BA8C0, 0xFD62F97A, 0x8A65C9EC, 0x14015C4F, 0x63066CD9, 0xFA0F3D63, 0x8D080DF5,
  854. 0x3B6E20C8, 0x4C69105E, 0xD56041E4, 0xA2677172, 0x3C03E4D1, 0x4B04D447, 0xD20D85FD, 0xA50AB56B,
  855. 0x35B5A8FA, 0x42B2986C, 0xDBBBC9D6, 0xACBCF940, 0x32D86CE3, 0x45DF5C75, 0xDCD60DCF, 0xABD13D59,
  856. 0x26D930AC, 0x51DE003A, 0xC8D75180, 0xBFD06116, 0x21B4F4B5, 0x56B3C423, 0xCFBA9599, 0xB8BDA50F,
  857. 0x2802B89E, 0x5F058808, 0xC60CD9B2, 0xB10BE924, 0x2F6F7C87, 0x58684C11, 0xC1611DAB, 0xB6662D3D,
  858. 0x76DC4190, 0x01DB7106, 0x98D220BC, 0xEFD5102A, 0x71B18589, 0x06B6B51F, 0x9FBFE4A5, 0xE8B8D433,
  859. 0x7807C9A2, 0x0F00F934, 0x9609A88E, 0xE10E9818, 0x7F6A0DBB, 0x086D3D2D, 0x91646C97, 0xE6635C01,
  860. 0x6B6B51F4, 0x1C6C6162, 0x856530D8, 0xF262004E, 0x6C0695ED, 0x1B01A57B, 0x8208F4C1, 0xF50FC457,
  861. 0x65B0D9C6, 0x12B7E950, 0x8BBEB8EA, 0xFCB9887C, 0x62DD1DDF, 0x15DA2D49, 0x8CD37CF3, 0xFBD44C65,
  862. 0x4DB26158, 0x3AB551CE, 0xA3BC0074, 0xD4BB30E2, 0x4ADFA541, 0x3DD895D7, 0xA4D1C46D, 0xD3D6F4FB,
  863. 0x4369E96A, 0x346ED9FC, 0xAD678846, 0xDA60B8D0, 0x44042D73, 0x33031DE5, 0xAA0A4C5F, 0xDD0D7CC9,
  864. 0x5005713C, 0x270241AA, 0xBE0B1010, 0xC90C2086, 0x5768B525, 0x206F85B3, 0xB966D409, 0xCE61E49F,
  865. 0x5EDEF90E, 0x29D9C998, 0xB0D09822, 0xC7D7A8B4, 0x59B33D17, 0x2EB40D81, 0xB7BD5C3B, 0xC0BA6CAD,
  866. 0xEDB88320, 0x9ABFB3B6, 0x03B6E20C, 0x74B1D29A, 0xEAD54739, 0x9DD277AF, 0x04DB2615, 0x73DC1683,
  867. 0xE3630B12, 0x94643B84, 0x0D6D6A3E, 0x7A6A5AA8, 0xE40ECF0B, 0x9309FF9D, 0x0A00AE27, 0x7D079EB1,
  868. 0xF00F9344, 0x8708A3D2, 0x1E01F268, 0x6906C2FE, 0xF762575D, 0x806567CB, 0x196C3671, 0x6E6B06E7,
  869. 0xFED41B76, 0x89D32BE0, 0x10DA7A5A, 0x67DD4ACC, 0xF9B9DF6F, 0x8EBEEFF9, 0x17B7BE43, 0x60B08ED5,
  870. 0xD6D6A3E8, 0xA1D1937E, 0x38D8C2C4, 0x4FDFF252, 0xD1BB67F1, 0xA6BC5767, 0x3FB506DD, 0x48B2364B,
  871. 0xD80D2BDA, 0xAF0A1B4C, 0x36034AF6, 0x41047A60, 0xDF60EFC3, 0xA867DF55, 0x316E8EEF, 0x4669BE79,
  872. 0xCB61B38C, 0xBC66831A, 0x256FD2A0, 0x5268E236, 0xCC0C7795, 0xBB0B4703, 0x220216B9, 0x5505262F,
  873. 0xC5BA3BBE, 0xB2BD0B28, 0x2BB45A92, 0x5CB36A04, 0xC2D7FFA7, 0xB5D0CF31, 0x2CD99E8B, 0x5BDEAE1D,
  874. 0x9B64C2B0, 0xEC63F226, 0x756AA39C, 0x026D930A, 0x9C0906A9, 0xEB0E363F, 0x72076785, 0x05005713,
  875. 0x95BF4A82, 0xE2B87A14, 0x7BB12BAE, 0x0CB61B38, 0x92D28E9B, 0xE5D5BE0D, 0x7CDCEFB7, 0x0BDBDF21,
  876. 0x86D3D2D4, 0xF1D4E242, 0x68DDB3F8, 0x1FDA836E, 0x81BE16CD, 0xF6B9265B, 0x6FB077E1, 0x18B74777,
  877. 0x88085AE6, 0xFF0F6A70, 0x66063BCA, 0x11010B5C, 0x8F659EFF, 0xF862AE69, 0x616BFFD3, 0x166CCF45,
  878. 0xA00AE278, 0xD70DD2EE, 0x4E048354, 0x3903B3C2, 0xA7672661, 0xD06016F7, 0x4969474D, 0x3E6E77DB,
  879. 0xAED16A4A, 0xD9D65ADC, 0x40DF0B66, 0x37D83BF0, 0xA9BCAE53, 0xDEBB9EC5, 0x47B2CF7F, 0x30B5FFE9,
  880. 0xBDBDF21C, 0xCABAC28A, 0x53B39330, 0x24B4A3A6, 0xBAD03605, 0xCDD70693, 0x54DE5729, 0x23D967BF,
  881. 0xB3667A2E, 0xC4614AB8, 0x5D681B02, 0x2A6F2B94, 0xB40BBE37, 0xC30C8EA1, 0x5A05DF1B, 0x2D02EF8D
  882. };
  883. unsigned int crc = ~0u;
  884. int i;
  885. for (i=0; i < len; ++i)
  886. crc = (crc >> 8) ^ crc_table[buffer[i] ^ (crc & 0xff)];
  887. return ~crc;
  888. #endif
  889. }
  890. #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)
  891. #define stbiw__wp32(data,v) stbiw__wpng4(data, (v)>>24,(v)>>16,(v)>>8,(v));
  892. #define stbiw__wptag(data,s) stbiw__wpng4(data, s[0],s[1],s[2],s[3])
  893. static void stbiw__wpcrc(unsigned char **data, int len)
  894. {
  895. unsigned int crc = stbiw__crc32(*data - len - 4, len+4);
  896. stbiw__wp32(*data, crc);
  897. }
  898. static unsigned char stbiw__paeth(int a, int b, int c)
  899. {
  900. int p = a + b - c, pa = abs(p-a), pb = abs(p-b), pc = abs(p-c);
  901. if (pa <= pb && pa <= pc) return STBIW_UCHAR(a);
  902. if (pb <= pc) return STBIW_UCHAR(b);
  903. return STBIW_UCHAR(c);
  904. }
  905. // @OPTIMIZE: provide an option that always forces left-predict or paeth predict
  906. static void stbiw__encode_png_line(unsigned char *pixels, int stride_bytes, int width, int height, int y, int n, int filter_type, signed char *line_buffer)
  907. {
  908. static int mapping[] = { 0,1,2,3,4 };
  909. static int firstmap[] = { 0,1,0,5,6 };
  910. int *mymap = (y != 0) ? mapping : firstmap;
  911. int i;
  912. int type = mymap[filter_type];
  913. unsigned char *z = pixels + stride_bytes * (stbi__flip_vertically_on_write ? height-1-y : y);
  914. int signed_stride = stbi__flip_vertically_on_write ? -stride_bytes : stride_bytes;
  915. if (type==0) {
  916. memcpy(line_buffer, z, width*n);
  917. return;
  918. }
  919. // first loop isn't optimized since it's just one pixel
  920. for (i = 0; i < n; ++i) {
  921. switch (type) {
  922. case 1: line_buffer[i] = z[i]; break;
  923. case 2: line_buffer[i] = z[i] - z[i-signed_stride]; break;
  924. case 3: line_buffer[i] = z[i] - (z[i-signed_stride]>>1); break;
  925. case 4: line_buffer[i] = (signed char) (z[i] - stbiw__paeth(0,z[i-signed_stride],0)); break;
  926. case 5: line_buffer[i] = z[i]; break;
  927. case 6: line_buffer[i] = z[i]; break;
  928. }
  929. }
  930. switch (type) {
  931. case 1: for (i=n; i < width*n; ++i) line_buffer[i] = z[i] - z[i-n]; break;
  932. case 2: for (i=n; i < width*n; ++i) line_buffer[i] = z[i] - z[i-signed_stride]; break;
  933. case 3: for (i=n; i < width*n; ++i) line_buffer[i] = z[i] - ((z[i-n] + z[i-signed_stride])>>1); break;
  934. case 4: for (i=n; i < width*n; ++i) line_buffer[i] = z[i] - stbiw__paeth(z[i-n], z[i-signed_stride], z[i-signed_stride-n]); break;
  935. case 5: for (i=n; i < width*n; ++i) line_buffer[i] = z[i] - (z[i-n]>>1); break;
  936. case 6: for (i=n; i < width*n; ++i) line_buffer[i] = z[i] - stbiw__paeth(z[i-n], 0,0); break;
  937. }
  938. }
  939. STBIWDEF unsigned char *stbi_write_png_to_mem(const unsigned char *pixels, int stride_bytes, int x, int y, int n, int *out_len)
  940. {
  941. int force_filter = stbi_write_force_png_filter;
  942. int ctype[5] = { -1, 0, 4, 2, 6 };
  943. unsigned char sig[8] = { 137,80,78,71,13,10,26,10 };
  944. unsigned char *out,*o, *filt, *zlib;
  945. signed char *line_buffer;
  946. int j,zlen;
  947. if (stride_bytes == 0)
  948. stride_bytes = x * n;
  949. if (force_filter >= 5) {
  950. force_filter = -1;
  951. }
  952. filt = (unsigned char *) STBIW_MALLOC((x*n+1) * y); if (!filt) return 0;
  953. line_buffer = (signed char *) STBIW_MALLOC(x * n); if (!line_buffer) { STBIW_FREE(filt); return 0; }
  954. for (j=0; j < y; ++j) {
  955. int filter_type;
  956. if (force_filter > -1) {
  957. filter_type = force_filter;
  958. stbiw__encode_png_line((unsigned char*)(pixels), stride_bytes, x, y, j, n, force_filter, line_buffer);
  959. } else { // Estimate the best filter by running through all of them:
  960. int best_filter = 0, best_filter_val = 0x7fffffff, est, i;
  961. for (filter_type = 0; filter_type < 5; filter_type++) {
  962. stbiw__encode_png_line((unsigned char*)(pixels), stride_bytes, x, y, j, n, filter_type, line_buffer);
  963. // Estimate the entropy of the line using this filter; the less, the better.
  964. est = 0;
  965. for (i = 0; i < x*n; ++i) {
  966. est += abs((signed char) line_buffer[i]);
  967. }
  968. if (est < best_filter_val) {
  969. best_filter_val = est;
  970. best_filter = filter_type;
  971. }
  972. }
  973. if (filter_type != best_filter) { // If the last iteration already got us the best filter, don't redo it
  974. stbiw__encode_png_line((unsigned char*)(pixels), stride_bytes, x, y, j, n, best_filter, line_buffer);
  975. filter_type = best_filter;
  976. }
  977. }
  978. // when we get here, filter_type contains the filter type, and line_buffer contains the data
  979. filt[j*(x*n+1)] = (unsigned char) filter_type;
  980. STBIW_MEMMOVE(filt+j*(x*n+1)+1, line_buffer, x*n);
  981. }
  982. STBIW_FREE(line_buffer);
  983. zlib = stbi_zlib_compress(filt, y*( x*n+1), &zlen, stbi_write_png_compression_level);
  984. STBIW_FREE(filt);
  985. if (!zlib) return 0;
  986. // each tag requires 12 bytes of overhead
  987. out = (unsigned char *) STBIW_MALLOC(8 + 12+13 + 12+zlen + 12);
  988. if (!out) return 0;
  989. *out_len = 8 + 12+13 + 12+zlen + 12;
  990. o=out;
  991. STBIW_MEMMOVE(o,sig,8); o+= 8;
  992. stbiw__wp32(o, 13); // header length
  993. stbiw__wptag(o, "IHDR");
  994. stbiw__wp32(o, x);
  995. stbiw__wp32(o, y);
  996. *o++ = 8;
  997. *o++ = STBIW_UCHAR(ctype[n]);
  998. *o++ = 0;
  999. *o++ = 0;
  1000. *o++ = 0;
  1001. stbiw__wpcrc(&o,13);
  1002. stbiw__wp32(o, zlen);
  1003. stbiw__wptag(o, "IDAT");
  1004. STBIW_MEMMOVE(o, zlib, zlen);
  1005. o += zlen;
  1006. STBIW_FREE(zlib);
  1007. stbiw__wpcrc(&o, zlen);
  1008. stbiw__wp32(o,0);
  1009. stbiw__wptag(o, "IEND");
  1010. stbiw__wpcrc(&o,0);
  1011. STBIW_ASSERT(o == out + *out_len);
  1012. return out;
  1013. }
  1014. #ifndef STBI_WRITE_NO_STDIO
  1015. STBIWDEF int stbi_write_png(char const *filename, int x, int y, int comp, const void *data, int stride_bytes)
  1016. {
  1017. FILE *f;
  1018. int len;
  1019. unsigned char *png = stbi_write_png_to_mem((const unsigned char *) data, stride_bytes, x, y, comp, &len);
  1020. if (png == NULL) return 0;
  1021. f = stbiw__fopen(filename, "wb");
  1022. if (!f) { STBIW_FREE(png); return 0; }
  1023. fwrite(png, 1, len, f);
  1024. fclose(f);
  1025. STBIW_FREE(png);
  1026. return 1;
  1027. }
  1028. #endif
  1029. 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)
  1030. {
  1031. int len;
  1032. unsigned char *png = stbi_write_png_to_mem((const unsigned char *) data, stride_bytes, x, y, comp, &len);
  1033. if (png == NULL) return 0;
  1034. func(context, png, len);
  1035. STBIW_FREE(png);
  1036. return 1;
  1037. }
  1038. /* ***************************************************************************
  1039. *
  1040. * JPEG writer
  1041. *
  1042. * This is based on Jon Olick's jo_jpeg.cpp:
  1043. * public domain Simple, Minimalistic JPEG writer - http://www.jonolick.com/code.html
  1044. */
  1045. static const unsigned char stbiw__jpg_ZigZag[] = { 0,1,5,6,14,15,27,28,2,4,7,13,16,26,29,42,3,8,12,17,25,30,41,43,9,11,18,
  1046. 24,31,40,44,53,10,19,23,32,39,45,52,54,20,22,33,38,46,51,55,60,21,34,37,47,50,56,59,61,35,36,48,49,57,58,62,63 };
  1047. static void stbiw__jpg_writeBits(stbi__write_context *s, int *bitBufP, int *bitCntP, const unsigned short *bs) {
  1048. int bitBuf = *bitBufP, bitCnt = *bitCntP;
  1049. bitCnt += bs[1];
  1050. bitBuf |= bs[0] << (24 - bitCnt);
  1051. while(bitCnt >= 8) {
  1052. unsigned char c = (bitBuf >> 16) & 255;
  1053. stbiw__putc(s, c);
  1054. if(c == 255) {
  1055. stbiw__putc(s, 0);
  1056. }
  1057. bitBuf <<= 8;
  1058. bitCnt -= 8;
  1059. }
  1060. *bitBufP = bitBuf;
  1061. *bitCntP = bitCnt;
  1062. }
  1063. static void stbiw__jpg_DCT(float *d0p, float *d1p, float *d2p, float *d3p, float *d4p, float *d5p, float *d6p, float *d7p) {
  1064. float d0 = *d0p, d1 = *d1p, d2 = *d2p, d3 = *d3p, d4 = *d4p, d5 = *d5p, d6 = *d6p, d7 = *d7p;
  1065. float z1, z2, z3, z4, z5, z11, z13;
  1066. float tmp0 = d0 + d7;
  1067. float tmp7 = d0 - d7;
  1068. float tmp1 = d1 + d6;
  1069. float tmp6 = d1 - d6;
  1070. float tmp2 = d2 + d5;
  1071. float tmp5 = d2 - d5;
  1072. float tmp3 = d3 + d4;
  1073. float tmp4 = d3 - d4;
  1074. // Even part
  1075. float tmp10 = tmp0 + tmp3; // phase 2
  1076. float tmp13 = tmp0 - tmp3;
  1077. float tmp11 = tmp1 + tmp2;
  1078. float tmp12 = tmp1 - tmp2;
  1079. d0 = tmp10 + tmp11; // phase 3
  1080. d4 = tmp10 - tmp11;
  1081. z1 = (tmp12 + tmp13) * 0.707106781f; // c4
  1082. d2 = tmp13 + z1; // phase 5
  1083. d6 = tmp13 - z1;
  1084. // Odd part
  1085. tmp10 = tmp4 + tmp5; // phase 2
  1086. tmp11 = tmp5 + tmp6;
  1087. tmp12 = tmp6 + tmp7;
  1088. // The rotator is modified from fig 4-8 to avoid extra negations.
  1089. z5 = (tmp10 - tmp12) * 0.382683433f; // c6
  1090. z2 = tmp10 * 0.541196100f + z5; // c2-c6
  1091. z4 = tmp12 * 1.306562965f + z5; // c2+c6
  1092. z3 = tmp11 * 0.707106781f; // c4
  1093. z11 = tmp7 + z3; // phase 5
  1094. z13 = tmp7 - z3;
  1095. *d5p = z13 + z2; // phase 6
  1096. *d3p = z13 - z2;
  1097. *d1p = z11 + z4;
  1098. *d7p = z11 - z4;
  1099. *d0p = d0; *d2p = d2; *d4p = d4; *d6p = d6;
  1100. }
  1101. static void stbiw__jpg_calcBits(int val, unsigned short bits[2]) {
  1102. int tmp1 = val < 0 ? -val : val;
  1103. val = val < 0 ? val-1 : val;
  1104. bits[1] = 1;
  1105. while(tmp1 >>= 1) {
  1106. ++bits[1];
  1107. }
  1108. bits[0] = val & ((1<<bits[1])-1);
  1109. }
  1110. static int stbiw__jpg_processDU(stbi__write_context *s, int *bitBuf, int *bitCnt, float *CDU, int du_stride, float *fdtbl, int DC, const unsigned short HTDC[256][2], const unsigned short HTAC[256][2]) {
  1111. const unsigned short EOB[2] = { HTAC[0x00][0], HTAC[0x00][1] };
  1112. const unsigned short M16zeroes[2] = { HTAC[0xF0][0], HTAC[0xF0][1] };
  1113. int dataOff, i, j, n, diff, end0pos, x, y;
  1114. int DU[64];
  1115. // DCT rows
  1116. for(dataOff=0, n=du_stride*8; dataOff<n; dataOff+=du_stride) {
  1117. stbiw__jpg_DCT(&CDU[dataOff], &CDU[dataOff+1], &CDU[dataOff+2], &CDU[dataOff+3], &CDU[dataOff+4], &CDU[dataOff+5], &CDU[dataOff+6], &CDU[dataOff+7]);
  1118. }
  1119. // DCT columns
  1120. for(dataOff=0; dataOff<8; ++dataOff) {
  1121. stbiw__jpg_DCT(&CDU[dataOff], &CDU[dataOff+du_stride], &CDU[dataOff+du_stride*2], &CDU[dataOff+du_stride*3], &CDU[dataOff+du_stride*4],
  1122. &CDU[dataOff+du_stride*5], &CDU[dataOff+du_stride*6], &CDU[dataOff+du_stride*7]);
  1123. }
  1124. // Quantize/descale/zigzag the coefficients
  1125. for(y = 0, j=0; y < 8; ++y) {
  1126. for(x = 0; x < 8; ++x,++j) {
  1127. float v;
  1128. i = y*du_stride+x;
  1129. v = CDU[i]*fdtbl[j];
  1130. // DU[stbiw__jpg_ZigZag[j]] = (int)(v < 0 ? ceilf(v - 0.5f) : floorf(v + 0.5f));
  1131. // ceilf() and floorf() are C99, not C89, but I /think/ they're not needed here anyway?
  1132. DU[stbiw__jpg_ZigZag[j]] = (int)(v < 0 ? v - 0.5f : v + 0.5f);
  1133. }
  1134. }
  1135. // Encode DC
  1136. diff = DU[0] - DC;
  1137. if (diff == 0) {
  1138. stbiw__jpg_writeBits(s, bitBuf, bitCnt, HTDC[0]);
  1139. } else {
  1140. unsigned short bits[2];
  1141. stbiw__jpg_calcBits(diff, bits);
  1142. stbiw__jpg_writeBits(s, bitBuf, bitCnt, HTDC[bits[1]]);
  1143. stbiw__jpg_writeBits(s, bitBuf, bitCnt, bits);
  1144. }
  1145. // Encode ACs
  1146. end0pos = 63;
  1147. for(; (end0pos>0)&&(DU[end0pos]==0); --end0pos) {
  1148. }
  1149. // end0pos = first element in reverse order !=0
  1150. if(end0pos == 0) {
  1151. stbiw__jpg_writeBits(s, bitBuf, bitCnt, EOB);
  1152. return DU[0];
  1153. }
  1154. for(i = 1; i <= end0pos; ++i) {
  1155. int startpos = i;
  1156. int nrzeroes;
  1157. unsigned short bits[2];
  1158. for (; DU[i]==0 && i<=end0pos; ++i) {
  1159. }
  1160. nrzeroes = i-startpos;
  1161. if ( nrzeroes >= 16 ) {
  1162. int lng = nrzeroes>>4;
  1163. int nrmarker;
  1164. for (nrmarker=1; nrmarker <= lng; ++nrmarker)
  1165. stbiw__jpg_writeBits(s, bitBuf, bitCnt, M16zeroes);
  1166. nrzeroes &= 15;
  1167. }
  1168. stbiw__jpg_calcBits(DU[i], bits);
  1169. stbiw__jpg_writeBits(s, bitBuf, bitCnt, HTAC[(nrzeroes<<4)+bits[1]]);
  1170. stbiw__jpg_writeBits(s, bitBuf, bitCnt, bits);
  1171. }
  1172. if(end0pos != 63) {
  1173. stbiw__jpg_writeBits(s, bitBuf, bitCnt, EOB);
  1174. }
  1175. return DU[0];
  1176. }
  1177. static int stbi_write_jpg_core(stbi__write_context *s, int width, int height, int comp, const void* data, int quality) {
  1178. // Constants that don't pollute global namespace
  1179. static const unsigned char std_dc_luminance_nrcodes[] = {0,0,1,5,1,1,1,1,1,1,0,0,0,0,0,0,0};
  1180. static const unsigned char std_dc_luminance_values[] = {0,1,2,3,4,5,6,7,8,9,10,11};
  1181. static const unsigned char std_ac_luminance_nrcodes[] = {0,0,2,1,3,3,2,4,3,5,5,4,4,0,0,1,0x7d};
  1182. static const unsigned char std_ac_luminance_values[] = {
  1183. 0x01,0x02,0x03,0x00,0x04,0x11,0x05,0x12,0x21,0x31,0x41,0x06,0x13,0x51,0x61,0x07,0x22,0x71,0x14,0x32,0x81,0x91,0xa1,0x08,
  1184. 0x23,0x42,0xb1,0xc1,0x15,0x52,0xd1,0xf0,0x24,0x33,0x62,0x72,0x82,0x09,0x0a,0x16,0x17,0x18,0x19,0x1a,0x25,0x26,0x27,0x28,
  1185. 0x29,0x2a,0x34,0x35,0x36,0x37,0x38,0x39,0x3a,0x43,0x44,0x45,0x46,0x47,0x48,0x49,0x4a,0x53,0x54,0x55,0x56,0x57,0x58,0x59,
  1186. 0x5a,0x63,0x64,0x65,0x66,0x67,0x68,0x69,0x6a,0x73,0x74,0x75,0x76,0x77,0x78,0x79,0x7a,0x83,0x84,0x85,0x86,0x87,0x88,0x89,
  1187. 0x8a,0x92,0x93,0x94,0x95,0x96,0x97,0x98,0x99,0x9a,0xa2,0xa3,0xa4,0xa5,0xa6,0xa7,0xa8,0xa9,0xaa,0xb2,0xb3,0xb4,0xb5,0xb6,
  1188. 0xb7,0xb8,0xb9,0xba,0xc2,0xc3,0xc4,0xc5,0xc6,0xc7,0xc8,0xc9,0xca,0xd2,0xd3,0xd4,0xd5,0xd6,0xd7,0xd8,0xd9,0xda,0xe1,0xe2,
  1189. 0xe3,0xe4,0xe5,0xe6,0xe7,0xe8,0xe9,0xea,0xf1,0xf2,0xf3,0xf4,0xf5,0xf6,0xf7,0xf8,0xf9,0xfa
  1190. };
  1191. static const unsigned char std_dc_chrominance_nrcodes[] = {0,0,3,1,1,1,1,1,1,1,1,1,0,0,0,0,0};
  1192. static const unsigned char std_dc_chrominance_values[] = {0,1,2,3,4,5,6,7,8,9,10,11};
  1193. static const unsigned char std_ac_chrominance_nrcodes[] = {0,0,2,1,2,4,4,3,4,7,5,4,4,0,1,2,0x77};
  1194. static const unsigned char std_ac_chrominance_values[] = {
  1195. 0x00,0x01,0x02,0x03,0x11,0x04,0x05,0x21,0x31,0x06,0x12,0x41,0x51,0x07,0x61,0x71,0x13,0x22,0x32,0x81,0x08,0x14,0x42,0x91,
  1196. 0xa1,0xb1,0xc1,0x09,0x23,0x33,0x52,0xf0,0x15,0x62,0x72,0xd1,0x0a,0x16,0x24,0x34,0xe1,0x25,0xf1,0x17,0x18,0x19,0x1a,0x26,
  1197. 0x27,0x28,0x29,0x2a,0x35,0x36,0x37,0x38,0x39,0x3a,0x43,0x44,0x45,0x46,0x47,0x48,0x49,0x4a,0x53,0x54,0x55,0x56,0x57,0x58,
  1198. 0x59,0x5a,0x63,0x64,0x65,0x66,0x67,0x68,0x69,0x6a,0x73,0x74,0x75,0x76,0x77,0x78,0x79,0x7a,0x82,0x83,0x84,0x85,0x86,0x87,
  1199. 0x88,0x89,0x8a,0x92,0x93,0x94,0x95,0x96,0x97,0x98,0x99,0x9a,0xa2,0xa3,0xa4,0xa5,0xa6,0xa7,0xa8,0xa9,0xaa,0xb2,0xb3,0xb4,
  1200. 0xb5,0xb6,0xb7,0xb8,0xb9,0xba,0xc2,0xc3,0xc4,0xc5,0xc6,0xc7,0xc8,0xc9,0xca,0xd2,0xd3,0xd4,0xd5,0xd6,0xd7,0xd8,0xd9,0xda,
  1201. 0xe2,0xe3,0xe4,0xe5,0xe6,0xe7,0xe8,0xe9,0xea,0xf2,0xf3,0xf4,0xf5,0xf6,0xf7,0xf8,0xf9,0xfa
  1202. };
  1203. // Huffman tables
  1204. static const unsigned short YDC_HT[256][2] = { {0,2},{2,3},{3,3},{4,3},{5,3},{6,3},{14,4},{30,5},{62,6},{126,7},{254,8},{510,9}};
  1205. static const unsigned short UVDC_HT[256][2] = { {0,2},{1,2},{2,2},{6,3},{14,4},{30,5},{62,6},{126,7},{254,8},{510,9},{1022,10},{2046,11}};
  1206. static const unsigned short YAC_HT[256][2] = {
  1207. {10,4},{0,2},{1,2},{4,3},{11,4},{26,5},{120,7},{248,8},{1014,10},{65410,16},{65411,16},{0,0},{0,0},{0,0},{0,0},{0,0},{0,0},
  1208. {12,4},{27,5},{121,7},{502,9},{2038,11},{65412,16},{65413,16},{65414,16},{65415,16},{65416,16},{0,0},{0,0},{0,0},{0,0},{0,0},{0,0},
  1209. {28,5},{249,8},{1015,10},{4084,12},{65417,16},{65418,16},{65419,16},{65420,16},{65421,16},{65422,16},{0,0},{0,0},{0,0},{0,0},{0,0},{0,0},
  1210. {58,6},{503,9},{4085,12},{65423,16},{65424,16},{65425,16},{65426,16},{65427,16},{65428,16},{65429,16},{0,0},{0,0},{0,0},{0,0},{0,0},{0,0},
  1211. {59,6},{1016,10},{65430,16},{65431,16},{65432,16},{65433,16},{65434,16},{65435,16},{65436,16},{65437,16},{0,0},{0,0},{0,0},{0,0},{0,0},{0,0},
  1212. {122,7},{2039,11},{65438,16},{65439,16},{65440,16},{65441,16},{65442,16},{65443,16},{65444,16},{65445,16},{0,0},{0,0},{0,0},{0,0},{0,0},{0,0},
  1213. {123,7},{4086,12},{65446,16},{65447,16},{65448,16},{65449,16},{65450,16},{65451,16},{65452,16},{65453,16},{0,0},{0,0},{0,0},{0,0},{0,0},{0,0},
  1214. {250,8},{4087,12},{65454,16},{65455,16},{65456,16},{65457,16},{65458,16},{65459,16},{65460,16},{65461,16},{0,0},{0,0},{0,0},{0,0},{0,0},{0,0},
  1215. {504,9},{32704,15},{65462,16},{65463,16},{65464,16},{65465,16},{65466,16},{65467,16},{65468,16},{65469,16},{0,0},{0,0},{0,0},{0,0},{0,0},{0,0},
  1216. {505,9},{65470,16},{65471,16},{65472,16},{65473,16},{65474,16},{65475,16},{65476,16},{65477,16},{65478,16},{0,0},{0,0},{0,0},{0,0},{0,0},{0,0},
  1217. {506,9},{65479,16},{65480,16},{65481,16},{65482,16},{65483,16},{65484,16},{65485,16},{65486,16},{65487,16},{0,0},{0,0},{0,0},{0,0},{0,0},{0,0},
  1218. {1017,10},{65488,16},{65489,16},{65490,16},{65491,16},{65492,16},{65493,16},{65494,16},{65495,16},{65496,16},{0,0},{0,0},{0,0},{0,0},{0,0},{0,0},
  1219. {1018,10},{65497,16},{65498,16},{65499,16},{65500,16},{65501,16},{65502,16},{65503,16},{65504,16},{65505,16},{0,0},{0,0},{0,0},{0,0},{0,0},{0,0},
  1220. {2040,11},{65506,16},{65507,16},{65508,16},{65509,16},{65510,16},{65511,16},{65512,16},{65513,16},{65514,16},{0,0},{0,0},{0,0},{0,0},{0,0},{0,0},
  1221. {65515,16},{65516,16},{65517,16},{65518,16},{65519,16},{65520,16},{65521,16},{65522,16},{65523,16},{65524,16},{0,0},{0,0},{0,0},{0,0},{0,0},
  1222. {2041,11},{65525,16},{65526,16},{65527,16},{65528,16},{65529,16},{65530,16},{65531,16},{65532,16},{65533,16},{65534,16},{0,0},{0,0},{0,0},{0,0},{0,0}
  1223. };
  1224. static const unsigned short UVAC_HT[256][2] = {
  1225. {0,2},{1,2},{4,3},{10,4},{24,5},{25,5},{56,6},{120,7},{500,9},{1014,10},{4084,12},{0,0},{0,0},{0,0},{0,0},{0,0},{0,0},
  1226. {11,4},{57,6},{246,8},{501,9},{2038,11},{4085,12},{65416,16},{65417,16},{65418,16},{65419,16},{0,0},{0,0},{0,0},{0,0},{0,0},{0,0},
  1227. {26,5},{247,8},{1015,10},{4086,12},{32706,15},{65420,16},{65421,16},{65422,16},{65423,16},{65424,16},{0,0},{0,0},{0,0},{0,0},{0,0},{0,0},
  1228. {27,5},{248,8},{1016,10},{4087,12},{65425,16},{65426,16},{65427,16},{65428,16},{65429,16},{65430,16},{0,0},{0,0},{0,0},{0,0},{0,0},{0,0},
  1229. {58,6},{502,9},{65431,16},{65432,16},{65433,16},{65434,16},{65435,16},{65436,16},{65437,16},{65438,16},{0,0},{0,0},{0,0},{0,0},{0,0},{0,0},
  1230. {59,6},{1017,10},{65439,16},{65440,16},{65441,16},{65442,16},{65443,16},{65444,16},{65445,16},{65446,16},{0,0},{0,0},{0,0},{0,0},{0,0},{0,0},
  1231. {121,7},{2039,11},{65447,16},{65448,16},{65449,16},{65450,16},{65451,16},{65452,16},{65453,16},{65454,16},{0,0},{0,0},{0,0},{0,0},{0,0},{0,0},
  1232. {122,7},{2040,11},{65455,16},{65456,16},{65457,16},{65458,16},{65459,16},{65460,16},{65461,16},{65462,16},{0,0},{0,0},{0,0},{0,0},{0,0},{0,0},
  1233. {249,8},{65463,16},{65464,16},{65465,16},{65466,16},{65467,16},{65468,16},{65469,16},{65470,16},{65471,16},{0,0},{0,0},{0,0},{0,0},{0,0},{0,0},
  1234. {503,9},{65472,16},{65473,16},{65474,16},{65475,16},{65476,16},{65477,16},{65478,16},{65479,16},{65480,16},{0,0},{0,0},{0,0},{0,0},{0,0},{0,0},
  1235. {504,9},{65481,16},{65482,16},{65483,16},{65484,16},{65485,16},{65486,16},{65487,16},{65488,16},{65489,16},{0,0},{0,0},{0,0},{0,0},{0,0},{0,0},
  1236. {505,9},{65490,16},{65491,16},{65492,16},{65493,16},{65494,16},{65495,16},{65496,16},{65497,16},{65498,16},{0,0},{0,0},{0,0},{0,0},{0,0},{0,0},
  1237. {506,9},{65499,16},{65500,16},{65501,16},{65502,16},{65503,16},{65504,16},{65505,16},{65506,16},{65507,16},{0,0},{0,0},{0,0},{0,0},{0,0},{0,0},
  1238. {2041,11},{65508,16},{65509,16},{65510,16},{65511,16},{65512,16},{65513,16},{65514,16},{65515,16},{65516,16},{0,0},{0,0},{0,0},{0,0},{0,0},{0,0},
  1239. {16352,14},{65517,16},{65518,16},{65519,16},{65520,16},{65521,16},{65522,16},{65523,16},{65524,16},{65525,16},{0,0},{0,0},{0,0},{0,0},{0,0},
  1240. {1018,10},{32707,15},{65526,16},{65527,16},{65528,16},{65529,16},{65530,16},{65531,16},{65532,16},{65533,16},{65534,16},{0,0},{0,0},{0,0},{0,0},{0,0}
  1241. };
  1242. static const int YQT[] = {16,11,10,16,24,40,51,61,12,12,14,19,26,58,60,55,14,13,16,24,40,57,69,56,14,17,22,29,51,87,80,62,18,22,
  1243. 37,56,68,109,103,77,24,35,55,64,81,104,113,92,49,64,78,87,103,121,120,101,72,92,95,98,112,100,103,99};
  1244. static const int UVQT[] = {17,18,24,47,99,99,99,99,18,21,26,66,99,99,99,99,24,26,56,99,99,99,99,99,47,66,99,99,99,99,99,99,
  1245. 99,99,99,99,99,99,99,99,99,99,99,99,99,99,99,99,99,99,99,99,99,99,99,99,99,99,99,99,99,99,99,99};
  1246. static const float aasf[] = { 1.0f * 2.828427125f, 1.387039845f * 2.828427125f, 1.306562965f * 2.828427125f, 1.175875602f * 2.828427125f,
  1247. 1.0f * 2.828427125f, 0.785694958f * 2.828427125f, 0.541196100f * 2.828427125f, 0.275899379f * 2.828427125f };
  1248. int row, col, i, k, subsample;
  1249. float fdtbl_Y[64], fdtbl_UV[64];
  1250. unsigned char YTable[64], UVTable[64];
  1251. if(!data || !width || !height || comp > 4 || comp < 1) {
  1252. return 0;
  1253. }
  1254. quality = quality ? quality : 90;
  1255. subsample = quality <= 90 ? 1 : 0;
  1256. quality = quality < 1 ? 1 : quality > 100 ? 100 : quality;
  1257. quality = quality < 50 ? 5000 / quality : 200 - quality * 2;
  1258. for(i = 0; i < 64; ++i) {
  1259. int uvti, yti = (YQT[i]*quality+50)/100;
  1260. YTable[stbiw__jpg_ZigZag[i]] = (unsigned char) (yti < 1 ? 1 : yti > 255 ? 255 : yti);
  1261. uvti = (UVQT[i]*quality+50)/100;
  1262. UVTable[stbiw__jpg_ZigZag[i]] = (unsigned char) (uvti < 1 ? 1 : uvti > 255 ? 255 : uvti);
  1263. }
  1264. for(row = 0, k = 0; row < 8; ++row) {
  1265. for(col = 0; col < 8; ++col, ++k) {
  1266. fdtbl_Y[k] = 1 / (YTable [stbiw__jpg_ZigZag[k]] * aasf[row] * aasf[col]);
  1267. fdtbl_UV[k] = 1 / (UVTable[stbiw__jpg_ZigZag[k]] * aasf[row] * aasf[col]);
  1268. }
  1269. }
  1270. // Write Headers
  1271. {
  1272. static const unsigned char head0[] = { 0xFF,0xD8,0xFF,0xE0,0,0x10,'J','F','I','F',0,1,1,0,0,1,0,1,0,0,0xFF,0xDB,0,0x84,0 };
  1273. static const unsigned char head2[] = { 0xFF,0xDA,0,0xC,3,1,0,2,0x11,3,0x11,0,0x3F,0 };
  1274. const unsigned char head1[] = { 0xFF,0xC0,0,0x11,8,(unsigned char)(height>>8),STBIW_UCHAR(height),(unsigned char)(width>>8),STBIW_UCHAR(width),
  1275. 3,1,(unsigned char)(subsample?0x22:0x11),0,2,0x11,1,3,0x11,1,0xFF,0xC4,0x01,0xA2,0 };
  1276. s->func(s->context, (void*)head0, sizeof(head0));
  1277. s->func(s->context, (void*)YTable, sizeof(YTable));
  1278. stbiw__putc(s, 1);
  1279. s->func(s->context, UVTable, sizeof(UVTable));
  1280. s->func(s->context, (void*)head1, sizeof(head1));
  1281. s->func(s->context, (void*)(std_dc_luminance_nrcodes+1), sizeof(std_dc_luminance_nrcodes)-1);
  1282. s->func(s->context, (void*)std_dc_luminance_values, sizeof(std_dc_luminance_values));
  1283. stbiw__putc(s, 0x10); // HTYACinfo
  1284. s->func(s->context, (void*)(std_ac_luminance_nrcodes+1), sizeof(std_ac_luminance_nrcodes)-1);
  1285. s->func(s->context, (void*)std_ac_luminance_values, sizeof(std_ac_luminance_values));
  1286. stbiw__putc(s, 1); // HTUDCinfo
  1287. s->func(s->context, (void*)(std_dc_chrominance_nrcodes+1), sizeof(std_dc_chrominance_nrcodes)-1);
  1288. s->func(s->context, (void*)std_dc_chrominance_values, sizeof(std_dc_chrominance_values));
  1289. stbiw__putc(s, 0x11); // HTUACinfo
  1290. s->func(s->context, (void*)(std_ac_chrominance_nrcodes+1), sizeof(std_ac_chrominance_nrcodes)-1);
  1291. s->func(s->context, (void*)std_ac_chrominance_values, sizeof(std_ac_chrominance_values));
  1292. s->func(s->context, (void*)head2, sizeof(head2));
  1293. }
  1294. // Encode 8x8 macroblocks
  1295. {
  1296. static const unsigned short fillBits[] = {0x7F, 7};
  1297. int DCY=0, DCU=0, DCV=0;
  1298. int bitBuf=0, bitCnt=0;
  1299. // comp == 2 is grey+alpha (alpha is ignored)
  1300. int ofsG = comp > 2 ? 1 : 0, ofsB = comp > 2 ? 2 : 0;
  1301. const unsigned char *dataR = (const unsigned char *)data;
  1302. const unsigned char *dataG = dataR + ofsG;
  1303. const unsigned char *dataB = dataR + ofsB;
  1304. int x, y, pos;
  1305. if(subsample) {
  1306. for(y = 0; y < height; y += 16) {
  1307. for(x = 0; x < width; x += 16) {
  1308. float Y[256], U[256], V[256];
  1309. for(row = y, pos = 0; row < y+16; ++row) {
  1310. // row >= height => use last input row
  1311. int clamped_row = (row < height) ? row : height - 1;
  1312. int base_p = (stbi__flip_vertically_on_write ? (height-1-clamped_row) : clamped_row)*width*comp;
  1313. for(col = x; col < x+16; ++col, ++pos) {
  1314. // if col >= width => use pixel from last input column
  1315. int p = base_p + ((col < width) ? col : (width-1))*comp;
  1316. float r = dataR[p], g = dataG[p], b = dataB[p];
  1317. Y[pos]= +0.29900f*r + 0.58700f*g + 0.11400f*b - 128;
  1318. U[pos]= -0.16874f*r - 0.33126f*g + 0.50000f*b;
  1319. V[pos]= +0.50000f*r - 0.41869f*g - 0.08131f*b;
  1320. }
  1321. }
  1322. DCY = stbiw__jpg_processDU(s, &bitBuf, &bitCnt, Y+0, 16, fdtbl_Y, DCY, YDC_HT, YAC_HT);
  1323. DCY = stbiw__jpg_processDU(s, &bitBuf, &bitCnt, Y+8, 16, fdtbl_Y, DCY, YDC_HT, YAC_HT);
  1324. DCY = stbiw__jpg_processDU(s, &bitBuf, &bitCnt, Y+128, 16, fdtbl_Y, DCY, YDC_HT, YAC_HT);
  1325. DCY = stbiw__jpg_processDU(s, &bitBuf, &bitCnt, Y+136, 16, fdtbl_Y, DCY, YDC_HT, YAC_HT);
  1326. // subsample U,V
  1327. {
  1328. float subU[64], subV[64];
  1329. int yy, xx;
  1330. for(yy = 0, pos = 0; yy < 8; ++yy) {
  1331. for(xx = 0; xx < 8; ++xx, ++pos) {
  1332. int j = yy*32+xx*2;
  1333. subU[pos] = (U[j+0] + U[j+1] + U[j+16] + U[j+17]) * 0.25f;
  1334. subV[pos] = (V[j+0] + V[j+1] + V[j+16] + V[j+17]) * 0.25f;
  1335. }
  1336. }
  1337. DCU = stbiw__jpg_processDU(s, &bitBuf, &bitCnt, subU, 8, fdtbl_UV, DCU, UVDC_HT, UVAC_HT);
  1338. DCV = stbiw__jpg_processDU(s, &bitBuf, &bitCnt, subV, 8, fdtbl_UV, DCV, UVDC_HT, UVAC_HT);
  1339. }
  1340. }
  1341. }
  1342. } else {
  1343. for(y = 0; y < height; y += 8) {
  1344. for(x = 0; x < width; x += 8) {
  1345. float Y[64], U[64], V[64];
  1346. for(row = y, pos = 0; row < y+8; ++row) {
  1347. // row >= height => use last input row
  1348. int clamped_row = (row < height) ? row : height - 1;
  1349. int base_p = (stbi__flip_vertically_on_write ? (height-1-clamped_row) : clamped_row)*width*comp;
  1350. for(col = x; col < x+8; ++col, ++pos) {
  1351. // if col >= width => use pixel from last input column
  1352. int p = base_p + ((col < width) ? col : (width-1))*comp;
  1353. float r = dataR[p], g = dataG[p], b = dataB[p];
  1354. Y[pos]= +0.29900f*r + 0.58700f*g + 0.11400f*b - 128;
  1355. U[pos]= -0.16874f*r - 0.33126f*g + 0.50000f*b;
  1356. V[pos]= +0.50000f*r - 0.41869f*g - 0.08131f*b;
  1357. }
  1358. }
  1359. DCY = stbiw__jpg_processDU(s, &bitBuf, &bitCnt, Y, 8, fdtbl_Y, DCY, YDC_HT, YAC_HT);
  1360. DCU = stbiw__jpg_processDU(s, &bitBuf, &bitCnt, U, 8, fdtbl_UV, DCU, UVDC_HT, UVAC_HT);
  1361. DCV = stbiw__jpg_processDU(s, &bitBuf, &bitCnt, V, 8, fdtbl_UV, DCV, UVDC_HT, UVAC_HT);
  1362. }
  1363. }
  1364. }
  1365. // Do the bit alignment of the EOI marker
  1366. stbiw__jpg_writeBits(s, &bitBuf, &bitCnt, fillBits);
  1367. }
  1368. // EOI
  1369. stbiw__putc(s, 0xFF);
  1370. stbiw__putc(s, 0xD9);
  1371. return 1;
  1372. }
  1373. STBIWDEF int stbi_write_jpg_to_func(stbi_write_func *func, void *context, int x, int y, int comp, const void *data, int quality)
  1374. {
  1375. stbi__write_context s = { 0 };
  1376. stbi__start_write_callbacks(&s, func, context);
  1377. return stbi_write_jpg_core(&s, x, y, comp, (void *) data, quality);
  1378. }
  1379. #ifndef STBI_WRITE_NO_STDIO
  1380. STBIWDEF int stbi_write_jpg(char const *filename, int x, int y, int comp, const void *data, int quality)
  1381. {
  1382. stbi__write_context s = { 0 };
  1383. if (stbi__start_write_file(&s,filename)) {
  1384. int r = stbi_write_jpg_core(&s, x, y, comp, data, quality);
  1385. stbi__end_write_file(&s);
  1386. return r;
  1387. } else
  1388. return 0;
  1389. }
  1390. #endif
  1391. /* Revision history
  1392. 1.16 (2021-07-11)
  1393. make Deflate code emit uncompressed blocks when it would otherwise expand
  1394. support writing BMPs with alpha channel
  1395. 1.15 (2020-07-13) unknown
  1396. 1.14 (2020-02-02) updated JPEG writer to downsample chroma channels
  1397. 1.13
  1398. 1.12
  1399. 1.11 (2019-08-11)
  1400. 1.10 (2019-02-07)
  1401. support utf8 filenames in Windows; fix warnings and platform ifdefs
  1402. 1.09 (2018-02-11)
  1403. fix typo in zlib quality API, improve STB_I_W_STATIC in C++
  1404. 1.08 (2018-01-29)
  1405. add stbi__flip_vertically_on_write, external zlib, zlib quality, choose PNG filter
  1406. 1.07 (2017-07-24)
  1407. doc fix
  1408. 1.06 (2017-07-23)
  1409. writing JPEG (using Jon Olick's code)
  1410. 1.05 ???
  1411. 1.04 (2017-03-03)
  1412. monochrome BMP expansion
  1413. 1.03 ???
  1414. 1.02 (2016-04-02)
  1415. avoid allocating large structures on the stack
  1416. 1.01 (2016-01-16)
  1417. STBIW_REALLOC_SIZED: support allocators with no realloc support
  1418. avoid race-condition in crc initialization
  1419. minor compile issues
  1420. 1.00 (2015-09-14)
  1421. installable file IO function
  1422. 0.99 (2015-09-13)
  1423. warning fixes; TGA rle support
  1424. 0.98 (2015-04-08)
  1425. added STBIW_MALLOC, STBIW_ASSERT etc
  1426. 0.97 (2015-01-18)
  1427. fixed HDR asserts, rewrote HDR rle logic
  1428. 0.96 (2015-01-17)
  1429. add HDR output
  1430. fix monochrome BMP
  1431. 0.95 (2014-08-17)
  1432. add monochrome TGA output
  1433. 0.94 (2014-05-31)
  1434. rename private functions to avoid conflicts with stb_image.h
  1435. 0.93 (2014-05-27)
  1436. warning fixes
  1437. 0.92 (2010-08-01)
  1438. casts to unsigned char to fix warnings
  1439. 0.91 (2010-07-17)
  1440. first public release
  1441. 0.90 first internal release
  1442. */
  1443. /*
  1444. ------------------------------------------------------------------------------
  1445. This software is available under 2 licenses -- choose whichever you prefer.
  1446. ------------------------------------------------------------------------------
  1447. ALTERNATIVE A - MIT License
  1448. Copyright (c) 2017 Sean Barrett
  1449. Permission is hereby granted, free of charge, to any person obtaining a copy of
  1450. this software and associated documentation files (the "Software"), to deal in
  1451. the Software without restriction, including without limitation the rights to
  1452. use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies
  1453. of the Software, and to permit persons to whom the Software is furnished to do
  1454. so, subject to the following conditions:
  1455. The above copyright notice and this permission notice shall be included in all
  1456. copies or substantial portions of the Software.
  1457. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
  1458. IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
  1459. FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
  1460. AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
  1461. LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
  1462. OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
  1463. SOFTWARE.
  1464. ------------------------------------------------------------------------------
  1465. ALTERNATIVE B - Public Domain (www.unlicense.org)
  1466. This is free and unencumbered software released into the public domain.
  1467. Anyone is free to copy, modify, publish, use, compile, sell, or distribute this
  1468. software, either in source code form or as a compiled binary, for any purpose,
  1469. commercial or non-commercial, and by any means.
  1470. In jurisdictions that recognize copyright laws, the author or authors of this
  1471. software dedicate any and all copyright interest in the software to the public
  1472. domain. We make this dedication for the benefit of the public at large and to
  1473. the detriment of our heirs and successors. We intend this dedication to be an
  1474. overt act of relinquishment in perpetuity of all present and future rights to
  1475. this software under copyright law.
  1476. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
  1477. IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
  1478. FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
  1479. AUTHORS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN
  1480. ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
  1481. WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
  1482. ------------------------------------------------------------------------------
  1483. */