summaryrefslogtreecommitdiff
path: root/doc/classes/VideoPlayer.xml
blob: 4f60b9d567bc8832b98446278f12a4bdc5f3197f (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
<?xml version="1.0" encoding="UTF-8" ?>
<class name="VideoPlayer" inherits="Control" version="4.0">
	<brief_description>
		Control for playing video streams.
	</brief_description>
	<description>
		Control node for playing video streams using [VideoStream] resources.
		Supported video formats are [url=https://www.webmproject.org/]WebM[/url] ([code].webm[/code], [VideoStreamWebm]), [url=https://www.theora.org/]Ogg Theora[/url] ([code].ogv[/code], [VideoStreamTheora]), and any format exposed via a GDNative plugin using [VideoStreamGDNative].
		[b]Note:[/b] Due to a bug, VideoPlayer does not support localization remapping yet.
		[b]Warning:[/b] On HTML5, video playback [i]will[/i] perform poorly due to missing architecture-specific assembly optimizations, especially for VP8/VP9.
	</description>
	<tutorials>
	</tutorials>
	<methods>
		<method name="get_stream_name" qualifiers="const">
			<return type="String" />
			<description>
				Returns the video stream's name, or [code]"&lt;No Stream&gt;"[/code] if no video stream is assigned.
			</description>
		</method>
		<method name="get_video_texture" qualifiers="const">
			<return type="Texture2D" />
			<description>
				Returns the current frame as a [Texture2D].
			</description>
		</method>
		<method name="is_playing" qualifiers="const">
			<return type="bool" />
			<description>
				Returns [code]true[/code] if the video is playing.
				[b]Note:[/b] The video is still considered playing if paused during playback.
			</description>
		</method>
		<method name="play">
			<return type="void" />
			<description>
				Starts the video playback from the beginning. If the video is paused, this will not unpause the video.
			</description>
		</method>
		<method name="stop">
			<return type="void" />
			<description>
				Stops the video playback and sets the stream position to 0.
				[b]Note:[/b] Although the stream position will be set to 0, the first frame of the video stream won't become the current frame.
			</description>
		</method>
	</methods>
	<members>
		<member name="audio_track" type="int" setter="set_audio_track" getter="get_audio_track" default="0">
			The embedded audio track to play.
		</member>
		<member name="autoplay" type="bool" setter="set_autoplay" getter="has_autoplay" default="false">
			If [code]true[/code], playback starts when the scene loads.
		</member>
		<member name="buffering_msec" type="int" setter="set_buffering_msec" getter="get_buffering_msec" default="500">
			Amount of time in milliseconds to store in buffer while playing.
		</member>
		<member name="bus" type="StringName" setter="set_bus" getter="get_bus" default="&amp;&quot;Master&quot;">
			Audio bus to use for sound playback.
		</member>
		<member name="expand" type="bool" setter="set_expand" getter="has_expand" default="true">
			If [code]true[/code], the video scales to the control size. Otherwise, the control minimum size will be automatically adjusted to match the video stream's dimensions.
		</member>
		<member name="paused" type="bool" setter="set_paused" getter="is_paused" default="false">
			If [code]true[/code], the video is paused.
		</member>
		<member name="stream" type="VideoStream" setter="set_stream" getter="get_stream">
			The assigned video stream. See description for supported formats.
		</member>
		<member name="stream_position" type="float" setter="set_stream_position" getter="get_stream_position">
			The current position of the stream, in seconds.
			[b]Note:[/b] Changing this value won't have any effect as seeking is not implemented yet, except in video formats implemented by a GDNative add-on.
		</member>
		<member name="volume" type="float" setter="set_volume" getter="get_volume">
			Audio volume as a linear value.
		</member>
		<member name="volume_db" type="float" setter="set_volume_db" getter="get_volume_db" default="0.0">
			Audio volume in dB.
		</member>
	</members>
	<signals>
		<signal name="finished">
			<description>
				Emitted when playback is finished.
			</description>
		</signal>
	</signals>
</class>