- "Background" may be initialized with a color nowv0.0.1-rc1

- fixed channel name/number display
- added parameter type (to store logo's filetype)
- "Timebar", "Progressbar" and "Volumebar": Background is only drawn if bg is
  specified
- fixed timebar (was running backwards)
- renamed "Progressbar" to "Replaybar" for more consistency
- renamed "Logo" to "ChannelLogo"
- introduced items "Language" (for audio language texts or symbols) and "Image"
  (foreground images)
- adopted SKINS document (SKINS.de is not up-to-date yet)
- introduced item "MenuTitle"
- introduced items "MenuRed", "MenuGreen", "MenuYellow" and "MenuBlue"
- activated message items for display in menu
- introcuded parameter "arc" and item "Slope"
- fixed possible segfault in Item=Message
- implemented items "SymbolReplaying" and "SymbolRadio"
- added "text" parameter for all text like Items (explanation follows)
- added "SymbolPlay", "SymbolPause", "SymbolFastFwd", "SymbolFastRew",
  "SymbolSlowFwd", "SymbolSlowRew" items.

1 files changed, 75 insertions, 28 deletions

diff --git a/SKINS b/SKINS
index 770f68f..cd59fd1 100644
--- a/SKINS
+++ b/SKINS
@@ -123,9 +123,10 @@ Description: This adds a background area for the specific display. This area
              background for everything that will be drawn later on. You can 
              define a background image for that area here, too. That picture
              has to be the same width and height as the area. If you don't use
-             a background image, the area will not be initialized with any 
-             content. The background color will replace the color 0 in the 
-             images palette, and the foreground color will replace color 1.
+             a background image, the area will be initialized with the bg color
+             (default 0). If an image is present, the background color will 
+             replace the color 0 in the images palette, and the foreground 
+             color will replace color 1.
 Parameters:  x, y, width, height, bpp, path, bg, fg
 
 Item:        Item=Text
@@ -135,34 +136,47 @@ Description: Draws plain text into the given area, using the given foreground
              limits are the background areas.
 Parameters:  x, y, text, width, height, fg, font, align
 
+Item:        Item=Image
+Description: Draws a plain image into the given area, using background and 
+             foreground color (if given) to replace the palette indices 0 
+             and 1. 
+Parameters:  x, y, width, height, fg, bg, path
 
 Item:        Item=DateTime
 Description: Draws a date and time string into the given area. Otherwise, see
              Item=Text
-Parameters:  x, y, width, height, fg, font, align
+Parameters:  x, y, width, height, fg, font, align, text
 
 Item:        Item=Date
 Description: Draws a date string into the given area. Otherwise, see Item=Text
-Parameters:  x, y, width, height, fg, font, align
+Parameters:  x, y, width, height, fg, font, align, text
 
 Item:        Item=Time
 Description: Draws a time string into the given area. Otherwise, see Item=Text
-Parameters:  x, y, width, height, fg, font, align
+Parameters:  x, y, width, height, fg, font, align, text
+
+Item:        Item=ChannelLogo
+Description: Draws a logo for the current channel (if present). The logo's 
+             filename will be the channel name, and the parameter type 
+             gives the file extension. The parameter path can give an 
+             additional subdirectory to the skin's directory.
+Example:     Item=ChannelLogo,path=logos/,type=png,...;
+Parameters:  x, y, width, height, fg, bg, path, type
 
 Item:        Item=ChannelNumberName
 Description: Draws the channel number and name into the given area. Otherwise, 
              see Item=Text
-Parameters:  x, y, width, height, fg, font, align
+Parameters:  x, y, width, height, fg, font, align, text
 
 Item:        Item=ChannelNumber
 Description: Draws the channel number into the given area. Otherwise, see 
              Item=Text
-Parameters:  x, y, width, height, fg, font, align
+Parameters:  x, y, width, height, fg, font, align, text
 
 Item:        Item=ChannelName
 Description: Draws the channel name into the given area. Otherwise, see 
              Item=Text
-Parameters:  x, y, width, height, fg, font, align
+Parameters:  x, y, width, height, fg, font, align, text
 
 Item:        Item=Rectangle
 Description: Draws a filled rectangle into the defined area.
@@ -175,34 +189,35 @@ Parameters:  x, y, width, height, fg
 
 Item:        Item=Timebar
 Description: Draws a timebar displaying the progress of the current programme.
-             The area will be filled with the background color and the bar will
-             be drawn using the foreground color. If width is greater than 
-             height, the bar will be drawn vertically, otherwise horizontally.
+             The area will be filled with the background color (if given) and 
+             the bar will be drawn using the foreground color. If width is 
+             greater than height, the bar will be drawn horizontally, otherwise
+             vertically.
 Parameters:  x, y, width, height, fg, bg
 
 Item:        Item=PresentTime
 Description: Draws the start time of the present programme. 
-Parameters:  x, y, width, height, fg, font, align
+Parameters:  x, y, width, height, fg, font, align, text
 
 Item:        Item=PresentTitle
 Description: Draws the title of the present programme. 
-Parameters:  x, y, width, height, fg, font, align
+Parameters:  x, y, width, height, fg, font, align, text
 
 Item:        Item=PresentShortText
 Description: Draws the short text (or episode name) of the present programme. 
-Parameters:  x, y, width, height, fg, font, align
+Parameters:  x, y, width, height, fg, font, align, text
 
 Item:        Item=FollowingTime
 Description: Draws the start time of the following programme. 
-Parameters:  x, y, width, height, fg, font, align
+Parameters:  x, y, width, height, fg, font, align, text
 
 Item:        Item=FollowingTitle
 Description: Draws the title of the following programme. 
-Parameters:  x, y, width, height, fg, font, align
+Parameters:  x, y, width, height, fg, font, align, text
 
 Item:        Item=FollowingShortText
 Description: Draws the short text (or episode name) of the following programme. 
-Parameters:  x, y, width, height, fg, font, align
+Parameters:  x, y, width, height, fg, font, align, text
 
 Item:        Item=SymbolTeletext
 Description: Draws the specified image into the specified location if the 
@@ -232,6 +247,28 @@ Description: Draws the specified image into the specified location if the
              image handling, see Item=Background.
 Parameters:  x, y, width, height, path, altpath, fg, bg
 
+Item:        Item=SymbolRecording
+Description: Draws the specified image into the specified location if VDR is
+             currently recording. If that is not the case, the alternative 
+             image (if given) will be displayed. For details on the image 
+             handling, see Item=Background.
+Parameters:  x, y, width, height, path, altpath, fg, bg
+
+Item:        Item=SymbolRadio
+Description: Draws the specified image into the specified location if the 
+             current channel is a radio channel. If that is not the case, the 
+             alternative image (if given) will be displayed. For details on the
+             image handling, see Item=Background.
+Parameters:  x, y, width, height, path, altpath, fg, bg
+
+Item:        Item=Language
+Description: Draws a logo for the current language (currently the only 
+             languages VDR knows are "Audio 1" and possibly "Audio 2", 
+             regardless of the real language). For more information on how
+             the logo is found, see Item=ChannelLogo. The logo's filename will
+             be the language's name.
+Parameters:  x, y, width, height, path, type, fg, bg
+
 Item:        Item=Volumebar
 Description: Draws a volumebar into the specified area. For more details, see
              Item=Timebar.
@@ -243,42 +280,42 @@ Description: Draws a mute symbol and/or text (if given) into the specified area.
              handling.
 Parameters:  x, y, width, height, fg, bg, text, font, align, path
 
-Item:        Item=Progressbar
+Item:        Item=Replaybar
 Description: Draws a progressbar displaying the replay progress into the 
              specified area. For more details, see Item=Timebar.
 Parameters:  x, y, width, height, fg, bg
 
 Item:        Item=ReplayTitle
 Description: Draws the title of the current replay.
-Parameters:  x, y, width, height, fg, font, align
+Parameters:  x, y, width, height, fg, font, align, text
 
 Item:        Item=ReplayCurrent
 Description: Draws the current time in the current replay.
-Parameters:  x, y, width, height, fg, font, align
+Parameters:  x, y, width, height, fg, font, align, text
 
 Item:        Item=ReplayTotal
 Description: Draws the total length of the current replay.
-Parameters:  x, y, width, height, fg, font, align
+Parameters:  x, y, width, height, fg, font, align, text
 
 Item:        Item=ReplayJump
 Description: Draws the "Jump:" prompt (if present) of the current replay.
-Parameters:  x, y, width, height, fg, font, align
+Parameters:  x, y, width, height, fg, font, align, text
 
 Item:        Item=MessageStatus
 Description: Draws the current status message (if present).
-Parameters:  x, y, width, height, fg, font, align
+Parameters:  x, y, width, height, fg, font, align, text
 
 Item:        Item=MessageInfo
 Description: Draws the current info message (if present).
-Parameters:  x, y, width, height, fg, font, align
+Parameters:  x, y, width, height, fg, font, align, text
 
 Item:        Item=MessageWarning
 Description: Draws the current warning message (if present).
-Parameters:  x, y, width, height, fg, font, align
+Parameters:  x, y, width, height, fg, font, align, text
 
 Item:        Item=MessageError
 Description: Draws the current error message (if present).
-Parameters:  x, y, width, height, fg, font, align
+Parameters:  x, y, width, height, fg, font, align, text
 
 
 Known Parameters
@@ -337,7 +374,17 @@ Description: A string representing a path- and filename relative to the skin
 Default:     not given
 
 Parameter:   text
-Description: The string that will be displayed.
+Description: For non-text-items (and for the item "Text" itself), this is the
+             plain text to be displayed. For items that have it's own texts
+             (such as "Date", "PresentTitle" etc.), this is a template that 
+             defines how the text is to be displayed. A dollar symbol '$' will
+             be replaced by the original text.
+Default:     not given
+Example:     Item=ReplayCurrent,text=Current: $; would display for example
+             "Current: 0:00:21" instead of only "0:00:21".
+
+Parameter:   type
+Description: The string giving the file extensions for logos.
 Default:     not given
 
 Parameter:   align