mirror of
https://github.com/godotengine/godot
synced 2024-09-05 20:59:56 +00:00
![Rémi Verschelde](/assets/img/avatar_default.png)
Upstream development restarted after 13 years. Changes: 2020-02-02: Version 0.5.0 Minor speed improvement on the decompressor. Prevent memory violation when decompressing corrupted input. 2020-01-10: Version 0.4.0 Only code & infrastructure clean-up, no new functionality.
592 lines
15 KiB
C
592 lines
15 KiB
C
/*
|
|
FastLZ - Byte-aligned LZ77 compression library
|
|
Copyright (C) 2005-2020 Ariya Hidayat <ariya.hidayat@gmail.com>
|
|
|
|
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.
|
|
*/
|
|
|
|
#include "fastlz.h"
|
|
|
|
#include <stdint.h>
|
|
|
|
/*
|
|
* Always check for bound when decompressing.
|
|
* Generally it is best to leave it defined.
|
|
*/
|
|
#define FASTLZ_SAFE
|
|
#if defined(FASTLZ_USE_SAFE_DECOMPRESSOR) && (FASTLZ_USE_SAFE_DECOMPRESSOR == 0)
|
|
#undef FASTLZ_SAFE
|
|
#endif
|
|
|
|
/*
|
|
* Give hints to the compiler for branch prediction optimization.
|
|
*/
|
|
#if defined(__clang__) || (defined(__GNUC__) && (__GNUC__ > 2))
|
|
#define FASTLZ_LIKELY(c) (__builtin_expect(!!(c), 1))
|
|
#define FASTLZ_UNLIKELY(c) (__builtin_expect(!!(c), 0))
|
|
#else
|
|
#define FASTLZ_LIKELY(c) (c)
|
|
#define FASTLZ_UNLIKELY(c) (c)
|
|
#endif
|
|
|
|
#if defined(FASTLZ_SAFE)
|
|
#define FASTLZ_BOUND_CHECK(cond) \
|
|
if (FASTLZ_UNLIKELY(!(cond))) return 0;
|
|
#else
|
|
#define FASTLZ_BOUND_CHECK(cond) \
|
|
do { \
|
|
} while (0)
|
|
#endif
|
|
|
|
#define MAX_COPY 32
|
|
#define MAX_LEN 264 /* 256 + 8 */
|
|
#define MAX_L1_DISTANCE 8192
|
|
#define MAX_L2_DISTANCE 8191
|
|
#define MAX_FARDISTANCE (65535 + MAX_L2_DISTANCE - 1)
|
|
|
|
#define FASTLZ_READU16(p) ((p)[0] | (p)[1] << 8)
|
|
|
|
#define HASH_LOG 13
|
|
#define HASH_SIZE (1 << HASH_LOG)
|
|
#define HASH_MASK (HASH_SIZE - 1)
|
|
#define HASH_FUNCTION(v, p) \
|
|
{ \
|
|
v = FASTLZ_READU16(p); \
|
|
v ^= FASTLZ_READU16(p + 1) ^ (v >> (16 - HASH_LOG)); \
|
|
v &= HASH_MASK; \
|
|
}
|
|
|
|
int fastlz1_compress(const void* input, int length, void* output) {
|
|
const uint8_t* ip = (const uint8_t*)input;
|
|
const uint8_t* ip_bound = ip + length - 2;
|
|
const uint8_t* ip_limit = ip + length - 12 - 1;
|
|
uint8_t* op = (uint8_t*)output;
|
|
|
|
const uint8_t* htab[HASH_SIZE];
|
|
uint32_t hval;
|
|
|
|
uint32_t copy;
|
|
|
|
/* sanity check */
|
|
if (FASTLZ_UNLIKELY(length < 4)) {
|
|
if (length) {
|
|
/* create literal copy only */
|
|
*op++ = length - 1;
|
|
ip_bound++;
|
|
while (ip <= ip_bound) *op++ = *ip++;
|
|
return length + 1;
|
|
} else
|
|
return 0;
|
|
}
|
|
|
|
/* initializes hash table */
|
|
for (hval = 0; hval < HASH_SIZE; ++hval) htab[hval] = ip;
|
|
|
|
/* we start with literal copy */
|
|
copy = 2;
|
|
*op++ = MAX_COPY - 1;
|
|
*op++ = *ip++;
|
|
*op++ = *ip++;
|
|
|
|
/* main loop */
|
|
while (FASTLZ_LIKELY(ip < ip_limit)) {
|
|
const uint8_t* ref;
|
|
uint32_t distance;
|
|
|
|
/* minimum match length */
|
|
uint32_t len = 3;
|
|
|
|
/* comparison starting-point */
|
|
const uint8_t* anchor = ip;
|
|
|
|
/* find potential match */
|
|
HASH_FUNCTION(hval, ip);
|
|
ref = htab[hval];
|
|
|
|
/* update hash table */
|
|
htab[hval] = anchor;
|
|
|
|
/* calculate distance to the match */
|
|
distance = anchor - ref;
|
|
|
|
/* is this a match? check the first 3 bytes */
|
|
if (distance == 0 || (distance >= MAX_L1_DISTANCE) || *ref++ != *ip++ ||
|
|
*ref++ != *ip++ || *ref++ != *ip++)
|
|
goto literal;
|
|
|
|
/* last matched byte */
|
|
ip = anchor + len;
|
|
|
|
/* distance is biased */
|
|
distance--;
|
|
|
|
if (!distance) {
|
|
/* zero distance means a run */
|
|
uint8_t x = ip[-1];
|
|
while (ip < ip_bound)
|
|
if (*ref++ != x)
|
|
break;
|
|
else
|
|
ip++;
|
|
} else
|
|
for (;;) {
|
|
/* safe because the outer check against ip limit */
|
|
if (*ref++ != *ip++) break;
|
|
if (*ref++ != *ip++) break;
|
|
if (*ref++ != *ip++) break;
|
|
if (*ref++ != *ip++) break;
|
|
if (*ref++ != *ip++) break;
|
|
if (*ref++ != *ip++) break;
|
|
if (*ref++ != *ip++) break;
|
|
if (*ref++ != *ip++) break;
|
|
while (ip < ip_bound)
|
|
if (*ref++ != *ip++) break;
|
|
break;
|
|
}
|
|
|
|
/* if we have copied something, adjust the copy count */
|
|
if (copy) /* copy is biased, '0' means 1 byte copy */
|
|
*(op - copy - 1) = copy - 1;
|
|
else
|
|
/* back, to overwrite the copy count */
|
|
op--;
|
|
|
|
/* reset literal counter */
|
|
copy = 0;
|
|
|
|
/* length is biased, '1' means a match of 3 bytes */
|
|
ip -= 3;
|
|
len = ip - anchor;
|
|
|
|
/* encode the match */
|
|
if (FASTLZ_UNLIKELY(len > MAX_LEN - 2))
|
|
while (len > MAX_LEN - 2) {
|
|
*op++ = (7 << 5) + (distance >> 8);
|
|
*op++ = MAX_LEN - 2 - 7 - 2;
|
|
*op++ = (distance & 255);
|
|
len -= MAX_LEN - 2;
|
|
}
|
|
|
|
if (len < 7) {
|
|
*op++ = (len << 5) + (distance >> 8);
|
|
*op++ = (distance & 255);
|
|
} else {
|
|
*op++ = (7 << 5) + (distance >> 8);
|
|
*op++ = len - 7;
|
|
*op++ = (distance & 255);
|
|
}
|
|
|
|
/* update the hash at match boundary */
|
|
HASH_FUNCTION(hval, ip);
|
|
htab[hval] = ip++;
|
|
HASH_FUNCTION(hval, ip);
|
|
htab[hval] = ip++;
|
|
|
|
/* assuming literal copy */
|
|
*op++ = MAX_COPY - 1;
|
|
|
|
continue;
|
|
|
|
literal:
|
|
*op++ = *anchor++;
|
|
ip = anchor;
|
|
copy++;
|
|
if (FASTLZ_UNLIKELY(copy == MAX_COPY)) {
|
|
copy = 0;
|
|
*op++ = MAX_COPY - 1;
|
|
}
|
|
}
|
|
|
|
/* left-over as literal copy */
|
|
ip_bound++;
|
|
while (ip <= ip_bound) {
|
|
*op++ = *ip++;
|
|
copy++;
|
|
if (copy == MAX_COPY) {
|
|
copy = 0;
|
|
*op++ = MAX_COPY - 1;
|
|
}
|
|
}
|
|
|
|
/* if we have copied something, adjust the copy length */
|
|
if (copy)
|
|
*(op - copy - 1) = copy - 1;
|
|
else
|
|
op--;
|
|
|
|
return op - (uint8_t*)output;
|
|
}
|
|
|
|
#if defined(FASTLZ_USE_MEMMOVE) && (FASTLZ_USE_MEMMOVE == 0)
|
|
|
|
static void fastlz_memmove(uint8_t* dest, const uint8_t* src, uint32_t count) {
|
|
do {
|
|
*dest++ = *src++;
|
|
} while (--count);
|
|
}
|
|
|
|
static void fastlz_memcpy(uint8_t* dest, const uint8_t* src, uint32_t count) {
|
|
return fastlz_memmove(dest, src, count);
|
|
}
|
|
|
|
#else
|
|
|
|
#include <string.h>
|
|
|
|
static void fastlz_memmove(uint8_t* dest, const uint8_t* src, uint32_t count) {
|
|
if ((count > 4) && (dest >= src + count)) {
|
|
memmove(dest, src, count);
|
|
} else {
|
|
switch (count) {
|
|
default:
|
|
do {
|
|
*dest++ = *src++;
|
|
} while (--count);
|
|
break;
|
|
case 3:
|
|
*dest++ = *src++;
|
|
case 2:
|
|
*dest++ = *src++;
|
|
case 1:
|
|
*dest++ = *src++;
|
|
case 0:
|
|
break;
|
|
}
|
|
}
|
|
}
|
|
|
|
static void fastlz_memcpy(uint8_t* dest, const uint8_t* src, uint32_t count) {
|
|
memcpy(dest, src, count);
|
|
}
|
|
|
|
#endif
|
|
|
|
int fastlz1_decompress(const void* input, int length, void* output,
|
|
int maxout) {
|
|
const uint8_t* ip = (const uint8_t*)input;
|
|
const uint8_t* ip_limit = ip + length;
|
|
const uint8_t* ip_bound = ip_limit - 2;
|
|
uint8_t* op = (uint8_t*)output;
|
|
uint8_t* op_limit = op + maxout;
|
|
uint32_t ctrl = (*ip++) & 31;
|
|
|
|
while (1) {
|
|
if (ctrl >= 32) {
|
|
uint32_t len = (ctrl >> 5) - 1;
|
|
uint32_t ofs = (ctrl & 31) << 8;
|
|
const uint8_t* ref = op - ofs - 1;
|
|
if (len == 7 - 1) {
|
|
FASTLZ_BOUND_CHECK(ip <= ip_bound);
|
|
len += *ip++;
|
|
}
|
|
ref -= *ip++;
|
|
len += 3;
|
|
FASTLZ_BOUND_CHECK(op + len <= op_limit);
|
|
FASTLZ_BOUND_CHECK(ref >= (uint8_t*)output);
|
|
fastlz_memmove(op, ref, len);
|
|
op += len;
|
|
} else {
|
|
ctrl++;
|
|
FASTLZ_BOUND_CHECK(op + ctrl <= op_limit);
|
|
FASTLZ_BOUND_CHECK(ip + ctrl <= ip_limit);
|
|
fastlz_memcpy(op, ip, ctrl);
|
|
ip += ctrl;
|
|
op += ctrl;
|
|
}
|
|
|
|
if (FASTLZ_UNLIKELY(ip > ip_bound)) break;
|
|
ctrl = *ip++;
|
|
}
|
|
|
|
return op - (uint8_t*)output;
|
|
}
|
|
|
|
int fastlz2_compress(const void* input, int length, void* output) {
|
|
const uint8_t* ip = (const uint8_t*)input;
|
|
const uint8_t* ip_bound = ip + length - 2;
|
|
const uint8_t* ip_limit = ip + length - 12 - 1;
|
|
uint8_t* op = (uint8_t*)output;
|
|
|
|
const uint8_t* htab[HASH_SIZE];
|
|
uint32_t hval;
|
|
|
|
uint32_t copy;
|
|
|
|
/* sanity check */
|
|
if (FASTLZ_UNLIKELY(length < 4)) {
|
|
if (length) {
|
|
/* create literal copy only */
|
|
*op++ = length - 1;
|
|
ip_bound++;
|
|
while (ip <= ip_bound) *op++ = *ip++;
|
|
return length + 1;
|
|
} else
|
|
return 0;
|
|
}
|
|
|
|
/* initializes hash table */
|
|
for (hval = 0; hval < HASH_SIZE; ++hval) htab[hval] = ip;
|
|
|
|
/* we start with literal copy */
|
|
copy = 2;
|
|
*op++ = MAX_COPY - 1;
|
|
*op++ = *ip++;
|
|
*op++ = *ip++;
|
|
|
|
/* main loop */
|
|
while (FASTLZ_LIKELY(ip < ip_limit)) {
|
|
const uint8_t* ref;
|
|
uint32_t distance;
|
|
|
|
/* minimum match length */
|
|
uint32_t len = 3;
|
|
|
|
/* comparison starting-point */
|
|
const uint8_t* anchor = ip;
|
|
|
|
/* check for a run */
|
|
if (ip[0] == ip[-1] && ip[0] == ip[1] && ip[1] == ip[2]) {
|
|
distance = 1;
|
|
ip += 3;
|
|
ref = anchor - 1 + 3;
|
|
goto match;
|
|
}
|
|
|
|
/* find potential match */
|
|
HASH_FUNCTION(hval, ip);
|
|
ref = htab[hval];
|
|
|
|
/* update hash table */
|
|
htab[hval] = anchor;
|
|
|
|
/* calculate distance to the match */
|
|
distance = anchor - ref;
|
|
|
|
/* is this a match? check the first 3 bytes */
|
|
if (distance == 0 || (distance >= MAX_FARDISTANCE) || *ref++ != *ip++ ||
|
|
*ref++ != *ip++ || *ref++ != *ip++)
|
|
goto literal;
|
|
|
|
/* far, needs at least 5-byte match */
|
|
if (distance >= MAX_L2_DISTANCE) {
|
|
if (*ip++ != *ref++ || *ip++ != *ref++) goto literal;
|
|
len += 2;
|
|
}
|
|
|
|
match:
|
|
|
|
/* last matched byte */
|
|
ip = anchor + len;
|
|
|
|
/* distance is biased */
|
|
distance--;
|
|
|
|
if (!distance) {
|
|
/* zero distance means a run */
|
|
uint8_t x = ip[-1];
|
|
while (ip < ip_bound)
|
|
if (*ref++ != x)
|
|
break;
|
|
else
|
|
ip++;
|
|
} else
|
|
for (;;) {
|
|
/* safe because the outer check against ip limit */
|
|
if (*ref++ != *ip++) break;
|
|
if (*ref++ != *ip++) break;
|
|
if (*ref++ != *ip++) break;
|
|
if (*ref++ != *ip++) break;
|
|
if (*ref++ != *ip++) break;
|
|
if (*ref++ != *ip++) break;
|
|
if (*ref++ != *ip++) break;
|
|
if (*ref++ != *ip++) break;
|
|
while (ip < ip_bound)
|
|
if (*ref++ != *ip++) break;
|
|
break;
|
|
}
|
|
|
|
/* if we have copied something, adjust the copy count */
|
|
if (copy) /* copy is biased, '0' means 1 byte copy */
|
|
*(op - copy - 1) = copy - 1;
|
|
else
|
|
/* back, to overwrite the copy count */
|
|
op--;
|
|
|
|
/* reset literal counter */
|
|
copy = 0;
|
|
|
|
/* length is biased, '1' means a match of 3 bytes */
|
|
ip -= 3;
|
|
len = ip - anchor;
|
|
|
|
/* encode the match */
|
|
if (distance < MAX_L2_DISTANCE) {
|
|
if (len < 7) {
|
|
*op++ = (len << 5) + (distance >> 8);
|
|
*op++ = (distance & 255);
|
|
} else {
|
|
*op++ = (7 << 5) + (distance >> 8);
|
|
for (len -= 7; len >= 255; len -= 255) *op++ = 255;
|
|
*op++ = len;
|
|
*op++ = (distance & 255);
|
|
}
|
|
} else {
|
|
/* far away, but not yet in the another galaxy... */
|
|
if (len < 7) {
|
|
distance -= MAX_L2_DISTANCE;
|
|
*op++ = (len << 5) + 31;
|
|
*op++ = 255;
|
|
*op++ = distance >> 8;
|
|
*op++ = distance & 255;
|
|
} else {
|
|
distance -= MAX_L2_DISTANCE;
|
|
*op++ = (7 << 5) + 31;
|
|
for (len -= 7; len >= 255; len -= 255) *op++ = 255;
|
|
*op++ = len;
|
|
*op++ = 255;
|
|
*op++ = distance >> 8;
|
|
*op++ = distance & 255;
|
|
}
|
|
}
|
|
|
|
/* update the hash at match boundary */
|
|
HASH_FUNCTION(hval, ip);
|
|
htab[hval] = ip++;
|
|
HASH_FUNCTION(hval, ip);
|
|
htab[hval] = ip++;
|
|
|
|
/* assuming literal copy */
|
|
*op++ = MAX_COPY - 1;
|
|
|
|
continue;
|
|
|
|
literal:
|
|
*op++ = *anchor++;
|
|
ip = anchor;
|
|
copy++;
|
|
if (FASTLZ_UNLIKELY(copy == MAX_COPY)) {
|
|
copy = 0;
|
|
*op++ = MAX_COPY - 1;
|
|
}
|
|
}
|
|
|
|
/* left-over as literal copy */
|
|
ip_bound++;
|
|
while (ip <= ip_bound) {
|
|
*op++ = *ip++;
|
|
copy++;
|
|
if (copy == MAX_COPY) {
|
|
copy = 0;
|
|
*op++ = MAX_COPY - 1;
|
|
}
|
|
}
|
|
|
|
/* if we have copied something, adjust the copy length */
|
|
if (copy)
|
|
*(op - copy - 1) = copy - 1;
|
|
else
|
|
op--;
|
|
|
|
/* marker for fastlz2 */
|
|
*(uint8_t*)output |= (1 << 5);
|
|
|
|
return op - (uint8_t*)output;
|
|
}
|
|
|
|
int fastlz2_decompress(const void* input, int length, void* output,
|
|
int maxout) {
|
|
const uint8_t* ip = (const uint8_t*)input;
|
|
const uint8_t* ip_limit = ip + length;
|
|
const uint8_t* ip_bound = ip_limit - 2;
|
|
uint8_t* op = (uint8_t*)output;
|
|
uint8_t* op_limit = op + maxout;
|
|
uint32_t ctrl = (*ip++) & 31;
|
|
|
|
while (1) {
|
|
if (ctrl >= 32) {
|
|
uint32_t len = (ctrl >> 5) - 1;
|
|
uint32_t ofs = (ctrl & 31) << 8;
|
|
const uint8_t* ref = op - ofs - 1;
|
|
|
|
uint8_t code;
|
|
if (len == 7 - 1) do {
|
|
FASTLZ_BOUND_CHECK(ip <= ip_bound);
|
|
code = *ip++;
|
|
len += code;
|
|
} while (code == 255);
|
|
code = *ip++;
|
|
ref -= code;
|
|
len += 3;
|
|
|
|
/* match from 16-bit distance */
|
|
if (FASTLZ_UNLIKELY(code == 255))
|
|
if (FASTLZ_LIKELY(ofs == (31 << 8))) {
|
|
FASTLZ_BOUND_CHECK(ip < ip_bound);
|
|
ofs = (*ip++) << 8;
|
|
ofs += *ip++;
|
|
ref = op - ofs - MAX_L2_DISTANCE - 1;
|
|
}
|
|
|
|
FASTLZ_BOUND_CHECK(op + len <= op_limit);
|
|
FASTLZ_BOUND_CHECK(ref >= (uint8_t*)output);
|
|
fastlz_memmove(op, ref, len);
|
|
op += len;
|
|
} else {
|
|
ctrl++;
|
|
FASTLZ_BOUND_CHECK(op + ctrl <= op_limit);
|
|
FASTLZ_BOUND_CHECK(ip + ctrl <= ip_limit);
|
|
fastlz_memcpy(op, ip, ctrl);
|
|
ip += ctrl;
|
|
op += ctrl;
|
|
}
|
|
|
|
if (FASTLZ_UNLIKELY(ip >= ip_limit)) break;
|
|
ctrl = *ip++;
|
|
}
|
|
|
|
return op - (uint8_t*)output;
|
|
}
|
|
|
|
int fastlz_compress(const void* input, int length, void* output) {
|
|
/* for short block, choose fastlz1 */
|
|
if (length < 65536) return fastlz1_compress(input, length, output);
|
|
|
|
/* else... */
|
|
return fastlz2_compress(input, length, output);
|
|
}
|
|
|
|
int fastlz_decompress(const void* input, int length, void* output, int maxout) {
|
|
/* magic identifier for compression level */
|
|
int level = ((*(const uint8_t*)input) >> 5) + 1;
|
|
|
|
if (level == 1) return fastlz1_decompress(input, length, output, maxout);
|
|
if (level == 2) return fastlz2_decompress(input, length, output, maxout);
|
|
|
|
/* unknown level, trigger error */
|
|
return 0;
|
|
}
|
|
|
|
int fastlz_compress_level(int level, const void* input, int length,
|
|
void* output) {
|
|
if (level == 1) return fastlz1_compress(input, length, output);
|
|
if (level == 2) return fastlz2_compress(input, length, output);
|
|
|
|
return 0;
|
|
}
|