Archived News
Search News Discussion Forum
Old Forum Install Programs More Downloads...
Troubleshooting Source Code
Format Specs.
Misc. Information
Non-SF Stuff
Links
Small banner for links to this site:
diff --git a/grpapi/grpapi_no-lib.h b/grpapi/grpapi_no-lib.h
--- a/grpapi/grpapi_no-lib.h
+++ b/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
-typedef BOOL (WINAPI* funcGetGrpFrameInfo)(HANDLE hGrp, WORD nFrame, DWORD *nLeft, DWORD *nTop, DWORD *nWidth, DWORD *nHeight);\r
-extern funcLoadPalette LoadPalette;\r
-extern funcLoadGrp LoadGrp;\r
-extern funcDestroyGrp DestroyGrp;\r
-extern funcDrawGrp DrawGrp;\r
-extern funcGetGrpInfo GetGrpInfo;\r
-extern funcGetGrpFrameInfo GetGrpFrameInfo;\r
-\r
-// A pointer to the raw image data to encode should be passed to lpImageData. The size of\r
-// the buffer containing the data should be nFrames * wMaxWidth * wMaxHeight * sizeof(short)\r
-// and the values should be arranged row by row of the frame, with the top row first.\r
-// After all the rows of a frame have been put into the buffer, the rows of the next frame\r
-// go after it. For transparent pixels, they should be set to -1. All other pixels should\r
-// have the high order byte set to zero, meaning that they should not be negative and the\r
-// values should not exceed 255 (0xFF). The values used for the colors are indexes into the\r
-// color palette.\r
-// Pass TRUE to bNoCompress if you need an uncompressed GRP.\r
-// Pass a pointer to a DWORD value to nGrpSize to receive the size in bytes of the resulting encoded GRP.\r
-// The return value of this function is actually a pointer to the GRP data. This is what your\r
-// program should save to a file. The size of this buffer is the value received by nGrpSize.\r
-// When your program is done with the returned buffer, it should call DestroyGrp on the\r
-// buffer that was returned by this function to free up the memory from it.\r
-// The pointer returned by this function can also be directly used by DrawGrp or GetGrpInfo.\r
-typedef HANDLE (WINAPI* funcCreateGrp)(signed short *lpImageData, WORD nFrames, WORD wMaxWidth, WORD wMaxHeight, BOOL bNoCompress, DWORD *nGrpSize);\r
-extern funcCreateGrp CreateGrp;\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
+/*
+
+ ShadowFlare GRP Library. (c) ShadowFlare Software 2002
+
+ Any comments or suggestions are accepted at blakflare@hotmail.com (ShadowFlare)
+*/
+
+#ifndef GRPAPI_INCLUDED
+#define GRPAPI_INCLUDED
+
+#include <windows.h>
+
+#ifdef GRPAPI_EXPORTS
+#define GRPAPI __declspec(dllexport)
+#else
+#define GRPAPI __declspec(dllimport)
+#endif
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+// These no longer need to be called
+extern void LoadGrpApiLib();
+extern void FreeGrpApiLib();
+
+typedef struct {
+ WORD nFrames;
+ WORD wMaxWidth;
+ WORD wMaxHeight;
+} GRPHEADER;
+
+#define HORIZONTAL_FLIP 0x00000001 // Flips the graphic horizontally
+#define VERTICAL_FLIP 0x00000002 // Flips the graphic vertically
+#define SHADOW_COLOR 0x00000004 // Causes the graphic to be drawn in one color
+ // Second byte of flags is the red component of
+ // the shadow's color, third byte is green,
+ // fourth byte is blue; like this:
+ // SHADOW_COLOR|0xBBGGRR00
+ // This can be accomplished by using the left shift
+ // operator like this: SHADOW_COLOR|(color << 8)
+#define ALPHA_BLEND 0x00000008 // Blends the graphic with what it is being drawn over.
+ // The dwAlpha parameter will only be used when this
+ // flag is specified. dwAlpha is an RGB value
+ // (0xBBGGRR).
+ // Note: Because of the extra calculations required,
+ // alpha blended graphics take longer to draw
+#define USE_INDEX 0x00000010 // Only valid when used with a custom SetPixel function.
+ // This flag cannot be used in combination with
+ // ALPHA_BLEND or SHADOW_COLOR
+ // When this flag is used, the index to a color in the
+ // palette will be passed to your custom SetPixel
+ // function instead of the actual color.
+
+// Palette is an array of 256 DWORD's
+// For LoadPalette and LoadGrp, lpFileName may be a file in an open mpq archive
+// or a file not in an archive
+typedef BOOL (WINAPI* funcLoadPalette)(LPCSTR lpFileName, DWORD *dwPaletteBuffer);
+typedef HANDLE (WINAPI* funcLoadGrp)(LPCSTR lpFileName);
+typedef BOOL (WINAPI* funcDestroyGrp)(HANDLE hGrp);
+typedef BOOL (WINAPI* funcDrawGrp)(HANDLE hGrp, HDC hdcDest, int nXDest, int nYDest, WORD nFrame, DWORD *dwPalette, DWORD dwFlags, DWORD dwAlpha);
+typedef BOOL (WINAPI* funcGetGrpInfo)(HANDLE hGrp, GRPHEADER *GrpInfo);
+typedef BOOL (WINAPI* funcGetGrpFrameInfo)(HANDLE hGrp, WORD nFrame, DWORD *nLeft, DWORD *nTop, DWORD *nWidth, DWORD *nHeight);
+extern funcLoadPalette LoadPalette;
+extern funcLoadGrp LoadGrp;
+extern funcDestroyGrp DestroyGrp;
+extern funcDrawGrp DrawGrp;
+extern funcGetGrpInfo GetGrpInfo;
+extern funcGetGrpFrameInfo GetGrpFrameInfo;
+
+// A pointer to the raw image data to encode should be passed to lpImageData. The size of
+// the buffer containing the data should be nFrames * wMaxWidth * wMaxHeight * sizeof(short)
+// and the values should be arranged row by row of the frame, with the top row first.
+// After all the rows of a frame have been put into the buffer, the rows of the next frame
+// go after it. For transparent pixels, they should be set to -1. All other pixels should
+// have the high order byte set to zero, meaning that they should not be negative and the
+// values should not exceed 255 (0xFF). The values used for the colors are indexes into the
+// color palette.
+// Pass TRUE to bNoCompress if you need an uncompressed GRP.
+// Pass a pointer to a DWORD value to nGrpSize to receive the size in bytes of the resulting encoded GRP.
+// The return value of this function is actually a pointer to the GRP data. This is what your
+// program should save to a file. The size of this buffer is the value received by nGrpSize.
+// When your program is done with the returned buffer, it should call DestroyGrp on the
+// buffer that was returned by this function to free up the memory from it.
+// The pointer returned by this function can also be directly used by DrawGrp or GetGrpInfo.
+typedef HANDLE (WINAPI* funcCreateGrp)(signed short *lpImageData, WORD nFrames, WORD wMaxWidth, WORD wMaxHeight, BOOL bNoCompress, DWORD *nGrpSize);
+extern funcCreateGrp CreateGrp;
+
+typedef COLORREF (WINAPI* GETPIXELPROC)(
+ HDC hDC, // same value as hdcDest from DrawGrp,
+ // does not need to be used as an HDC,
+ // can be used for any other type of pointer
+ int X, // x-coordinate of pixel
+ int Y // y-coordinate of pixel
+);
+typedef void (WINAPI* SETPIXELPROC)(
+ HDC hDC, // same value as hdcDest from DrawGrp,
+ // does not need to be used as an HDC,
+ // can be used for any other type of pointer
+ int X, // x-coordinate of pixel
+ int Y, // y-coordinate of pixel
+ COLORREF clrColor // new pixel color
+);
+
+// Call these to have DrawGrp use custom functions for reading and drawing pixels
+// so that you can have it read from and write to a buffer, for example.
+typedef void (WINAPI* funcSetFunctionGetPixel)(GETPIXELPROC lpGetPixelProc);
+typedef void (WINAPI* funcSetFunctionSetPixel)(SETPIXELPROC lpSetPixelProc);
+extern funcSetFunctionGetPixel SetFunctionGetPixel; // Only used with ALPHA_BLEND
+extern funcSetFunctionSetPixel SetFunctionSetPixel;
+
+// Call this to make a different Storm.dll-compatible MPQ library be used (like SFMPQ).
+typedef BOOL (WINAPI* funcSetMpqDll)(LPCSTR lpDllFileName);
+extern funcSetMpqDll SetMpqDll;
+
+// These no longer need to be called
+typedef BOOL (WINAPI* funcLoadGrpApi)();
+typedef void (WINAPI* funcFreeGrpApi)();
+extern funcLoadGrpApi LoadGrpApi;
+extern funcFreeGrpApi FreeGrpApi;
+
+#ifdef __cplusplus
+}; // extern "C"
+#endif
+
+#endif