Bitmap

A Bitmap resource represents an image file that can be used in the skin. Only when you have added an image as a Bitmap resource, items in the skin can use it.

At the moment you can only use PNG images with the Skin Editor, although VLC supports most common graphic formats.

Attributes

alphacolor
Left: original image
Right: how VLC renders it

id
The name identifying this Bitmap. The skin's items use this ID to refer to the image associated with that Bitmap.
This ID has to be unique and is required to be set.

file
The path to the image file, relative to the location of the Skin XML file. The Skin Editor automatically allows only PNGs inside the folder of the skin to be chosen.

alphacolor
All pixels of the image that have that color will not be painted, they will be transparent.
Note that also the transparency mask of the PNG file will be taken into consideration. But at the moment VLC does not support semi-transparency, thus only fully transparent pixels will not be drawn. Semi-transparent pixels will have a black background.

The color has to be set in hexadecimal format. The Skin Editor helps you with setting that color by providing a color chooser.
By default the alphacolor attribute is set to #000000 (black).

Left: source image
Right: animation with nbframes=3 and fps=3

Animation

To create an animated bitmap all frames have to be stored vertically in the source image. The animation will be repeated endlessly.

nbframes
The number of frames. By default this is set to 1.

fps
The speed of the animation in frames per second. By default this is set to 0.

See also:
SubBitmap