Help Center
Help CenterFreeBASICTutorials

zlib

Documentation

Loss-less data compression library using the Deflate algorithm unencumbered by patents.

Website: http://www.zlib.net
Platforms supported: Win32, Linux, DOS
Headers to include: zlib.bi
Header version: 1.2.8
Examples: in examples/compression/

Example

zlib-based PNG save & load code: http://www.freebasic.net/forum/viewtopic.php?t=3936

In-memory compression example:
'' Zlib compress/decompress example, by yetifoot



#include Once "zlib.bi"



Dim As Integer errlev



'' This is the size of our test data in bytes.

Dim As Integer src_len = 100000



Print "ZLib test - Version " & *zlibVersion()

Print

Print "Test data size      : " & src_len & " bytes." 



'' The size of the destination buffer for the compressed data is calculated by

'' the compressBound function.

Dim As Integer dest_len = compressBound(src_len)



'' Allocate our needed memory.

Dim As UByte Ptr src = Allocate(src_len)

Dim As UByte Ptr dest = Allocate(dest_len)



'' Fill the src buffer with random, yet still compressable data.

For i As Integer = 0 To src_len - 1

    src[i] = Rnd * 4

Next



'' Store the crc32 checksum of the input data, so we can check if the 

'' uncompression has worked.

Dim As UInteger crc = crc32(0, src, src_len)



'' Perform the compression.  dest_len is passed as its address, because when

'' the function returns it will contain the size of the compressed data.

errlev = compress(dest, @dest_len, src, src_len)

If errlev <> 0 Then

    '' If the function returns a value other than 0 then an error occured.

    Print "**** Error during compress - code " & errlev & " ****"

End If

Print "Compressed to       : " & dest_len & " bytes."



'' NOTE: in normal use in a program, you would store the src_len, in order to

'' be able to tell uncompress the output size.  However in this example we can

'' just leave it in src_len.  The same goes for dest_len, which is the compressed

'' datas size.



'' Wipe the src buffer before we uncompress to it, so that we can check if the 

'' decompression has worked.

For i As Integer = 0 To src_len - 1

    src[i] = 0

Next



'' Perform a decompression.  This time we uncompress the data back to src.  

'' src_len is passed as its address, because when

'' the function returns it will contain the size of the uncompressed data.

errlev = uncompress(src, @src_len, dest, dest_len)

If errlev <> 0 Then

    '' If the function returns a value other than 0 then an error occured.

    Print "**** Error during uncompress - code " & errlev & " ****"

End If

Print "Uncompressed to     : " & src_len & " bytes."



'' Make sure the checksum of the uncompressed data matches our original data.

If crc <> crc32(0, src, src_len) Then

    Print "crc32 checksum      : FAILED"

Else

    Print "crc32 checksum      : PASSED"

End If



'' Free the buffers used in the test.

Deallocate(src)

Deallocate(dest)



Print

Print "Press any key to end . . . "

Sleep