Contents - Index

Differences between VCLZip Pro and VCLZip Lite

• Please test your application throroughly with this new version of VCLZip Pro.  While it has been tested and has even been used in at least two production applications for several months now prior to initial VCLZip Pro release, there are so many combinations of property settings, environment differences, and ways to use VCLZip that you should always test VCLZip completely in your application before deploying.

*** New Zip64 capabilities, properties, methods and events:

• Uncompressed, Compressed, and Archive file sizes can be up to 2^63-1 bytes in length.  
• You can compress up to 2147483647 files into an archive.  This is compatible with PKZip's Zip64 format.  
• If a file does not extend beyond any of the original limitations (filesizes of 4 gig or 65535 files) then no Zip64 format information is included in the archive.
• property isZip64 - tells you when you are working with a zip file that is using Zip64 format.

• Much faster processing due to linking to Zlib object files for compression and decompression routines.

• Blocked Zip Files (spanned zip archives split onto hard drive) 
• Now completely compatible with PKZip and WinZip split archives file naming format. 
• For backwards compatability you can tell VCLZip to use the old VCLZip filenaming format by using the BlockMode property.
• New method OnFileNameForSplitPart called just before each split filepart is created.  VCLZip supplies a default implementation of this method so for most purposes you won't need your own
• method DefaultFileNameForSplitPart - VCLZip calls this internally if you don't define your own OnFileNameForSplitPart.  You can also call it from your own OnFileNameForSplitPart if you wish to add some processing to the default behavior.
• property BlockMode - determines whether VCLZip uses PKZip/WinZip standard naming convention or VCLZip classic method.
• method DefaultGetNextDisk - VCLZip calls this internally if you don't define your own OnGetNextDisk.  You can also call it from your own OnGetNextDisk event if you wish to add some processing to the default behavior.
• Properties for controlling which files are zipped...
• IncludeHiddenFiles - default False;
• IncludeSysFiles: - default False;
• IncludeReadOnlyFiles: - default True;
• IncludeArchiveFiles: - default True;
• Event OnGetNextStream - Allows you to zip from multiple streams when using the ZipFromStream method. This improves performance since repeated calls to ZipFromStream causes the archive to be updated on each subsequent call.
• property ThisBuild - Tells you the current build.  See also ThisVersion      
• property OnHandleMessage - Handles interactive messages with VCLZip.  There is a default, so you don't need to define your own unless you wish to eliminate interactive messages and handle them on your own.  This is helpful if you are using VCLZip as a service or on a webserver for instance.
• VCLZip Pro works with Delphi 4 through Delphi 7 and BCB 4 through BCB 6.
• When setting ArchiveStream using Delphi 4 or 5 or BCB 4 or 5 you should use one of the TkpHugeStream types or create your own stream class inherted from TKpHugeStream.  This allows Zip64 capabilities with these versions of Delphi.  For Delphi 6, 7, and BCB 6, you can use regular TStreams.
• Future enhancements will be applied to VCLZip Pro, not VCLZip Lite
• Supports PKZip Zip64 format
• Removes the file size limitations of VCLZip Lite - up to 2^63-1 bytes
• Removes the number of files limitation of VCLZip Lite - up to 2147483647 files
• Faster than VCLZip Lite - compression and decompression uses standard ZLib, written in C
• If normal limitations are not reached, then format of zip file will be normal PKZip format, no Zip64 formatting will be included

About VCLZip Lite

• VCLZip Lite works with all versions of Delphi/BCB
• Limits
• File sizes up to 2 gig
• Archives hold up to 65535 files
• Does not create PKZip/WinZip compatible split/blocked archives (does create pkzip/winzip compatible spanned archives)
• Has most but not all of the events that VCLZip Pro has