/src/zstd/lib/compress/fse_compress.c
Line | Count | Source (jump to first uncovered line) |
1 | | /* ****************************************************************** |
2 | | * FSE : Finite State Entropy encoder |
3 | | * Copyright (c) Meta Platforms, Inc. and affiliates. |
4 | | * |
5 | | * You can contact the author at : |
6 | | * - FSE source repository : https://github.com/Cyan4973/FiniteStateEntropy |
7 | | * - Public forum : https://groups.google.com/forum/#!forum/lz4c |
8 | | * |
9 | | * This source code is licensed under both the BSD-style license (found in the |
10 | | * LICENSE file in the root directory of this source tree) and the GPLv2 (found |
11 | | * in the COPYING file in the root directory of this source tree). |
12 | | * You may select, at your option, one of the above-listed licenses. |
13 | | ****************************************************************** */ |
14 | | |
15 | | /* ************************************************************** |
16 | | * Includes |
17 | | ****************************************************************/ |
18 | | #include "../common/compiler.h" |
19 | | #include "../common/mem.h" /* U32, U16, etc. */ |
20 | | #include "../common/debug.h" /* assert, DEBUGLOG */ |
21 | | #include "hist.h" /* HIST_count_wksp */ |
22 | | #include "../common/bitstream.h" |
23 | | #define FSE_STATIC_LINKING_ONLY |
24 | | #include "../common/fse.h" |
25 | | #include "../common/error_private.h" |
26 | | #define ZSTD_DEPS_NEED_MALLOC |
27 | | #define ZSTD_DEPS_NEED_MATH64 |
28 | | #include "../common/zstd_deps.h" /* ZSTD_memset */ |
29 | | #include "../common/bits.h" /* ZSTD_highbit32 */ |
30 | | |
31 | | |
32 | | /* ************************************************************** |
33 | | * Error Management |
34 | | ****************************************************************/ |
35 | 0 | #define FSE_isError ERR_isError |
36 | | |
37 | | |
38 | | /* ************************************************************** |
39 | | * Templates |
40 | | ****************************************************************/ |
41 | | /* |
42 | | designed to be included |
43 | | for type-specific functions (template emulation in C) |
44 | | Objective is to write these functions only once, for improved maintenance |
45 | | */ |
46 | | |
47 | | /* safety checks */ |
48 | | #ifndef FSE_FUNCTION_EXTENSION |
49 | | # error "FSE_FUNCTION_EXTENSION must be defined" |
50 | | #endif |
51 | | #ifndef FSE_FUNCTION_TYPE |
52 | | # error "FSE_FUNCTION_TYPE must be defined" |
53 | | #endif |
54 | | |
55 | | /* Function names */ |
56 | | #define FSE_CAT(X,Y) X##Y |
57 | | #define FSE_FUNCTION_NAME(X,Y) FSE_CAT(X,Y) |
58 | | #define FSE_TYPE_NAME(X,Y) FSE_CAT(X,Y) |
59 | | |
60 | | |
61 | | /* Function templates */ |
62 | | |
63 | | /* FSE_buildCTable_wksp() : |
64 | | * Same as FSE_buildCTable(), but using an externally allocated scratch buffer (`workSpace`). |
65 | | * wkspSize should be sized to handle worst case situation, which is `1<<max_tableLog * sizeof(FSE_FUNCTION_TYPE)` |
66 | | * workSpace must also be properly aligned with FSE_FUNCTION_TYPE requirements |
67 | | */ |
68 | | size_t FSE_buildCTable_wksp(FSE_CTable* ct, |
69 | | const short* normalizedCounter, unsigned maxSymbolValue, unsigned tableLog, |
70 | | void* workSpace, size_t wkspSize) |
71 | 0 | { |
72 | 0 | U32 const tableSize = 1 << tableLog; |
73 | 0 | U32 const tableMask = tableSize - 1; |
74 | 0 | void* const ptr = ct; |
75 | 0 | U16* const tableU16 = ( (U16*) ptr) + 2; |
76 | 0 | void* const FSCT = ((U32*)ptr) + 1 /* header */ + (tableLog ? tableSize>>1 : 1) ; |
77 | 0 | FSE_symbolCompressionTransform* const symbolTT = (FSE_symbolCompressionTransform*) (FSCT); |
78 | 0 | U32 const step = FSE_TABLESTEP(tableSize); |
79 | 0 | U32 const maxSV1 = maxSymbolValue+1; |
80 | |
|
81 | 0 | U16* cumul = (U16*)workSpace; /* size = maxSV1 */ |
82 | 0 | FSE_FUNCTION_TYPE* const tableSymbol = (FSE_FUNCTION_TYPE*)(cumul + (maxSV1+1)); /* size = tableSize */ |
83 | |
|
84 | 0 | U32 highThreshold = tableSize-1; |
85 | |
|
86 | 0 | assert(((size_t)workSpace & 1) == 0); /* Must be 2 bytes-aligned */ |
87 | 0 | if (FSE_BUILD_CTABLE_WORKSPACE_SIZE(maxSymbolValue, tableLog) > wkspSize) return ERROR(tableLog_tooLarge); |
88 | | /* CTable header */ |
89 | 0 | tableU16[-2] = (U16) tableLog; |
90 | 0 | tableU16[-1] = (U16) maxSymbolValue; |
91 | 0 | assert(tableLog < 16); /* required for threshold strategy to work */ |
92 | | |
93 | | /* For explanations on how to distribute symbol values over the table : |
94 | | * https://fastcompression.blogspot.fr/2014/02/fse-distributing-symbol-values.html */ |
95 | |
|
96 | | #ifdef __clang_analyzer__ |
97 | | ZSTD_memset(tableSymbol, 0, sizeof(*tableSymbol) * tableSize); /* useless initialization, just to keep scan-build happy */ |
98 | | #endif |
99 | | |
100 | | /* symbol start positions */ |
101 | 0 | { U32 u; |
102 | 0 | cumul[0] = 0; |
103 | 0 | for (u=1; u <= maxSV1; u++) { |
104 | 0 | if (normalizedCounter[u-1]==-1) { /* Low proba symbol */ |
105 | 0 | cumul[u] = cumul[u-1] + 1; |
106 | 0 | tableSymbol[highThreshold--] = (FSE_FUNCTION_TYPE)(u-1); |
107 | 0 | } else { |
108 | 0 | assert(normalizedCounter[u-1] >= 0); |
109 | 0 | cumul[u] = cumul[u-1] + (U16)normalizedCounter[u-1]; |
110 | 0 | assert(cumul[u] >= cumul[u-1]); /* no overflow */ |
111 | 0 | } } |
112 | 0 | cumul[maxSV1] = (U16)(tableSize+1); |
113 | 0 | } |
114 | | |
115 | | /* Spread symbols */ |
116 | 0 | if (highThreshold == tableSize - 1) { |
117 | | /* Case for no low prob count symbols. Lay down 8 bytes at a time |
118 | | * to reduce branch misses since we are operating on a small block |
119 | | */ |
120 | 0 | BYTE* const spread = tableSymbol + tableSize; /* size = tableSize + 8 (may write beyond tableSize) */ |
121 | 0 | { U64 const add = 0x0101010101010101ull; |
122 | 0 | size_t pos = 0; |
123 | 0 | U64 sv = 0; |
124 | 0 | U32 s; |
125 | 0 | for (s=0; s<maxSV1; ++s, sv += add) { |
126 | 0 | int i; |
127 | 0 | int const n = normalizedCounter[s]; |
128 | 0 | MEM_write64(spread + pos, sv); |
129 | 0 | for (i = 8; i < n; i += 8) { |
130 | 0 | MEM_write64(spread + pos + i, sv); |
131 | 0 | } |
132 | 0 | assert(n>=0); |
133 | 0 | pos += (size_t)n; |
134 | 0 | } |
135 | 0 | } |
136 | | /* Spread symbols across the table. Lack of lowprob symbols means that |
137 | | * we don't need variable sized inner loop, so we can unroll the loop and |
138 | | * reduce branch misses. |
139 | | */ |
140 | 0 | { size_t position = 0; |
141 | 0 | size_t s; |
142 | 0 | size_t const unroll = 2; /* Experimentally determined optimal unroll */ |
143 | 0 | assert(tableSize % unroll == 0); /* FSE_MIN_TABLELOG is 5 */ |
144 | 0 | for (s = 0; s < (size_t)tableSize; s += unroll) { |
145 | 0 | size_t u; |
146 | 0 | for (u = 0; u < unroll; ++u) { |
147 | 0 | size_t const uPosition = (position + (u * step)) & tableMask; |
148 | 0 | tableSymbol[uPosition] = spread[s + u]; |
149 | 0 | } |
150 | 0 | position = (position + (unroll * step)) & tableMask; |
151 | 0 | } |
152 | 0 | assert(position == 0); /* Must have initialized all positions */ |
153 | 0 | } |
154 | 0 | } else { |
155 | 0 | U32 position = 0; |
156 | 0 | U32 symbol; |
157 | 0 | for (symbol=0; symbol<maxSV1; symbol++) { |
158 | 0 | int nbOccurrences; |
159 | 0 | int const freq = normalizedCounter[symbol]; |
160 | 0 | for (nbOccurrences=0; nbOccurrences<freq; nbOccurrences++) { |
161 | 0 | tableSymbol[position] = (FSE_FUNCTION_TYPE)symbol; |
162 | 0 | position = (position + step) & tableMask; |
163 | 0 | while (position > highThreshold) |
164 | 0 | position = (position + step) & tableMask; /* Low proba area */ |
165 | 0 | } } |
166 | 0 | assert(position==0); /* Must have initialized all positions */ |
167 | 0 | } |
168 | | |
169 | | /* Build table */ |
170 | 0 | { U32 u; for (u=0; u<tableSize; u++) { |
171 | 0 | FSE_FUNCTION_TYPE s = tableSymbol[u]; /* note : static analyzer may not understand tableSymbol is properly initialized */ |
172 | 0 | tableU16[cumul[s]++] = (U16) (tableSize+u); /* TableU16 : sorted by symbol order; gives next state value */ |
173 | 0 | } } |
174 | | |
175 | | /* Build Symbol Transformation Table */ |
176 | 0 | { unsigned total = 0; |
177 | 0 | unsigned s; |
178 | 0 | for (s=0; s<=maxSymbolValue; s++) { |
179 | 0 | switch (normalizedCounter[s]) |
180 | 0 | { |
181 | 0 | case 0: |
182 | | /* filling nonetheless, for compatibility with FSE_getMaxNbBits() */ |
183 | 0 | symbolTT[s].deltaNbBits = ((tableLog+1) << 16) - (1<<tableLog); |
184 | 0 | break; |
185 | | |
186 | 0 | case -1: |
187 | 0 | case 1: |
188 | 0 | symbolTT[s].deltaNbBits = (tableLog << 16) - (1<<tableLog); |
189 | 0 | assert(total <= INT_MAX); |
190 | 0 | symbolTT[s].deltaFindState = (int)(total - 1); |
191 | 0 | total ++; |
192 | 0 | break; |
193 | 0 | default : |
194 | 0 | assert(normalizedCounter[s] > 1); |
195 | 0 | { U32 const maxBitsOut = tableLog - ZSTD_highbit32 ((U32)normalizedCounter[s]-1); |
196 | 0 | U32 const minStatePlus = (U32)normalizedCounter[s] << maxBitsOut; |
197 | 0 | symbolTT[s].deltaNbBits = (maxBitsOut << 16) - minStatePlus; |
198 | 0 | symbolTT[s].deltaFindState = (int)(total - (unsigned)normalizedCounter[s]); |
199 | 0 | total += (unsigned)normalizedCounter[s]; |
200 | 0 | } } } } |
201 | | |
202 | | #if 0 /* debug : symbol costs */ |
203 | | DEBUGLOG(5, "\n --- table statistics : "); |
204 | | { U32 symbol; |
205 | | for (symbol=0; symbol<=maxSymbolValue; symbol++) { |
206 | | DEBUGLOG(5, "%3u: w=%3i, maxBits=%u, fracBits=%.2f", |
207 | | symbol, normalizedCounter[symbol], |
208 | | FSE_getMaxNbBits(symbolTT, symbol), |
209 | | (double)FSE_bitCost(symbolTT, tableLog, symbol, 8) / 256); |
210 | | } } |
211 | | #endif |
212 | | |
213 | 0 | return 0; |
214 | 0 | } |
215 | | |
216 | | |
217 | | |
218 | | #ifndef FSE_COMMONDEFS_ONLY |
219 | | |
220 | | /*-************************************************************** |
221 | | * FSE NCount encoding |
222 | | ****************************************************************/ |
223 | | size_t FSE_NCountWriteBound(unsigned maxSymbolValue, unsigned tableLog) |
224 | 0 | { |
225 | 0 | size_t const maxHeaderSize = (((maxSymbolValue+1) * tableLog |
226 | 0 | + 4 /* bitCount initialized at 4 */ |
227 | 0 | + 2 /* first two symbols may use one additional bit each */) / 8) |
228 | 0 | + 1 /* round up to whole nb bytes */ |
229 | 0 | + 2 /* additional two bytes for bitstream flush */; |
230 | 0 | return maxSymbolValue ? maxHeaderSize : FSE_NCOUNTBOUND; /* maxSymbolValue==0 ? use default */ |
231 | 0 | } |
232 | | |
233 | | static size_t |
234 | | FSE_writeNCount_generic (void* header, size_t headerBufferSize, |
235 | | const short* normalizedCounter, unsigned maxSymbolValue, unsigned tableLog, |
236 | | unsigned writeIsSafe) |
237 | 0 | { |
238 | 0 | BYTE* const ostart = (BYTE*) header; |
239 | 0 | BYTE* out = ostart; |
240 | 0 | BYTE* const oend = ostart + headerBufferSize; |
241 | 0 | int nbBits; |
242 | 0 | const int tableSize = 1 << tableLog; |
243 | 0 | int remaining; |
244 | 0 | int threshold; |
245 | 0 | U32 bitStream = 0; |
246 | 0 | int bitCount = 0; |
247 | 0 | unsigned symbol = 0; |
248 | 0 | unsigned const alphabetSize = maxSymbolValue + 1; |
249 | 0 | int previousIs0 = 0; |
250 | | |
251 | | /* Table Size */ |
252 | 0 | bitStream += (tableLog-FSE_MIN_TABLELOG) << bitCount; |
253 | 0 | bitCount += 4; |
254 | | |
255 | | /* Init */ |
256 | 0 | remaining = tableSize+1; /* +1 for extra accuracy */ |
257 | 0 | threshold = tableSize; |
258 | 0 | nbBits = (int)tableLog+1; |
259 | |
|
260 | 0 | while ((symbol < alphabetSize) && (remaining>1)) { /* stops at 1 */ |
261 | 0 | if (previousIs0) { |
262 | 0 | unsigned start = symbol; |
263 | 0 | while ((symbol < alphabetSize) && !normalizedCounter[symbol]) symbol++; |
264 | 0 | if (symbol == alphabetSize) break; /* incorrect distribution */ |
265 | 0 | while (symbol >= start+24) { |
266 | 0 | start+=24; |
267 | 0 | bitStream += 0xFFFFU << bitCount; |
268 | 0 | if ((!writeIsSafe) && (out > oend-2)) |
269 | 0 | return ERROR(dstSize_tooSmall); /* Buffer overflow */ |
270 | 0 | out[0] = (BYTE) bitStream; |
271 | 0 | out[1] = (BYTE)(bitStream>>8); |
272 | 0 | out+=2; |
273 | 0 | bitStream>>=16; |
274 | 0 | } |
275 | 0 | while (symbol >= start+3) { |
276 | 0 | start+=3; |
277 | 0 | bitStream += 3U << bitCount; |
278 | 0 | bitCount += 2; |
279 | 0 | } |
280 | 0 | bitStream += (symbol-start) << bitCount; |
281 | 0 | bitCount += 2; |
282 | 0 | if (bitCount>16) { |
283 | 0 | if ((!writeIsSafe) && (out > oend - 2)) |
284 | 0 | return ERROR(dstSize_tooSmall); /* Buffer overflow */ |
285 | 0 | out[0] = (BYTE)bitStream; |
286 | 0 | out[1] = (BYTE)(bitStream>>8); |
287 | 0 | out += 2; |
288 | 0 | bitStream >>= 16; |
289 | 0 | bitCount -= 16; |
290 | 0 | } } |
291 | 0 | { int count = normalizedCounter[symbol++]; |
292 | 0 | int const max = (2*threshold-1) - remaining; |
293 | 0 | remaining -= count < 0 ? -count : count; |
294 | 0 | count++; /* +1 for extra accuracy */ |
295 | 0 | if (count>=threshold) |
296 | 0 | count += max; /* [0..max[ [max..threshold[ (...) [threshold+max 2*threshold[ */ |
297 | 0 | bitStream += (U32)count << bitCount; |
298 | 0 | bitCount += nbBits; |
299 | 0 | bitCount -= (count<max); |
300 | 0 | previousIs0 = (count==1); |
301 | 0 | if (remaining<1) return ERROR(GENERIC); |
302 | 0 | while (remaining<threshold) { nbBits--; threshold>>=1; } |
303 | 0 | } |
304 | 0 | if (bitCount>16) { |
305 | 0 | if ((!writeIsSafe) && (out > oend - 2)) |
306 | 0 | return ERROR(dstSize_tooSmall); /* Buffer overflow */ |
307 | 0 | out[0] = (BYTE)bitStream; |
308 | 0 | out[1] = (BYTE)(bitStream>>8); |
309 | 0 | out += 2; |
310 | 0 | bitStream >>= 16; |
311 | 0 | bitCount -= 16; |
312 | 0 | } } |
313 | | |
314 | 0 | if (remaining != 1) |
315 | 0 | return ERROR(GENERIC); /* incorrect normalized distribution */ |
316 | 0 | assert(symbol <= alphabetSize); |
317 | | |
318 | | /* flush remaining bitStream */ |
319 | 0 | if ((!writeIsSafe) && (out > oend - 2)) |
320 | 0 | return ERROR(dstSize_tooSmall); /* Buffer overflow */ |
321 | 0 | out[0] = (BYTE)bitStream; |
322 | 0 | out[1] = (BYTE)(bitStream>>8); |
323 | 0 | out+= (bitCount+7) /8; |
324 | |
|
325 | 0 | assert(out >= ostart); |
326 | 0 | return (size_t)(out-ostart); |
327 | 0 | } |
328 | | |
329 | | |
330 | | size_t FSE_writeNCount (void* buffer, size_t bufferSize, |
331 | | const short* normalizedCounter, unsigned maxSymbolValue, unsigned tableLog) |
332 | 0 | { |
333 | 0 | if (tableLog > FSE_MAX_TABLELOG) return ERROR(tableLog_tooLarge); /* Unsupported */ |
334 | 0 | if (tableLog < FSE_MIN_TABLELOG) return ERROR(GENERIC); /* Unsupported */ |
335 | | |
336 | 0 | if (bufferSize < FSE_NCountWriteBound(maxSymbolValue, tableLog)) |
337 | 0 | return FSE_writeNCount_generic(buffer, bufferSize, normalizedCounter, maxSymbolValue, tableLog, 0); |
338 | | |
339 | 0 | return FSE_writeNCount_generic(buffer, bufferSize, normalizedCounter, maxSymbolValue, tableLog, 1 /* write in buffer is safe */); |
340 | 0 | } |
341 | | |
342 | | |
343 | | /*-************************************************************** |
344 | | * FSE Compression Code |
345 | | ****************************************************************/ |
346 | | |
347 | | /* provides the minimum logSize to safely represent a distribution */ |
348 | | static unsigned FSE_minTableLog(size_t srcSize, unsigned maxSymbolValue) |
349 | 0 | { |
350 | 0 | U32 minBitsSrc = ZSTD_highbit32((U32)(srcSize)) + 1; |
351 | 0 | U32 minBitsSymbols = ZSTD_highbit32(maxSymbolValue) + 2; |
352 | 0 | U32 minBits = minBitsSrc < minBitsSymbols ? minBitsSrc : minBitsSymbols; |
353 | 0 | assert(srcSize > 1); /* Not supported, RLE should be used instead */ |
354 | 0 | return minBits; |
355 | 0 | } |
356 | | |
357 | | unsigned FSE_optimalTableLog_internal(unsigned maxTableLog, size_t srcSize, unsigned maxSymbolValue, unsigned minus) |
358 | 0 | { |
359 | 0 | U32 maxBitsSrc = ZSTD_highbit32((U32)(srcSize - 1)) - minus; |
360 | 0 | U32 tableLog = maxTableLog; |
361 | 0 | U32 minBits = FSE_minTableLog(srcSize, maxSymbolValue); |
362 | 0 | assert(srcSize > 1); /* Not supported, RLE should be used instead */ |
363 | 0 | if (tableLog==0) tableLog = FSE_DEFAULT_TABLELOG; |
364 | 0 | if (maxBitsSrc < tableLog) tableLog = maxBitsSrc; /* Accuracy can be reduced */ |
365 | 0 | if (minBits > tableLog) tableLog = minBits; /* Need a minimum to safely represent all symbol values */ |
366 | 0 | if (tableLog < FSE_MIN_TABLELOG) tableLog = FSE_MIN_TABLELOG; |
367 | 0 | if (tableLog > FSE_MAX_TABLELOG) tableLog = FSE_MAX_TABLELOG; |
368 | 0 | return tableLog; |
369 | 0 | } |
370 | | |
371 | | unsigned FSE_optimalTableLog(unsigned maxTableLog, size_t srcSize, unsigned maxSymbolValue) |
372 | 0 | { |
373 | 0 | return FSE_optimalTableLog_internal(maxTableLog, srcSize, maxSymbolValue, 2); |
374 | 0 | } |
375 | | |
376 | | /* Secondary normalization method. |
377 | | To be used when primary method fails. */ |
378 | | |
379 | | static size_t FSE_normalizeM2(short* norm, U32 tableLog, const unsigned* count, size_t total, U32 maxSymbolValue, short lowProbCount) |
380 | 0 | { |
381 | 0 | short const NOT_YET_ASSIGNED = -2; |
382 | 0 | U32 s; |
383 | 0 | U32 distributed = 0; |
384 | 0 | U32 ToDistribute; |
385 | | |
386 | | /* Init */ |
387 | 0 | U32 const lowThreshold = (U32)(total >> tableLog); |
388 | 0 | U32 lowOne = (U32)((total * 3) >> (tableLog + 1)); |
389 | |
|
390 | 0 | for (s=0; s<=maxSymbolValue; s++) { |
391 | 0 | if (count[s] == 0) { |
392 | 0 | norm[s]=0; |
393 | 0 | continue; |
394 | 0 | } |
395 | 0 | if (count[s] <= lowThreshold) { |
396 | 0 | norm[s] = lowProbCount; |
397 | 0 | distributed++; |
398 | 0 | total -= count[s]; |
399 | 0 | continue; |
400 | 0 | } |
401 | 0 | if (count[s] <= lowOne) { |
402 | 0 | norm[s] = 1; |
403 | 0 | distributed++; |
404 | 0 | total -= count[s]; |
405 | 0 | continue; |
406 | 0 | } |
407 | | |
408 | 0 | norm[s]=NOT_YET_ASSIGNED; |
409 | 0 | } |
410 | 0 | ToDistribute = (1 << tableLog) - distributed; |
411 | |
|
412 | 0 | if (ToDistribute == 0) |
413 | 0 | return 0; |
414 | | |
415 | 0 | if ((total / ToDistribute) > lowOne) { |
416 | | /* risk of rounding to zero */ |
417 | 0 | lowOne = (U32)((total * 3) / (ToDistribute * 2)); |
418 | 0 | for (s=0; s<=maxSymbolValue; s++) { |
419 | 0 | if ((norm[s] == NOT_YET_ASSIGNED) && (count[s] <= lowOne)) { |
420 | 0 | norm[s] = 1; |
421 | 0 | distributed++; |
422 | 0 | total -= count[s]; |
423 | 0 | continue; |
424 | 0 | } } |
425 | 0 | ToDistribute = (1 << tableLog) - distributed; |
426 | 0 | } |
427 | |
|
428 | 0 | if (distributed == maxSymbolValue+1) { |
429 | | /* all values are pretty poor; |
430 | | probably incompressible data (should have already been detected); |
431 | | find max, then give all remaining points to max */ |
432 | 0 | U32 maxV = 0, maxC = 0; |
433 | 0 | for (s=0; s<=maxSymbolValue; s++) |
434 | 0 | if (count[s] > maxC) { maxV=s; maxC=count[s]; } |
435 | 0 | norm[maxV] += (short)ToDistribute; |
436 | 0 | return 0; |
437 | 0 | } |
438 | | |
439 | 0 | if (total == 0) { |
440 | | /* all of the symbols were low enough for the lowOne or lowThreshold */ |
441 | 0 | for (s=0; ToDistribute > 0; s = (s+1)%(maxSymbolValue+1)) |
442 | 0 | if (norm[s] > 0) { ToDistribute--; norm[s]++; } |
443 | 0 | return 0; |
444 | 0 | } |
445 | | |
446 | 0 | { U64 const vStepLog = 62 - tableLog; |
447 | 0 | U64 const mid = (1ULL << (vStepLog-1)) - 1; |
448 | 0 | U64 const rStep = ZSTD_div64((((U64)1<<vStepLog) * ToDistribute) + mid, (U32)total); /* scale on remaining */ |
449 | 0 | U64 tmpTotal = mid; |
450 | 0 | for (s=0; s<=maxSymbolValue; s++) { |
451 | 0 | if (norm[s]==NOT_YET_ASSIGNED) { |
452 | 0 | U64 const end = tmpTotal + (count[s] * rStep); |
453 | 0 | U32 const sStart = (U32)(tmpTotal >> vStepLog); |
454 | 0 | U32 const sEnd = (U32)(end >> vStepLog); |
455 | 0 | U32 const weight = sEnd - sStart; |
456 | 0 | if (weight < 1) |
457 | 0 | return ERROR(GENERIC); |
458 | 0 | norm[s] = (short)weight; |
459 | 0 | tmpTotal = end; |
460 | 0 | } } } |
461 | | |
462 | 0 | return 0; |
463 | 0 | } |
464 | | |
465 | | size_t FSE_normalizeCount (short* normalizedCounter, unsigned tableLog, |
466 | | const unsigned* count, size_t total, |
467 | | unsigned maxSymbolValue, unsigned useLowProbCount) |
468 | 0 | { |
469 | | /* Sanity checks */ |
470 | 0 | if (tableLog==0) tableLog = FSE_DEFAULT_TABLELOG; |
471 | 0 | if (tableLog < FSE_MIN_TABLELOG) return ERROR(GENERIC); /* Unsupported size */ |
472 | 0 | if (tableLog > FSE_MAX_TABLELOG) return ERROR(tableLog_tooLarge); /* Unsupported size */ |
473 | 0 | if (tableLog < FSE_minTableLog(total, maxSymbolValue)) return ERROR(GENERIC); /* Too small tableLog, compression potentially impossible */ |
474 | | |
475 | 0 | { static U32 const rtbTable[] = { 0, 473195, 504333, 520860, 550000, 700000, 750000, 830000 }; |
476 | 0 | short const lowProbCount = useLowProbCount ? -1 : 1; |
477 | 0 | U64 const scale = 62 - tableLog; |
478 | 0 | U64 const step = ZSTD_div64((U64)1<<62, (U32)total); /* <== here, one division ! */ |
479 | 0 | U64 const vStep = 1ULL<<(scale-20); |
480 | 0 | int stillToDistribute = 1<<tableLog; |
481 | 0 | unsigned s; |
482 | 0 | unsigned largest=0; |
483 | 0 | short largestP=0; |
484 | 0 | U32 lowThreshold = (U32)(total >> tableLog); |
485 | |
|
486 | 0 | for (s=0; s<=maxSymbolValue; s++) { |
487 | 0 | if (count[s] == total) return 0; /* rle special case */ |
488 | 0 | if (count[s] == 0) { normalizedCounter[s]=0; continue; } |
489 | 0 | if (count[s] <= lowThreshold) { |
490 | 0 | normalizedCounter[s] = lowProbCount; |
491 | 0 | stillToDistribute--; |
492 | 0 | } else { |
493 | 0 | short proba = (short)((count[s]*step) >> scale); |
494 | 0 | if (proba<8) { |
495 | 0 | U64 restToBeat = vStep * rtbTable[proba]; |
496 | 0 | proba += (count[s]*step) - ((U64)proba<<scale) > restToBeat; |
497 | 0 | } |
498 | 0 | if (proba > largestP) { largestP=proba; largest=s; } |
499 | 0 | normalizedCounter[s] = proba; |
500 | 0 | stillToDistribute -= proba; |
501 | 0 | } } |
502 | 0 | if (-stillToDistribute >= (normalizedCounter[largest] >> 1)) { |
503 | | /* corner case, need another normalization method */ |
504 | 0 | size_t const errorCode = FSE_normalizeM2(normalizedCounter, tableLog, count, total, maxSymbolValue, lowProbCount); |
505 | 0 | if (FSE_isError(errorCode)) return errorCode; |
506 | 0 | } |
507 | 0 | else normalizedCounter[largest] += (short)stillToDistribute; |
508 | 0 | } |
509 | | |
510 | | #if 0 |
511 | | { /* Print Table (debug) */ |
512 | | U32 s; |
513 | | U32 nTotal = 0; |
514 | | for (s=0; s<=maxSymbolValue; s++) |
515 | | RAWLOG(2, "%3i: %4i \n", s, normalizedCounter[s]); |
516 | | for (s=0; s<=maxSymbolValue; s++) |
517 | | nTotal += abs(normalizedCounter[s]); |
518 | | if (nTotal != (1U<<tableLog)) |
519 | | RAWLOG(2, "Warning !!! Total == %u != %u !!!", nTotal, 1U<<tableLog); |
520 | | getchar(); |
521 | | } |
522 | | #endif |
523 | | |
524 | 0 | return tableLog; |
525 | 0 | } |
526 | | |
527 | | /* fake FSE_CTable, for rle input (always same symbol) */ |
528 | | size_t FSE_buildCTable_rle (FSE_CTable* ct, BYTE symbolValue) |
529 | 0 | { |
530 | 0 | void* ptr = ct; |
531 | 0 | U16* tableU16 = ( (U16*) ptr) + 2; |
532 | 0 | void* FSCTptr = (U32*)ptr + 2; |
533 | 0 | FSE_symbolCompressionTransform* symbolTT = (FSE_symbolCompressionTransform*) FSCTptr; |
534 | | |
535 | | /* header */ |
536 | 0 | tableU16[-2] = (U16) 0; |
537 | 0 | tableU16[-1] = (U16) symbolValue; |
538 | | |
539 | | /* Build table */ |
540 | 0 | tableU16[0] = 0; |
541 | 0 | tableU16[1] = 0; /* just in case */ |
542 | | |
543 | | /* Build Symbol Transformation Table */ |
544 | 0 | symbolTT[symbolValue].deltaNbBits = 0; |
545 | 0 | symbolTT[symbolValue].deltaFindState = 0; |
546 | |
|
547 | 0 | return 0; |
548 | 0 | } |
549 | | |
550 | | |
551 | | static size_t FSE_compress_usingCTable_generic (void* dst, size_t dstSize, |
552 | | const void* src, size_t srcSize, |
553 | | const FSE_CTable* ct, const unsigned fast) |
554 | 0 | { |
555 | 0 | const BYTE* const istart = (const BYTE*) src; |
556 | 0 | const BYTE* const iend = istart + srcSize; |
557 | 0 | const BYTE* ip=iend; |
558 | |
|
559 | 0 | BIT_CStream_t bitC; |
560 | 0 | FSE_CState_t CState1, CState2; |
561 | | |
562 | | /* init */ |
563 | 0 | if (srcSize <= 2) return 0; |
564 | 0 | { size_t const initError = BIT_initCStream(&bitC, dst, dstSize); |
565 | 0 | if (FSE_isError(initError)) return 0; /* not enough space available to write a bitstream */ } |
566 | | |
567 | 0 | #define FSE_FLUSHBITS(s) (fast ? BIT_flushBitsFast(s) : BIT_flushBits(s)) |
568 | | |
569 | 0 | if (srcSize & 1) { |
570 | 0 | FSE_initCState2(&CState1, ct, *--ip); |
571 | 0 | FSE_initCState2(&CState2, ct, *--ip); |
572 | 0 | FSE_encodeSymbol(&bitC, &CState1, *--ip); |
573 | 0 | FSE_FLUSHBITS(&bitC); |
574 | 0 | } else { |
575 | 0 | FSE_initCState2(&CState2, ct, *--ip); |
576 | 0 | FSE_initCState2(&CState1, ct, *--ip); |
577 | 0 | } |
578 | | |
579 | | /* join to mod 4 */ |
580 | 0 | srcSize -= 2; |
581 | 0 | if ((sizeof(bitC.bitContainer)*8 > FSE_MAX_TABLELOG*4+7 ) && (srcSize & 2)) { /* test bit 2 */ |
582 | 0 | FSE_encodeSymbol(&bitC, &CState2, *--ip); |
583 | 0 | FSE_encodeSymbol(&bitC, &CState1, *--ip); |
584 | 0 | FSE_FLUSHBITS(&bitC); |
585 | 0 | } |
586 | | |
587 | | /* 2 or 4 encoding per loop */ |
588 | 0 | while ( ip>istart ) { |
589 | |
|
590 | 0 | FSE_encodeSymbol(&bitC, &CState2, *--ip); |
591 | |
|
592 | 0 | if (sizeof(bitC.bitContainer)*8 < FSE_MAX_TABLELOG*2+7 ) /* this test must be static */ |
593 | 0 | FSE_FLUSHBITS(&bitC); |
594 | |
|
595 | 0 | FSE_encodeSymbol(&bitC, &CState1, *--ip); |
596 | |
|
597 | 0 | if (sizeof(bitC.bitContainer)*8 > FSE_MAX_TABLELOG*4+7 ) { /* this test must be static */ |
598 | 0 | FSE_encodeSymbol(&bitC, &CState2, *--ip); |
599 | 0 | FSE_encodeSymbol(&bitC, &CState1, *--ip); |
600 | 0 | } |
601 | |
|
602 | 0 | FSE_FLUSHBITS(&bitC); |
603 | 0 | } |
604 | |
|
605 | 0 | FSE_flushCState(&bitC, &CState2); |
606 | 0 | FSE_flushCState(&bitC, &CState1); |
607 | 0 | return BIT_closeCStream(&bitC); |
608 | 0 | } |
609 | | |
610 | | size_t FSE_compress_usingCTable (void* dst, size_t dstSize, |
611 | | const void* src, size_t srcSize, |
612 | | const FSE_CTable* ct) |
613 | 0 | { |
614 | 0 | unsigned const fast = (dstSize >= FSE_BLOCKBOUND(srcSize)); |
615 | |
|
616 | 0 | if (fast) |
617 | 0 | return FSE_compress_usingCTable_generic(dst, dstSize, src, srcSize, ct, 1); |
618 | 0 | else |
619 | 0 | return FSE_compress_usingCTable_generic(dst, dstSize, src, srcSize, ct, 0); |
620 | 0 | } |
621 | | |
622 | | |
623 | 0 | size_t FSE_compressBound(size_t size) { return FSE_COMPRESSBOUND(size); } |
624 | | |
625 | | #endif /* FSE_COMMONDEFS_ONLY */ |