libmng_trace.h

奇趣公司比较新的qt/emd版本

/* ************************************************************************** */
/* *             For conditions of distribution and use,                    * */
/* *                see copyright notice in libmng.h                        * */
/* ************************************************************************** */
/* *                                                                        * */
/* * project   : libmng                                                     * */
/* * file      : libmng_trace.h            copyright (c) 2000-2004 G.Juyn   * */
/* * version   : 1.0.9                                                      * */
/* *                                                                        * */
/* * purpose   : Trace functions (definition)                               * */
/* *                                                                        * */
/* * author    : G.Juyn                                                     * */
/* *                                                                        * */
/* * comment   : Definition of the trace functions                          * */
/* *                                                                        * */
/* * changes   : 0.5.1 - 05/08/2000 - G.Juyn                                * */
/* *             - added chunk-access function trace-codes                  * */
/* *             - changed strict-ANSI stuff                                * */
/* *             0.5.1 - 05/12/2000 - G.Juyn                                * */
/* *             - changed trace to macro for callback error-reporting      * */
/* *             0.5.1 - 05/13/2000 - G.Juyn                                * */
/* *             - added save_state & restore_state trace-codes             * */
/* *             0.5.1 - 05/15/2000 - G.Juyn                                * */
/* *             - added getimgdata & putimgdata trace-codes                * */
/* *                                                                        * */
/* *             0.5.2 - 05/20/2000 - G.Juyn                                * */
/* *             - added JNG tracecodes                                     * */
/* *             0.5.2 - 05/23/2000 - G.Juyn                                * */
/* *             - added trace-table entry definition                       * */
/* *             0.5.2 - 05/24/2000 - G.Juyn                                * */
/* *             - added tracecodes for global animation color-chunks       * */
/* *             - added tracecodes for get/set of default ZLIB/IJG parms   * */
/* *             - added tracecodes for global PLTE,tRNS,bKGD               * */
/* *             0.5.2 - 05/30/2000 - G.Juyn                                * */
/* *             - added tracecodes for image-object promotion              * */
/* *             - added tracecodes for delta-image processing              * */
/* *             0.5.2 - 06/02/2000 - G.Juyn                                * */
/* *             - added tracecodes for getalphaline callback               * */
/* *             0.5.2 - 06/05/2000 - G.Juyn                                * */
/* *             - added tracecode for RGB8_A8 canvasstyle                  * */
/* *             0.5.2 - 06/06/2000 - G.Juyn                                * */
/* *             - added tracecode for mng_read_resume HLAPI function       * */
/* *                                                                        * */
/* *             0.5.3 - 06/06/2000 - G.Juyn                                * */
/* *             - added tracecodes for tracing JPEG progression            * */
/* *             0.5.3 - 06/21/2000 - G.Juyn                                * */
/* *             - added tracecodes for get/set speedtype                   * */
/* *             - added tracecodes for get imagelevel                      * */
/* *             0.5.3 - 06/22/2000 - G.Juyn                                * */
/* *             - added tracecode for delta-image processing               * */
/* *             - added tracecodes for PPLT chunk processing               * */
/* *                                                                        * */
/* *             0.9.1 - 07/07/2000 - G.Juyn                                * */
/* *             - added tracecodes for special display processing          * */
/* *             0.9.1 - 07/08/2000 - G.Juyn                                * */
/* *             - added tracecode for get/set suspensionmode               * */
/* *             - added tracecodes for get/set display variables           * */
/* *             - added tracecode for read_databuffer (I/O-suspension)     * */
/* *             0.9.1 - 07/15/2000 - G.Juyn                                * */
/* *             - added tracecodes for SAVE/SEEK callbacks                 * */
/* *             - added tracecodes for get/set sectionbreaks               * */
/* *             - added tracecode for special error routine                * */
/* *             0.9.1 - 07/19/2000 - G.Juyn                                * */
/* *             - added tracecode for updatemngheader                      * */
/* *                                                                        * */
/* *             0.9.2 - 07/31/2000 - G.Juyn                                * */
/* *             - added tracecodes for status_xxxxx functions              * */
/* *             0.9.2 - 08/05/2000 - G.Juyn                                * */
/* *             - changed file-prefixes                                    * */
/* *             - added tracecode for updatemngsimplicity                  * */
/* *                                                                        * */
/* *             0.9.3 - 08/26/2000 - G.Juyn                                * */
/* *             - added MAGN chunk                                         * */
/* *             0.9.3 - 09/07/2000 - G.Juyn                                * */
/* *             - added support for new filter_types                       * */
/* *             0.9.3 - 10/10/2000 - G.Juyn                                * */
/* *             - added support for alpha-depth prediction                 * */
/* *             0.9.3 - 10/11/2000 - G.Juyn                                * */
/* *             - added JDAA chunk                                         * */
/* *             - added support for nEED                                   * */
/* *             0.9.3 - 10/16/2000 - G.Juyn                                * */
/* *             - added functions to retrieve PNG/JNG specific header-info * */
/* *             - added optional support for bKGD for PNG images           * */
/* *             0.9.3 - 10/17/2000 - G.Juyn                                * */
/* *             - added callback to process non-critical unknown chunks    * */
/* *             - added routine to discard "invalid" objects               * */
/* *             0.9.3 - 10/19/2000 - G.Juyn                                * */
/* *             - implemented delayed delta-processing                     * */
/* *             0.9.3 - 10/20/2000 - G.Juyn                                * */
/* *             - added get/set for bKGD preference setting                * */
/* *             0.9.3 - 10/21/2000 - G.Juyn                                * */
/* *             - added get function for interlace/progressive display     * */
/* *                                                                        * */
/* *             0.9.4 -  1/18/2001 - G.Juyn                                * */
/* *             - added "new" MAGN methods 3, 4 & 5                        * */
/* *                                                                        * */
/* *             1.0.1 - 02/08/2001 - G.Juyn                                * */
/* *             - added MEND processing callback                           * */
/* *             1.0.1 - 04/21/2001 - G.Juyn (code by G.Kelly)              * */
/* *             - added BGRA8 canvas with premultiplied alpha              * */
/* *             1.0.1 - 05/02/2001 - G.Juyn                                * */
/* *             - added "default" sRGB generation (Thanks Marti!)          * */
/* *                                                                        * */
/* *             1.0.2 - 06/23/2001 - G.Juyn                                * */
/* *             - added optimization option for MNG-video playback         * */
/* *             - added processterm callback                               * */
/* *             1.0.2 - 06/25/2001 - G.Juyn                                * */
/* *             - added option to turn off progressive refresh             * */
/* *                                                                        * */
/* *             1.0.3 - 08/06/2001 - G.Juyn                                * */
/* *             - added get function for last processed BACK chunk         * */
/* *                                                                        * */
/* *             1.0.5 - 08/15/2002 - G.Juyn                                * */
/* *             - completed PROM support                                   * */
/* *             - completed delta-image support                            * */
/* *             1.0.5 - 08/19/2002 - G.Juyn                                * */
/* *             - B597134 - libmng pollutes the linker namespace           * */
/* *             - added HLAPI function to copy chunks                      * */
/* *             1.0.5 - 09/14/2002 - G.Juyn                                * */
/* *             - added event handling for dynamic MNG                     * */
/* *             1.0.5 - 09/20/2002 - G.Juyn                                * */
/* *             - added support for PAST                                   * */
/* *             1.0.5 - 09/22/2002 - G.Juyn                                * */
/* *             - added bgrx8 canvas (filler byte)                         * */
/* *             1.0.5 - 09/23/2002 - G.Juyn                                * */
/* *             - added in-memory color-correction of abstract images      * */
/* *             - added compose over/under routines for PAST processing    * */
/* *             - added flip & tile routines for PAST processing           * */
/* *             1.0.5 - 10/09/2002 - G.Juyn                                * */
/* *             - fixed trace-constants for PAST chunk                     * */
/* *             1.0.5 - 11/07/2002 - G.Juyn                                * */
/* *             - added support to get totals after mng_read()             * */
/* *                                                                        * */
/* *             1.0.6 - 07/14/2003 - G.Randers-Pehrson                     * */
/* *             - added conditionals around rarely used features           * */
/* *                                                                        * */
/* *             1.0.7 - 11/27/2003 - R.A                                   * */
/* *             - added CANVAS_RGB565 and CANVAS_BGR565                    * */
/* *             1.0.7 - 01/25/2004 - J.S                                   * */
/* *             - added premultiplied alpha canvas' for RGBA, ARGB, ABGR   * */
/* *             1.0.7 - 03/10/2004 - G.R-P                                 * */
/* *             - added conditionals around openstream/closestream         * */
/* *                                                                        * */
/* *             1.0.8 - 04/02/2004 - G.Juyn                                * */
/* *             - added CRC existence & checking flags                     * */
/* *             1.0.8 - 04/11/2004 - G.Juyn                                * */
/* *             - added data-push mechanisms for specialized decoders      * */
/* *                                                                        * */
/* *             1.0.9 - 10/03/2004 - G.Juyn                                * */
/* *             - added function to retrieve current FRAM delay            * */
/* *             1.0.9 - 10/14/2004 - G.Juyn                                * */
/* *             - added bgr565_a8 canvas-style (thanks to J. Elvander)     * */
/* *                                                                        * */
/* ************************************************************************** */

#if defined(__BORLANDC__) && defined(MNG_STRICT_ANSI)
#pragma option -A                      /* force ANSI-C */
#endif

#ifndef _libmng_trace_h_
#define _libmng_trace_h_

/* ************************************************************************** */

#ifdef MNG_INCLUDE_TRACE_PROCS

/* ************************************************************************** */

/* TODO: add a trace-mask so certain functions can be excluded */

mng_retcode mng_trace (mng_datap  pData,
                       mng_uint32 iFunction,
                       mng_uint32 iLocation);

/* ************************************************************************** */

#define MNG_TRACE(D,F,L)  { mng_retcode iR = mng_trace (D,F,L); \
                            if (iR) return iR; }

#define MNG_TRACEB(D,F,L) { if (mng_trace (D,F,L)) return MNG_FALSE; }

#define MNG_TRACEX(D,F,L) { if (mng_trace (D,F,L)) return 0; }

/* ************************************************************************** */

#define MNG_LC_START                    1
#define MNG_LC_END                      2
#define MNG_LC_INITIALIZE               3
#define MNG_LC_CLEANUP                  4

/* ************************************************************************** */

#define MNG_LC_JPEG_CREATE_DECOMPRESS   101
#define MNG_LC_JPEG_READ_HEADER         102
#define MNG_LC_JPEG_START_DECOMPRESS    103
#define MNG_LC_JPEG_START_OUTPUT        104
#define MNG_LC_JPEG_READ_SCANLINES      105
#define MNG_LC_JPEG_FINISH_OUTPUT       106
#define MNG_LC_JPEG_FINISH_DECOMPRESS   107
#define MNG_LC_JPEG_DESTROY_DECOMPRESS  108

/* ************************************************************************** */

#define MNG_FN_INITIALIZE               1
#define MNG_FN_RESET                    2
#define MNG_FN_CLEANUP                  3
#define MNG_FN_READ                     4
#define MNG_FN_WRITE                    5
#define MNG_FN_CREATE                   6
#define MNG_FN_READDISPLAY              7
#define MNG_FN_DISPLAY                  8
#define MNG_FN_DISPLAY_RESUME           9
#define MNG_FN_DISPLAY_FREEZE          10
#define MNG_FN_DISPLAY_RESET           11
#ifndef MNG_NO_DISPLAY_GO_SUPPORTED
#define MNG_FN_DISPLAY_GOFRAME         12
#define MNG_FN_DISPLAY_GOLAYER         13
#define MNG_FN_DISPLAY_GOTIME          14
#endif
#define MNG_FN_GETLASTERROR            15
#define MNG_FN_READ_RESUME             16
#define MNG_FN_TRAPEVENT               17
#define MNG_FN_READ_PUSHDATA           18
#define MNG_FN_READ_PUSHSIG            19
#define MNG_FN_READ_PUSHCHUNK          20

#define MNG_FN_SETCB_MEMALLOC         101
#define MNG_FN_SETCB_MEMFREE          102
#define MNG_FN_SETCB_READDATA         103
#define MNG_FN_SETCB_WRITEDATA        104
#define MNG_FN_SETCB_ERRORPROC        105
#define MNG_FN_SETCB_TRACEPROC        106
#define MNG_FN_SETCB_PROCESSHEADER    107
#define MNG_FN_SETCB_PROCESSTEXT      108
#define MNG_FN_SETCB_GETCANVASLINE    109
#define MNG_FN_SETCB_GETBKGDLINE      110
#define MNG_FN_SETCB_REFRESH          111
#define MNG_FN_SETCB_GETTICKCOUNT     112
#define MNG_FN_SETCB_SETTIMER         113
#define MNG_FN_SETCB_PROCESSGAMMA     114
#define MNG_FN_SETCB_PROCESSCHROMA    115
#define MNG_FN_SETCB_PROCESSSRGB      116
#define MNG_FN_SETCB_PROCESSICCP      117
#define MNG_FN_SETCB_PROCESSAROW      118
#ifndef MNG_NO_OPEN_CLOSE_STREAM
#define MNG_FN_SETCB_OPENSTREAM       119
#define MNG_FN_SETCB_CLOSESTREAM      120
#endif
#define MNG_FN_SETCB_GETALPHALINE     121
#define MNG_FN_SETCB_PROCESSSAVE      122
#define MNG_FN_SETCB_PROCESSSEEK      123
#define MNG_FN_SETCB_PROCESSNEED      124
#define MNG_FN_SETCB_PROCESSUNKNOWN   125
#define MNG_FN_SETCB_PROCESSMEND      126
#define MNG_FN_SETCB_PROCESSTERM      127
#define MNG_FN_SETCB_RELEASEDATA      128

#define MNG_FN_GETCB_MEMALLOC         201
#define MNG_FN_GETCB_MEMFREE          202
#define MNG_FN_GETCB_READDATA         203
#define MNG_FN_GETCB_WRITEDATA        204
#define MNG_FN_GETCB_ERRORPROC        205
#define MNG_FN_GETCB_TRACEPROC        206
#define MNG_FN_GETCB_PROCESSHEADER    207
#define MNG_FN_GETCB_PROCESSTEXT      208
#define MNG_FN_GETCB_GETCANVASLINE    209
#define MNG_FN_GETCB_GETBKGDLINE      210
#define MNG_FN_GETCB_REFRESH          211
#define MNG_FN_GETCB_GETTICKCOUNT     212
#define MNG_FN_GETCB_SETTIMER         213
#define MNG_FN_GETCB_PROCESSGAMMA     214
#define MNG_FN_GETCB_PROCESSCHROMA    215
#define MNG_FN_GETCB_PROCESSSRGB      216
#define MNG_FN_GETCB_PROCESSICCP      217
#define MNG_FN_GETCB_PROCESSAROW      218
#ifndef MNG_NO_OPEN_CLOSE_STREAM
#define MNG_FN_GETCB_OPENSTREAM       219
#define MNG_FN_GETCB_CLOSESTREAM      220
#endif
#define MNG_FN_GETCB_GETALPHALINE     221
#define MNG_FN_GETCB_PROCESSSAVE      222
#define MNG_FN_GETCB_PROCESSSEEK      223
#define MNG_FN_GETCB_PROCESSNEED      224
#define MNG_FN_GETCB_PROCESSUNKNOWN   225
#define MNG_FN_GETCB_PROCESSMEND      226
#define MNG_FN_GETCB_PROCESSTERM      227
#define MNG_FN_GETCB_RELEASEDATA      228

#define MNG_FN_SET_USERDATA           301
#define MNG_FN_SET_CANVASSTYLE        302
#define MNG_FN_SET_BKGDSTYLE          303
#define MNG_FN_SET_BGCOLOR            304