/usr/include/OGRE/OgreDeflate.h is in libogre-1.9-dev 1.9.0+dfsg1-4.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 | /*
-----------------------------------------------------------------------------
This source file is part of OGRE
(Object-oriented Graphics Rendering Engine)
For the latest info, see http://www.ogre3d.org/
Copyright (c) 2000-2013 Torus Knot Software Ltd
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in
all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
THE SOFTWARE.
-----------------------------------------------------------------------------
*/
#ifndef __OGRE_DEFLATE_H__
#define __OGRE_DEFLATE_H__
#include "OgrePrerequisites.h"
#include "OgreDataStream.h"
#include "OgreHeaderPrefix.h"
/// forward decls
struct z_stream_s;
typedef struct z_stream_s z_stream;
namespace Ogre
{
/** Stream which compresses / uncompresses data using the 'deflate' compression
algorithm.
@remarks
This stream is designed to wrap another stream for the actual source / destination
of the compressed data, it has no concrete source / data itself. The idea is
that you pass uncompressed data through this stream, and the underlying
stream reads/writes compressed data to the final source.
@note
This is an alternative to using a compressed archive since it is able to
compress & decompress regardless of the actual source of the stream.
You should avoid using this with already compressed archives.
Also note that this cannot be used as a read / write stream, only a read-only
or write-only stream.
*/
class _OgreExport DeflateStream : public DataStream
{
protected:
DataStreamPtr mCompressedStream;
DataStreamPtr mTmpWriteStream;
String mTempFileName;
z_stream* mZStream;
size_t mCurrentPos;
size_t mAvailIn;
/// Cache for read data in case skipping around
StaticCache<16 * OGRE_STREAM_TEMP_SIZE> mReadCache;
/// Intermediate buffer for read / write
unsigned char *mTmp;
/// Whether the underlying stream is valid compressed data
bool mIsCompressedValid;
void init();
void destroy();
void compressFinal();
size_t getAvailInForSinglePass();
public:
/** Constructor for creating unnamed stream wrapping another stream.
@param compressedStream The stream that this stream will use when reading /
writing compressed data. The access mode from this stream will be matched.
@param tmpFileName Path/Filename to be used for temporary storage of incoming data
@param avail_in Available data length to be uncompressed. With it we can uncompress
DataStream partly.
*/
DeflateStream(const DataStreamPtr& compressedStream, const String& tmpFileName = "",
size_t avail_in = 0);
/** Constructor for creating named stream wrapping another stream.
@param name The name to give this stream
@param compressedStream The stream that this stream will use when reading /
writing compressed data. The access mode from this stream will be matched.
@param tmpFileName Path/Filename to be used for temporary storage of incoming data
@param avail_in Available data length to be uncompressed. With it we can uncompress
DataStream partly.
*/
DeflateStream(const String& name, const DataStreamPtr& compressedStream, const String& tmpFileName="",
size_t avail_in = 0);
~DeflateStream();
/** Returns whether the compressed stream is valid deflated data.
@remarks
If you pass this class a READ stream which is not compressed with the
deflate algorithm, this method returns false and all read commands
will actually be executed as passthroughs as a fallback.
*/
bool isCompressedStreamValid() const { return mIsCompressedValid; }
/** @copydoc DataStream::read
*/
size_t read(void* buf, size_t count);
/** @copydoc DataStream::write
*/
size_t write(const void* buf, size_t count);
/** @copydoc DataStream::skip
*/
void skip(long count);
/** @copydoc DataStream::seek
*/
void seek( size_t pos );
/** @copydoc DataStream::tell
*/
size_t tell(void) const;
/** @copydoc DataStream::eof
*/
bool eof(void) const;
/** @copydoc DataStream::close
*/
void close(void);
};
}
#include "OgreHeaderSuffix.h"
#endif
|