+<sect2 id="commattr">
+ <title>Common attributes</title>
+ <para>The following attributes are common to all the controls (Image, Button, Checkbox, Text, Slider, RadialSlider, Playlist, Playtree, Video)</para>
+ <sect3 id="attrid">
+ <title>id</title>
+ <para>Identifiant of the control. Currently unused.</para>
+ <para>Default value: none</para>
+ </sect3>
+ <sect3 id="visible">
+ <title>visible</title>
+ <para>See <link linkend="boolexpr">Boolean expressions</link>.</para>
+ <para>Default value: true</para>
+ </sect3>
+ <sect3 id="x">
+ <title>x</title>
+ <para>Horizontal offset of the control, relative to the container box (see the <link linkend="layoutmodel">Layout model</link>) or to the parent <link linkend="Group">Group</link>.</para>
+ <para>Default value: 0</para>
+ </sect3>
+ <sect3 id="y">
+ <title>y</title>
+ <para>Vertical offset of the control, relative to the container box (see the <link linkend="layoutmodel">Layout model</link>) or to the parent <link linkend="Group">Group</link>.</para>
+ <para>Default value: 0</para>
+ </sect3>
+ <sect3 id="lefttop">
+ <title>lefttop</title>
+ <para>Indicate to which corner of the container box the top-left-hand corner of this control is attached, in case of resizing. Possible values are 'lefttop', 'leftbottom', 'righttop' and 'rightbottom'. See the <link linkend="layoutmodel">Layout model</link> for more details.</para>
+ <para>Default value: lefttop</para>
+ </sect3>
+ <sect3 id="rightbottom">
+ <title>rightbottom</title>
+ <para>Indicate to which corner of the container box the bottom-right-hand corner of this control is attached, in case of resizing. See the <link linkend="layoutmodel">Layout model</link> for more details.</para>
+ <para>Default value: lefttop</para>
+ </sect3>
+ <sect3 id="xkeepratio">
+ <title>xkeepratio</title>
+ <para>When set to true, the behaviour of the horizontal resizing is changed. Instead of taking into account the <link linkend="lefttop">lefttop</link> and <link linkend="rightbottom">rightbottom</link> attributes to determine how the control will be moved/resized, only its initial position inside the container box matters. For example, if initially the space to the left of the control is twice as big as the one to its right, this will stay the same during any horizontal resizing. The width of the control stays constant.</para>
+ <para>This attribute can be particularly useful to keep a control centered in the container box, without resizing it (to resize it, you would rather use the lefttop/rightbottom attributes). See the <link linkend="layoutmodel">Layout model</link> for more details. Available since VLC 0.8.6.</para>
+ <para>Default value: false</para>
+ </sect3>
+ <sect3 id="ykeepratio">
+ <title>ykeepratio</title>
+ <para>When set to true, the behaviour of the vertical resizing is changed. Instead of taking into account the <link linkend="lefttop">lefttop</link> and <link linkend="rightbottom">rightbottom</link> attributes to determine how the control will be moved/resized, only its initial position inside the <link linkend="Layout">Layout</link> matters. For example, if initially the space to the top of the control is twice as big as the one to its bottom, this will stay the same during any vertical resizing. The height of the control stays constant.</para>
+ <para>This attribute can be particularly useful to keep a control centered in the container box, without resizing it (to resize it, you would rather use the lefttop/rightbottom attributes). See the <link linkend="layoutmodel">Layout model</link> for more details. Available since VLC 0.8.6.</para>
+ <para>Default value: false</para>
+ </sect3>
+ <sect3 id="help">
+ <title>help</title>
+ <para>Help text for the current control. The variable '$H' will be expanded to this value when the mouse hovers the current control (see <link linkend="textvars">Text variables</link>).</para>
+ <para>Default value: </para>
+ </sect3>
+ <para>The vlc2.0 extends some of these parameters and adds five more parameters to ease up positioning windows within a given screen and widgets within their own containers (layout, panel, ...). As extension, the x, y, width and height can now be given in pixels (default) or in percentage of their container. For instance, x="10" or x="10px" is construed as 10 pixels, and x="10%" is construed as 10% of the width of the screen for windows or their container for widgets.</para>
+ <sect3 id="position">
+ <title>position</title>
+ <para>Relative placement of windows or widget within their respective container(screen for windows, layout or panel for widgets). This placement is given with a geographical qualifier. Possible values are "Center", "North", "NorthWest", ....The skin engine computes the size of the element (from the width and height parameters) then places it at the center or sticks it to a given border depending on the geographical qualifer.</para>
+ <para>Default value: -1(N/A)</para>
+ </sect3>
+ <sect3 id="xmargin">
+ <title>xmargin</title>
+ <para>Coupled with position, xmargin allows for a horizontal margin instead of just sticking to the border. It can be given in pixels or in percentage of the width of the container.</para>
+ <para>Default value: 0</para>
+ </sect3>
+ <sect3 id="ymargin">
+ <title>ymargin</title>
+ <para>Coupled with position, ymargin allows for a vertical margin instead of just sticking to the border. It can be given in pixels or in percentage of the height of the container.</para>
+ <para>Default value: 0</para>
+ </sect3>
+ <sect3 id="xoffset">
+ <title>xoffset</title>
+ <para>Coupled with position and xmargin, this parameter moves the widget horizontally by this offset from the position computed above. From VLC2.1.0 on, xoffset can directly be used without position, in which case percentage is computed against the current object instead of the upper container</para>
+ <para>Default value: 0</para>
+ </sect3>
+ <sect3 id="yoffset">
+ <title>yoffset</title>
+ <para>Coupled with position and ymargin, this parameter moves the widget vertically by this offset from the position computed above. From VLC2.1.0 on, yoffset can directly be used without position, in which case percentage is computed against the current object instead of the upper container</para>
+ <para>Default value: 0</para>
+ </sect3>
+</sect2>
+
+<sect2 id="Image">