Blinkenlights Markup Language English

From BlinkenArea Wiki
Jump to: navigation, search
Zur deutschsprachigen Version dieser Seite

back to summary

The BlinkenlightsMarkupLanguage (BML) is a XML-based format for description of Blinkenlights animations. The blm-tag encloses the whole description of the animation that consists of a optional header and arbitrary many frames. Frames are constructed with row-tags, that describe one line of pixels.

tag: attribut: description:
blm width // width of the animation in pixels
height // height of the animation in pixels
bits // number of bits per channel (default: 1)
channels // number of color-channels (1 = only brightness, 3 = RGB) (default: 1)
header title // title of the animation, necessary if header is present
description // short description of the animation (optional)
creator // software which was used to make this animation (optional)
author // name of the author(optional)
email // email-address of the author (optional)
url // homepage (optional)
loop // loop this animation (optional)
frame // A frame has as many row-tags as the attribute of the blm-tag says. This tag has only one attribute duration, that sets the time in miliseconds how long the picture will be displayed.
row // The row-tag describes one line of pixels with color values. One of this color values is a hexadecimal value of length one (for 1 to 4 bpp) or two (for 5 to 8 bpp). If there is more than one channel, there must be a value for each channel.

For example:

<?xml version="1.0" encoding="UTF-8"?>
<blm width="18" height="8" bits="4" channels="1">
<description>Auto-Generated Vertical Color Test</description>
<frame duration="50">