(no commit message)

[grpapi.git] / grpapi / grpapi.h

diff --git a/grpapi/grpapi.h b/grpapi/grpapi.h
index 8fc78cb..bfa6864 100644 (file)
--- a/grpapi/grpapi.h
+++ b/grpapi/grpapi.h
@@ -1,6 +1,6 @@
 /*\r
 \r
-  ShadowFlare GRP Library. (c) ShadowFlare Software 2002\r
+  ShadowFlare GRP Library. (c) ShadowFlare Software 2002-2006\r
 \r
   Any comments or suggestions are accepted at blakflare@hotmail.com (ShadowFlare)\r
 */\r
@@ -39,12 +39,20 @@ typedef struct {
                                    // 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
@@ -55,6 +63,32 @@ BOOL   GRPAPI WINAPI DestroyGrp(HANDLE hGrp);
 BOOL   GRPAPI WINAPI DrawGrp(HANDLE hGrp, HDC hdcDest, int nXDest, int nYDest, WORD nFrame, DWORD *dwPalette, DWORD dwFlags, DWORD dwAlpha);\r
 BOOL   GRPAPI WINAPI GetGrpInfo(HANDLE hGrp, GRPHEADER *GrpInfo);\r
 \r
+HANDLE GRPAPI WINAPI CreateGrp(signed short *lpImageData, WORD nFrames, WORD wMaxWidth, WORD wMaxHeight, BOOL bNoCompress, DWORD *nGrpSize);\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
+void GRPAPI WINAPI SetFunctionGetPixel(GETPIXELPROC lpGetPixelProc); // Only used with ALPHA_BLEND\r
+void GRPAPI WINAPI SetFunctionSetPixel(SETPIXELPROC lpSetPixelProc);\r
+\r
+// Call this to make a different Storm.dll-compatible MPQ library be used (like SFMPQ).\r
+BOOL GRPAPI WINAPI SetMpqDll(LPCSTR lpDllFileName);\r
+\r
 // These no longer need to be called\r
 BOOL   GRPAPI WINAPI LoadGrpApi();\r
 void   GRPAPI WINAPI FreeGrpApi();\r