home *** CD-ROM | disk | FTP | other *** search
/ PC World Plus! (NZ) 2001 June / HDC50.iso / Info / Extras / Zlib / ZLIB.PAS next >
Pascal/Delphi Source File  |  1999-08-11  |  17KB  |  556 lines

  1. {*******************************************************}
  2. {                                                       }
  3. {       Borland Delphi Supplemental Components          }
  4. {       ZLIB Data Compression Interface Unit            }
  5. {                                                       }
  6. {       Copyright (c) 1997,99 Inprise Corporation       }
  7. {                                                       }
  8. {*******************************************************}
  9.  
  10. unit zlib;
  11.  
  12. interface
  13.  
  14. uses Sysutils, Classes;
  15.  
  16. type
  17.   TAlloc = function (AppData: Pointer; Items, Size: Integer): Pointer; register;
  18.   TFree = procedure (AppData, Block: Pointer); register;
  19.  
  20.   // Internal structure.  Ignore.
  21.   TZStreamRec = packed record
  22.     next_in: PChar;       // next input byte
  23.     avail_in: Integer;    // number of bytes available at next_in
  24.     total_in: Integer;    // total nb of input bytes read so far
  25.  
  26.     next_out: PChar;      // next output byte should be put here
  27.     avail_out: Integer;   // remaining free space at next_out
  28.     total_out: Integer;   // total nb of bytes output so far
  29.  
  30.     msg: PChar;           // last error message, NULL if no error
  31.     internal: Pointer;    // not visible by applications
  32.  
  33.     zalloc: TAlloc;       // used to allocate the internal state
  34.     zfree: TFree;         // used to free the internal state
  35.     AppData: Pointer;     // private data object passed to zalloc and zfree
  36.  
  37.     data_type: Integer;   //  best guess about the data type: ascii or binary
  38.     adler: Integer;       // adler32 value of the uncompressed data
  39.     reserved: Integer;    // reserved for future use
  40.   end;
  41.  
  42.   // Abstract ancestor class
  43.   TCustomZlibStream = class(TStream)
  44.   private
  45.     FStrm: TStream;
  46.     FStrmPos: Integer;
  47.     FOnProgress: TNotifyEvent;
  48.     FZRec: TZStreamRec;
  49.     FBuffer: array [Word] of Char;
  50.   protected
  51.     procedure Progress(Sender: TObject); dynamic;
  52.     property OnProgress: TNotifyEvent read FOnProgress write FOnProgress;
  53.     constructor Create(Strm: TStream);
  54.   end;
  55.  
  56. { TCompressionStream compresses data on the fly as data is written to it, and
  57.   stores the compressed data to another stream.
  58.  
  59.   TCompressionStream is write-only and strictly sequential. Reading from the
  60.   stream will raise an exception. Using Seek to move the stream pointer
  61.   will raise an exception.
  62.  
  63.   Output data is cached internally, written to the output stream only when
  64.   the internal output buffer is full.  All pending output data is flushed
  65.   when the stream is destroyed.
  66.  
  67.   The Position property returns the number of uncompressed bytes of
  68.   data that have been written to the stream so far.
  69.  
  70.   CompressionRate returns the on-the-fly percentage by which the original
  71.   data has been compressed:  (1 - (CompressedBytes / UncompressedBytes)) * 100
  72.   If raw data size = 100 and compressed data size = 25, the CompressionRate
  73.   is 75%
  74.  
  75.   The OnProgress event is called each time the output buffer is filled and
  76.   written to the output stream.  This is useful for updating a progress
  77.   indicator when you are writing a large chunk of data to the compression
  78.   stream in a single call.}
  79.  
  80.  
  81.   TCompressionLevel = (clNone, clFastest, clDefault, clMax);
  82.  
  83.   TCompressionStream = class(TCustomZlibStream)
  84.   private
  85.     function GetCompressionRate: Single;
  86.   public
  87.     constructor Create(CompressionLevel: TCompressionLevel; Dest: TStream);
  88.     destructor Destroy; override;
  89.     function Read(var Buffer; Count: Longint): Longint; override;
  90.     function Write(const Buffer; Count: Longint): Longint; override;
  91.     function Seek(Offset: Longint; Origin: Word): Longint; override;
  92.     property CompressionRate: Single read GetCompressionRate;
  93.     property OnProgress;
  94.   end;
  95.  
  96. { TDecompressionStream decompresses data on the fly as data is read from it.
  97.  
  98.   Compressed data comes from a separate source stream.  TDecompressionStream
  99.   is read-only and unidirectional; you can seek forward in the stream, but not
  100.   backwards.  The special case of setting the stream position to zero is
  101.   allowed.  Seeking forward decompresses data until the requested position in
  102.   the uncompressed data has been reached.  Seeking backwards, seeking relative
  103.   to the end of the stream, requesting the size of the stream, and writing to
  104.   the stream will raise an exception.
  105.  
  106.   The Position property returns the number of bytes of uncompressed data that
  107.   have been read from the stream so far.
  108.  
  109.   The OnProgress event is called each time the internal input buffer of
  110.   compressed data is exhausted and the next block is read from the input stream.
  111.   This is useful for updating a progress indicator when you are reading a
  112.   large chunk of data from the decompression stream in a single call.}
  113.  
  114.   TDecompressionStream = class(TCustomZlibStream)
  115.   public
  116.     constructor Create(Source: TStream);
  117.     destructor Destroy; override;
  118.     function Read(var Buffer; Count: Longint): Longint; override;
  119.     function Write(const Buffer; Count: Longint): Longint; override;
  120.     function Seek(Offset: Longint; Origin: Word): Longint; override;
  121.     property OnProgress;
  122.   end;
  123.  
  124.  
  125.  
  126. { CompressBuf compresses data, buffer to buffer, in one call.
  127.    In: InBuf = ptr to compressed data
  128.        InBytes = number of bytes in InBuf
  129.   Out: OutBuf = ptr to newly allocated buffer containing decompressed data
  130.        OutBytes = number of bytes in OutBuf   }
  131. procedure CompressBuf(const InBuf: Pointer; InBytes: Integer;
  132.                       out OutBuf: Pointer; out OutBytes: Integer);
  133.  
  134.  
  135. { DecompressBuf decompresses data, buffer to buffer, in one call.
  136.    In: InBuf = ptr to compressed data
  137.        InBytes = number of bytes in InBuf
  138.        OutEstimate = zero, or est. size of the decompressed data
  139.   Out: OutBuf = ptr to newly allocated buffer containing decompressed data
  140.        OutBytes = number of bytes in OutBuf   }
  141. procedure DecompressBuf(const InBuf: Pointer; InBytes: Integer;
  142.  OutEstimate: Integer; out OutBuf: Pointer; out OutBytes: Integer);
  143.  
  144. { DecompressToUserBuf decompresses data, buffer to buffer, in one call.
  145.    In: InBuf = ptr to compressed data
  146.        InBytes = number of bytes in InBuf
  147.   Out: OutBuf = ptr to user-allocated buffer to contain decompressed data
  148.        BufSize = number of bytes in OutBuf   }
  149. procedure DecompressToUserBuf(const InBuf: Pointer; InBytes: Integer;
  150.   const OutBuf: Pointer; BufSize: Integer);
  151.  
  152. const
  153.   zlib_Version = '1.0.4';
  154.  
  155. type
  156.   EZlibError = class(Exception);
  157.   ECompressionError = class(EZlibError);
  158.   EDecompressionError = class(EZlibError);
  159.  
  160. implementation
  161.  
  162. uses ZlibConst;
  163.  
  164. const
  165.   Z_NO_FLUSH      = 0;
  166.   Z_PARTIAL_FLUSH = 1;
  167.   Z_SYNC_FLUSH    = 2;
  168.   Z_FULL_FLUSH    = 3;
  169.   Z_FINISH        = 4;
  170.  
  171.   Z_OK            = 0;
  172.   Z_STREAM_END    = 1;
  173.   Z_NEED_DICT     = 2;
  174.   Z_ERRNO         = (-1);
  175.   Z_STREAM_ERROR  = (-2);
  176.   Z_DATA_ERROR    = (-3);
  177.   Z_MEM_ERROR     = (-4);
  178.   Z_BUF_ERROR     = (-5);
  179.   Z_VERSION_ERROR = (-6);
  180.  
  181.   Z_NO_COMPRESSION       =   0;
  182.   Z_BEST_SPEED           =   1;
  183.   Z_BEST_COMPRESSION     =   9;
  184.   Z_DEFAULT_COMPRESSION  = (-1);
  185.  
  186.   Z_FILTERED            = 1;
  187.   Z_HUFFMAN_ONLY        = 2;
  188.   Z_DEFAULT_STRATEGY    = 0;
  189.  
  190.   Z_BINARY   = 0;
  191.   Z_ASCII    = 1;
  192.   Z_UNKNOWN  = 2;
  193.  
  194.   Z_DEFLATED = 8;
  195.  
  196.  
  197.  
  198. {$L deflate.obj}
  199. {$L inflate.obj}
  200. {$L inftrees.obj}
  201. {$L trees.obj}
  202. {$L adler32.obj}
  203. {$L infblock.obj}
  204. {$L infcodes.obj}
  205. {$L infutil.obj}
  206. {$L inffast.obj}
  207.  
  208. procedure _tr_init; external;
  209. procedure _tr_tally; external;
  210. procedure _tr_flush_block; external;
  211. procedure _tr_align; external;
  212. procedure _tr_stored_block; external;
  213. procedure adler32; external;
  214. procedure inflate_blocks_new; external;
  215. procedure inflate_blocks; external;
  216. procedure inflate_blocks_reset; external;
  217. procedure inflate_blocks_free; external;
  218. procedure inflate_set_dictionary; external;
  219. procedure inflate_trees_bits; external;
  220. procedure inflate_trees_dynamic; external;
  221. procedure inflate_trees_fixed; external;
  222. procedure inflate_trees_free; external;
  223. procedure inflate_codes_new; external;
  224. procedure inflate_codes; external;
  225. procedure inflate_codes_free; external;
  226. procedure _inflate_mask; external;
  227. procedure inflate_flush; external;
  228. procedure inflate_fast; external;
  229.  
  230. procedure _memset(P: Pointer; B: Byte; count: Integer); cdecl;
  231. begin
  232.   FillChar(P^, count, B);
  233. end;
  234.  
  235. procedure _memcpy(dest, source: Pointer; count: Integer); cdecl;
  236. begin
  237.   Move(source^, dest^, count);
  238. end;
  239.  
  240.  
  241.  
  242. // deflate compresses data
  243. function deflateInit_(var strm: TZStreamRec; level: Integer; version: PChar;
  244.   recsize: Integer): Integer; external;
  245. function deflate(var strm: TZStreamRec; flush: Integer): Integer; external;
  246. function deflateEnd(var strm: TZStreamRec): Integer; external;
  247.  
  248. // inflate decompresses data
  249. function inflateInit_(var strm: TZStreamRec; version: PChar;
  250.   recsize: Integer): Integer; external;
  251. function inflate(var strm: TZStreamRec; flush: Integer): Integer; external;
  252. function inflateEnd(var strm: TZStreamRec): Integer; external;
  253. function inflateReset(var strm: TZStreamRec): Integer; external;
  254.  
  255.  
  256. function zlibAllocMem(AppData: Pointer; Items, Size: Integer): Pointer; register;
  257. begin
  258. //  GetMem(Result, Items*Size);
  259.   Result := AllocMem(Items * Size);
  260. end;
  261.  
  262. procedure zlibFreeMem(AppData, Block: Pointer); register;
  263. begin
  264.   FreeMem(Block);
  265. end;
  266.  
  267. {function zlibCheck(code: Integer): Integer;
  268. begin
  269.   Result := code;
  270.   if code < 0 then
  271.     raise EZlibError.Create('error');    //!!
  272. end;}
  273.  
  274. function CCheck(code: Integer): Integer;
  275. begin
  276.   Result := code;
  277.   if code < 0 then
  278.     raise ECompressionError.Create('error'); //!!
  279. end;
  280.  
  281. function DCheck(code: Integer): Integer;
  282. begin
  283.   Result := code;
  284.   if code < 0 then
  285.     raise EDecompressionError.Create('error');  //!!
  286. end;
  287.  
  288. procedure CompressBuf(const InBuf: Pointer; InBytes: Integer;
  289.                       out OutBuf: Pointer; out OutBytes: Integer);
  290. var
  291.   strm: TZStreamRec;
  292.   P: Pointer;
  293. begin
  294.   FillChar(strm, sizeof(strm), 0);
  295.   strm.zalloc := zlibAllocMem;
  296.   strm.zfree := zlibFreeMem;
  297.   OutBytes := ((InBytes + (InBytes div 10) + 12) + 255) and not 255;
  298.   GetMem(OutBuf, OutBytes);
  299.   try
  300.     strm.next_in := InBuf;
  301.     strm.avail_in := InBytes;
  302.     strm.next_out := OutBuf;
  303.     strm.avail_out := OutBytes;
  304.     CCheck(deflateInit_(strm, Z_BEST_COMPRESSION, zlib_version, sizeof(strm)));
  305.     try
  306.       while CCheck(deflate(strm, Z_FINISH)) <> Z_STREAM_END do
  307.       begin
  308.         P := OutBuf;
  309.         Inc(OutBytes, 256);
  310.         ReallocMem(OutBuf, OutBytes);
  311.         strm.next_out := PChar(Integer(OutBuf) + (Integer(strm.next_out) - Integer(P)));
  312.         strm.avail_out := 256;
  313.       end;
  314.     finally
  315.       CCheck(deflateEnd(strm));
  316.     end;
  317.     ReallocMem(OutBuf, strm.total_out);
  318.     OutBytes := strm.total_out;
  319.   except
  320.     FreeMem(OutBuf);
  321.     raise
  322.   end;
  323. end;
  324.  
  325.  
  326. procedure DecompressBuf(const InBuf: Pointer; InBytes: Integer;
  327.   OutEstimate: Integer; out OutBuf: Pointer; out OutBytes: Integer);
  328. var
  329.   strm: TZStreamRec;
  330.   P: Pointer;
  331.   BufInc: Integer;
  332. begin
  333.   FillChar(strm, sizeof(strm), 0);
  334.   strm.zalloc := zlibAllocMem;
  335.   strm.zfree := zlibFreeMem;
  336.   BufInc := (InBytes + 255) and not 255;
  337.   if OutEstimate = 0 then
  338.     OutBytes := BufInc
  339.   else
  340.     OutBytes := OutEstimate;
  341.   GetMem(OutBuf, OutBytes);
  342.   try
  343.     strm.next_in := InBuf;
  344.     strm.avail_in := InBytes;
  345.     strm.next_out := OutBuf;
  346.     strm.avail_out := OutBytes;
  347.     DCheck(inflateInit_(strm, zlib_version, sizeof(strm)));
  348.     try
  349.       while DCheck(inflate(strm, Z_FINISH)) <> Z_STREAM_END do
  350.       begin
  351.         P := OutBuf;
  352.         Inc(OutBytes, BufInc);
  353.         ReallocMem(OutBuf, OutBytes);
  354.         strm.next_out := PChar(Integer(OutBuf) + (Integer(strm.next_out) - Integer(P)));
  355.         strm.avail_out := BufInc;
  356.       end;
  357.     finally
  358.       DCheck(inflateEnd(strm));
  359.     end;
  360.     ReallocMem(OutBuf, strm.total_out);
  361.     OutBytes := strm.total_out;
  362.   except
  363.     FreeMem(OutBuf);
  364.     raise
  365.   end;
  366. end;
  367.  
  368. procedure DecompressToUserBuf(const InBuf: Pointer; InBytes: Integer;
  369.   const OutBuf: Pointer; BufSize: Integer);
  370. var
  371.   strm: TZStreamRec;
  372. begin
  373.   FillChar(strm, sizeof(strm), 0);
  374.   strm.zalloc := zlibAllocMem;
  375.   strm.zfree := zlibFreeMem;
  376.   strm.next_in := InBuf;
  377.   strm.avail_in := InBytes;
  378.   strm.next_out := OutBuf;
  379.   strm.avail_out := BufSize;
  380.   DCheck(inflateInit_(strm, zlib_version, sizeof(strm)));
  381.   try
  382.     if DCheck(inflate(strm, Z_FINISH)) <> Z_STREAM_END then
  383.       raise EZlibError.CreateRes(@sTargetBufferTooSmall);
  384.   finally
  385.     DCheck(inflateEnd(strm));
  386.   end;
  387. end;
  388.  
  389. // TCustomZlibStream
  390.  
  391. constructor TCustomZLibStream.Create(Strm: TStream);
  392. begin
  393.   inherited Create;
  394.   FStrm := Strm;
  395.   FStrmPos := Strm.Position;
  396.   FZRec.zalloc := zlibAllocMem;
  397.   FZRec.zfree := zlibFreeMem;
  398. end;
  399.  
  400. procedure TCustomZLibStream.Progress(Sender: TObject);
  401. begin
  402.   if Assigned(FOnProgress) then FOnProgress(Sender);
  403. end;
  404.  
  405.  
  406. // TCompressionStream
  407.  
  408. constructor TCompressionStream.Create(CompressionLevel: TCompressionLevel;
  409.   Dest: TStream);
  410. const
  411.   Levels: array [TCompressionLevel] of ShortInt =
  412.     (Z_NO_COMPRESSION, Z_BEST_SPEED, Z_DEFAULT_COMPRESSION, Z_BEST_COMPRESSION);
  413. begin
  414.   inherited Create(Dest);
  415.   FZRec.next_out := FBuffer;
  416.   FZRec.avail_out := sizeof(FBuffer);
  417.   CCheck(deflateInit_(FZRec, Levels[CompressionLevel], zlib_version, sizeof(FZRec)));
  418. end;
  419.  
  420. destructor TCompressionStream.Destroy;
  421. begin
  422.   FZRec.next_in := nil;
  423.   FZRec.avail_in := 0;
  424.   try
  425.     if FStrm.Position <> FStrmPos then FStrm.Position := FStrmPos;
  426.     while (CCheck(deflate(FZRec, Z_FINISH)) <> Z_STREAM_END)
  427.       and (FZRec.avail_out = 0) do
  428.     begin
  429.       FStrm.WriteBuffer(FBuffer, sizeof(FBuffer));
  430.       FZRec.next_out := FBuffer;
  431.       FZRec.avail_out := sizeof(FBuffer);
  432.     end;
  433.     if FZRec.avail_out < sizeof(FBuffer) then
  434.       FStrm.WriteBuffer(FBuffer, sizeof(FBuffer) - FZRec.avail_out);
  435.   finally
  436.     deflateEnd(FZRec);
  437.   end;
  438.   inherited Destroy;
  439. end;
  440.  
  441. function TCompressionStream.Read(var Buffer; Count: Longint): Longint;
  442. begin
  443.   raise ECompressionError.CreateRes(@sInvalidStreamOp);
  444. end;
  445.  
  446. function TCompressionStream.Write(const Buffer; Count: Longint): Longint;
  447. begin
  448.   FZRec.next_in := @Buffer;
  449.   FZRec.avail_in := Count;
  450.   if FStrm.Position <> FStrmPos then FStrm.Position := FStrmPos;
  451.   while (FZRec.avail_in > 0) do
  452.   begin
  453.     CCheck(deflate(FZRec, 0));
  454.     if FZRec.avail_out = 0 then
  455.     begin
  456.       FStrm.WriteBuffer(FBuffer, sizeof(FBuffer));
  457.       FZRec.next_out := FBuffer;
  458.       FZRec.avail_out := sizeof(FBuffer);
  459.       FStrmPos := FStrm.Position;
  460.       Progress(Self);
  461.     end;
  462.   end;
  463.   Result := Count;
  464. end;
  465.  
  466. function TCompressionStream.Seek(Offset: Longint; Origin: Word): Longint;
  467. begin
  468.   if (Offset = 0) and (Origin = soFromCurrent) then
  469.     Result := FZRec.total_in
  470.   else
  471.     raise ECompressionError.CreateRes(@sInvalidStreamOp);
  472. end;
  473.  
  474. function TCompressionStream.GetCompressionRate: Single;
  475. begin
  476.   if FZRec.total_in = 0 then
  477.     Result := 0
  478.   else
  479.     Result := (1.0 - (FZRec.total_out / FZRec.total_in)) * 100.0;
  480. end;
  481.  
  482.  
  483. // TDecompressionStream
  484.  
  485. constructor TDecompressionStream.Create(Source: TStream);
  486. begin
  487.   inherited Create(Source);
  488.   FZRec.next_in := FBuffer;
  489.   FZRec.avail_in := 0;
  490.   DCheck(inflateInit_(FZRec, zlib_version, sizeof(FZRec)));
  491. end;
  492.  
  493. destructor TDecompressionStream.Destroy;
  494. begin
  495.   FStrm.Seek(-FZRec.avail_in, 1);
  496.   inflateEnd(FZRec);
  497.   inherited Destroy;
  498. end;
  499.  
  500. function TDecompressionStream.Read(var Buffer; Count: Longint): Longint;
  501. begin
  502.   FZRec.next_out := @Buffer;
  503.   FZRec.avail_out := Count;
  504.   if FStrm.Position <> FStrmPos then FStrm.Position := FStrmPos;
  505.   while (FZRec.avail_out > 0) do
  506.   begin
  507.     if FZRec.avail_in = 0 then
  508.     begin
  509.       FZRec.avail_in := FStrm.Read(FBuffer, sizeof(FBuffer));
  510.       FZRec.next_in := FBuffer;
  511.       FStrmPos := FStrm.Position;
  512.       Progress(Self);
  513.     end;
  514.     CCheck(inflate(FZRec, 0));
  515.   end;
  516.   Result := Count;
  517. end;
  518.  
  519. function TDecompressionStream.Write(const Buffer; Count: Longint): Longint;
  520. begin
  521.   raise EDecompressionError.CreateRes(@sInvalidStreamOp);
  522. end;
  523.  
  524. function TDecompressionStream.Seek(Offset: Longint; Origin: Word): Longint;
  525. var
  526.   I: Integer;
  527.   Buf: array [0..4095] of Char;
  528. begin
  529.   if (Offset = 0) and (Origin = soFromBeginning) then
  530.   begin
  531.     DCheck(inflateReset(FZRec));
  532.     FZRec.next_in := FBuffer;
  533.     FZRec.avail_in := 0;
  534.     FStrm.Position := 0;
  535.     FStrmPos := 0;
  536.   end
  537.   else if ( (Offset >= 0) and (Origin = soFromCurrent)) or
  538.           ( ((Offset - FZRec.total_out) > 0) and (Origin = soFromBeginning)) then
  539.   begin
  540.     if Origin = soFromBeginning then Dec(Offset, FZRec.total_out);
  541.     if Offset > 0 then
  542.     begin
  543.       for I := 1 to Offset div sizeof(Buf) do
  544.         ReadBuffer(Buf, sizeof(Buf));
  545.       ReadBuffer(Buf, Offset mod sizeof(Buf));
  546.     end;
  547.   end
  548.   else
  549.     raise EDecompressionError.CreateRes(@sInvalidStreamOp);
  550.   Result := FZRec.total_out;
  551. end;
  552.  
  553.  
  554.  
  555. end.
  556.