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
 72enum rpng2_states {
 73    kPreInit = 0,
 74    kWindowInit,
 75    kDone
 76};
 77
 78typedef unsigned char   uch;
 79typedef unsigned short  ush;
 80typedef unsigned long   ulg;
 81
 82typedef 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
108void readpng2_version_info(void);
109
110int readpng2_check_sig(uch *sig, int num);
111
112int readpng2_init(mainprog_info *mainprog_ptr);
113
114int readpng2_decode_data(mainprog_info *mainprog_ptr, uch *rawbuf, ulg length);
115
116void readpng2_cleanup(mainprog_info *mainprog_ptr);