1
<!DOCTYPE node PUBLIC "-//freedesktop//DTD D-BUS Object Introspection 1.0//EN" "http://www.freedesktop.org/standards/dbus/1.0/introspect.dtd">
2
<node name="/Call_Content_Interface_Video_Control"
3
xmlns:tp="http://telepathy.freedesktop.org/wiki/DbusSpec#extensions-v0">
4
<tp:copyright>Copyright © 2009-2010 Collabora Ltd.</tp:copyright>
5
<tp:copyright>Copyright © 2009-2010 Nokia Corporation</tp:copyright>
6
<tp:license xmlns="http://www.w3.org/1999/xhtml">
7
<p>This library is free software; you can redistribute it and/or
8
modify it under the terms of the GNU Lesser General Public
9
License as published by the Free Software Foundation; either
10
version 2.1 of the License, or (at your option) any later version.</p>
12
<p>This library is distributed in the hope that it will be useful,
13
but WITHOUT ANY WARRANTY; without even the implied warranty of
14
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
15
Lesser General Public License for more details.</p>
17
<p>You should have received a copy of the GNU Lesser General Public
18
License along with this library; if not, write to the Free Software
19
Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
23
<interface name="org.freedesktop.Telepathy.Call.Content.Interface.VideoControl.DRAFT"
24
tp:causes-havoc="experimental">
25
<tp:added version="0.21.UNRELEASED">(draft 1)</tp:added>
26
<tp:requires interface="org.freedesktop.Telepathy.Call.Content.Interface.Media.DRAFT"/>
28
<tp:docstring xmlns="http://www.w3.org/1999/xhtml">
29
<p>An interface that allows the connection manager to control the video
31
<p>This interface is generally not needed. In cases where the connection
32
manager handles the network communication and the media is transferred
33
from the client to the connection manager via shared memory, it can
34
sometimes be beneficial for the connection manager to be able to
35
control certain aspects of the video stream.</p>
38
<signal name="KeyFrameRequested" tp:name-for-bindings="Key_Frame_Requested">
40
Request that the video encoder produce a new key frame as soon as
45
<tp:struct name="Video_Resolution"
46
array-name="Video_Resolution_Struct">
47
<tp:member type="u" name="Width">
49
With of the video stream.
52
<tp:member type="u" name="Height">
54
Height of the video stream.
59
<property name="VideoResolution" type="(uu)" tp:type="Video_Resolution"
60
access="read" tp:name-for-bindings="Video_Resolution">
62
The resolution at which the streaming engine should be sending.
64
<p>Change notification is via the
65
<tp:member-ref>VideoResolutionChanged</tp:member-ref> signal.</p>
69
<signal name="VideoResolutionChanged"
70
tp:name-for-bindings="Video_Resolution_Changed">
72
The desired video resolution has changed.
74
<arg type="(uu)" tp:type="Video_Resolution" name="NewResolution" />
77
<property name="Bitrate" type="u" access="read"
78
tp:name-for-bindings="Bitrate">
80
The bitrate the streaming engine should be sending at.
82
<p>Change notification is via the
83
<tp:member-ref>BitrateChanged</tp:member-ref> signal.</p>
87
<signal name="BitrateChanged"
88
tp:name-for-bindings="Bitrate_Changed">
90
The desired bitrate has changed
92
<arg type="u" name="NewBitrate" />
95
<property name="Framerate" type="u" access="read"
96
tp:name-for-bindings="Framerate">
98
The framerate the streaming engine should be sending at.
100
<p>Change notification is via the
101
<tp:member-ref>FramerateChanged</tp:member-ref> signal.</p>
105
<signal name="FramerateChanged"
106
tp:name-for-bindings="Framerate_Changed">
108
The desired framerate has changed
110
<arg type="u" name="NewFramerate" />
113
<property name="MTU" type="u" access="read"
114
tp:name-for-bindings="MTU">
116
The Maximum Transmission Unit
118
<p>Change notification is via the
119
<tp:member-ref>MTUChanged</tp:member-ref> signal.</p>
123
<signal name="MTUChanged" tp:name-for-bindings="MTU_Changed">
125
The Maximum Transmission Unit has changed
127
<arg type="u" name="NewMTU" />
130
<property name="ManualKeyFrames" type="b" access="read"
131
tp:name-for-bindings="Manual_Key_Frames">
133
Only send key frames when manually requested