]> de.git.xonotic.org Git - xonotic/darkplaces.git/blob - image_png.c
Implemented r_sky_scissor feature (on by default) - this limits rendering of sky...
[xonotic/darkplaces.git] / image_png.c
1 /*
2         Copyright (C) 2006  Serge "(515)" Ziryukin, Forest "LordHavoc" Hale
3
4         This program is free software; you can redistribute it and/or
5         modify it under the terms of the GNU General Public License
6         as published by the Free Software Foundation; either version 2
7         of the License, or (at your option) any later version.
8
9         This program is distributed in the hope that it will be useful,
10         but WITHOUT ANY WARRANTY; without even the implied warranty of
11         MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
12
13         See the GNU General Public License for more details.
14
15         You should have received a copy of the GNU General Public License
16         along with this program; if not, write to:
17
18                 Free Software Foundation, Inc.
19                 59 Temple Place - Suite 330
20                 Boston, MA  02111-1307, USA
21
22 */
23
24 //[515]: png implemented into DP ONLY FOR TESTING 2d stuff with csqc
25 // so delete this bullshit :D
26 //
27 //LordHavoc: rewrote most of this.
28
29 #include "quakedef.h"
30 #include "image.h"
31 #include "image_png.h"
32
33
34 static void                             (*qpng_set_sig_bytes)           (void*, int);
35 static int                              (*qpng_sig_cmp)                         (const unsigned char*, size_t, size_t);
36 static void*                    (*qpng_create_read_struct)      (const char*, void*, void(*)(void *png, const char *message), void(*)(void *png, const char *message));
37 static void*                    (*qpng_create_write_struct)     (const char*, void*, void(*)(void *png, const char *message), void(*)(void *png, const char *message));
38 static void*                    (*qpng_create_info_struct)      (void*);
39 static void                             (*qpng_read_info)                       (void*, void*);
40 static void                             (*qpng_set_compression_level)   (void*, int);
41 static void                             (*qpng_set_filter)                      (void*, int, int);
42 static void                             (*qpng_set_expand)                      (void*);
43 static void                             (*qpng_set_palette_to_rgb)      (void*);
44 static void                             (*qpng_set_tRNS_to_alpha)       (void*);
45 static void                             (*qpng_set_gray_to_rgb)         (void*);
46 static void                             (*qpng_set_filler)                      (void*, unsigned int, int);
47 static void                             (*qpng_set_IHDR)                        (void*, void*, unsigned long, unsigned long, int, int, int, int, int);
48 static void                             (*qpng_set_packing)                     (void*);
49 static void                             (*qpng_set_bgr)                         (void*);
50 static int                              (*qpng_set_interlace_handling)  (void*);
51 static void                             (*qpng_read_update_info)        (void*, void*);
52 static void                             (*qpng_read_image)                      (void*, unsigned char**);
53 static void                             (*qpng_read_end)                        (void*, void*);
54 static void                             (*qpng_destroy_read_struct)     (void**, void**, void**);
55 static void                             (*qpng_destroy_write_struct)    (void**, void**);
56 static void                             (*qpng_set_read_fn)                     (void*, void*, void(*)(void *png, unsigned char *data, size_t length));
57 static void                             (*qpng_set_write_fn)            (void*, void*, void(*)(void *png, unsigned char *data, size_t length), void(*)(void *png));
58 static unsigned int             (*qpng_get_valid)                       (void*, void*, unsigned int);
59 static unsigned int             (*qpng_get_rowbytes)            (void*, void*);
60 static unsigned char    (*qpng_get_channels)            (void*, void*);
61 static unsigned char    (*qpng_get_bit_depth)           (void*, void*);
62 static unsigned int             (*qpng_get_IHDR)                        (void*, void*, unsigned long*, unsigned long*, int *, int *, int *, int *, int *);
63 static unsigned int                     (*qpng_access_version_number)           (void); // FIXME is this return type right? It is a png_uint_32 in libpng
64 static void                             (*qpng_write_info)                      (void*, void*);
65 static void                             (*qpng_write_row)                       (void*, unsigned char*);
66 static void                             (*qpng_write_end)                       (void*, void*);
67
68 // libpng 1.4+ longjmp hack
69 typedef void (*qpng_longjmp_ptr) (jmp_buf, int);
70 static jmp_buf* (*qpng_set_longjmp_fn) (void *, qpng_longjmp_ptr, size_t);
71 #define qpng_jmpbuf_14(png_ptr) (*qpng_set_longjmp_fn((png_ptr), longjmp, sizeof (jmp_buf)))
72
73 // libpng 1.2 longjmp hack
74 #define qpng_jmpbuf_12(png_ptr) (*((jmp_buf *) png_ptr))
75
76 // all version support
77 #define qpng_jmpbuf(png_ptr) \
78         (qpng_set_longjmp_fn ? qpng_jmpbuf_14(png_ptr) : qpng_jmpbuf_12(png_ptr))
79
80 static dllfunction_t pngfuncs[] =
81 {
82         {"png_set_sig_bytes",           (void **) &qpng_set_sig_bytes},
83         {"png_sig_cmp",                         (void **) &qpng_sig_cmp},
84         {"png_create_read_struct",      (void **) &qpng_create_read_struct},
85         {"png_create_write_struct",     (void **) &qpng_create_write_struct},
86         {"png_create_info_struct",      (void **) &qpng_create_info_struct},
87         {"png_read_info",                       (void **) &qpng_read_info},
88         {"png_set_compression_level",   (void **) &qpng_set_compression_level},
89         {"png_set_filter",                      (void **) &qpng_set_filter},
90         {"png_set_expand",                      (void **) &qpng_set_expand},
91         {"png_set_palette_to_rgb",      (void **) &qpng_set_palette_to_rgb},
92         {"png_set_tRNS_to_alpha",       (void **) &qpng_set_tRNS_to_alpha},
93         {"png_set_gray_to_rgb",         (void **) &qpng_set_gray_to_rgb},
94         {"png_set_filler",                      (void **) &qpng_set_filler},
95         {"png_set_IHDR",                        (void **) &qpng_set_IHDR},
96         {"png_set_packing",                     (void **) &qpng_set_packing},
97         {"png_set_bgr",                         (void **) &qpng_set_bgr},
98         {"png_set_interlace_handling",  (void **) &qpng_set_interlace_handling},
99         {"png_read_update_info",        (void **) &qpng_read_update_info},
100         {"png_read_image",                      (void **) &qpng_read_image},
101         {"png_read_end",                        (void **) &qpng_read_end},
102         {"png_destroy_read_struct",     (void **) &qpng_destroy_read_struct},
103         {"png_destroy_write_struct",    (void **) &qpng_destroy_write_struct},
104         {"png_set_read_fn",                     (void **) &qpng_set_read_fn},
105         {"png_set_write_fn",            (void **) &qpng_set_write_fn},
106         {"png_get_valid",                       (void **) &qpng_get_valid},
107         {"png_get_rowbytes",            (void **) &qpng_get_rowbytes},
108         {"png_get_channels",            (void **) &qpng_get_channels},
109         {"png_get_bit_depth",           (void **) &qpng_get_bit_depth},
110         {"png_get_IHDR",                        (void **) &qpng_get_IHDR},
111         {"png_access_version_number",           (void **) &qpng_access_version_number},
112         {"png_write_info",                      (void **) &qpng_write_info},
113         {"png_write_row",                       (void **) &qpng_write_row},
114         {"png_write_end",                       (void **) &qpng_write_end},
115         {NULL, NULL}
116 };
117 static dllfunction_t png14funcs[] =
118 {
119         {"png_set_longjmp_fn",          (void **) &qpng_set_longjmp_fn},
120         {NULL, NULL}
121 };
122
123 // Handle for PNG DLL
124 dllhandle_t png_dll = NULL;
125 dllhandle_t png14_dll = NULL;
126
127
128 /*
129 =================================================================
130
131   DLL load & unload
132
133 =================================================================
134 */
135
136 /*
137 ====================
138 PNG_OpenLibrary
139
140 Try to load the PNG DLL
141 ====================
142 */
143 qboolean PNG_OpenLibrary (void)
144 {
145         const char* dllnames [] =
146         {
147 #if WIN32
148                 "libpng16.dll",
149                 "libpng16-16.dll",
150                 "libpng15-15.dll",
151                 "libpng15.dll",
152                 "libpng14-14.dll",
153                 "libpng14.dll",
154                 "libpng12.dll",
155 #elif defined(MACOSX)
156                 "libpng16.16.dylib",
157                 "libpng15.15.dylib",
158                 "libpng14.14.dylib",
159                 "libpng12.0.dylib",
160 #else
161                 "libpng16.so.16",
162                 "libpng15.so.15", // WTF libtool guidelines anyone?
163                 "libpng14.so.14", // WTF libtool guidelines anyone?
164                 "libpng12.so.0",
165                 "libpng.so", // FreeBSD
166 #endif
167                 NULL
168         };
169
170         // Already loaded?
171         if (png_dll)
172                 return true;
173
174         // Load the DLL
175         if(!Sys_LoadLibrary (dllnames, &png_dll, pngfuncs))
176                 return false;
177         if(qpng_access_version_number() / 100 >= 104)
178                 if(!Sys_LoadLibrary (dllnames, &png14_dll, png14funcs))
179                 {
180                         Sys_UnloadLibrary (&png_dll);
181                         return false;
182                 }
183         return true;
184 }
185
186
187 /*
188 ====================
189 PNG_CloseLibrary
190
191 Unload the PNG DLL
192 ====================
193 */
194 void PNG_CloseLibrary (void)
195 {
196         Sys_UnloadLibrary (&png14_dll);
197         Sys_UnloadLibrary (&png_dll);
198 }
199
200 /*
201 =================================================================
202
203         PNG decompression
204
205 =================================================================
206 */
207
208 #define PNG_LIBPNG_VER_STRING_12 "1.2.4"
209 #define PNG_LIBPNG_VER_STRING_14 "1.4.0"
210 #define PNG_LIBPNG_VER_STRING_15 "1.5.0"
211 #define PNG_LIBPNG_VER_STRING_16 "1.6.0"
212
213 #define PNG_COLOR_MASK_PALETTE    1
214 #define PNG_COLOR_MASK_COLOR      2
215 #define PNG_COLOR_MASK_ALPHA      4
216
217 #define PNG_COLOR_TYPE_GRAY 0
218 #define PNG_COLOR_TYPE_PALETTE  (PNG_COLOR_MASK_COLOR | PNG_COLOR_MASK_PALETTE)
219 #define PNG_COLOR_TYPE_RGB        (PNG_COLOR_MASK_COLOR)
220 #define PNG_COLOR_TYPE_RGB_ALPHA  (PNG_COLOR_MASK_COLOR | PNG_COLOR_MASK_ALPHA)
221 #define PNG_COLOR_TYPE_GRAY_ALPHA (PNG_COLOR_MASK_ALPHA)
222
223 #define PNG_COLOR_TYPE_RGBA  PNG_COLOR_TYPE_RGB_ALPHA
224 #define PNG_COLOR_TYPE_GA  PNG_COLOR_TYPE_GRAY_ALPHA
225
226 #define PNG_INFO_tRNS 0x0010
227
228 // this struct is only used for status information during loading
229 static struct
230 {
231         const unsigned char     *tmpBuf;
232         int             tmpBuflength;
233         int             tmpi;
234         //int           FBgColor;
235         //int           FTransparent;
236         unsigned int    FRowBytes;
237         //double        FGamma;
238         //double        FScreenGamma;
239         unsigned char   **FRowPtrs;
240         unsigned char   *Data;
241         //char  *Title;
242         //char  *Author;
243         //char  *Description;
244         int             BitDepth;
245         int             BytesPerPixel;
246         int             ColorType;
247         unsigned long   Height; // retarded libpng 1.2 pngconf.h uses long (64bit/32bit depending on arch)
248         unsigned long   Width; // retarded libpng 1.2 pngconf.h uses long (64bit/32bit depending on arch)
249         int             Interlace;
250         int             Compression;
251         int             Filter;
252         //double        LastModified;
253         //int           Transparent;
254         qfile_t *outfile;
255 } my_png;
256
257 //LordHavoc: removed __cdecl prefix, added overrun protection, and rewrote this to be more efficient
258 static void PNG_fReadData(void *png, unsigned char *data, size_t length)
259 {
260         size_t l;
261         l = my_png.tmpBuflength - my_png.tmpi;
262         if (l < length)
263         {
264                 Con_Printf("PNG_fReadData: overrun by %i bytes\n", (int)(length - l));
265                 // a read going past the end of the file, fill in the remaining bytes
266                 // with 0 just to be consistent
267                 memset(data + l, 0, length - l);
268                 length = l;
269         }
270         memcpy(data, my_png.tmpBuf + my_png.tmpi, length);
271         my_png.tmpi += (int)length;
272         //Com_HexDumpToConsole(data, (int)length);
273 }
274
275 static void PNG_fWriteData(void *png, unsigned char *data, size_t length)
276 {
277         FS_Write(my_png.outfile, data, length);
278 }
279
280 static void PNG_fFlushData(void *png)
281 {
282 }
283
284 static void PNG_error_fn(void *png, const char *message)
285 {
286         Con_Printf("PNG_LoadImage: error: %s\n", message);
287 }
288
289 static void PNG_warning_fn(void *png, const char *message)
290 {
291         Con_Printf("PNG_LoadImage: warning: %s\n", message);
292 }
293
294 unsigned char *PNG_LoadImage_BGRA (const unsigned char *raw, int filesize, int *miplevel)
295 {
296         unsigned int c;
297         unsigned int    y;
298         void *png, *pnginfo;
299         unsigned char *imagedata = NULL;
300         unsigned char ioBuffer[8192];
301
302         // FIXME: register an error handler so that abort() won't be called on error
303
304         // No DLL = no PNGs
305         if (!png_dll)
306                 return NULL;
307
308         if(qpng_sig_cmp(raw, 0, filesize))
309                 return NULL;
310         png = (void *)qpng_create_read_struct(
311                 (qpng_access_version_number() / 100 == 102) ? PNG_LIBPNG_VER_STRING_12 :
312                 (qpng_access_version_number() / 100 == 104) ? PNG_LIBPNG_VER_STRING_14 :
313                 (qpng_access_version_number() / 100 == 105) ? PNG_LIBPNG_VER_STRING_15 :
314                 PNG_LIBPNG_VER_STRING_16, // nasty hack... whatever
315                 0, PNG_error_fn, PNG_warning_fn
316         );
317         if(!png)
318                 return NULL;
319
320         // this must be memset before the setjmp error handler, because it relies
321         // on the fields in this struct for cleanup
322         memset(&my_png, 0, sizeof(my_png));
323
324         // NOTE: this relies on jmp_buf being the first thing in the png structure
325         // created by libpng! (this is correct for libpng 1.2.x)
326         if (setjmp(qpng_jmpbuf(png)))
327         {
328                 if (my_png.Data)
329                         Mem_Free(my_png.Data);
330                 my_png.Data = NULL;
331                 if (my_png.FRowPtrs)
332                         Mem_Free(my_png.FRowPtrs);
333                 my_png.FRowPtrs = NULL;
334                 qpng_destroy_read_struct(&png, &pnginfo, 0);
335                 return NULL;
336         }
337         //
338
339         pnginfo = qpng_create_info_struct(png);
340         if(!pnginfo)
341         {
342                 qpng_destroy_read_struct(&png, &pnginfo, 0);
343                 return NULL;
344         }
345         qpng_set_sig_bytes(png, 0);
346
347         my_png.tmpBuf = raw;
348         my_png.tmpBuflength = filesize;
349         my_png.tmpi = 0;
350         //my_png.Data           = NULL;
351         //my_png.FRowPtrs       = NULL;
352         //my_png.Height         = 0;
353         //my_png.Width          = 0;
354         my_png.ColorType        = PNG_COLOR_TYPE_RGB;
355         //my_png.Interlace      = 0;
356         //my_png.Compression    = 0;
357         //my_png.Filter         = 0;
358         qpng_set_read_fn(png, ioBuffer, PNG_fReadData);
359         qpng_read_info(png, pnginfo);
360         qpng_get_IHDR(png, pnginfo, &my_png.Width, &my_png.Height,&my_png.BitDepth, &my_png.ColorType, &my_png.Interlace, &my_png.Compression, &my_png.Filter);
361
362         // this check guards against pngconf.h with unsigned int *width/height parameters on big endian systems by detecting the strange values and shifting them down 32bits
363         // (if it's little endian the unwritten bytes are the most significant
364         //  ones and we don't worry about that)
365         //
366         // this is only necessary because of retarded 64bit png_uint_32 types in libpng 1.2, which can (conceivably) vary by platform
367 #if LONG_MAX > 4000000000
368         if (my_png.Width > LONG_MAX || my_png.Height > LONG_MAX)
369         {
370                 my_png.Width >>= 32;
371                 my_png.Height >>= 32;
372         }
373 #endif
374
375         if (my_png.ColorType == PNG_COLOR_TYPE_PALETTE)
376                 qpng_set_palette_to_rgb(png);
377         if (my_png.ColorType == PNG_COLOR_TYPE_GRAY || my_png.ColorType == PNG_COLOR_TYPE_GRAY_ALPHA)
378                 qpng_set_gray_to_rgb(png);
379         if (qpng_get_valid(png, pnginfo, PNG_INFO_tRNS))
380                 qpng_set_tRNS_to_alpha(png);
381         if (my_png.BitDepth == 8 && !(my_png.ColorType  & PNG_COLOR_MASK_ALPHA))
382                 qpng_set_filler(png, 255, 1);
383         if (( my_png.ColorType == PNG_COLOR_TYPE_GRAY) || (my_png.ColorType == PNG_COLOR_TYPE_GRAY_ALPHA ))
384                 qpng_set_gray_to_rgb(png);
385         if (my_png.BitDepth < 8)
386                 qpng_set_expand(png);
387
388         qpng_read_update_info(png, pnginfo);
389
390         my_png.FRowBytes = qpng_get_rowbytes(png, pnginfo);
391         my_png.BytesPerPixel = qpng_get_channels(png, pnginfo);
392
393         my_png.FRowPtrs = (unsigned char **)Mem_Alloc(tempmempool, my_png.Height * sizeof(*my_png.FRowPtrs));
394         if (my_png.FRowPtrs)
395         {
396                 imagedata = (unsigned char *)Mem_Alloc(tempmempool, my_png.Height * my_png.FRowBytes);
397                 if(imagedata)
398                 {
399                         my_png.Data = imagedata;
400                         for(y = 0;y < my_png.Height;y++)
401                                 my_png.FRowPtrs[y] = my_png.Data + y * my_png.FRowBytes;
402                         qpng_read_image(png, my_png.FRowPtrs);
403                 }
404                 else
405                 {
406                         Con_Printf("PNG_LoadImage : not enough memory\n");
407                         qpng_destroy_read_struct(&png, &pnginfo, 0);
408                         Mem_Free(my_png.FRowPtrs);
409                         return NULL;
410                 }
411                 Mem_Free(my_png.FRowPtrs);
412                 my_png.FRowPtrs = NULL;
413         }
414         else
415         {
416                 Con_Printf("PNG_LoadImage : not enough memory\n");
417                 qpng_destroy_read_struct(&png, &pnginfo, 0);
418                 return NULL;
419         }
420
421         qpng_read_end(png, pnginfo);
422         qpng_destroy_read_struct(&png, &pnginfo, 0);
423
424         image_width = (int)my_png.Width;
425         image_height = (int)my_png.Height;
426
427         if (my_png.BitDepth != 8)
428         {
429                 Con_Printf ("PNG_LoadImage : bad color depth\n");
430                 Mem_Free(imagedata);
431                 return NULL;
432         }
433
434         // swizzle RGBA to BGRA
435         for (y = 0;y < (unsigned int)(image_width*image_height*4);y += 4)
436         {
437                 c = imagedata[y+0];
438                 imagedata[y+0] = imagedata[y+2];
439                 imagedata[y+2] = c;
440         }
441
442         return imagedata;
443 }
444
445 /*
446 =================================================================
447
448         PNG compression
449
450 =================================================================
451 */
452
453 #define Z_BEST_SPEED 1
454 #define Z_BEST_COMPRESSION 9
455 #define PNG_INTERLACE_NONE 0
456 #define PNG_INTERLACE_ADAM7 1
457 #define PNG_FILTER_TYPE_BASE 0
458 #define PNG_FILTER_TYPE_DEFAULT PNG_FILTER_TYPE_BASE
459 #define PNG_COMPRESSION_TYPE_BASE 0
460 #define PNG_COMPRESSION_TYPE_DEFAULT PNG_COMPRESSION_TYPE_BASE
461 #define PNG_NO_FILTERS     0x00
462 #define PNG_FILTER_NONE    0x08
463 #define PNG_FILTER_SUB     0x10
464 #define PNG_FILTER_UP      0x20
465 #define PNG_FILTER_AVG     0x40
466 #define PNG_FILTER_PAETH   0x80
467 #define PNG_ALL_FILTERS (PNG_FILTER_NONE | PNG_FILTER_SUB | PNG_FILTER_UP | \
468                          PNG_FILTER_AVG | PNG_FILTER_PAETH)
469
470 /*
471 ====================
472 PNG_SaveImage_preflipped
473
474 Save a preflipped PNG image to a file
475 ====================
476 */
477 qboolean PNG_SaveImage_preflipped (const char *filename, int width, int height, qboolean has_alpha, unsigned char *data)
478 {
479         unsigned int offset, linesize;
480         qfile_t* file = NULL;
481         void *png, *pnginfo;
482         unsigned char ioBuffer[8192];
483         int passes, i, j;
484
485         // No DLL = no JPEGs
486         if (!png_dll)
487         {
488                 Con_Print("You need the libpng library to save PNG images\n");
489                 return false;
490         }
491
492         png = (void *)qpng_create_write_struct( 
493                 (qpng_access_version_number() / 100 == 102) ? PNG_LIBPNG_VER_STRING_12 :
494                 (qpng_access_version_number() / 100 == 104) ? PNG_LIBPNG_VER_STRING_14 :
495                 (qpng_access_version_number() / 100 == 105) ? PNG_LIBPNG_VER_STRING_15 :
496                 PNG_LIBPNG_VER_STRING_16, // nasty hack... whatever
497                 0, PNG_error_fn, PNG_warning_fn
498         );
499         if(!png)
500                 return false;
501         pnginfo = (void *)qpng_create_info_struct(png);
502         if(!pnginfo)
503         {
504                  qpng_destroy_write_struct(&png, NULL);
505                  return false;
506         }
507
508         // this must be memset before the setjmp error handler, because it relies
509         // on the fields in this struct for cleanup
510         memset(&my_png, 0, sizeof(my_png));
511
512         // NOTE: this relies on jmp_buf being the first thing in the png structure
513         // created by libpng! (this is correct for libpng 1.2.x)
514 #ifdef __cplusplus
515 #ifdef WIN64
516         if (setjmp((_JBTYPE *)png))
517 #elif defined(MACOSX) || defined(WIN32)
518         if (setjmp((int *)png))
519 #elif defined(__ANDROID__)
520         if (setjmp((long *)png))
521 #else
522         if (setjmp((__jmp_buf_tag *)png))
523 #endif
524 #else
525         if (setjmp(png))
526 #endif
527         {
528                 qpng_destroy_write_struct(&png, &pnginfo);
529                 return false;
530         }
531
532         // Open the file
533         file = FS_OpenRealFile(filename, "wb", true);
534         if (!file)
535                 return false;
536         my_png.outfile = file;
537         qpng_set_write_fn(png, ioBuffer, PNG_fWriteData, PNG_fFlushData);
538
539         //qpng_set_compression_level(png, Z_BEST_COMPRESSION);
540         qpng_set_compression_level(png, Z_BEST_SPEED);
541         qpng_set_IHDR(png, pnginfo, width, height, 8, has_alpha ? PNG_COLOR_TYPE_RGB_ALPHA : PNG_COLOR_TYPE_RGB, PNG_INTERLACE_ADAM7, PNG_COMPRESSION_TYPE_DEFAULT, PNG_FILTER_TYPE_DEFAULT);
542         qpng_set_filter(png, 0, PNG_NO_FILTERS);
543         qpng_write_info(png, pnginfo);
544         qpng_set_packing(png);
545         qpng_set_bgr(png);
546
547         passes = qpng_set_interlace_handling(png);
548
549         linesize = width * (has_alpha ? 4 : 3);
550         offset = linesize * (height - 1);
551         for(i = 0; i < passes; ++i)
552                 for(j = 0; j < height; ++j)
553                         qpng_write_row(png, &data[offset - j * linesize]);
554
555         qpng_write_end(png, NULL);
556         qpng_destroy_write_struct(&png, &pnginfo);
557
558         FS_Close (file);
559
560         return true;
561 }