Difference between revisions of "love.math.compress"

m
m
Line 9: Line 9:
 
=== Arguments ===
 
=== Arguments ===
 
{{param|string|rawstring|The raw (un-compressed) string to compress.}}
 
{{param|string|rawstring|The raw (un-compressed) string to compress.}}
{{param|CompressedDataFormat|format ("lz4")|The format to compress the string to.}}
+
{{param|CompressedDataFormat|format ("lz4")|The format to use when compressing the string.}}
 
{{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 ===
Line 20: Line 20:
 
=== Arguments ===
 
=== Arguments ===
 
{{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|CompressedDataFormat|format ("lz4")|The format to compress the data to.}}
+
{{param|CompressedDataFormat|format ("lz4")|The format to use when compressing the data.}}
 
{{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 ===

Revision as of 18:14, 3 October 2015

Available since LÖVE 0.10.0
This function is not supported in earlier versions.

Compresses a string or data using a specific compression algorithm.

O.png This function can be slow if it is called repeatedly, such as from love.update or love.draw. If you need to use a specific resource often, create it once and store it somewhere it can be reused!  



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