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
|
/*=========================================================================
Program: Visualization Toolkit
Module: vtkDataCompressor.h
Copyright (c) Ken Martin, Will Schroeder, Bill Lorensen
All rights reserved.
See Copyright.txt or http://www.kitware.com/Copyright.htm for details.
This software is distributed WITHOUT ANY WARRANTY; without even
the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
PURPOSE. See the above copyright notice for more information.
=========================================================================*/
/**
* @class vtkDataCompressor
* @brief Abstract interface for data compression classes.
*
* vtkDataCompressor provides a universal interface for data
* compression. Subclasses provide one compression method and one
* decompression method. The public interface to all compressors
* remains the same, and is defined by this class.
*/
#ifndef vtkDataCompressor_h
#define vtkDataCompressor_h
#include "vtkIOCoreModule.h" // For export macro
#include "vtkObject.h"
class vtkUnsignedCharArray;
class VTKIOCORE_EXPORT vtkDataCompressor : public vtkObject
{
public:
vtkTypeMacro(vtkDataCompressor,vtkObject);
void PrintSelf(ostream& os, vtkIndent indent);
/**
* Get the maximum space that may be needed to store data of the
* given uncompressed size after compression. This is the minimum
* size of the output buffer that can be passed to the four-argument
* Compress method.
*/
virtual size_t GetMaximumCompressionSpace(size_t size)=0;
/**
* Compress the given input data buffer into the given output
* buffer. The size of the output buffer must be at least as large
* as the value given by GetMaximumCompressionSpace for the given
* input size.
*/
size_t Compress(unsigned char const* uncompressedData,
size_t uncompressedSize,
unsigned char* compressedData,
size_t compressionSpace);
/**
* Uncompress the given input data into the given output buffer.
* The size of the uncompressed data must be known by the caller.
* It should be transmitted from the compressor by a means outside
* of this class.
*/
size_t Uncompress(unsigned char const* compressedData,
size_t compressedSize,
unsigned char* uncompressedData,
size_t uncompressedSize);
/**
* Compress the given data. A vtkUnsignedCharArray containing the
* compressed data is returned with a reference count of 1.
*/
vtkUnsignedCharArray* Compress(unsigned char const* uncompressedData,
size_t uncompressedSize);
/**
* Uncompress the given data. A vtkUnsignedCharArray containing the
* compressed data is returned with a reference count of 1. The
* size of the uncompressed data must be known by the caller. It
* should be transmitted from the compressor by a means outside of
* this class.
*/
vtkUnsignedCharArray* Uncompress(unsigned char const* compressedData,
size_t compressedSize,
size_t uncompressedSize);
protected:
vtkDataCompressor();
~vtkDataCompressor();
// Actual compression method. This must be provided by a subclass.
// Must return the size of the compressed data, or zero on error.
virtual size_t CompressBuffer(unsigned char const* uncompressedData,
size_t uncompressedSize,
unsigned char* compressedData,
size_t compressionSpace)=0;
// Actual decompression method. This must be provided by a subclass.
// Must return the size of the uncompressed data, or zero on error.
virtual size_t UncompressBuffer(unsigned char const* compressedData,
size_t compressedSize,
unsigned char* uncompressedData,
size_t uncompressedSize)=0;
private:
vtkDataCompressor(const vtkDataCompressor&) VTK_DELETE_FUNCTION;
void operator=(const vtkDataCompressor&) VTK_DELETE_FUNCTION;
};
#endif
|
