GDAL

cpl_compressor.h
Go to the documentation of this file.
1 /**********************************************************************
2 * Project: CPL - Common Portability Library
3 * Purpose: Registry of compression/decompression functions
4 * Author: Even Rouault <even.rouault at spatialys.com>
5 *
6 **********************************************************************
7 * Copyright (c) 2021, Even Rouault <even.rouault at spatialys.com>
8 *
9 * Permission is hereby granted, free of charge, to any person obtaining a
10 * copy of this software and associated documentation files (the "Software"),
11 * to deal in the Software without restriction, including without limitation
12 * the rights to use, copy, modify, merge, publish, distribute, sublicense,
13 * and/or sell copies of the Software, and to permit persons to whom the
14 * Software is furnished to do so, subject to the following conditions:
15 *
16 * The above copyright notice and this permission notice shall be included
17 * in all copies or substantial portions of the Software.
18 *
19 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
20 * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
21 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
22 * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
23 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
24 * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
25 * DEALINGS IN THE SOFTWARE.
26 ****************************************************************************/
27
28 #include "cpl_port.h"
29
30 #include <stdbool.h>
31
38 CPL_C_START
39
70 typedef bool (*CPLCompressionFunc)(const void *input_data, size_t input_size,
71 void **output_data, size_t *output_size,
72 CSLConstList options,
73 void *compressor_user_data);
74
76 typedef enum
77 {
79 CCT_COMPRESSOR,
81 CCT_FILTER
82 } CPLCompressorType;
83
85 typedef struct
86 {
88 int nStructVersion;
90 const char *pszId;
92 CPLCompressorType eType;
100 CSLConstList papszMetadata;
102 CPLCompressionFunc pfnFunc;
104 void *user_data;
105 } CPLCompressor;
106
107 bool CPL_DLL CPLRegisterCompressor(const CPLCompressor *compressor);
108
109 bool CPL_DLL CPLRegisterDecompressor(const CPLCompressor *decompressor);
110
111 char CPL_DLL **CPLGetCompressors(void);
112
113 char CPL_DLL **CPLGetDecompressors(void);
114
115 const CPLCompressor CPL_DLL *CPLGetCompressor(const char *pszId);
116
117 const CPLCompressor CPL_DLL *CPLGetDecompressor(const char *pszId);
118
120 void CPL_DLL CPLDestroyCompressorRegistry(void);
123 CPL_C_END
CPLCompressor::pfnFunc
CPLCompressionFunc pfnFunc
Compressor/decompressor callback.
Definition: cpl_compressor.h:102
CPLCompressor::pszId
const char * pszId
Id of the compressor/decompressor.
Definition: cpl_compressor.h:90
CCT_COMPRESSOR
@ CCT_COMPRESSOR
Compressor.
Definition: cpl_compressor.h:79
CPLRegisterDecompressor
bool CPLRegisterDecompressor(const CPLCompressor *decompressor)
Register a new decompressor.
Definition: cpl_compressor.cpp:1886
CPLCompressorType
CPLCompressorType
Type of compressor.
Definition: cpl_compressor.h:76
CPLCompressor::papszMetadata
CSLConstList papszMetadata
Metadata, as a NULL terminated list of strings.
Definition: cpl_compressor.h:100
CPLCompressor::eType
CPLCompressorType eType
Compressor type.
Definition: cpl_compressor.h:92
CPL_C_START
#define CPL_C_START
Macro to start a block of C symbols.
Definition: cpl_port.h:315
CPLRegisterCompressor
bool CPLRegisterCompressor(const CPLCompressor *compressor)
Register a new compressor.
Definition: cpl_compressor.cpp:1854
CSLConstList
char ** CSLConstList
Type of a constant null-terminated list of nul terminated strings.
Definition: cpl_port.h:1195
CPL_C_END
#define CPL_C_END
Macro to end a block of C symbols.
Definition: cpl_port.h:319
CPLGetDecompressor
const CPLCompressor * CPLGetDecompressor(const char *pszId)
Return a decompressor.
Definition: cpl_compressor.cpp:1982
CPLGetCompressor
const CPLCompressor * CPLGetCompressor(const char *pszId)
Return a compressor.
Definition: cpl_compressor.cpp:1958
CPLCompressor
Compressor/decompressor description.
Definition: cpl_compressor.h:85
CPLCompressionFunc
bool(* CPLCompressionFunc)(const void *input_data, size_t input_size, void **output_data, size_t *output_size, CSLConstList options, void *compressor_user_data)
Callback of a compressor/decompressor.
Definition: cpl_compressor.h:70
CPLGetCompressors
char ** CPLGetCompressors(void)
Return the list of registered compressors.
Definition: cpl_compressor.cpp:1914
cpl_port.h
CPLGetDecompressors
char ** CPLGetDecompressors(void)
Return the list of registered decompressors.
Definition: cpl_compressor.cpp:1935
CPLCompressor::user_data
void * user_data
User data to provide to the callback.
Definition: cpl_compressor.h:104
CCT_FILTER
@ CCT_FILTER
Filter.
Definition: cpl_compressor.h:81
CPLCompressor::nStructVersion
int nStructVersion
Structure version.
Definition: cpl_compressor.h:88