LibCompress

Хочешь карту со своим ником? Оформить ❤️

LibCompress-это библиотека сжатия и декомпрессии, полностью реализованная в WoW-дружественном Lua. Он поддерживает алгоритмы LZW и Хаффмана и может автоматически выбирать наиболее эффективный алгоритм для ваших данных. Одним из популярных способов использования этой библиотеки является отправка сжатой таблицы другому игроку или дополнению. Для этого требуется дополнительная кодировка для удаления символов \000 из потока данных.

Взгляните на сообщение на форуме для получения дополнительной информации и обсуждения развития:

[http://forums.wowace.com/showthread.php?t=12660]

Использование:

Компрессия

Загрузите библиотеку с помощью:

libc = LibStub:GetLibrary("LibCompress")

Сжатие данных (должно быть в строковой форме):

compressed_data = libc:Сжатие(данных)

Это позволит попробовать все алгоритмы сжатия и вернуть наилучший сжатый результат. Можно указать конкретный алгоритм сжатия, например:

compressed_data = libc:CompressHuffman(data)

или

 compressed_data = libc:CompressLZW(данные)

Данные будут либо сжаты с помощью алгоритма сжатия Хаффмана, либо вообще не будут сжаты. Данные, возвращаемые с префиксным байтом, идентифицирующим, что данные распакованы.

Чтобы распаковать данные, просто используйте это:

 decompressed_data = libc:Распаковать(compressed_data)

Сжатие и распаковка могут возвращать ошибку, и об этом сигнализирует первый возвращаемый аргумент, равный нулю, а второй-сообщение об ошибке. Так что проверить это было бы уместно.

Кодирование

LibCompress также имеет возможность кодировать и декодировать данные, подготавливая их к передаче по каналу аддона или каналу чата (или пользовательской кодировке). Предусмотрены две формы кодирования:

Префиксное кодирование

Первая форма-префикс-кодирование. В основном зарезервированные символы заменяются префиксом/escape-символом, за которым следует символ суффикса, то есть зарезервированные байты заменяются двухбайтовой комбинацией. Вот как это делается:

 таблица, msg = libc:GetEncodeTable(reservedChars, escapeChars, mapChars)

reservedChars: Символы в этой строке не будут отображаться в закодированных данных.
escapeChars: Строка символов, используемых в качестве escape-символов (не предоставляйте больше, чем необходимо). #escapeChars >= 1
mapChars: Первые символы в reservedChars сопоставляются с первыми символами в mapChars. (#mapChars <= #reservedChars)

Если таблица равна нулю, то msg содержит сообщение об ошибке. В противном случае использование очень простое:

encoded_message = таблица:Кодирование(сообщение)

 сообщение = таблица:Декодирование(encoded_message)

Были включены две предопределенные настройки:

GetAddonEncodeTable: Настройка кодировки для канала аддона (кодируется\000)

GetChatEncodeTable: Настройка кодировки для канала чата (многие байты закодированы, подробнее см. функцию)

7-битное кодирование

Эта кодировка упаковывает биты, а не байты. Он помещает 7 бит в каждый байт, увеличивая данные примерно на 14%. Значения от 0 до 127 (оба включительно) присутствуют в закодированных данных, и поэтому они также должны быть закодированы префиксом. Эта кодировка генерирует немного строкового мусора и должна использоваться с осторожностью.

Кодируйте данные вот так:

 encoded_data = libc:Encode7bit(данные)

Расшифровать такие данные :

 decoded_data = libc:Decode7bit(encoded_data)

Контрольная сумма/хэш-алгоритмы

LibCompress также предоставляет 2 разумных быстрых алгоритма хэширования. Они преобразуются из C-реализации в lua и довольно быстры. Хэш-значение может быть либо 16-битным, либо 32-битным.

Используйте вот так (data1, data2, data… = string):

 код = libc:fcs16init()
 code = libc:fcs16update(code, data1)
 code = libc:fcs16update(code, data2)
 code = libc:fcs16update(код, данные...)
 code = libc:fcs16final(код)

data = string
fcs16 предоставляет 16-битную контрольную сумму, fcs32 предоставляет 32-битную контрольную сумму.

Похожие аддоны

MooUnit MooSpec LibDeflate Buff Duty