X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/7c913512a4c9f36e11e07ea707002fab1608d324..d9faa1fede04455b98de64001bcad46fa2061231:/interface/zstream.h diff --git a/interface/zstream.h b/interface/zstream.h index 51ecb09385..205c6bcc14 100644 --- a/interface/zstream.h +++ b/interface/zstream.h @@ -1,6 +1,6 @@ ///////////////////////////////////////////////////////////////////////////// // Name: zstream.h -// Purpose: documentation for wxZlibOutputStream class +// Purpose: interface of wxZlibOutputStream // Author: wxWidgets team // RCS-ID: $Id$ // Licence: wxWindows license @@ -21,30 +21,25 @@ @library{wxbase} @category{streams} - @seealso - wxOutputStream, wxZlibInputStream + @see wxOutputStream, wxZlibInputStream */ class wxZlibOutputStream : public wxFilterOutputStream { public: //@{ /** - Creates a new write-only compressed stream. @e level means level of + Creates a new write-only compressed stream. @a level means level of compression. It is number between 0 and 9 (including these values) where 0 means no compression and 9 best but slowest compression. -1 is default value (currently equivalent to 6). - If the parent stream is passed as a pointer then the new filter stream takes ownership of it. If it is passed by reference then it does not. - - The @e flags wxZLIB_ZLIB and wxZLIB_GZIP specify whether the output data + The @a flags wxZLIB_ZLIB and wxZLIB_GZIP specify whether the output data will be in zlib or gzip format. wxZLIB_ZLIB is the default. - - If @e flags is wxZLIB_NO_HEADER, then a raw deflate stream is output + If @a flags is wxZLIB_NO_HEADER, then a raw deflate stream is output without either zlib or gzip headers. This is a lower level mode, which is not usually used directly. It can be used to embed a raw deflate stream in a higher level protocol. - The following symbols can be use for the compression level and flags: */ wxZlibOutputStream(wxOutputStream& stream, int level = -1, @@ -60,6 +55,7 @@ public: }; + /** @class wxZlibInputStream @wxheader{zstream.h} @@ -75,8 +71,7 @@ public: @library{wxbase} @category{streams} - @seealso - wxInputStream, wxZlibOutputStream. + @see wxInputStream, wxZlibOutputStream. */ class wxZlibInputStream : public wxFilterInputStream { @@ -85,16 +80,13 @@ public: /** If the parent stream is passed as a pointer then the new filter stream takes ownership of it. If it is passed by reference then it does not. - - The @e flags wxZLIB_ZLIB and wxZLIB_GZIP specify whether the input data + The @a flags wxZLIB_ZLIB and wxZLIB_GZIP specify whether the input data is in zlib or gzip format. If wxZLIB_AUTO is used, then zlib will autodetect the stream type, this is the default. - - If @e flags is wxZLIB_NO_HEADER, then the data is assumed to be a raw + If @a flags is wxZLIB_NO_HEADER, then the data is assumed to be a raw deflate stream without either zlib or gzip headers. This is a lower level mode, which is not usually used directly. It can be used to read a raw deflate stream embedded in a higher level protocol. - This version is not by default compatible with the output produced by the version of @e wxZlibOutputStream in wxWidgets 2.4.x. However, there is a compatibility mode, which is switched on by passing @@ -112,3 +104,4 @@ public: */ static bool CanHandleGZip(); }; +