git.saurik.com Git - wxWidgets.git/blame_incremental

... / ...

Commit	Line	Data
	1	/////////////////////////////////////////////////////////////////////////////
	2	// Name: gifdecod.h
	3	// Purpose: wxGIFDecoder, GIF reader for wxImage and wxAnimation
	4	// Author: Guillermo Rodriguez Garcia <guille@iies.es>
	5	// Version: 3.02
	6	// CVS-ID: $Id$
	7	// Copyright: (c) 1999 Guillermo Rodriguez Garcia
	8	// Licence: wxWindows licence
	9	/////////////////////////////////////////////////////////////////////////////
	10
	11	#ifndef _WX_GIFDECOD_H
	12	#define _WX_GIFDECOD_H
	13
	14	#ifdef __GNUG__
	15	#pragma interface "gifdecod.h"
	16	#endif
	17
	18	#include "wx/setup.h"
	19
	20	#if wxUSE_STREAMS && wxUSE_GIF
	21
	22	#include "wx/stream.h"
	23	#include "wx/image.h"
	24
	25
	26	// --------------------------------------------------------------------------
	27	// Constants
	28	// --------------------------------------------------------------------------
	29
	30	// Error codes:
	31	// Note that the error code wxGIF_TRUNCATED means that the image itself
	32	// is most probably OK, but the decoder didn't reach the end of the data
	33	// stream; this means that if it was not reading directly from file,
	34	// the stream will not be correctly positioned. the
	35	//
	36	enum
	37	{
	38	wxGIF_OK = 0, /* everything was OK */
	39	wxGIF_INVFORMAT, /* error in gif header */
	40	wxGIF_MEMERR, /* error allocating memory */
	41	wxGIF_TRUNCATED /* file appears to be truncated */
	42	};
	43
	44	// Disposal method
	45	// Experimental; subject to change.
	46	//
	47	enum
	48	{
	49	wxGIF_D_UNSPECIFIED = -1, /* not specified */
	50	wxGIF_D_DONOTDISPOSE = 0, /* do not dispose */
	51	wxGIF_D_TOBACKGROUND = 1, /* restore to background colour */
	52	wxGIF_D_TOPREVIOUS = 2 /* restore to previous image */
	53	};
	54
	55
	56	#define MAX_BLOCK_SIZE 256 /* max. block size */
	57
	58
	59	// --------------------------------------------------------------------------
	60	// wxGIFDecoder class
	61	// --------------------------------------------------------------------------
	62
	63	// internal class for storing GIF image data
	64	class GIFImage
	65	{
	66	public:
	67	// def ctor
	68	GIFImage();
	69
	70	unsigned int w; /* width */
	71	unsigned int h; /* height */
	72	unsigned int left; /* x coord (in logical screen) */
	73	unsigned int top; /* y coord (in logical screen) */
	74	int transparent; /* transparent color (-1 = none) */
	75	int disposal; /* disposal method (-1 = unspecified) */
	76	long delay; /* delay in ms (-1 = unused) */
	77	unsigned char p; / bitmap */
	78	unsigned char pal; / palette */
	79	GIFImage next; / next image */
	80	GIFImage prev; / prev image */
	81	};
	82
	83
	84	class WXDLLEXPORT wxGIFDecoder
	85	{
	86	private:
	87	// logical screen
	88	unsigned int m_screenw; /* logical screen width */
	89	unsigned int m_screenh; /* logical screen height */
	90	int m_background; /* background color (-1 = none) */
	91
	92	// image data
	93	bool m_anim; /* animated GIF */
	94	int m_nimages; /* number of images */
	95	int m_image; /* current image */
	96	GIFImage m_pimage; / pointer to current image */
	97	GIFImage m_pfirst; / pointer to first image */
	98	GIFImage m_plast; / pointer to last image */
	99
	100	// decoder state vars
	101	int m_restbits; /* remaining valid bits */
	102	unsigned int m_restbyte; /* remaining bytes in this block */
	103	unsigned int m_lastbyte; /* last byte read */
	104	unsigned char m_buffer[MAX_BLOCK_SIZE]; /* buffer for reading */
	105	unsigned char m_bufp; / pointer to next byte in buffer */
	106
	107	// input stream
	108	wxInputStream m_f; / input stream */
	109
	110	private:
	111	int getcode(int bits, int abfin);
	112	int dgif(GIFImage *img, int interl, int bits);
	113
	114	public:
	115	// get data of current frame
	116	int GetFrameIndex() const;
	117	unsigned char* GetData() const;
	118	unsigned char* GetPalette() const;
	119	unsigned int GetWidth() const;
	120	unsigned int GetHeight() const;
	121	unsigned int GetLeft() const;
	122	unsigned int GetTop() const;
	123	int GetDisposalMethod() const;
	124	int GetTransparentColour() const;
	125	long GetDelay() const;
	126
	127	// get global data
	128	unsigned int GetLogicalScreenWidth() const;
	129	unsigned int GetLogicalScreenHeight() const;
	130	int GetBackgroundColour() const;
	131	int GetNumberOfFrames() const;
	132	bool IsAnimation() const;
	133
	134	// move through the animation
	135	bool GoFirstFrame();
	136	bool GoLastFrame();
	137	bool GoNextFrame(bool cyclic = FALSE);
	138	bool GoPrevFrame(bool cyclic = FALSE);
	139	bool GoFrame(int which);
	140
	141	public:
	142	// constructor, destructor, etc.
	143	wxGIFDecoder(wxInputStream *s, bool anim = FALSE);
	144	~wxGIFDecoder();
	145	bool CanRead();
	146	int ReadGIF();
	147	void Destroy();
	148
	149	// convert current frame to wxImage
	150	bool ConvertToImage(wxImage *image) const;
	151	};
	152
	153
	154	#endif // wxUSE_STREAM && wxUSE_GIF
	155	#endif // _WX_GIFDECOD_H
	156