Difference between revisions of "ImageData:encode"

(0.8.0)
m (Draw a circle in a canvas, save it in file and display it on screen: Small wording changes and fixes.)
 
(15 intermediate revisions by 6 users not shown)
Line 1: Line 1:
Encodes the ImageData.
+
Encodes the ImageData to a file format and optionally writes it to the [[love.filesystem|save directory]].
 +
 
 
== Function ==
 
== Function ==
{{oldin|[[0.8.0]]|type=variant}}
+
{{newin|[[0.10.0]]|100|type=variant}}
 
=== Synopsis ===
 
=== Synopsis ===
 
<source lang="lua">
 
<source lang="lua">
data = ImageData:encode( format )
+
filedata = ImageData:encode( format, filename )
 
</source>
 
</source>
 
=== Arguments ===
 
=== Arguments ===
{{param|ImageFormat|format|The format to encode the image in.}}
+
{{param|ImageEncodeFormat|format|The format to encode the image as.}}
 +
{{param|string|filename (nil)|The filename to write the file to. If nil, no file will be written but the FileData will still be returned.}}
 
=== Returns ===
 
=== Returns ===
{{param|Data|data|The encoded image data.}}
+
{{param|FileData|filedata|The encoded image as a new FileData object.}}
 +
 
 
== Function ==
 
== Function ==
{{newin|[[0.8.0]]|type=variant}}
+
{{newinoldin|[[0.8.0]]|080|[[0.10.0]]|100|type=variant}}
 
=== Synopsis ===
 
=== Synopsis ===
 
<source lang="lua">
 
<source lang="lua">
Line 20: Line 23:
 
=== Returns ===
 
=== Returns ===
 
Nothing.
 
Nothing.
 +
 
== Function ==
 
== Function ==
{{newin|[[0.8.0]]|type=variant}}
+
{{newinoldin|[[0.8.0]]|080|[[0.10.0]]|100|type=variant}}
 
=== Synopsis ===
 
=== Synopsis ===
 
<source lang="lua">
 
<source lang="lua">
Line 28: Line 32:
 
=== Arguments ===
 
=== Arguments ===
 
{{param|string|outFile|Name of a file to write encoded data to.}}
 
{{param|string|outFile|Name of a file to write encoded data to.}}
{{param|ImageFormat|format|The format to encode the image in.}}
+
{{param|ImageEncodeFormat|format|The format to encode the image in.}}
 
=== Returns ===
 
=== Returns ===
 
Nothing.
 
Nothing.
 +
 +
== Function ==
 +
{{oldin|[[0.8.0]]|080|type=variant}}
 +
=== Synopsis ===
 +
<source lang="lua">
 +
data = ImageData:encode( format )
 +
</source>
 +
=== Arguments ===
 +
{{param|ImageEncodeFormat|format|The format to encode the image in.}}
 +
=== Returns ===
 +
{{param|Data|data|The encoded image data.}}
 +
 +
== Examples ==
 +
=== Draw a circle to a canvas and save it to a file ===
 +
<source lang="lua">
 +
function love.load()
 +
    canvas = love.graphics.newCanvas(800, 600)
 +
 +
    love.graphics.setCanvas(canvas)
 +
    love.graphics.circle("fill", 200,200, 100)
 +
    love.graphics.setCanvas() -- The canvas must not be active when we call canvas:newImageData().
 +
 +
    local imagedata = canvas:newImageData()
 +
    imagedata:encode("tga", "test.tga")
 +
end
 +
 +
function love.draw()
 +
    love.graphics.draw(canvas) -- Draw canvas on screen.
 +
end
 +
</source>
 +
 +
== User Notes ==
 +
* If you want the file to have an extension when saved add it in the file name. Example : <source lang="lua">image:encode("png","aPngImage.png")</source>
 +
 
== See Also ==
 
== See Also ==
 
* [[parent::ImageData]]
 
* [[parent::ImageData]]
 
[[Category:Functions]]
 
[[Category:Functions]]
{{#set:Description=Encodes ImageData.}}
+
{{#set:Description=Encodes the ImageData to a file format and optionally writes it to the [[love.filesystem|save directory]].}}
 
{{#set:Since=000}}
 
{{#set:Since=000}}
 +
 
== Other Languages ==
 
== Other Languages ==
 
{{i18n|ImageData:encode}}
 
{{i18n|ImageData:encode}}

Latest revision as of 19:16, 3 June 2022

Encodes the ImageData to a file format and optionally writes it to the save directory.

Function

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

Synopsis

filedata = ImageData:encode( format, filename )

Arguments

ImageEncodeFormat format
The format to encode the image as.
string filename (nil)
The filename to write the file to. If nil, no file will be written but the FileData will still be returned.

Returns

FileData filedata
The encoded image as a new FileData object.

Function

Available since LÖVE 0.8.0 and removed in LÖVE 0.10.0
This variant is not supported in earlier or later versions.

Synopsis

ImageData:encode( outFile )

Arguments

string outFile
Name of a file to write encoded data to. The format will be automatically deduced from the file extension.

Returns

Nothing.

Function

Available since LÖVE 0.8.0 and removed in LÖVE 0.10.0
This variant is not supported in earlier or later versions.

Synopsis

ImageData:encode( outFile, format )

Arguments

string outFile
Name of a file to write encoded data to.
ImageEncodeFormat format
The format to encode the image in.

Returns

Nothing.

Function

Removed in LÖVE 0.8.0
This variant is not supported in that and later versions.

Synopsis

data = ImageData:encode( format )

Arguments

ImageEncodeFormat format
The format to encode the image in.

Returns

Data data
The encoded image data.

Examples

Draw a circle to a canvas and save it to a file

function love.load()
    canvas = love.graphics.newCanvas(800, 600)

    love.graphics.setCanvas(canvas)
    love.graphics.circle("fill", 200,200, 100)
    love.graphics.setCanvas() -- The canvas must not be active when we call canvas:newImageData().

    local imagedata = canvas:newImageData()
    imagedata:encode("tga", "test.tga")
end

function love.draw()
    love.graphics.draw(canvas) -- Draw canvas on screen.
end

User Notes

  • If you want the file to have an extension when saved add it in the file name. Example :
    image:encode("png","aPngImage.png")
    

See Also


Other Languages