(no commit message)

[grpapi.git] / grpapi / grpapi_no-lib.h

/*\r
\r
  ShadowFlare GRP Library. (c) ShadowFlare Software 2002\r
\r
  Any comments or suggestions are accepted at blakflare@hotmail.com (ShadowFlare)\r
*/\r
\r
#ifndef GRPAPI_INCLUDED\r
#define GRPAPI_INCLUDED\r
\r
#include <windows.h>\r
\r
#ifdef GRPAPI_EXPORTS\r
#define GRPAPI __declspec(dllexport)\r
#else\r
#define GRPAPI __declspec(dllimport)\r
#endif\r
\r
#ifdef __cplusplus\r
extern "C" {\r
#endif\r
\r
// These no longer need to be called\r
extern void LoadGrpApiLib();\r
extern void FreeGrpApiLib();\r
\r
typedef struct {\r
	WORD nFrames;\r
	WORD wMaxWidth;\r
	WORD wMaxHeight;\r
} GRPHEADER;\r
\r
#define HORIZONTAL_FLIP 0x00000001 // Flips the graphic horizontally\r
#define VERTICAL_FLIP   0x00000002 // Flips the graphic vertically\r
#define SHADOW_COLOR    0x00000004 // Causes the graphic to be drawn in one color\r
                                   // Second byte of flags is the red component of\r
                                   // the shadow's color, third byte is green,\r
                                   // fourth byte is blue; like this:\r
                                   // SHADOW_COLOR|0xBBGGRR00\r
                                   // This can be accomplished by using the left shift\r
                                   // operator like this:  SHADOW_COLOR|(color << 8)\r
#define ALPHA_BLEND     0x00000008 // Blends the graphic with what it is being drawn over.\r
                                   // The dwAlpha parameter will only be used when this\r
                                   // flag is specified.  dwAlpha is an RGB value\r
                                   // (0xBBGGRR).\r
                                   // Note: Because of the extra calculations required,\r
                                   // alpha blended graphics take longer to draw\r
#define USE_INDEX       0x00000010 // Only valid when used with a custom SetPixel function.\r
                                   // This flag cannot be used in combination with\r
                                   // ALPHA_BLEND or SHADOW_COLOR\r
                                   // When this flag is used, the index to a color in the\r
                                   // palette will be passed to your custom SetPixel\r
                                   // function instead of the actual color.\r
\r
// Palette is an array of 256 DWORD's\r
// For LoadPalette and LoadGrp, lpFileName may be a file in an open mpq archive\r
// or a file not in an archive\r
typedef BOOL   (WINAPI* funcLoadPalette)(LPCSTR lpFileName, DWORD *dwPaletteBuffer);\r
typedef HANDLE (WINAPI* funcLoadGrp)(LPCSTR lpFileName);\r
typedef BOOL   (WINAPI* funcDestroyGrp)(HANDLE hGrp);\r
typedef BOOL   (WINAPI* funcDrawGrp)(HANDLE hGrp, HDC hdcDest, int nXDest, int nYDest, WORD nFrame, DWORD *dwPalette, DWORD dwFlags, DWORD dwAlpha);\r
typedef BOOL   (WINAPI* funcGetGrpInfo)(HANDLE hGrp, GRPHEADER *GrpInfo);\r
extern funcLoadPalette LoadPalette;\r
extern funcLoadGrp LoadGrp;\r
extern funcDestroyGrp DestroyGrp;\r
extern funcDrawGrp DrawGrp;\r
extern funcGetGrpInfo GetGrpInfo;\r
\r
typedef COLORREF (WINAPI* GETPIXELPROC)(\r
  HDC hDC, // same value as hdcDest from DrawGrp,\r
	       // does not need to be used as an HDC,\r
	       // can be used for any other type of pointer\r
  int X,   // x-coordinate of pixel\r
  int Y    // y-coordinate of pixel\r
);\r
typedef void (WINAPI* SETPIXELPROC)(\r
	HDC hDC,          // same value as hdcDest from DrawGrp,\r
	                  // does not need to be used as an HDC,\r
	                  // can be used for any other type of pointer\r
	int X,            // x-coordinate of pixel\r
	int Y,            // y-coordinate of pixel\r
	COLORREF clrColor // new pixel color\r
);\r
\r
// Call these to have DrawGrp use custom functions for reading and drawing pixels\r
// so that you can have it read from and write to a buffer, for example.\r
typedef void (WINAPI* funcSetFunctionGetPixel)(GETPIXELPROC lpGetPixelProc);\r
typedef void (WINAPI* funcSetFunctionSetPixel)(SETPIXELPROC lpSetPixelProc);\r
extern funcSetFunctionGetPixel SetFunctionGetPixel; // Only used with ALPHA_BLEND\r
extern funcSetFunctionSetPixel SetFunctionSetPixel;\r
\r
// Call this to make a different Storm.dll-compatible MPQ library be used (like SFMPQ).\r
typedef BOOL (WINAPI* funcSetMpqDll)(LPCSTR lpDllFileName);\r
extern funcSetMpqDll SetMpqDll;\r
\r
// These no longer need to be called\r
typedef BOOL   (WINAPI* funcLoadGrpApi)();\r
typedef void   (WINAPI* funcFreeGrpApi)();\r
extern funcLoadGrpApi LoadGrpApi;\r
extern funcFreeGrpApi FreeGrpApi;\r
\r
#ifdef __cplusplus\r
};  // extern "C" \r
#endif\r
\r
#endif\r
\r