Graphlcd-plugin/touchcol: Difference between revisions

From VDR Wiki
Jump to navigation Jump to search
 
(34 intermediate revisions by 2 users not shown)
Line 3: Line 3:
'''Author:''' Community maintained.
'''Author:''' Community maintained.


This page is about a branch of the [[Graphlcd-plugin|GraphLCD plugin]] with built-in support for skins. The '''GraphLCD plugin''' integrates a graphical display into [[VDR]] and makes it possible to control VDR even if the television is off.
The '''GraphLCD plugin''' integrates a graphical display into [[VDR]] and makes it possible to control VDR even if the television is off.


This page is about a branch of the [[Graphlcd-plugin|GraphLCD plugin]] with the following '''added''' or '''enhanced features''':
The branch was started by Andreas 'powarman' Regel but was then abandoned and given to new maintainers by his request.
* '''skins'''
* '''interaction''' (e.g. touchpads)
* '''colour devices''' (including '''alpha channel''')
* '''external services''' (data from other plugins)


The branch was started by Andreas 'powarman' Regel but was then abandoned and given to new maintainers by his request.
The functionality of this branch is rather impressive but unfortunately the code is hardly documented.


So this page will be used as a starting point for collecting and formatting its features. Thus this page will be started being a pigsty and improved 'along the way'.
The documentation for the new features is rather 'sparse' at the moment but this page will be used as a starting point for collecting and formatting its features, thus this page will be started being a pigsty and improved 'along the way'.


===Images===
===Images===
Line 30: Line 34:


Supported are the following controllers (or compatibles) and modules:
Supported are the following controllers (or compatibles) and modules:
* <strike>Hitachi HD61830
* Hitachi HD61830
* Samsung KS0108
* Samsung KS0108
* Toshiba T6963
* Toshiba T6963
Line 36: Line 40:
* Epson SED1330
* Epson SED1330
* Noritake GU140X32F-7806
* Noritake GU140X32F-7806
* Noritake GU256X64-372</strike>
* Noritake GU256X64-372


and with the extra library [[http://serdisplib.sf.net serdisplib]] even a lot more (list of supported displays/modules: [[http://serdisplib.sourceforge.net/index.html#displays supported displays]]).
and with the extra library [[http://serdisplib.sf.net serdisplib]] even a lot more (list of supported displays/modules: [[http://serdisplib.sourceforge.net/index.html#displays supported displays]]).


====displays/drivers currently supported (some are broken because of a missing SetPixel()-method)====
====displays/drivers currently supported (not all drivers are verified to correctly support the new internal 32bit colour representation)====


'''Please adapt this list if a driver is working flawlessly (add a cross to 'verified') or inform the maintainer!'''
{|cellpadding="5" cellspacing="0" border="1" width="100%"

Status informations are related to the most current GIT-version!

{|cellpadding="2" cellspacing="0" border="1" width="50%"
!driver
!driver
!verified
!verified
!may work (not verified)
!may work (not verified)
!not working (no SetPixel())
|-
|-
| avrctl
| avrctl
|
|
|
| x
| x
|-
| ax206dpf <sup>2)</sup>
| x
|
|-
|-
| dm140gink
| dm140gink
|
|
| x
| x
|
|-
|-
| framebuffer
| framebuffer
|
| x
| x
|
|
|-
|-
| futabaMDM166A
| gu256x64-372
|
|
| x
| x
|
|-
|-
| g15daemon
| g15daemon
|
|
| x
| x
|
|-
|-
| gu126x64D-K610A4
| gu126x64D-K610A4
|
|
| x
| x
|
|-
|-
| gu140x32f
| gu140x32f
|
|
| x
| x
|
|-
|-
| gu256x64-372
| gu256x64-372
|
| x
| x
|
|
|-
|-
| gu256x64-3900
| gu256x64-3900
|
|
| x
| x
|
|-
|-
| hd61830
| hd61830
|
| x
|
|
| x
|-
|-
| image
| image
|
| x
| x
|
|
|-
|-
| ks0108
| ks0108
| x <sup>1)</sup>
|
|
|
| x 1)
|-
|-
| network
| network
|
|
|
| x
| x
Line 116: Line 114:
|
|
| x
| x
|
|-
|-
| sed1330
| sed1330
|
| x
|
|
| x 1)
|-
|-
| sed1520
| sed1520
|
|
|
| x
| x 2)
|-
|-
| serdisp
| serdisp
| x
| x
|
|
|
|-
|-
| simlcd
| simlcd
| x
| x
|
|
|
|-
|-
| t6963c
| t6963c
|
| x
|
|
| x 1)
|-
|-
|}
|}


<sup>1)</sup> graphic output is very slow. use ks0108-support of serdisplib instead.
1) in the meantime serdisplib might be used as substitute.


<sup>2)</sup> experimental. only available if enabled during build process.
2) some sed1520-based displays are supported by serdisplib.


===Software requirements===
===Software requirements===
Line 157: Line 149:
===Installation of graphlcd===
===Installation of graphlcd===


graphlcd (skin-branch) consists of two parts:
graphlcd (touchcol-branch) consists of two parts:
* '''graphlcd-base''': library with low level drivers, basic functionality, and skin support
* '''graphlcd-base''': library with low level drivers, basic functionality, and skin support
* '''vdr-plugin-graphlcd''': VDR plugin.
* '''vdr-plugin-graphlcd''': VDR plugin.
Line 164: Line 156:
First of all a current version (contains included skin support) of <tt>graphlcd-base</tt> needs to be installed:
First of all a current version (contains included skin support) of <tt>graphlcd-base</tt> needs to be installed:
* Get current version from the GIT repoository:
* Get current version from the GIT repoository:
git clone git://projects.vdr-developer.org/graphlcd-base.git
<tt>git clone git://projects.vdr-developer.org/graphlcd-base.git -b touchcol graphlcd-base.git.touchcol</tt>
* compile and install the library
* compile and install the library (default installation directory: <tt>/usr/local/include/</tt>, can be changed in <tt>Make.config</tt>)
<tt>make</tt>

<tt>make install</tt>


Then the VDR plugin needs to be retrieved, installed, and compiled:
Then the VDR plugin needs to be retrieved, installed, and compiled:
* Note: <tt>$SOURCEDIR/VDR</tt> is the source directory of VDR and needs to be adapted accordingly.
* Note: <tt>$SOURCEDIR/VDR</tt> is the source directory of VDR and needs to be adapted accordingly.
* Get current version of the branch from the GIT repository:
* Get current version of the branch from the GIT repository:
cd $SOURCEDIR/VDR/PLUGINS/src/
<tt>cd $SOURCEDIR/VDR/PLUGINS/src/</tt>
git clone git://projects.vdr-developer.org/vdr-plugin-graphlcd.git -b 0.2.0 vdr-plugin-graphlcd_0.2.0
<tt>git clone git://projects.vdr-developer.org/vdr-plugin-graphlcd.git -b touchcol vdr-plugin-graphlcd_0.3.0</tt>
ln -s vdr-plugin-graphlcd_0.2.0 graphlcd
<tt>ln -s vdr-plugin-graphlcd_0.3.0 graphlcd</tt>
* compile plugin, eg:
* compile plugin, eg:
cd $SOURCEDIR/VDR/
<tt>cd $SOURCEDIR/VDR/</tt>
make plugins
<tt>make plugins</tt>


Everything else is the same as described in [[plugin installation]].
Everything else is the same as described in [[plugin installation]].
Line 183: Line 176:
After finishing the installation, some files need to be copied.
After finishing the installation, some files need to be copied.


* copy the configuration file <tt>graphlcd.conf</tt> to some destination, on most installations this will be /etc.<br/>can be manually configured by setting parameter <tt>--skin</tt> (see below):
* copy the configuration file <tt>graphlcd.conf</tt> to some destination, on most installations this will be /etc.<br/>can be manually configured by setting parameter ''skin'' (see below):<br/>(replace <tt>/etc/</tt> if your distribution expects another destination)
cp graphlcd.conf /etc/
<tt>cp graphlcd.conf /etc/</tt>
* copy the directory with logos, fonts, and skins to <tt>$VDRCONFIG/plugins</tt> (depending on your installation this will be <tt>/etc/vdr/plugins</tt>, or <tt>/video/plugins</tt>, or some other destination):
* copy the directory with logos, fonts, and skins to <tt>$VDRCONFIG/plugins</tt> (depending on your installation this will be <tt>/etc/vdr/plugins</tt>, or <tt>/video/plugins</tt>, or some other destination):
cp -r $SOURCEDIR/VDR/PLUGINS/src/graphlcd/graphlcd $VDRCONFIG/plugins/
<tt>cp -r $SOURCEDIR/VDR/PLUGINS/src/graphlcd/graphlcd $VDRCONFIG/plugins/</tt>


===Parameter===
===Parameter===
Line 258: Line 251:
* skins are always UTF-8, on non UTF-8 systems UTF-8 text will be transcoded on-the-fly.
* skins are always UTF-8, on non UTF-8 systems UTF-8 text will be transcoded on-the-fly.
* All variable and font names must be 7-bit safe (no umlauts or diacritics).
* All variable and font names must be 7-bit safe (no umlauts or diacritics).
* HTML-entities are not supported, except '''&amp;lt;''','''&amp;gt;''', '''&amp;amp;''', '''&#x''<hexID>'';''', and '''&#''<decID>'';''' (e.g.: &#xE001;).
* HTML-entities are not supported, except '''&amp;lt;''', '''&amp;gt;''', '''&amp;amp;''', '''&#x''<hexID>'';''' and '''&#''<decID>'';''' (e.g.: &amp;#xE001;).
}}
}}


Line 293: Line 286:


===List of tokens defined in either graphlcd-base or vdr-plugin-graphlcd===
===List of tokens defined in either graphlcd-base or vdr-plugin-graphlcd===
* Current channel
* '''Current channel'''
:;<nowiki>{ChannelNumber}</nowiki>
:;<nowiki>{ChannelNumber}</nowiki>
::''Return: an integer value''
::''Returns an integer value''
::The Channel Number
::Channel number
:;<nowiki>{ChannelName}</nowiki>
:;<nowiki>{ChannelName}</nowiki>
::''Return: an string value, may empty''
::''Returns a string value, may be empty''
::The Channel [[Syntax_of_channels.conf#Name|Name]]
::Channel [[Syntax_of_channels.conf#Name|name]] or group name
:;<nowiki>{ChannelShortName}</nowiki>
:;<nowiki>{ChannelShortName}</nowiki>
::''Return: an string value, may empty''
::''Returns a string value, may be empty''
::The Channel [[Syntax_of_channels.conf#Name|short Name]], if present
::[[Syntax_of_channels.conf#Name|Short name]] of channel, if available
:;<nowiki>{ChannelProvider}</nowiki>
:;<nowiki>{ChannelProvider}</nowiki>
::''Return: an string value, may empty''
::''Returns a string value, may be empty''
::The [[Syntax_of_channels.conf#Name|Provider Name]], if present
::[[Syntax_of_channels.conf#Name|Provider]]/bouquet name, if available
:;<nowiki>{ChannelPortal}</nowiki>
:;<nowiki>{ChannelPortal}</nowiki>
::''Return: an string value, may empty''
::''Returns a string value, may be empty''
::Portal name, if available
::The Name of the VDRs channel group the Channel belong to
:;<nowiki>{ChannelSource}</nowiki>
:;<nowiki>{ChannelSource}</nowiki>
::''Return: an string value, may empty''
::''Returns a string value, may be empty''
::[[Syntax_of_channels.conf#Source|Signal source]] of the channel, as defined in [[sources.conf|sources.conf]].
::[[Syntax_of_channels.conf#Source|Signal source]] of channel, as defined in [[sources.conf|sources.conf]].
:;<nowiki>{ChannelID}</nowiki>
:;<nowiki>{ChannelID}</nowiki>
::''Returns a string value: "<[[Syntax_of_channels.conf#Source|Source]]>-<[[Syntax_of_channels.conf#NID|NID]]>-<[[Syntax_of_channels.conf#TID|TID]]>-<[[Syntax_of_channels.conf#SID|SID]]><nowiki>[</nowiki>-<[[Syntax_of_channels.conf#RID|RID]]><nowiki>]</nowiki>"
::''Return: an valid vdr channel id string, maybe ?''
::Identifier of the current channel
::The VDRs channel ID
:;<nowiki>{ChannelHasTeletext} | {HasTeletext}</nowiki>
:;<nowiki>{ChannelHasTeletext} | {HasTeletext}</nowiki>
::''Return: boolean''
::''Returns a boolean''
::True if Teletext is present
::True if teletext is present
:;<nowiki>{ChannelHasMultilang} | {HasMultilang}</nowiki>
:;<nowiki>{ChannelHasMultilang} | {HasMultilang}</nowiki>
::''Return: boolean''
::''Returns a boolean''
::True if more than one Audio stream is present
::True if more than one audio stream is present
:;<nowiki>{ChannelHasDolby} | {HasDolby}</nowiki>
:;<nowiki>{ChannelHasDolby} | {HasDolby}</nowiki>
::''Return: boolean''
::''Returns a boolean''
::True if [[Wikipedia:Dolby_Digital|Dolby Digital]] stream is present
::True if a [[Wikipedia:Dolby_Digital|Dolby Digital]] stream is present
:;<nowiki>{ChannelIsEncrypted} | {IsEncrypted}</nowiki>
:;<nowiki>{ChannelIsEncrypted} | {IsEncrypted}</nowiki>
::''Return: boolean''
::''Returns a boolean''
::True if the channel is encrypted
::True if the channel is encrypted
:;<nowiki>{ChannelIsRadio} | {IsRadio}</nowiki>
:;<nowiki>{ChannelIsRadio} | {IsRadio}</nowiki>
::''Return: boolean''
::''Returns a boolean''
::True if the channel is an Radio channel
::True if the channel is a radio channel
:;<nowiki>{ChannelAlias}</nowiki>
:;<nowiki>{ChannelAlias}</nowiki>
::''Return: string, may empty?''
::''Returns a string, may be empty''
::The ChannelAlias, this is an virtual channel Name mapped throw the channels.alias mapping file.<br />Its the preferred way for naming channel logos
::The ChannelAlias is a virtual channel name mapped through the channels.alias mapping file.<br />It's the preferred way for naming channel logos.
* Recording
* '''Recording'''
:;<nowiki>{IsRecording[,<card number>]}</nowiki>
:;<nowiki>{IsRecording[,<card number>]}</nowiki>
::?
::?
:;<nowiki>{Recordings[,<card number>]}</nowiki>
:;<nowiki>{Recordings[,<card number>]}</nowiki>
::?
::?
* Present EPG
* '''Present EPG'''
:;<nowiki>{PresentValid}</nowiki>
:;<nowiki>{PresentValid}</nowiki>
::?
::?
Line 359: Line 352:
:;<nowiki>{PresentDescription}</nowiki>
:;<nowiki>{PresentDescription}</nowiki>
::?
::?
* Following EPG
* '''Following EPG'''
:;<nowiki>{FollowingValid}</nowiki>
:;<nowiki>{FollowingValid}</nowiki>
::?
::?
Line 376: Line 369:
:;<nowiki>{FollowingDescription}</nowiki>
:;<nowiki>{FollowingDescription}</nowiki>
::?
::?
* Volume
* '''Volume'''
:;<nowiki>{VolumeCurrent}</nowiki>
:;<nowiki>{VolumeCurrent}</nowiki>
::?
::?
Line 383: Line 376:
:;<nowiki>{VolumeIsMute} | {IsMute}</nowiki>
:;<nowiki>{VolumeIsMute} | {IsMute}</nowiki>
::?
::?
* Replay
* '''Replay'''
:;<nowiki>{ReplayTitle}</nowiki>
:;<nowiki>{ReplayTitle}</nowiki>
::?
::?
Line 414: Line 407:
:;<nowiki>{ReplayIsLoop}</nowiki>
:;<nowiki>{ReplayIsLoop}</nowiki>
::Not implemented yet!
::Not implemented yet!
* OSD related
* '''OSD related'''
:;<nowiki>{Message}</nowiki>
:;<nowiki>{Message}</nowiki>
::?
::?
Line 433: Line 426:
:;<nowiki>{ButtonBlue}</nowiki>
:;<nowiki>{ButtonBlue}</nowiki>
::?
::?
* Settings
* '''Settings'''
:;<nowiki>{SettingShowChannelLogo}</nowiki>
:;<nowiki>{SettingShowChannelLogo}</nowiki>
::?
::?
Line 456: Line 449:
:;<nowiki>{DisplayMode}</nowiki>
:;<nowiki>{DisplayMode}</nowiki>
::?<br />Return "Normal" or "Interactive"
::?<br />Return "Normal" or "Interactive"
* General info
* '''General info'''
:;<nowiki>{IsUTF8}</nowiki>
:;<nowiki>{IsUTF8}</nowiki>
::''Return: boolean''
::''Returns a boolean''
::true if the VDR runnig under [[Wikipedia:Utf-8|utf-8]] encoding
::true if the VDR is runnig with [[Wikipedia:UTF-8|UTF-8]] encoding enabled.
:;<nowiki>{DateTime[:</nowiki>[[#strftime_format_string|<strftime format>]]<nowiki>]}</nowiki>
:;<nowiki>{DateTime[:</nowiki>[[#strftime_format_string|<strftime format>]]<nowiki>]}</nowiki>
::?
::?
Line 470: Line 463:
:;<nowiki>{ScreenHeight}</nowiki>
:;<nowiki>{ScreenHeight}</nowiki>
::?
::?
:;<nowiki>{ForegroundColor}</nowiki>
::''Return: an valid color string "0x<AA><RR><GG><BB>"''
::return the foreground color as reportet by the display driver. {DefaultForegroundColor} if the driver do not set this.
::black&white skins use this color to set an pixel.
:;<nowiki>{BackgroundColor}</nowiki>
::''Return: an valid color string "0x<AA><RR><GG><BB>"''
::return the background color as reportet by the display driver. {DefaultBackgroundColor} if the driver do not set this.
::black&white skins use this color to clear an pixel.
:;<nowiki>{DefaultForegroundColor}</nowiki>
:;<nowiki>{DefaultForegroundColor}</nowiki>
::''Return: an valid color string "0x<AA><RR><GG><BB>"''
::''Returns a colour string representation, format: "0x<AA><RR><GG><BB>"''.
::return the graphlcd default foreground color (currently set to white)
::Contains the default foreground colour of the currently used graphlcd driver '''''without''''' consideration of user settings.
:;<nowiki>{DefaultBackgroundColor}</nowiki>
:;<nowiki>{DefaultBackgroundColor}</nowiki>
::''Return: an valid color string "0x<AA><RR><GG><BB>"''
::''Returns a colour string representation, format: "0x<AA><RR><GG><BB>"''.
::return the graphlcd default background color (currently set to black)
::Contains the default background colour of the currently used graphlcd driver '''''without''''' consideration of user settings.
:;<nowiki>{ForegroundColor}</nowiki>
* Set with [[SVDRP|SVDRP]]
::''Returns a colour string representation, format: "0x<AA><RR><GG><BB>", (eg: 0xFFFFFFFF)''.
::Contains the foreground colour (if set in graphlcd.conf: returns ''FGColour'', or, if not set: the same as {DefaultForegroundColor}).
::(Setting ''FGColour'' is currently only supported by driver ''serdisp'').
::On monochrome displays this colour defines the colour for ''setting'' a pixel.
::{ForegroundColor} should be used in favour of {DefaultForegroundColor}.
:;<nowiki>{BackgroundColor}</nowiki>
::''Returns a colour string representation, format: "0x<AA><RR><GG><BB>", (eg: 0xFF000000)''.
::Contains the background colour (if set in graphlcd.conf: returns ''BGColour'', or, if not set: the same as {DefaultBackgroundColor}).
::(Setting ''BGColour'' is currently only supported by driver ''serdisp'').
::On monochrome displays this colour defines the colour for ''clearing'' a pixel.
::{BackgroundColor} should be used in favour of {DefaultBackgroundColor},
* [[SVDRP|SVDRP commands]]
:{|cellspacing="0" cellpadding="0" style="background-color:lightcyan"
:{|cellspacing="0" cellpadding="0" style="background-color:lightcyan"
|'''CLS'''<br>&nbsp;&nbsp;&nbsp;Clear display
|svdrpsend plug graphlcd set <key> <value, space allowed>
|-
|-
|'''UPD'''<br>&nbsp;&nbsp;&nbsp;Update display
|svdrpsend plug graphlcd setexp <exp> <key> <value, space allowed>
|-
|-
|'''OFF'''<br>&nbsp;&nbsp;&nbsp;Switch off plugin
|svdrpsend plug graphlcd unset <key>
|-
|-
|'''ON'''<br>&nbsp;&nbsp;&nbsp;Switch on plugin
|svdrpsend plug graphlcd get <key>
|-
|'''SET <key>[,display=<display>][,expire=<expire] <value>'''<br>&nbsp;&nbsp;&nbsp;Set entry <key> to value <value>. optionally expire after <expire> seconds. <value> may contain spaces
|-
|'''GET <key>[,display=<display>]'''<br>&nbsp;&nbsp;&nbsp;Unset (clear) entry <key>
|-
|'''UNSET <key>[,display=<display>]'''<br>&nbsp;&nbsp;&nbsp;Get value assigned to entry <key>
|-
|'''CONNECT [<display> [<skin>]]'''<br>&nbsp;&nbsp;&nbsp;Connect given display or reconnect all displays if called w/o parameter
|-
|'''DISCONN''' [<display>]<br>&nbsp;&nbsp;&nbsp;Disconnect given display or all displays if called w/o parameter
|}
|}

:'''''examples:'''''
<pre style="margin-left:2em;">
PLUG GRAPHLCD SET somekey somevalue
PLUG GRAPHLCD UNSET somekey
PLUG GRAPHLCD SET someotherkey,expire=30 this will expire after 30 seconds
</pre>

* Read variables set by SVDRP command ''SET''
:;<nowiki>{ExtDataIsAvailable:<key>}</nowiki>
:;<nowiki>{ExtDataIsAvailable:<key>}</nowiki>
::Check if a given variable is set with an SVDRP call
::Check if a given variable was set
:; <nowiki>{ExtDataItem:<key>}</nowiki>
:;<nowiki>{ExtDataItem:<key>}</nowiki>
::Retrieve the contend of the given variable
::Retrieve the content of the given variable

:'''''example:'''''
<pre style="margin-left:2em;">
<block condition="{ExtDataIsAvailable:somekey}">
<text x="0" y="0" font="somefont">SomeKey: {ExtDataItem:somekey}</text>
</block>
</pre>

* Other Plugins Services
* Other Plugins Services
:;<nowiki>{ServiceIsAvailable:<service>}</nowiki>
:;<nowiki>{ServiceIsAvailable:<service>}</nowiki>
Line 576: Line 600:
:::''Update interval 2 s''
:::''Update interval 2 s''
:::'' '''[[#printf_format_string|<printf format>]]''' and '''<divisor>''' are only available with key '''video_bitrate/vbr''', '''audio_bitrate/abr''' and '''dolby_bitrate/dbr''' ''
:::'' '''[[#printf_format_string|<printf format>]]''' and '''<divisor>''' are only available with key '''video_bitrate/vbr''', '''audio_bitrate/abr''' and '''dolby_bitrate/dbr''' ''
::*[[Mailbox-plugin|mailbox-Plugin]] Service

:::;<nowiki>{ServiceItem:mailbox,<key>}</nowiki>
:::{|class="wikitable"
|- style="text-align:center;"
!colspan="2"|key
!Return
!Description
|-
|style="text-align:center;"| '''default''' || '''hasnew''' || boolean ||style="text-align:left;"| return true if there are unread mails in one of the accounts configured to report unread mails.<br />false if accounts not checked yet or if there are no new mails
|-
|colspan="2" style="text-align:center;"| '''newcount''' || integer || report how many mails are unread in all accounts configured to report this.<br />return zero if accounts not checked yet, use '''hasnew''' to check this
|-
|}
:::''Update interval 10 s''
;Format Strings
;Format Strings
* <div id="printf_format_string">printf Format String</div>
* <div id="printf_format_string">printf Format String</div>
Line 588: Line 625:
!Replaced by
!Replaced by
|-
|-
|style="text-align:center;"| '''%H''' || ?
|style="text-align:center;"| '''%H''' || Hour Part, leading Zero (2 Chars)
|-
|-
|style="text-align:center;"| '''%k''' || ?
|style="text-align:center;"| '''%k''' || Hour Part, leading Whitespace (2 Chars)
|-
|-
|style="text-align:center;"| '''%M''' || ?
|style="text-align:center;"| '''%M''' || Minute Part, leading Zero (2 Chars)
|-
|-
|style="text-align:center;"| '''%m''' || ?
|style="text-align:center;"| '''%m''' || Time in Minutes
|-
|-
|style="text-align:center;"| '''%S''' || ?
|style="text-align:center;"| '''%S''' || Second Part, leading Zero (2 Chars)
|-
|-
|style="text-align:center;"| '''%f''' || ?
|style="text-align:center;"| '''%f''' || ?

Latest revision as of 19:58, 13 July 2012

Description

Author: Community maintained.

The GraphLCD plugin integrates a graphical display into VDR and makes it possible to control VDR even if the television is off.

This page is about a branch of the GraphLCD plugin with the following added or enhanced features:

  • skins
  • interaction (e.g. touchpads)
  • colour devices (including alpha channel)
  • external services (data from other plugins)

The branch was started by Andreas 'powarman' Regel but was then abandoned and given to new maintainers by his request.

The documentation for the new features is rather 'sparse' at the moment but this page will be used as a starting point for collecting and formatting its features, thus this page will be started being a pigsty and improved 'along the way'.

Images

OLED, 256x64, customised skin
GLCD, 240x128, another customised skin
LCD panel, 640x200, connected to USB13700 module


Installation

Hardware requirements

To use this plugin you need a graphical display with supported controller. It's even possible to redirect the output of the plugin to image files or to the framebuffer to drive e.g. TFT monitors.

Supported are the following controllers (or compatibles) and modules:

  • Hitachi HD61830
  • Samsung KS0108
  • Toshiba T6963
  • Epson SED1520
  • Epson SED1330
  • Noritake GU140X32F-7806
  • Noritake GU256X64-372

and with the extra library [serdisplib] even a lot more (list of supported displays/modules: [supported displays]).

displays/drivers currently supported (not all drivers are verified to correctly support the new internal 32bit colour representation)

Please adapt this list if a driver is working flawlessly (add a cross to 'verified') or inform the maintainer!

Status informations are related to the most current GIT-version!

driver verified may work (not verified)
avrctl x
ax206dpf 2) x
dm140gink x
framebuffer x
futabaMDM166A x
g15daemon x
gu126x64D-K610A4 x
gu140x32f x
gu256x64-372 x
gu256x64-3900 x
hd61830 x
image x
ks0108 x 1)
network x
noritake800 x
sed1330 x
sed1520 x
serdisp x
simlcd x
t6963c x

1) graphic output is very slow. use ks0108-support of serdisplib instead.

2) experimental. only available if enabled during build process.

Software requirements

  • freetype (rendering of TrueType fonts)
  • ImageMagick or GraphicsMagick (optional, required for reading image formats other than glcd and pbm)
  • serdisplib (optional, see above, not required at compile time)

Installation of graphlcd

graphlcd (touchcol-branch) consists of two parts:

  • graphlcd-base: library with low level drivers, basic functionality, and skin support
  • vdr-plugin-graphlcd: VDR plugin.


First of all a current version (contains included skin support) of graphlcd-base needs to be installed:

  • Get current version from the GIT repoository:
  git clone git://projects.vdr-developer.org/graphlcd-base.git -b touchcol graphlcd-base.git.touchcol
  • compile and install the library (default installation directory: /usr/local/include/, can be changed in Make.config)
  make
  make install

Then the VDR plugin needs to be retrieved, installed, and compiled:

  • Note: $SOURCEDIR/VDR is the source directory of VDR and needs to be adapted accordingly.
  • Get current version of the branch from the GIT repository:
  cd $SOURCEDIR/VDR/PLUGINS/src/
  git clone git://projects.vdr-developer.org/vdr-plugin-graphlcd.git -b touchcol vdr-plugin-graphlcd_0.3.0
  ln -s vdr-plugin-graphlcd_0.3.0 graphlcd
  • compile plugin, eg:
  cd $SOURCEDIR/VDR/
  make plugins

Everything else is the same as described in plugin installation.

Configuration

After finishing the installation, some files need to be copied.

  • copy the configuration file graphlcd.conf to some destination, on most installations this will be /etc.
    can be manually configured by setting parameter skin (see below):
    (replace /etc/ if your distribution expects another destination)
 cp graphlcd.conf /etc/
  • copy the directory with logos, fonts, and skins to $VDRCONFIG/plugins (depending on your installation this will be /etc/vdr/plugins, or /video/plugins, or some other destination):
 cp -r $SOURCEDIR/VDR/PLUGINS/src/graphlcd/graphlcd $VDRCONFIG/plugins/

Parameter

Parameter (short) Parameter (long) Description Default (if parameter not given)
-c CFG --config=CFG use CFG as driver config file /etc/graphlcd.conf
-d DISP --display=DISP use display DISP for ouput first display defined in config file
-s SKIN --skin=SKIN use skin SKIN default
-p SKINPATH path to skin files $VDRCONFIG/plugins/graphlcd/skins


Skins

A skin gives a high flexibility of how and which information is brought to a display. Its markup language is the well-known XML.

Structure and elements of a skin

Example skeleton of a skin

<?xml version="1.0"?>
<skin version="1.0" name="testskin">
 
 

 <variable id="LogoWdith" value="40" condition="le({ScreenHeight},64)" />
 <variable id="LogoWdith" value="64" />

 <display id="normal">

   <variable id="TextX" value="4" />

   <text x1="#TextX" ...>
     {PresentTitle}
   </text>

   <image ... />
   <rectangle ... />
   <progress ... />

   <block condition="{Recordings}">
     <image ... />
     <text ...>
       {Recordings}
     </text>
   </block>

   <variable id="Arrow" value="'images/arrow.pbm'"/>
   <text ... >{MenuTitle}</text>
   <list ...>
     <item height="ITEMHEIGHT" />
     <text ... >{MenuCurrent}</text>
     <text ... >{Menuitem}</text>
     <image ... path="#Arrow" condition="{IsMenuCurrent}" />
   </list>

 </display>
</skin>
Info
Info
  • skins are always UTF-8, on non UTF-8 systems UTF-8 text will be transcoded on-the-fly.
  • All variable and font names must be 7-bit safe (no umlauts or diacritics).
  • HTML-entities are not supported, except &lt;, &gt;, &amp;, &#x<hexID>; and &#<decID>; (e.g.: &#xE001;).


A skin definition contains different types and sections of information:

font
defines an easy to remember font 'handle'. if a condition is given the font item is only defined if the condition is true.
Note:: fonts can only be defined in the context 'skin'.
variable
defines a variable which can be a constant or calculated using a complex evaluation.
Note:: variables can be defined everywhere, but the scope will always be skin-wide!


sections:

skin
root element.
display
a layer containing drawing elements.
block
groups elements together. may be displayed or hidden depending on a condition.
list
a menu with a defined item height, selected text line, line marker, maybe some lines before, and after the .selected line.

drawing elements:

  • image
  • text
  • pixel
  • line
  • rectangle
  • elipse
  • slope
  • progress (progress bar)
  • item (needed in lists)


functions, conditions, evaluations, and tokens:

function
retrieves a value of a certain entity, eg. the height of a font or width of a text string in pixels.
condition
evaluates boolean terms (returns either true or false).
evaluation
evaluates a simple calculation using basic arithmetic operations.
token
contains an information (eg. runtime information from VDR like present title, current channel name, ...) and is either displayed or used in evaluations or conditions.

List of tokens defined in either graphlcd-base or vdr-plugin-graphlcd

  • Current channel
{ChannelNumber}
Returns an integer value
Channel number
{ChannelName}
Returns a string value, may be empty
Channel name or group name
{ChannelShortName}
Returns a string value, may be empty
Short name of channel, if available
{ChannelProvider}
Returns a string value, may be empty
Provider/bouquet name, if available
{ChannelPortal}
Returns a string value, may be empty
Portal name, if available
{ChannelSource}
Returns a string value, may be empty
Signal source of channel, as defined in sources.conf.
{ChannelID}
Returns a string value: "<Source>-<NID>-<TID>-<SID>[-<RID>]"
Identifier of the current channel
{ChannelHasTeletext} | {HasTeletext}
Returns a boolean
True if teletext is present
{ChannelHasMultilang} | {HasMultilang}
Returns a boolean
True if more than one audio stream is present
{ChannelHasDolby} | {HasDolby}
Returns a boolean
True if a Dolby Digital stream is present
{ChannelIsEncrypted} | {IsEncrypted}
Returns a boolean
True if the channel is encrypted
{ChannelIsRadio} | {IsRadio}
Returns a boolean
True if the channel is a radio channel
{ChannelAlias}
Returns a string, may be empty
The ChannelAlias is a virtual channel name mapped through the channels.alias mapping file.
It's the preferred way for naming channel logos.
  • Recording
{IsRecording[,<card number>]}
?
{Recordings[,<card number>]}
?
  • Present EPG
{PresentValid}
?
{PresentStartDateTime[:<strftime format>]}
?
{PresentVpsDateTime[:<strftime format>]}
?
{PresentEndDateTime[:<strftime format>]}
?
{PresentDuration[:<duration format>]}
?
{PresentProgress[:<duration format>]}
?
{PresentRemaining[:<duration format>]}
?
{PresentTitle}
?
{PresentShortText}
?
{PresentDescription}
?
  • Following EPG
{FollowingValid}
?
{FollowingStartDateTime[:<strftime format>]}
?
{FollowingVpsDateTime[:<strftime format>]}
?
{FollowingEndDateTime[:<strftime format>]}
?
{FollowingDuration[:<duration format>]}
?
{FollowingTitle}
?
{FollowingShortText}
?
{FollowingDescription}
?
  • Volume
{VolumeCurrent}
?
{VolumeTotal}
?
{VolumeIsMute} | {IsMute}
?
  • Replay
{ReplayTitle}
?
{ReplayPositionIndex[:<duration format>]}
?
{ReplayDurationIndex[:<duration format>]}
?
{ReplayIsPlaying} | {IsPlaying}
?
{ReplayIsFastForward[:<replay speed>]} | {IsFastForward[:<replay speed>]}
?
{ReplayIsFastRewind[:<replay speed>]} | {IsFastRewind[:<replay speed>]}
?
{ReplayIsSlowForward[:<replay speed>]} | {IsSlowForward[:<replay speed>]}
?
{ReplayIsSlowRewind[:<replay speed>]} | {IsSlowRewind[:<replay speed>]}
?
{ReplayIsPausing} | {IsPausing}
?
{ReplayPosition}
?
{ReplayDuration}
?
{ReplayRemaining[:<duration format>]}
?
{ReplayMode}
"cd", "dvd", "file", "image", "music", "vdr"
{ReplayIsShuffle}
Not implemented yet!
{ReplayIsLoop}
Not implemented yet!
  • OSD related
{Message}
?
{MenuTitle}
?
{MenuItem}
?
{MenuCurrent}
?
{IsMenuCurrent}
?
{ButtonRed}
?
{ButtonGreen}
?
{ButtonYellow}
?
{ButtonBlue}
?
  • Settings
{SettingShowChannelLogo}
?
{SettingShowReplayLogo}
?
{SettingShowSymbols}
?
{SettingShowTimebar}
?
{ScrollMode}
?
{ScrollSpeed}
?
{ScrollTime}
?
{BrightnessActive}
?
{BrightnessIdle}
?
{BrightnessDelay}
?
{DisplayMode}
?
Return "Normal" or "Interactive"
  • General info
{IsUTF8}
Returns a boolean
true if the VDR is runnig with UTF-8 encoding enabled.
{DateTime[:<strftime format>]}
?
{ConfigPath}
?
{SkinPath}
?
{ScreenWidth}
?
{ScreenHeight}
?
{DefaultForegroundColor}
Returns a colour string representation, format: "0x<AA><RR><GG><BB>".
Contains the default foreground colour of the currently used graphlcd driver without consideration of user settings.
{DefaultBackgroundColor}
Returns a colour string representation, format: "0x<AA><RR><GG><BB>".
Contains the default background colour of the currently used graphlcd driver without consideration of user settings.
{ForegroundColor}
Returns a colour string representation, format: "0x<AA><RR><GG><BB>", (eg: 0xFFFFFFFF).
Contains the foreground colour (if set in graphlcd.conf: returns FGColour, or, if not set: the same as {DefaultForegroundColor}).
(Setting FGColour is currently only supported by driver serdisp).
On monochrome displays this colour defines the colour for setting a pixel.
{ForegroundColor} should be used in favour of {DefaultForegroundColor}.
{BackgroundColor}
Returns a colour string representation, format: "0x<AA><RR><GG><BB>", (eg: 0xFF000000).
Contains the background colour (if set in graphlcd.conf: returns BGColour, or, if not set: the same as {DefaultBackgroundColor}).
(Setting BGColour is currently only supported by driver serdisp).
On monochrome displays this colour defines the colour for clearing a pixel.
{BackgroundColor} should be used in favour of {DefaultBackgroundColor},
CLS
   Clear display
UPD
   Update display
OFF
   Switch off plugin
ON
   Switch on plugin
SET <key>[,display=<display>][,expire=<expire] <value>
   Set entry <key> to value <value>. optionally expire after <expire> seconds. <value> may contain spaces
GET <key>[,display=<display>]
   Unset (clear) entry <key>
UNSET <key>[,display=<display>]
   Get value assigned to entry <key>
CONNECT [<display> [<skin>]]
   Connect given display or reconnect all displays if called w/o parameter
DISCONN [<display>]
   Disconnect given display or all displays if called w/o parameter
examples:
 PLUG GRAPHLCD SET somekey somevalue
 PLUG GRAPHLCD UNSET somekey
 PLUG GRAPHLCD SET someotherkey,expire=30 this will expire after 30 seconds
  • Read variables set by SVDRP command SET
{ExtDataIsAvailable:<key>}
Check if a given variable was set
{ExtDataItem:<key>}
Retrieve the content of the given variable
example:
 <block condition="{ExtDataIsAvailable:somekey}">
   <text x="0" y="0" font="somefont">SomeKey: {ExtDataItem:somekey}</text>
 </block>
  • Other Plugins Services
{ServiceIsAvailable:<service>}
Return: boolean
Check if a given Service is available
{ServiceItem:<service>,<key>[,<parameter 1>][,<parameter 2>]}
Return: based on <key>
Retrieve a service value
{ServiceItem:radio,<key>}
key Return Description
default string at rds_info = 2: "<start hh>:<start mm> <title> | <artist>"
at rds_info = 1: "<radiotext>"
at rds_info = 0: empty
title string Title
artist string Artist
text string Radiotext
rds_info info integer 0 = No RDS present
1 = Radiotext present
2 = Radiotext, Title and Artist present
rds_pty pty integer Program type
http://tech.ebu.ch/docs/techreview/trev_255-beale.pdf (Page 3)
Update interval 100 ms
{ServiceItem:lcr,<key>}
key Return Description
default string ?
destination string ?
price string ?
pulse string ?
Update interval 60 s
{ServiceItem:femon,<key>[,<printf format>][,<divisor>]}
key Return Description
default status string "Status <"LOCKED"|"-">:<"SIGNAL"|"-">:<"CARRIER"|"-">:<"VITERBI"|"-">:<"SYNC"|"-"> on device #<device number>"
name string "<frontend name> on device #<device number>"
snr integer ?
signal integer ?
percent_snr integer ?
percent_signal integer ?
ber integer ?
unc integer ?
video_bitrate vbr integer
string*)
?
audio_bitrate abr integer
string*)
?
dolby_bitrate dbr integer
string*)
?
*) if <printf format> given
Update interval 2 s
<printf format> and <divisor> are only available with key video_bitrate/vbr, audio_bitrate/abr and dolby_bitrate/dbr
{ServiceItem:mailbox,<key>}
key Return Description
default hasnew boolean return true if there are unread mails in one of the accounts configured to report unread mails.
false if accounts not checked yet or if there are no new mails
newcount integer report how many mails are unread in all accounts configured to report this.
return zero if accounts not checked yet, use hasnew to check this
Update interval 10 s
Format Strings
  • printf Format String
<printf format> is an valid printf format string
  • strftime Format String
<strftime format> is an valid strftime format string
  • duration Format String
specifier Replaced by
%H Hour Part, leading Zero (2 Chars)
%k Hour Part, leading Whitespace (2 Chars)
%M Minute Part, leading Zero (2 Chars)
%m Time in Minutes
%S Second Part, leading Zero (2 Chars)
%f ?

Problems

Links

[1] http://projects.vdr-developer.org/projects/show/graphlcd new plugin homepage
[2] http://projects.vdr-developer.org/wiki/graphlcd/GraphlcdSkin page for skin branch