1 ///////////////////////////////////////////////////////////////////////////////
3 /// \file filter_decoder.c
4 /// \brief Filter ID mapping to filter-specific functions
6 // Author: Lasse Collin
8 // This file has been put into the public domain.
9 // You can do whatever you want with this file.
11 ///////////////////////////////////////////////////////////////////////////////
13 #include "filter_encoder.h"
14 #include "filter_common.h"
15 #include "lzma_encoder.h"
16 #include "lzma2_encoder.h"
17 #include "simple_encoder.h"
18 #include "delta_encoder.h"
25 /// Initializes the filter encoder and calls lzma_next_filter_init()
27 lzma_init_function init;
29 /// Calculates memory usage of the encoder. If the options are
30 /// invalid, UINT64_MAX is returned.
31 uint64_t (*memusage)(const void *options);
33 /// Calculates the minimum sane size for Blocks (or other types of
34 /// chunks) to which the input data can be split to make
35 /// multithreaded encoding possible. If this is NULL, it is assumed
36 /// that the encoder is fast enough with single thread.
37 lzma_vli (*chunk_size)(const void *options);
39 /// Tells the size of the Filter Properties field. If options are
40 /// invalid, UINT32_MAX is returned. If this is NULL, props_size_fixed
42 lzma_ret (*props_size_get)(uint32_t *size, const void *options);
43 uint32_t props_size_fixed;
45 /// Encodes Filter Properties.
47 /// \return - LZMA_OK: Properties encoded successfully.
48 /// - LZMA_OPTIONS_ERROR: Unsupported options
49 /// - LZMA_PROG_ERROR: Invalid options or not enough
51 lzma_ret (*props_encode)(const void *options, uint8_t *out);
53 } lzma_filter_encoder;
56 static const lzma_filter_encoder encoders[] = {
57 #ifdef HAVE_ENCODER_LZMA1
59 .id = LZMA_FILTER_LZMA1,
60 .init = &lzma_lzma_encoder_init,
61 .memusage = &lzma_lzma_encoder_memusage,
62 .chunk_size = NULL, // FIXME
63 .props_size_get = NULL,
64 .props_size_fixed = 5,
65 .props_encode = &lzma_lzma_props_encode,
68 #ifdef HAVE_ENCODER_LZMA2
70 .id = LZMA_FILTER_LZMA2,
71 .init = &lzma_lzma2_encoder_init,
72 .memusage = &lzma_lzma2_encoder_memusage,
73 .chunk_size = NULL, // FIXME
74 .props_size_get = NULL,
75 .props_size_fixed = 1,
76 .props_encode = &lzma_lzma2_props_encode,
79 #ifdef HAVE_ENCODER_X86
81 .id = LZMA_FILTER_X86,
82 .init = &lzma_simple_x86_encoder_init,
85 .props_size_get = &lzma_simple_props_size,
86 .props_encode = &lzma_simple_props_encode,
89 #ifdef HAVE_ENCODER_POWERPC
91 .id = LZMA_FILTER_POWERPC,
92 .init = &lzma_simple_powerpc_encoder_init,
95 .props_size_get = &lzma_simple_props_size,
96 .props_encode = &lzma_simple_props_encode,
99 #ifdef HAVE_ENCODER_IA64
101 .id = LZMA_FILTER_IA64,
102 .init = &lzma_simple_ia64_encoder_init,
105 .props_size_get = &lzma_simple_props_size,
106 .props_encode = &lzma_simple_props_encode,
109 #ifdef HAVE_ENCODER_ARM
111 .id = LZMA_FILTER_ARM,
112 .init = &lzma_simple_arm_encoder_init,
115 .props_size_get = &lzma_simple_props_size,
116 .props_encode = &lzma_simple_props_encode,
119 #ifdef HAVE_ENCODER_ARMTHUMB
121 .id = LZMA_FILTER_ARMTHUMB,
122 .init = &lzma_simple_armthumb_encoder_init,
125 .props_size_get = &lzma_simple_props_size,
126 .props_encode = &lzma_simple_props_encode,
129 #ifdef HAVE_ENCODER_SPARC
131 .id = LZMA_FILTER_SPARC,
132 .init = &lzma_simple_sparc_encoder_init,
135 .props_size_get = &lzma_simple_props_size,
136 .props_encode = &lzma_simple_props_encode,
139 #ifdef HAVE_ENCODER_DELTA
141 .id = LZMA_FILTER_DELTA,
142 .init = &lzma_delta_encoder_init,
143 .memusage = &lzma_delta_coder_memusage,
145 .props_size_get = NULL,
146 .props_size_fixed = 1,
147 .props_encode = &lzma_delta_props_encode,
153 static const lzma_filter_encoder *
154 encoder_find(lzma_vli id)
157 for (i = 0; i < ARRAY_SIZE(encoders); ++i)
158 if (encoders[i].id == id)
165 extern LZMA_API(lzma_bool)
166 lzma_filter_encoder_is_supported(lzma_vli id)
168 return encoder_find(id) != NULL;
172 extern LZMA_API(lzma_ret)
173 lzma_filters_update(lzma_stream *strm, const lzma_filter *filters)
175 if (strm->internal->next.update == NULL)
176 return LZMA_PROG_ERROR;
178 // Validate the filter chain.
179 if (lzma_raw_encoder_memusage(filters) == UINT64_MAX)
180 return LZMA_OPTIONS_ERROR;
182 // The actual filter chain in the encoder is reversed. Some things
183 // still want the normal order chain, so we provide both.
185 while (filters[count].id != LZMA_VLI_UNKNOWN)
188 lzma_filter reversed_filters[LZMA_FILTERS_MAX + 1];
190 for (i = 0; i < count; ++i)
191 reversed_filters[count - i - 1] = filters[i];
193 reversed_filters[count].id = LZMA_VLI_UNKNOWN;
195 return strm->internal->next.update(strm->internal->next.coder,
196 strm->allocator, filters, reversed_filters);
201 lzma_raw_encoder_init(lzma_next_coder *next, lzma_allocator *allocator,
202 const lzma_filter *options)
204 return lzma_raw_coder_init(next, allocator,
205 options, (lzma_filter_find)(&encoder_find), true);
209 extern LZMA_API(lzma_ret)
210 lzma_raw_encoder(lzma_stream *strm, const lzma_filter *options)
212 lzma_next_strm_init(lzma_raw_coder_init, strm, options,
213 (lzma_filter_find)(&encoder_find), true);
215 strm->internal->supported_actions[LZMA_RUN] = true;
216 strm->internal->supported_actions[LZMA_SYNC_FLUSH] = true;
217 strm->internal->supported_actions[LZMA_FINISH] = true;
223 extern LZMA_API(uint64_t)
224 lzma_raw_encoder_memusage(const lzma_filter *filters)
226 return lzma_raw_coder_memusage(
227 (lzma_filter_find)(&encoder_find), filters);
232 extern LZMA_API(lzma_vli)
233 lzma_chunk_size(const lzma_filter *filters)
237 for (size_t i = 0; filters[i].id != LZMA_VLI_UNKNOWN; ++i) {
238 const lzma_filter_encoder *const fe
239 = encoder_find(filters[i].id);
240 if (fe->chunk_size != NULL) {
242 = fe->chunk_size(filters[i].options);
243 if (size == LZMA_VLI_UNKNOWN)
244 return LZMA_VLI_UNKNOWN;
256 extern LZMA_API(lzma_ret)
257 lzma_properties_size(uint32_t *size, const lzma_filter *filter)
259 const lzma_filter_encoder *const fe = encoder_find(filter->id);
261 // Unknown filter - if the Filter ID is a proper VLI,
262 // return LZMA_OPTIONS_ERROR instead of LZMA_PROG_ERROR,
263 // because it's possible that we just don't have support
264 // compiled in for the requested filter.
265 return filter->id <= LZMA_VLI_MAX
266 ? LZMA_OPTIONS_ERROR : LZMA_PROG_ERROR;
269 if (fe->props_size_get == NULL) {
270 // No props_size_get() function, use props_size_fixed.
271 *size = fe->props_size_fixed;
275 return fe->props_size_get(size, filter->options);
279 extern LZMA_API(lzma_ret)
280 lzma_properties_encode(const lzma_filter *filter, uint8_t *props)
282 const lzma_filter_encoder *const fe = encoder_find(filter->id);
284 return LZMA_PROG_ERROR;
286 if (fe->props_encode == NULL)
289 return fe->props_encode(filter->options, props);