readme.txt

本解码器类支持GIF文件格式的89a版本

GIF文件解码器类使用说明
    本解码器类支持GIF文件格式的89a版本，可支持动画GIF文件！
本原代码未经严格测试，欢迎广大朋友批评指正。

1.使用授权
    本原代码文档包括下列文件：
    gif89a.cpp   解码器类原程序
    gif89a.h     解码器类头文件
    gif89a.doc   GIF文件格式说明
    lzw.doc      GIF文件所用压缩算法的说明
    readme.txt   自述文件
    gifinfo.exe  使用本原代码的例子程序
    gifinfo.cpp  例子程序原文件  
    如果您要在各种媒体刊载、引用本文档，请不要对本文档内容进行任何修改。如果您在自己的编程中
引用本文档内容，可对引用内容进行修改。在您引用本文档时如能注明出处，并通过下面方式通知本人一
下，本人将非常高兴！



2.GIF文件解码器类参考
    请参考GIF文件格式说明文件gif89a.doc

    (1)结构类型说明：
        typedef struct                //GIF文件的全局参数
        {    UINT frames;             //文件中图象帧数
             WORD scrWidth,scrHeight; //逻辑屏幕的宽度和高度（单位像素）
             BOOL gFlag;              //是否有全局调色板（决定其他调色板参数是否有效）
             UINT colorRes;           //色彩分辨率（不使用）
             BOOL gSort;              //全局调色板是否按优先排序
             UINT gSize;              //全局调色板大小（有多少个实际入口）
             UINT BKColorIdx;         //背景色的调色板索引
             UINT pixelAspectRatio;   //像素长宽比例
             BYTE *gColorTable;       //指向全局调色板的指针（256个入口，每个入口三字节）
                                      //调色板格式请参看gif89a.doc
        }GLOBAL_INFO;

        typedef struct                //一帧图象的参数
        {    WORD imageLPos;          //图象左边沿到逻辑屏幕的距离（单位像素）
             WORD imageTPos;          //图象上边沿到逻辑屏幕的距离（单位像素）
             WORD imageWidth;         //图象的宽度（单位像素）
             WORD imageHeight;        //图象的高度（单位像素）
             BOOL lFlag;              //是否有局部调色板（决定其他调色板参数是否有效）
             BOOL interlaceFlag;      //图象数据是否交错
             BOOL sortFlag;           //局部调色板数据是否按优先排序
             UINT lSize;              //局部调色板大小（有多少个实际入口）
             BYTE *pColorTable;       //指向局部调色板的指针（256个入口，每个入口三字节）
                                      //调色板格式请参看gif89a.doc
             BYTE *dataBuf;           //图象数据指针
             GCTRLEXT ctrlExt;        //图象扩展参数（与透明背景和动画有关）
        }FRAME;

        typedef struct                //图象扩展参数
        {    BOOL active;             //本结构中的其它参数是否可用
             UINT disposalMethod;     //处理方法（见gif89a.doc，可忽略）
             BOOL userInputFlag;      //是否期待用户输入
             BOOL trsFlag;            //是否有透明色
             WORD delayTime;          //延时时间（单位1/100秒）
             UINT trsColorIndex;      //透明色调色板索引
        }GCTRLEXT;

    （2）公有数据成员
        无！

    （3）私有数据成员
        ifstream ifs;                 //用于读文件的文件流
	char version[4];              //版本字符串
        BOOL error;                   //类实例变量创建时是否出错的标志
        BOOL opened;                  //是否处于打开状态
        BOOL inMem;                   //图象数据是否一次读入内存
        BYTE gColorTable[256*3];      //全局调色板
        BYTE lColorTable[256*3];      //局部调色板（inMem为假时用）
        streampos dataStart;          //保存文件流中图象数据开始的地方
        FRAME *allFrames;             //指向所有图象帧的指针（inMem为真时用）
        UINT curIndex;                //当前帧的索引（inMem为真时用）
        GLOBAL_INFO gInfo;            //GIF文件的全局参数
        FRAME curFrame;               //当前帧的参数（inMem为假时用）
        GCTRLEXT ctrlExt;             //图象扩展参数（读入数据时临时使用）

    （4）私有成员函数
        UINT CGif89a::checkFrames(ifstream& ifs)
        功能  ：检查文件中图象帧数。
        参数  ：ifs:对文件流的引用。
        返回值：文件中图象帧数。

        BOOL CGif89a::getAllFrames(ifstream& ifs)
        功能  ：将所有图象帧数据读入内存。
        参数  ：ifs:对文件流的引用。
        返回值：操作是否成功，为真成功，为假失败。

        BOOL CGif89a::extractData(FRAME* f,ifstream& ifs)
        功能  ：解压缩一帧图象数据。
        参数  ：f:指向用于保存图象数据的结构。
                ifs:对文件流的引用。
        返回值：操作是否成功，为真成功，为假失败。

        BOOL CGif89a::initStrTable(STRING_TABLE_ENTRY* strTable,UINT rootSize)
        功能  ：初始化字符串表。
        参数  ：strTable:指向字符串表的指针。
                rootSize:初始化的入口数。
        返回值：操作是否成功，为真成功，为假失败。

        BOOL CGif89a::addStrTable(STRING_TABLE_ENTRY* strTable,UINT addIdx,UINT idx,unsigned char c)
        功能  ：在字符串表中增加一项。
        参数  ：strTable:指向字符串表的指针。
                addIdx:增加的入口索引。
                idx:用于构造要增加的字符串的入口索引。
                c:用于构造要增加的字符串的字符。
        返回值：操作是否成功，为真成功，为假失败。

    （5）公有成员函数
        CGif89a::CGif89a()
        功  能：构造函数
        参  数：无
        返回值：无
        说  明：用于构造一个空的实例，以便以后用open()函数打开文件。

        CGif89a::CGif89a(LPCSTR fileName,BOOL inMem)
        功  能：构造函数
        参  数：fileName:要打开的文件名字符串
                inMem:是否将图象数据一次读入内存
        返回值：无
        说  明：内部调用open()函数，请参考open()函数。

        CGif89a::~CGif89a()
        功  能：析构函数
        参  数：无
        返回值：无
        说  明：内部调用close()函数进行清理工作。

        BOOL CGif89a::operator!()
        功  能：判断构造是否成功
        参  数：无
        返回值：为真则构造成功，为假则失败。
        说  明：在构造函数调用之后，一定要调用此函数确定构造是否成功。

        BOOL CGif89a::open(LPCSTR fileName,BOOL inMem)
        功  能：打开文件
        参  数：fileName:要打开的文件名字符串
                inMem:是否将图象数据一次读入内存
        返回值：为真则成功，为假则失败
        说  明：如果inMem为真，则将所有图象帧数据一次全部读入内存，然后关闭文件。此方式
                用于文件较小，需要读取数据较快的情况。此方式占用内存较多。
                如果inMem为假，则保持文件为打开状态，以后需要时由文件读入数据。此方式用
                于文件较大，对读取数据不要求很快的情况。此方式占用内存较少。
                使用其它函数前，应首先调用此函数。
                本函数对GIF文件完整性要求较为严格，对于从Internet上下载的GIF文件，如果未
                能完整下载，则打开将失败。

        void CGif89a::close()
        功  能：将状态有打开切换到关闭，以便打开新的文件
        参  数：无
        返回值：无
        说  明：关闭文件（inMem为假时），释放内存，可以再次用open()打开新的文件。

        LPCSTR CGif89a::getVer()
        功  能：读取版本字符串
        参  数：无
        返回值：指向版本字符串的指针
        说  明：无

        LPCFRAME CGif89a::getNextFrame()
        功  能：取得一帧图象
        参  数：无
        返回值：指向FRAME结构的指针，保存了图象数据，及参数,成功时返回非0值，失败时返回NULL。
        说  明：每次调用返回一帧新的数据，图象数据是已经解压的。当读取最后一帧数据后，再
                次调用此函数，返回第一帧的数据，如此循环。使用返回的数据时要注意各种参数，
                特别是数据是否交错。
                如果图象帧数大于1，循环调用此函数可得到动画GIF文件中的所有图象帧数据。
                一定要检查返回值是否有效！

        LPCGLOBAL_INFO CGif89a::getGlobalInfo()
        功  能：取得全局参数
        参  数：无
        返回值：指向GLOBAL_INFO结构的指针，保存了GIF文件的全局参数。
        说  明：无

3.gifinfo.exe使用说明
    功能：显示GIF文件全局参数和每一帧图象的参数
    用法：gifinfo GIF文件名
    说明：输出文字中有汉字，请在DOS窗口运行。如果文件中有多帧图象，显示内容可能看不全，可
          用下面格式将输出保存到文件，再打开文件观看。
          gifinfo GIF文件名 > tp.txt

“全文完”