share/png/contrib/gregbook/readpng2.h

   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);