Difference between revisions of "love.video.newVideoStream"

m (Arguments)
(Added a warning about potential compatibility issues: https://love2d.org/forums/viewtopic.php?p=259088&sid=b4713b788863f510a31950232932d8da#p259088)
 
(One intermediate revision by one other user not shown)
Line 14: Line 14:
 
=== Synopsis ===
 
=== Synopsis ===
 
<source lang="lua">
 
<source lang="lua">
videostream = love.video.newVideoStream( filename )
+
videostream = love.video.newVideoStream( file )
 
</source>
 
</source>
 
=== Arguments ===
 
=== Arguments ===
{{param|File|filename|The [[File]] object containing the Ogg Theora video.}}
+
{{param|File|file|The [[File]] object containing the Ogg Theora video.}}
  
 
=== Returns ===
 
=== Returns ===
 
{{param|VideoStream|videostream|A new VideoStream.}}
 
{{param|VideoStream|videostream|A new VideoStream.}}
 +
 +
== Notes ==
 +
 +
Löve only provides the basic functionality provided by libtheora. If your video plays fine in a video player but not in Löve, try different encoding options.
  
 
== See Also ==
 
== See Also ==

Latest revision as of 12:06, 22 March 2024

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

Creates a new VideoStream. Currently only Ogg Theora video files are supported. VideoStreams can't draw videos, see love.graphics.newVideo for that.

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

videostream = love.video.newVideoStream( filename )

Arguments

string filename
The file path to the Ogg Theora video file.

Returns

VideoStream videostream
A new VideoStream.

Function

Synopsis

videostream = love.video.newVideoStream( file )

Arguments

File file
The File object containing the Ogg Theora video.

Returns

VideoStream videostream
A new VideoStream.

Notes

Löve only provides the basic functionality provided by libtheora. If your video plays fine in a video player but not in Löve, try different encoding options.

See Also


Other Languages