0
0
mirror of https://github.com/sp-tarkov/modules.git synced 2025-02-13 09:50:43 -05:00
Merijn Hendriks 3c23adebe2 [enhancement] Simplify zlib (!43)
## Preface

EFT has been reworking the `bsg.componentace.compression.libs.zlib` alot the past versions, including various enhancements and introduced bugs (zero-tail decompression infinite looping). This also includes working towards deprecating `SimpleZlib` and improving `ZOutputStream`'s performance.

While working on Haru, @waffle.lord and I have been reworking the zlib code to be much simpler. These changes are compatible with Aki.

## The issue

- The current code is complex to understand without experience with the zlib library in question
- `Zlib.IsCompressed` has a bug when operating on < 3 bytes. The third statement is reached and thus out of bounds.

## Why fix this

- Simplifying the code improves future readability.
- Using `ZOutputStream` enables usage of further performance improvements made to `ZOutputStream` by BSG.
- `Zlib.IsCompressed` will work again on `byte[2]` and below.

## Why was it like this in the first place?

At the time of writing this code, there was poor understanding of how the zlib library worked. The implementation was a best-guess from decompiled code.

## What's affected?

Only Zlib utility's internal code. No external libraries are affected.

Co-authored-by: Merijn Hendriks <merijn.d.hendriks@gmail.com>
Reviewed-on: SPT-AKI/Modules#43
Co-authored-by: Merijn Hendriks <senko-san@noreply.dev.sp-tarkov.com>
Co-committed-by: Merijn Hendriks <senko-san@noreply.dev.sp-tarkov.com>
2023-12-09 22:49:16 +00:00

86 lines
2.3 KiB
C#

using System.IO;
using ComponentAce.Compression.Libs.zlib;
namespace Aki.Common.Utils
{
public enum ZlibCompression
{
Store = 0,
Fastest = 1,
Fast = 3,
Normal = 5,
Ultra = 7,
Maximum = 9
}
public static class Zlib
{
/// <summary>
/// Check if the file is ZLib compressed
/// </summary>
/// <param name="data">Data</param>
/// <returns>If the file is Zlib compressed</returns>
public static bool IsCompressed(byte[] data)
{
if (data == null || data.Length < 3)
{
return false;
}
// data[0]: Info (CM/CINFO) Header; must be 0x78
if (data[0] != 0x78)
{
return false;
}
// data[1]: Flags (FLG) Header; compression level.
switch (data[1])
{
case 0x01: // [0x78 0x01] level 0-2: fastest
case 0x5E: // [0x78 0x5E] level 3-4: low
case 0x9C: // [0x78 0x9C] level 5-6: normal
case 0xDA: // [0x78 0xDA] level 7-9: max
return true;
}
return false;
}
private static byte[] Run(byte[] data, ZlibCompression level)
{
// ZOutputStream.Close() flushes itself.
// ZOutputStream.Flush() flushes the target stream.
// It's fucking stupid, but whatever.
// -- Waffle.Lord, 2022-12-01
using (var ms = new MemoryStream())
{
using (var zs = (level > ZlibCompression.Store)
? new ZOutputStream(ms, (int)level)
: new ZOutputStream(ms))
{
zs.Write(data, 0, data.Length);
}
// <-- zs flushes everything here
return ms.ToArray();
}
}
/// <summary>
/// Deflate data.
/// </summary>
public static byte[] Compress(byte[] data, ZlibCompression level)
{
return Run(data, level);
}
/// <summary>
/// Inflate data.
/// </summary>
public static byte[] Decompress(byte[] data)
{
return Run(data, ZlibCompression.Store);
}
}
}