Difference between revisions of "love.data.compress"

(Need to read LOVE source code to get the argument order. Please edit if it's incorrect.)
 
m (¯\_(ツ)_/¯)
 
(2 intermediate revisions by the same user not shown)
Line 1: Line 1:
{{newin|[[0.11.0]]|110|type=function|text=It has replaced [[love.math.compress]]}}
+
{{newin|[[11.0]]|110|type=function|text=Deprecates [[love.math.compress]]}}
 
Compresses a string or data using a specific compression algorithm.
 
Compresses a string or data using a specific compression algorithm.
 
{{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].}}
 
{{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].}}
Line 5: Line 5:
 
=== Synopsis ===
 
=== Synopsis ===
 
<source lang="lua">
 
<source lang="lua">
compressedData = love.data.compress( format, rawstring, level )
+
compressedData = love.data.compress( container, format, rawstring, level )
 
</source>
 
</source>
 
=== Arguments ===
 
=== Arguments ===
 +
{{param|ContainerType|container|What type to return the compressed data as.}}
 
{{param|CompressedDataFormat|format|The format to use when compressing the string.}}
 
{{param|CompressedDataFormat|format|The format to use when compressing the string.}}
 
{{param|string|rawstring|The raw (un-compressed) string to compress.}}
 
{{param|string|rawstring|The raw (un-compressed) string to compress.}}
 
{{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.}}
 
{{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 ===
 
=== Returns ===
{{param|CompressedData|compressedData|A new Data object containing the compressed version of the string.}}
+
{{param|value|compressedData|[[CompressedData]]/[[string]] which contains the compressed version of rawstring.}}
 
== Function ==
 
== Function ==
 
=== Synopsis ===
 
=== Synopsis ===
 
<source lang="lua">
 
<source lang="lua">
compressedData = love.data.compress( format, data, level )
+
compressedData = love.data.compress( container, format, data, level )
 
</source>
 
</source>
 
=== Arguments ===
 
=== Arguments ===
 +
{{param|ContainerType|container|What type to return the compressed data as.}}
 
{{param|CompressedDataFormat|format|The format to use when compressing the data.}}
 
{{param|CompressedDataFormat|format|The format to use when compressing the data.}}
 
{{param|Data|data|A Data object containing the raw (un-compressed) data to compress.}}
 
{{param|Data|data|A Data object containing the raw (un-compressed) data to compress.}}
 
{{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.}}
 
{{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 ===
 
=== Returns ===
{{param|CompressedData|compressedData|A new Data object containing the compressed version of the raw data.}}
+
{{param|value|compressedData|[[CompressedData]]/[[string]] which contains the compressed version of data.}}
 
== See Also ==
 
== See Also ==
 
* [[parent::love.data]]
 
* [[parent::love.data]]

Latest revision as of 13:13, 2 April 2018

Available since LÖVE 11.0
Deprecates love.math.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.data.compress( container, format, rawstring, level )

Arguments

ContainerType container
What type to return the compressed data as.
CompressedDataFormat format
The format to use when compressing the string.
string rawstring
The raw (un-compressed) string to compress.
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

value compressedData
CompressedData/string which contains the compressed version of rawstring.

Function

Synopsis

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

Arguments

ContainerType container
What type to return the compressed data as.
CompressedDataFormat format
The format to use when compressing the data.
Data data
A Data object containing the raw (un-compressed) data to compress.
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

value compressedData
CompressedData/string which contains the compressed version of data.

See Also

Other Languages