diff -r 000000000000 -r e4d67989cc36 compressionlibs/ziplib/inc/ezdecompressor.h --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/compressionlibs/ziplib/inc/ezdecompressor.h Tue Feb 02 02:01:42 2010 +0200 @@ -0,0 +1,98 @@ +// Copyright (c) 1999-2009 Nokia Corporation and/or its subsidiary(-ies). +// All rights reserved. +// This component and the accompanying materials are made available +// under the terms of "Eclipse Public License v1.0" +// which accompanies this distribution, and is available +// at the URL "http://www.eclipse.org/legal/epl-v10.html". +// +// Initial Contributors: +// Nokia Corporation - initial contribution. +// +// Contributors: +// +// Description: +// Declaration for Decompression class +// +// + +#ifndef __EZDECOMPRESSOR_H__ +#define __EZDECOMPRESSOR_H__ + +#include +#include +#include + +/** +The CEZDecompressor class provides in-memory de-compression functions, including integrity checks of the compressed data. +This version of the library supports only one compression / de-compression method (deflation / inflation). De-compression +can be done in a single step (using DecompressL()) if the buffers are large enough (for example if an input file is mmap'ed), +or can be done by repeated calls of the InflateL() function. The source data is de-compressed to the target buffer (both source +and target contained within the buffer manager argument). + +Note: In this version of the library a windowBits value of 8 is unsupported due to a problem with the window size being +set to 256 bytes. Although a value of 8 will be accepted by the CEZCompressor constructors, as it is being changed +internally by Zlib from 8 to 9, it will not be possible to use the same value for decompression. This is because the +Zlib functions called by the CEZDecompressor constructors do not make the same change internally and as a result a +KEZlibErrData is returned when calling InflateL(). It is therefore advised that for this version of the library +windowBits of 9 is used in place of 8. + +@publishedAll +@released +*/ +class CEZDecompressor : public CEZZStream + { +public: + /** Decompression panic values */ + enum + { + EInflateInitlialiserError = EUnexpected + 1, + EInflateVersionError, + EInflateTerminated, + EInflateDictionaryError + }; + + /** Window Bits - the base two logarithm of the window size (the size of the history buffer) */ + enum + { + EMaxWBits = MAX_WBITS + }; + +public: + ~CEZDecompressor(); + + IMPORT_C static CEZDecompressor* NewLC(MEZBufferManager& aInit, TInt aWindowBits = EMaxWBits); + IMPORT_C static CEZDecompressor* NewL(MEZBufferManager& aInit, TInt aWindowBits = EMaxWBits); + + IMPORT_C static CEZDecompressor* NewLC(MEZBufferManager& aInit, const TDesC8& aDictionary, TInt aWindowBits = EMaxWBits); + IMPORT_C static CEZDecompressor* NewL(MEZBufferManager& aInit, const TDesC8& aDictionary, TInt aWindowBits = EMaxWBits); + + + IMPORT_C void ResetL(MEZBufferManager& aInit); + IMPORT_C TBool InflateL(); + + IMPORT_C static void DecompressL(TDes8 &aDestination, const TDesC8 &aSource); + + private: + enum TInflationState + { + ENoFlush, + EFinalize, + ETerminated + }; + + private: + void SetDictionaryL(); + CEZDecompressor(MEZBufferManager* aInit); + CEZDecompressor(MEZBufferManager* aInit, const TUint8 *aDictionary, TInt aLength); + void ConstructL(TInt aWindowBits); + + private: + MEZBufferManager* iBufferInit; + TInflationState iInflationState; + const TUint8* iDictionary; + TInt iDictionaryLength; + }; + +#endif + +