Original Source for 1.13 Mod High Resolution version from 12/06/05

git-svn-id: https://ja2svn.mooo.com/source/ja2/trunk/GameSource/ja2_v1.13/Build@21 3b4a5df2-a311-0410-b5c6-a8a6f20db521
2026-09-09 14:46:05 +02:00 · 2006-04-19 11:32:51 +00:00
commit e54aeb96aa
790 changed files with 741287 additions and 0 deletions
@@ -0,0 +1,52 @@
+#if !defined( COMPRESSION_H )
+
+#define COMPRESSION_H
+
+#include "types.h"
+
+// Notes on how to use these functions without getting your hands dirty:
+
+// To decompress:
+//
+// 1) call DecompressInit() with a pointer to your compressed data, and the
+// size of that compressed data.  DecompressInit() returns a "decompression
+// pointer" that you should pass to Decompress() and DecompressFini()
+//
+// 2) call Decompress() with the decompression pointer, a pointer to a
+// buffer for decompressed data, and the length of that buffer.  If the
+// buffer is not large enough to hold all of the decompressed data,
+// Decompress() will fill it completely, and you can call Decompress() again
+// to continue your decompression.  You are responsible for knowing the
+// size your data will be after decompression.  (The STI/STCI file format
+// records your original data size for you...)  Decompress() returns the
+// number of bytes of output.
+//
+// 3) call DecompressFini() with the decompression pointer when you're done
+
+PTR DecompressInit( BYTE * pCompressedData, UINT32 uiDataSize );
+UINT32 Decompress( PTR pDecompPtr, BYTE * pBuffer, UINT32 uiBufferLen );
+void DecompressFini( PTR pDecompPtr );
+
+// To compress:
+//
+// 1) call CompressInit() with a pointer to your uncompressed data, and the
+// size of that uncompressed data.  CompressInit() returns a "compression
+// pointer" that you should pass to Compress() and CompressFini()
+//
+// 2) call Compress() with the compression pointer, a pointer to a
+// buffer for compressed data, and the length of that buffer.  If the
+// buffer is not large enough to hold all of the compressed data,
+// Compress() will fill it completely, and you can call Compress() again
+// with a new or emptied buffer to continue your compression later.  You 
+// can call CompressedBufferSize() to determine the largest buffer size you 
+// should need for a certain number of bytes.  Ccompress() returns the number 
+// of bytes of output.
+//
+// 3) call CompressFini() with the compression pointer when you're done
+
+UINT32 CompressedBufferSize( UINT32 uiDataSize );
+PTR CompressInit( BYTE * pUncompressedData, UINT32 uiDataSize );
+UINT32 Compress( PTR pCompPtr, BYTE * pBuffer, UINT32 uiBufferLen );
+void CompressFini( PTR pCompPtr );
+
+#endif