mirror of
https://github.com/Mauler125/r5sdk.git
synced 2025-02-09 19:15:03 +01:00
b3a68ed095
DirtySDK (EA's Dirty Sockets library) will be used for the LiveAPI implementation, and depends on: EABase, EAThread.
98 lines
3.8 KiB
C
98 lines
3.8 KiB
C
/*H********************************************************************************/
|
|
/*!
|
|
\File dirtygif.h
|
|
|
|
\Description
|
|
Routines to parse and decode a GIF file.
|
|
|
|
\Copyright
|
|
Copyright (c) 2003-2020 Electronic Arts Inc.
|
|
|
|
\Version 11/13/2003 (jbrookes) First Version
|
|
\Version 01/28/2020 (jbrookes) Added multiframe (animated) support
|
|
*/
|
|
/********************************************************************************H*/
|
|
|
|
#ifndef _dirtygif_h
|
|
#define _dirtygif_h
|
|
|
|
/*!
|
|
\Moduledef DirtyGif DirtyGif
|
|
\Modulemember Graph
|
|
*/
|
|
//@{
|
|
|
|
/*** Include files ****************************************************************/
|
|
|
|
#include "DirtySDK/platform.h"
|
|
|
|
/*** Defines **********************************************************************/
|
|
|
|
/*** Macros ***********************************************************************/
|
|
|
|
/*** Type Definitions *************************************************************/
|
|
|
|
//! structure to represent a parsed gif/gif frame
|
|
typedef struct DirtyGifHdrT
|
|
{
|
|
// image info
|
|
const uint8_t *pImageData; //!< pointer to start of gif bits
|
|
const uint8_t *pImageEnd; //!< pointer to end of gif bits
|
|
const uint8_t *pColorTable; //!< pointer to gif color table
|
|
|
|
uint32_t uNumFrames; //!< number of image frames
|
|
|
|
uint16_t uTop; //!< top offset of image frame
|
|
uint16_t uLeft; //!< left offset of image frame
|
|
uint16_t uWidth; //!< image width
|
|
uint16_t uHeight; //!< image height
|
|
uint16_t uNumColors; //!< number of color table entries
|
|
uint16_t uDelay; //!< time delay after displaying current frame before moving to next in 1/100ths of a second
|
|
|
|
// misc info
|
|
uint8_t bInterlaced; //!< flag indicating an interlaced image
|
|
uint8_t bHasAlpha; //!< flag indicating transparent color present
|
|
uint8_t uTransColor; //!< which color index is transparent
|
|
uint8_t pad;
|
|
} DirtyGifHdrT;
|
|
|
|
/*** Variables ********************************************************************/
|
|
|
|
/*** Functions ********************************************************************/
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
// identify if image is a gif or not
|
|
DIRTYCODE_API int32_t DirtyGifIdentify(const uint8_t *pImageData, uint32_t uImageLen);
|
|
|
|
// parse GIF into something we can use
|
|
DIRTYCODE_API int32_t DirtyGifParse(DirtyGifHdrT *pGifHdr, const uint8_t *pGifData, const uint8_t *pGifEnd);
|
|
|
|
// parse GIF with extended info
|
|
DIRTYCODE_API int32_t DirtyGifParseEx(DirtyGifHdrT *pGifHdr, const uint8_t *pGifData, const uint8_t *pGifEnd, DirtyGifHdrT *pFrames, uint32_t uNumFrames);
|
|
|
|
// decode a GIF palette to 32bit color table
|
|
DIRTYCODE_API int32_t DirtyGifDecodePalette(DirtyGifHdrT *pGifHdr, uint8_t *pPalette, uint8_t *pPaletteEnd, uint8_t uAlpha);
|
|
|
|
// decode a GIF image to 8bit paletted image
|
|
DIRTYCODE_API int32_t DirtyGifDecodeImage(DirtyGifHdrT *pGifHdr, uint8_t *pImageData, int32_t iBufWidth, int32_t iBufHeight, uint32_t bVflip);
|
|
|
|
// decode a GIF image to 32bit direct-color image
|
|
DIRTYCODE_API int32_t DirtyGifDecodeImage32(DirtyGifHdrT *pGifHdr, uint8_t *pImageData, int32_t iBufWidth, int32_t iBufHeight, uint32_t bVflip);
|
|
|
|
// decode a GIF image to one or more 32bit direct-color images
|
|
DIRTYCODE_API int32_t DirtyGifDecodeImage32Multi(DirtyGifHdrT *pGifHdr, DirtyGifHdrT *pFrameInfo, uint8_t *pImageData, int32_t iBufWidth, int32_t iBufHeight, int32_t iNumFrames, uint32_t bVflip);
|
|
|
|
// decode a specific frame of a GIF image into a single 32bit ARGB direct-color bitmap.
|
|
DIRTYCODE_API int32_t DirtyGifDecodeImage32Frame(DirtyGifHdrT *pGifHdr, DirtyGifHdrT *pFrameInfo, uint8_t *pImageData, uint8_t *p8BitImage, int32_t iBufWidth, int32_t iBufHeight, int32_t iFrame, int32_t iNumFrames, uint32_t bVflip);
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
|
|
//@}
|
|
|
|
#endif // _dirtygif_h
|