Difference between revisions of "love.math.compress"

m (Undo revision 25101 by Dmy (talk) Accidentally edited Ukrainian text inline)
 
Line 1: Line 1:
{{newin (Українська)|[[0.10.0]]|100|type=function}}
+
{{newin|[[0.10.0]]|100|type=function}}
{{deprecatedin (Українська)|[[11.0]]|110|type=function|text=Ця функція застаріла. Її замінила [[love.data.compress (Українська)|love.data.compress]]}}
+
{{deprecatedin|[[11.0]]|110|type=function|text=This function is deprecated and is replaced by [[love.data.compress]]}}
Стискає рядок чи дані певним алгоритмом.
+
Compresses a string or data using a specific compression algorithm.
{{notice|В залежності від формату та рівня стиснення ця функція може сповільнювати роботу програми, якщо її викликати багато раз, наприклад, в [[love.update (Українська)|love.update]] чи [[love.draw (Українська)|love.draw]]. Деякі тести швидкодії доступні [https://github.com/Cyan4973/lz4#user-content-benchmarks тут] (англ.).}}
+
{{notice|This function, depending on the compression format and level, can be slow if called repeatedly, such as from [[love.update]] or [[love.draw]]. Some benchmarks are available [https://github.com/Cyan4973/lz4#user-content-benchmarks here].}}
== Функція ==
+
== Function ==
=== Вигляд ===
+
=== Synopsis ===
 
<source lang="lua">
 
<source lang="lua">
 
compressedData = love.math.compress( rawstring, format, level )
 
compressedData = love.math.compress( rawstring, format, level )
 
</source>
 
</source>
=== Аргументи ===
+
=== Arguments ===
{{param (Українська)|string|rawstring|Чистий (нестиснений) рядок, який буде стиснено.}}
+
{{param|string|rawstring|The raw (un-compressed) string to compress.}}
{{param (Українська)|CompressedDataFormat|format ("lz4")|Формат, який буде використано для стиснення рядка.}}
+
{{param|CompressedDataFormat|format ("lz4")|The format to use when compressing the string.}}
{{param (Українська)|number|level (-1)|Рівень стиснення, який буде використано, від 0 до 9. -1 значить стандартний рівень. Значення цього аргументу залежить від формату.}}
+
{{param|number|level (-1)|The level of compression to use, between 0 and 9. -1 indicates the default level. The meaning of this argument depends on the compression format being used.}}
=== Повертає ===
+
=== Returns ===
{{param (Українська)|CompressedData|compressedData|Новий об'єкт Data, в якому буде міститися стиснена версія рядка.}}
+
{{param|CompressedData|compressedData|A new Data object containing the compressed version of the string.}}
== Функція ==
+
== Function ==
=== Вигляд ===
+
=== Synopsis ===
 
<source lang="lua">
 
<source lang="lua">
 
compressedData = love.math.compress( data, format, level )
 
compressedData = love.math.compress( data, format, level )
 
</source>
 
</source>
=== Аргументи ===
+
=== Arguments ===
{{param (Українська)|Data|data|Об'єкт Data, в якому містяться чисті (нестиснені) дані для стиснення.}}
+
{{param|Data|data|A Data object containing the raw (un-compressed) data to compress.}}
{{param (Українська)|CompressedDataFormat|format ("lz4")|Формат, який буде використано для стиснення даних.}}
+
{{param|CompressedDataFormat|format ("lz4")|The format to use when compressing the data.}}
{{param (Українська)|number|level (-1)|Рівень стиснення, який буде використано, від 0 до 9. -1 значить стандартний рівень. Значення цього аргументу залежить від формату.}}
+
{{param|number|level (-1)|The level of compression to use, between 0 and 9. -1 indicates the default level. The meaning of this argument depends on the compression format being used.}}
=== Повертає ===
+
=== Returns ===
{{param (Українська)|CompressedData|compressedData|Новий об'єкт Data, в якому буде міститися стиснена версія даних.}}
+
{{param|CompressedData|compressedData|A new Data object containing the compressed version of the raw data.}}
== Див. також ==
+
== See Also ==
* [[parent::love.math (Українська)|love.math]]
+
* [[parent::love.math]]
* [[love.math.decompress (Українська)|decompress]]
+
* [[love.math.decompress]]
* [[Constructs::CompressedData (Українська)|CompressedData ]]
+
* [[Constructs::CompressedData]]
 
[[Category:Functions]]
 
[[Category:Functions]]
{{#set:Description=Стискає рядок чи дані певним алгоритмом.}}
+
{{#set:Description=Compresses a string or data using a specific compression algorithm.}}
== Іншими мовами ==
+
== Other Languages ==
 
{{i18n|love.math.compress}}
 
{{i18n|love.math.compress}}

Latest revision as of 14:33, 25 February 2020

Available since LÖVE 0.10.0
This function is not supported in earlier versions.
Deprecated in LÖVE 11.0
This function is deprecated and is replaced by love.data.compress.

Compresses a string or data using a specific compression algorithm.

O.png This function, depending on the compression format and level, can be slow if called repeatedly, such as from love.update or love.draw. Some benchmarks are available here.  


Function

Synopsis

compressedData = love.math.compress( rawstring, format, level )

Arguments

string rawstring
The raw (un-compressed) string to compress.
CompressedDataFormat format ("lz4")
The format to use when compressing the string.
number level (-1)
The level of compression to use, between 0 and 9. -1 indicates the default level. The meaning of this argument depends on the compression format being used.

Returns

CompressedData compressedData
A new Data object containing the compressed version of the string.

Function

Synopsis

compressedData = love.math.compress( data, format, level )

Arguments

Data data
A Data object containing the raw (un-compressed) data to compress.
CompressedDataFormat format ("lz4")
The format to use when compressing the data.
number level (-1)
The level of compression to use, between 0 and 9. -1 indicates the default level. The meaning of this argument depends on the compression format being used.

Returns

CompressedData compressedData
A new Data object containing the compressed version of the raw data.

See Also

Other Languages