- <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>
+ <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>
+ <sect3 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>
+ </sect3>
+ <sect3 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>
+ </sect3>
+ <sect3 id="bitmapalphacolor">
+ <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?-->
+ </sect3>
+ <sect3 id="bitmapnbframes">
+ <title>nbframes</title>
+ <para>This attribute is needed to define animated bitmaps; it is the number of frames (images) contained in your animation. All the different frames are just images laid vertically in the bitmap. Animated GIFs are not supported at the moment. (since VLC 0.8.5)</para>
+ <para>Default value: 1</para>
+ </sect3>
+ <sect3 id="bitmapfps">
+ <title>fps</title>
+ <para>Only used in animated bitmaps; it is the number of frames (images) per seconds of the animation. (since VLC 0.8.5)</para>
+ <para>Default value: 0</para>
+ </sect3>
+
+</sect2>
+
+<sect2 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>
+ <sect3 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>
+ </sect3>
+ <sect3 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>
+ </sect3>
+ <sect3 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>
+ </sect3>
+ <sect3 id="subbitmapwidth">
+ <title>width</title>
+ <para>Width of the sub-bitmap, in pixels.</para>
+ <para><emphasis>Required.</emphasis></para>
+ </sect3>
+ <sect3 id="subbitmapheight">
+ <title>height</title>
+ <para>Height of the SubBitmap, in pixels.</para>
+ <para><emphasis>Required.</emphasis></para>
+ </sect3>
+ <sect3 id="subbitmapnbframes">
+ <title>nbframes</title>
+ <para>Same as in <link linkend="bitmapnbframes">Bitmap</link> tag.</para>
+ <para>Default value: 1</para>
+ </sect3>
+ <sect3 id="subbitmapfps">
+ <title>fps</title>
+ <para>Same as in <link linkend="bitmapfps">Bitmap</link> tag.</para>