libmng_pixels.h

Linux下的基于X11的图形开发环境。

/* ************************************************************************** */
/* *             For conditions of distribution and use,                    * */
/* *                see copyright notice in libmng.h                        * */
/* ************************************************************************** */
/* *                                                                        * */
/* * project   : libmng                                                     * */
/* * file      : libmng_pixels.h           copyright (c) 2000 G.Juyn        * */
/* * version   : 1.0.1                                                      * */
/* *                                                                        * */
/* * purpose   : Pixel-row management routines (definition)                 * */
/* *                                                                        * */
/* * author    : G.Juyn                                                     * */
/* * web       : http://www.3-t.com                                         * */
/* * email     : mailto:[e-mail]                                        * */
/* *                                                                        * */
/* * comment   : Definition of the pixel-row management routines            * */
/* *                                                                        * */
/* * changes   : 0.5.1 - 05/08/2000 - G.Juyn                                * */
/* *             - changed strict-ANSI stuff                                * */
/* *                                                                        * */
/* *             0.5.2 - 05/22/2000 - G.Juyn                                * */
/* *             - added some JNG definitions                               * */
/* *             - added delta-image row-processing routines                * */
/* *             0.5.2 - 06/05/2000 - G.Juyn                                * */
/* *             - added support for RGB8_A8 canvasstyle                    * */
/* *                                                                        * */
/* *             0.5.3 - 06/16/2000 - G.Juyn                                * */
/* *             - changed progressive-display processing                   * */
/* *                                                                        * */
/* *             0.9.2 - 08/05/2000 - G.Juyn                                * */
/* *             - changed file-prefixes                                    * */
/* *                                                                        * */
/* *             0.9.3 - 08/26/2000 - G.Juyn                                * */
/* *             - added MAGN support                                       * */
/* *             0.9.3 - 09/07/2000 - G.Juyn                                * */
/* *             - added support for new filter_types                       * */
/* *             0.9.3 - 10/16/2000 - G.Juyn                                * */
/* *             - added optional support for bKGD for PNG images           * */
/* *             - added support for JDAA                                   * */
/* *             0.9.3 - 10/19/2000 - G.Juyn                                * */
/* *             - implemented delayed delta-processing                     * */
/* *                                                                        * */
/* *             0.9.4 -  1/18/2001 - G.Juyn                                * */
/* *             - added "new" MAGN methods 3, 4 & 5                        * */
/* *                                                                        * */
/* *             1.0.1 - 04/21/2001 - G.Juyn (code by G.Kelly)              * */
/* *             - added BGRA8 canvas with premultiplied alpha              * */
/* *                                                                        * */
/* ************************************************************************** */

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

#ifndef _libmng_pixels_h_
#define _libmng_pixels_h_

/* ************************************************************************** */
/* *                                                                        * */
/* * Progressive display check - checks to see if progressive display is    * */
/* * in order & indicates so                                                * */
/* *                                                                        * */
/* * The routine is called after a call to one of the display_xxx routines  * */
/* * if appropriate                                                         * */
/* *                                                                        * */
/* * The refresh is warrented in the read_chunk routine (mng_read.c)        * */
/* * and only during read&display processing, since there's not much point  * */
/* * doing it from memory!                                                  * */
/* *                                                                        * */
/* ************************************************************************** */

mng_retcode display_progressive_check (mng_datap pData);

/* ************************************************************************** */
/* *                                                                        * */
/* * Display routines - convert rowdata (which is already color-corrected)  * */
/* * to the output canvas, respecting any transparency information          * */
/* *                                                                        * */
/* ************************************************************************** */

mng_retcode display_rgb8           (mng_datap  pData);
mng_retcode display_rgba8          (mng_datap  pData);
mng_retcode display_argb8          (mng_datap  pData);
mng_retcode display_rgb8_a8        (mng_datap  pData);
mng_retcode display_bgr8           (mng_datap  pData);
mng_retcode display_bgra8          (mng_datap  pData);
mng_retcode display_bgra8_pm       (mng_datap  pData);
mng_retcode display_abgr8          (mng_datap  pData);

/* ************************************************************************** */
/* *                                                                        * */
/* * Background restore routines - restore the background with info from    * */
/* * the BACK and/or bKGD chunk and/or the app's background canvas          * */
/* *                                                                        * */
/* ************************************************************************** */

mng_retcode restore_bkgd_backimage (mng_datap  pData);
mng_retcode restore_bkgd_backcolor (mng_datap  pData);
mng_retcode restore_bkgd_bkgd      (mng_datap  pData);
mng_retcode restore_bkgd_bgcolor   (mng_datap  pData);
mng_retcode restore_bkgd_rgb8      (mng_datap  pData);
mng_retcode restore_bkgd_bgr8      (mng_datap  pData);

/* ************************************************************************** */
/* *                                                                        * */
/* * Row retrieval routines - retrieve processed & uncompressed row-data    * */
/* * from the current "object"                                              * */
/* *                                                                        * */
/* ************************************************************************** */

mng_retcode retrieve_g8            (mng_datap  pData);
mng_retcode retrieve_g16           (mng_datap  pData);
mng_retcode retrieve_rgb8          (mng_datap  pData);
mng_retcode retrieve_rgb16         (mng_datap  pData);
mng_retcode retrieve_idx8          (mng_datap  pData);
mng_retcode retrieve_ga8           (mng_datap  pData);
mng_retcode retrieve_ga16          (mng_datap  pData);
mng_retcode retrieve_rgba8         (mng_datap  pData);
mng_retcode retrieve_rgba16        (mng_datap  pData);

/* ************************************************************************** */
/* *                                                                        * */
/* * Row storage routines - store processed & uncompressed row-data         * */
/* * into the current "object"                                              * */
/* *                                                                        * */
/* ************************************************************************** */

mng_retcode store_g1               (mng_datap  pData);
mng_retcode store_g2               (mng_datap  pData);
mng_retcode store_g4               (mng_datap  pData);
mng_retcode store_g8               (mng_datap  pData);
mng_retcode store_g16              (mng_datap  pData);
mng_retcode store_rgb8             (mng_datap  pData);
mng_retcode store_rgb16            (mng_datap  pData);
mng_retcode store_idx1             (mng_datap  pData);
mng_retcode store_idx2             (mng_datap  pData);
mng_retcode store_idx4             (mng_datap  pData);
mng_retcode store_idx8             (mng_datap  pData);
mng_retcode store_ga8              (mng_datap  pData);
mng_retcode store_ga16             (mng_datap  pData);
mng_retcode store_rgba8            (mng_datap  pData);
mng_retcode store_rgba16           (mng_datap  pData);

/* ************************************************************************** */
/* *                                                                        * */
/* * Row storage routines (JPEG) - store processed & uncompressed row-data  * */
/* * into the current "object"                                              * */
/* *                                                                        * */
/* ************************************************************************** */

mng_retcode store_jpeg_g8          (mng_datap  pData);
mng_retcode store_jpeg_rgb8        (mng_datap  pData);
mng_retcode store_jpeg_ga8         (mng_datap  pData);
mng_retcode store_jpeg_rgba8       (mng_datap  pData);

mng_retcode store_jpeg_g12         (mng_datap  pData);
mng_retcode store_jpeg_rgb12       (mng_datap  pData);
mng_retcode store_jpeg_ga12        (mng_datap  pData);
mng_retcode store_jpeg_rgba12      (mng_datap  pData);

mng_retcode store_jpeg_g8_alpha    (mng_datap  pData);
mng_retcode store_jpeg_rgb8_alpha  (mng_datap  pData);

mng_retcode store_jpeg_g8_a1       (mng_datap  pData);
mng_retcode store_jpeg_g8_a2       (mng_datap  pData);
mng_retcode store_jpeg_g8_a4       (mng_datap  pData);
mng_retcode store_jpeg_g8_a8       (mng_datap  pData);
mng_retcode store_jpeg_g8_a16      (mng_datap  pData);

mng_retcode store_jpeg_rgb8_a1     (mng_datap  pData);
mng_retcode store_jpeg_rgb8_a2     (mng_datap  pData);
mng_retcode store_jpeg_rgb8_a4     (mng_datap  pData);
mng_retcode store_jpeg_rgb8_a8     (mng_datap  pData);
mng_retcode store_jpeg_rgb8_a16    (mng_datap  pData);

mng_retcode store_jpeg_g12_a1      (mng_datap  pData);
mng_retcode store_jpeg_g12_a2      (mng_datap  pData);
mng_retcode store_jpeg_g12_a4      (mng_datap  pData);
mng_retcode store_jpeg_g12_a8      (mng_datap  pData);
mng_retcode store_jpeg_g12_a16     (mng_datap  pData);

mng_retcode store_jpeg_rgb12_a1    (mng_datap  pData);
mng_retcode store_jpeg_rgb12_a2    (mng_datap  pData);
mng_retcode store_jpeg_rgb12_a4    (mng_datap  pData);
mng_retcode store_jpeg_rgb12_a8    (mng_datap  pData);
mng_retcode store_jpeg_rgb12_a16   (mng_datap  pData);

/* ************************************************************************** */
/* *                                                                        * */
/* * Delta-image row routines - apply the processed & uncompressed row-data * */
/* * onto the target "object"                                               * */