- <para>Associates a bitmap file in PNG format with an identifiant (=name) that will be used by the various controls. Obviously, you need one Bitmap tag for each bitmap file you have.</para>
- <sect4 id="bitmapid">
- <title>id</title>
- <para>This is the identifiant of the bitmap that will be used with controls. Two bitmaps cannot have the same id.</para>
- <para><emphasis>Required.</emphasis></para>
- </sect4>
- <sect4 id="bitmapfile">
- <title>file</title>
- <para>This attribute is used to indicate the path and name of the bitmap file used. This path can be absolute (but you should definitely avoid it), or relative to the path of the XML file.</para>
- <para><emphasis>Required.</emphasis></para>
- </sect4>
- <sect4 id="alphacolor">
- <title>alphacolor</title>
- <para>This is the transparency color of the bitmap. It must be indicated with the following format: "#RRGGBB" (where RR stands for the hexadecimal value of the red component, GG for the green one, and BB for the blue one).</para>
- <note><para>If your PNG file specifies a transparency mask, it will be taken into account too.</para></note>
- <para>Default value: #000000</para><!--XXX: should we change it into a less often used color?-->
- </sect4>
- </sect3>
+ <para>Associates a bitmap file (usually in PNG format) with an identifiant (=name) that will be used by the various controls. Obviously, you need one Bitmap tag for each bitmap file you have.</para>
+ <sect4 id="bitmapid">
+ <title>id</title>
+ <para>Identifiant of the bitmap that will be used with controls. Two bitmaps cannot have the same id.</para>
+ <para><emphasis>Required.</emphasis></para>
+ </sect4>
+ <sect4 id="bitmapfile">
+ <title>file</title>
+ <para>Indicates the path and name of the bitmap file used. This path can be absolute (but you should definitely avoid it), or relative to the path of the XML file.</para>
+ <para><emphasis>Required.</emphasis></para>
+ </sect4>
+ <sect4 id="alphacolor">
+ <title>alphacolor</title>
+ <para>Transparency color of the bitmap. It must be indicated with the following format: "#RRGGBB", where RR stands for the hexadecimal value of the red component, GG for the green one, and BB for the blue one.</para>
+ <note><para>If your PNG file specifies a transparency mask, it will be taken into account too.</para></note>
+ <para>Default value: #000000</para><!--XXX: should we change it into a less often used color?-->
+ </sect4>
+</sect3>
+
+<sect3 id="SubBitmap">
+ <title>SubBitmap</title>
+ <para>Declares a portion of bitmap, that will be used with controls in the same way as a regular Bitmap. A SubBitmap tag can only be placed inside a <link linkend="Bitmap">Bitmap</link> tag, and references implicitly the same file. SubBitmaps are very convenient when a file contains images for several controls. (This tag was not available before VLC 0.8.5).</para>
+ <sect4 id="subbitmapid">
+ <title>id</title>
+ <para>Identifiant of the portion of bitmap that will be used with controls. It must be unique in the whole skin.</para>
+ <para><emphasis>Required.</emphasis></para>
+ </sect4>
+ <sect4 id="subbitmapx">
+ <title>x</title>
+ <para>Horizontal offset of the sub-bitmap (in pixels), relative to the "parent" bitmap.</para>
+ <para><emphasis>Required.</emphasis></para>
+ </sect4>
+ <sect4 id="subbitmapy">
+ <title>y</title>
+ <para>Vertical offset of the sub-bitmap (in pixels), relative to the "parent" bitmap.</para>
+ <para><emphasis>Required.</emphasis></para>
+ </sect4>
+ <sect4 id="subbitmapwidth">
+ <title>width</title>
+ <para>Width of the sub-bitmap, in pixels.</para>
+ <para><emphasis>Required.</emphasis></para>
+ </sect4>
+ <sect4 id="subbitmapheight">
+ <title>height</title>
+ <para>Height of the SubBitmap, in pixels.</para>
+ <para><emphasis>Required.</emphasis></para>
+ </sect4>
+</sect3>