1 /*---------------------------------------------------------------------------
2 
3    rpng2 - progressive-model PNG display program                 readpng2.h
4 
5   ---------------------------------------------------------------------------
6 
7       Copyright (c) 1998-2008 Greg Roelofs.  All rights reserved.
8 
9       This software is provided "as is," without warranty of any kind,
10       express or implied.  In no event shall the author or contributors
11       be held liable for any damages arising in any way from the use of
12       this software.
13 
14       The contents of this file are DUAL-LICENSED.  You may modify and/or
15       redistribute this software according to the terms of one of the
16       following two licenses (at your option):
17 
18 
19       LICENSE 1 ("BSD-like with advertising clause"):
20 
21       Permission is granted to anyone to use this software for any purpose,
22       including commercial applications, and to alter it and redistribute
23       it freely, subject to the following restrictions:
24 
25       1. Redistributions of source code must retain the above copyright
26          notice, disclaimer, and this list of conditions.
27       2. Redistributions in binary form must reproduce the above copyright
28          notice, disclaimer, and this list of conditions in the documenta-
29          tion and/or other materials provided with the distribution.
30       3. All advertising materials mentioning features or use of this
31          software must display the following acknowledgment:
32 
33             This product includes software developed by Greg Roelofs
34             and contributors for the book, "PNG: The Definitive Guide,"
35             published by O'Reilly and Associates.
36 
37 
38       LICENSE 2 (GNU GPL v2 or later):
39 
40       This program is free software; you can redistribute it and/or modify
41       it under the terms of the GNU General Public License as published by
42       the Free Software Foundation; either version 2 of the License, or
43       (at your option) any later version.
44 
45       This program is distributed in the hope that it will be useful,
46       but WITHOUT ANY WARRANTY; without even the implied warranty of
47       MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
48       GNU General Public License for more details.
49 
50       You should have received a copy of the GNU General Public License
51       along with this program; if not, write to the Free Software Foundation,
52       Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
53 
54   ---------------------------------------------------------------------------*/
55 
56 #ifndef TRUE
57 #  define TRUE 1
58 #  define FALSE 0
59 #endif
60 
61 #ifndef MAX
62 #  define MAX(a,b)  ((a) > (b)? (a) : (b))
63 #  define MIN(a,b)  ((a) < (b)? (a) : (b))
64 #endif
65 
66 #ifdef DEBUG
67 #  define Trace(x)  {fprintf x ; fflush(stderr); fflush(stdout);}
68 #else
69 #  define Trace(x)  ;
70 #endif
71 
72 enum rpng2_states {
73     kPreInit = 0,
74     kWindowInit,
75     kDone
76 };
77 
78 typedef unsigned char   uch;
79 typedef unsigned short  ush;
80 typedef unsigned long   ulg;
81 
82 typedef struct _mainprog_info {
83     double display_exponent;
84     ulg width;
85     ulg height;
86     void *png_ptr;
87     void *info_ptr;
88     void (*mainprog_init)(void);
89     void (*mainprog_display_row)(ulg row_num);
90     void (*mainprog_finish_display)(void);
91     uch *image_data;
92     uch **row_pointers;
93     jmp_buf jmpbuf;
94     int passes;              /* not used */
95     int pass;
96     int rowbytes;
97     int channels;
98     int need_bgcolor;
99     int state;
100     uch bg_red;
101     uch bg_green;
102     uch bg_blue;
103 } mainprog_info;
104 
105 
106 /* prototypes for public functions in readpng2.c */
107 
108 void readpng2_version_info(void);
109 
110 int readpng2_check_sig(uch *sig, int num);
111 
112 int readpng2_init(mainprog_info *mainprog_ptr);
113 
114 int readpng2_decode_data(mainprog_info *mainprog_ptr, uch *rawbuf, ulg length);
115 
116 void readpng2_cleanup(mainprog_info *mainprog_ptr);
117