Der graphtftng Konfigurationsthread

massi · 13. November 2013

Hallo,

da ich mich gerade mit der Erstellung eines themes für graphtftng beschäftige und die Doku sehr spärlich und auch teilweise veraltet ist, würde ich es ganz gut finden, wenn man diesen Thread dazu nutzen könnte, die Erfahrungen mit der Themeerstellung bei graphtftng hier zu teilen.
Es ist manchmal nämlich recht mühsam heraus zu bekommen, wie was funktioniert.
Vielleicht führt das ja auch dazu, daß der Wiki Artikel mal mehr Inhalt bekommt.

Ich fange mal mit etwas banalem an, welche Variablen bzw. Attribute kann denn z.B Text haben, also x und y Position, width, size, height, line, align, dots, on_click
Gibt's da noch mehr? Und was bedeutet eigentlich dots genau?

Würde mich freuen, wenn es hier eine rege Beteiligung gäbe.

massi

P.S. Ich war mir jetzt nicht sicher ob's hierhin oder eher in den VDR Pluginteil gehört.

horchi · 14. November 2013

Dann lass uns doch noch banaler anfangen

Es gibt grundsätzlich vier Bestandteile für ein Theme File:

1.) Sektionen
Sektionen werden durch den Namen der Sektion in eckigen Klammern definiert.
Eine Sektion hält eine Menge Items zusammen welche 'gleichzeitig' angezeigt werden sollen. So ziemlich jeder Ansicht/Menü des VDRs kann eine Sektion zugeordnet werden, das hängt von der Methode 'MenuKind' ab welche durch das graphTFT Patch in den VDR kommt und je Menü oder Ansicht einen anderen Bezeichner zurückgibt. Einige Plugins unterstützen dies ebenso (epgsearch, extrec, ...).
Darüberhinaus kann man weitere, beliebige Sektionen definieren um Items zu gruppieren und in anderen Sektionen per Include wiederzuverwenden. Eine Besonderheit sind hierbei Sektionen dessen Name mit 'Normal' beginnt, zwischen diesen kann bei LiveTV mittels Plugin-Menü und SCVDP hin und her geschaltet werden.

2.) Items
Die anzuzeigenden Items wie Text, Image ColorButton, Menu... etc. (Liste im nächsten Thread)

3.) Parameter
Die Parameter der Theme Items, über diese wird Position, Farbe, Größe etc. des Items bestimmt

4.) Variablen
Hier gibt es eine Menge automatisch gefüllter welche von Plugin je nach Kontext mit aktuellen Daten gefüllt werden welche gerade zur Verfügung stehen ist vom Kontext abhängig in dem der VDR sich befindet (LiveTV, Wiedergabe, EpgMenü, Mauptmenü, Menü(XYZ). Weiterhin kann man im Theme eigene Variablen definieren z.B. um an zentraler Stelle einige Einstellungen machen zu können. Variablen dienen in erster Linie der Zuordnung zu den Parametern, so setzt man z.B. den Wert des text Parameters auf den akztuellen Sendungstitel indem man die Variable presentTitle verwendet: text={presentTitle}.
Variablen löst man mittels der geschweiften Klammern auf. Zum Teil gibt es zu den Variablen noch Formatierungsanweisung welche mittels / getrennt angegeben werden können. Aktuell beschränken sich diese auf 'upper', 'lower' und die Formatstrings für die Formatierung von datum und zeit welcher der Manpage von strftime entsprechen. Den aktuellen Titel in Kleinbuchstaben erhält man somit mittels: {presentTitle/lower}

5.) Schlüsselwörter und Direktiven
Dazu kommen Schlüsselwörter wie Include und var sowie die Direktiven (#ifdef, #define, #ifndef und #endif).

Grüße, Jörg

horchi · 14. November 2013

Sektionen des VDR (durch den Patch):

Code

"MenuEditChannel"
"MenuChannels"
"MenuTimers"
"MenuWhatsOnNow"
"MenuWhatsOnNext"
"MenuSchedule"
"MenuCam"
"MenuRecording"
"MenuSetupOsd"
"MenuSetupEpg"
"MenuSetupDvb"
"MenuSetupLnb"
"MenuSetupCam"
"MenuSetupPlugins"
"MenuSetup"
"MenuText"
"MenuTimerEdit"
"MenuEvent"
"MenuMain"
"MenuRecordings"
"MenuSetupPage"

Alles anzeigen

Für epgsearch:

Code

"MenuEpgsSchedule"
"MenuEpgsWhatsOnElse"
"MenuEpgsWhatsOnNow" 
"MenuEpgsFavorites"
"MenuEpgsWhatsOnNext"

Für extrec kommen diese hinzu:

Code

"MenuExtRecording"
"MenuExtRecordings"

Für Menüs welche (in Plugins) dies nicht definiert ist wird 'MenuUnknown' verwendet, für alle Sektionsanfragen die im Theme fehlen wird die Sektion "Menü" gewählt, diese sollte mindestens definiert sein.
Denke die Namen sagen schon aus für was sie sind, ansonsten Fragen ....

Jörg

horchi · 14. November 2013

Die Parameter:

Code

color
bg_color
alpha
bg_alpha 


x
y
width
height


overlay
lines
start_line
line
font
size
text


align_v
align


type
delay
foreground
count


stat_pic
stat_text
stat_width
stat_height
stat_x
stat_y
bg_x
bg_y
bg_width
bg_height
number
spacing
yspacing
scroll
factor
unit


scroll_count
dots
permanent
value
total


menu_x
menu_y
menu_width
menu_height


fit
aspect_ratio


whipe_res
on_click
on_dblclick
on_up
on_down


name
file
path2


reference
condition
debug

Alles anzeigen

fast 'depricated', größtenteils durch andere Features abgedeckt:

Code

focus       (use path)
image_map   (damit ist nicht das Theme MenuImageMap gemeint!)
switch      (noch nicht abgelöst, wird für Farbwechsel ProgressBar verwendet)

'depricated' Untersützung wird früher oder später eingestellt:

Code

format      (image extension)


pathON      (use path)
pathOFF     (use path2)


red          (use color)
green       (use color)
blue         (use color)
transparent (use color or alpha)
bg_red
bg_green
bg_blue
bg_transparent

Alles anzeigen

Fehlt noch für was sie sind und welche von welchen Theme Items unterstützt werden.

Jörg

horchi · 14. November 2013

Die Theme Items:

Code

Theme

   Text
   Image
   ImageFile
   Rectangle
   Timebar


   Message
   VolumeMuteSymbol
   Volumebar


   Menu
   MenuSelected


   MenuButtonRed
   MenuButtonGreen
   MenuButtonYellow
   MenuButtonBlue
   MenuButtonBackgroundRed
   MenuButtonBackgroundGreen
   MenuButtonBackgroundYellow
   MenuButtonBackgroundBlue
   MenuImageMap


   PartingLine
   Sysinfo
   Background
   TextList
   Progressbar


   ClickArea
   MenuNavigationArea
   CalibrationCursor


   Column
   ColumnSelected


   EventColumn
   EventColumnSelected


   Defaults
   VariableFile

Alles anzeigen

massi · 14. November 2013

Na, das ist ja schonmal was.

Kannst Du mir vielleicht auch noch sagen wo sowas hier herkommt?

Text text={selectedRowEventDescription}

horchi · 14. November 2013

das sind die Variablen, die stelle ich gerade neben bei zusammen

horchi · 15. November 2013

Hoffe ich hab alle :o

Die Variablen setzen sich aus einem Präfix und Bezeicher zusammen, das Präfix spezifiziert den Context.
Beispiel der Titel der aktuellen Sendung steht in "presentTitle", der Titel der folgenden Sendung in "followingTitle"
Wo und wann die Variablen verfügbar sind ist abhängig vom Präfix, siehe unten

Code

Präfix:
----------------------------------------
event               (Event in der Event Info Ansicht)
present             (aktuelles Event in der Live TV/Radio)
following           (folgendes Event in der Live TV/Radio)
rowEvent            (Zeile eins EPG Menüs)
selectedRowEvent    (gewählte Zeile eins EPG Menüs)


Für diese gibt es folgende Ausprägungen:
----------------------------------------
 Title
 SubTitle
 Description
 ChannelName
 ChannelNumber
 ID
 StartTime
 EndTime
 Duration
 HasTimer
 HasPartialTimer
 HasPartialTimerBefore
 HasPartialTimerAfter
 IsRunning
 Elapsed
 Remaining
 Progress
 IsRecording

Alles anzeigen

Code

Präfix:
----------------------------------------
recording  (Aufnahme im Aufnahme-Info Menü)
replay     (aktuell wiedergegebene Aufnahme)


Ausprägungen:
----------------------------------------
 Speed
 Play
 Forward
 Current
 Total
 RawCurrent
 RawTotal
 Title
 Path
 Time
 EventID
 SubTitle
 Description
 Channel
 Title
 EventID
 SubTitle
 Channel
 Path
 Time
 Description

Alles anzeigen

Code

Präfix:
----------------------------------------
calibration (beim callibrieren des Touch)


Ausprägungen:
----------------------------------------
 Instruction
 Info
 CursorX
 CursorY
 TouchedX
 TouchedY
 OffsetX
 OffsetY
 ScaleX
 ScaleY

Alles anzeigen

Code

Allgemeine Variablen ohne Präfix, in jeden Kontext verfügbar:
--------------------------------------------------------------
 textWidth
 colCount
 rowCount
 visibleRows
 currentRow
 touchMenu
 themeVersion
 syntaxVersion
 themeName
 vdrVersion
 mouseX
 mouseY
 mouseKey
 actRecordingCount
 actRecordingName
 actTimersRunning
 actTimersTitle
 actTimersFile
 actTimersStart
 actTimersStop
 STR
 SNR
 unseenMailCount
 hasNewMail
 channelHasVtx
 channelHasMultilang
 channelHasDD
 channelIsEncrypted
 channelIsRadio
 videoSizeHeight
 videoSizeWidth
 time
 volumeMute
 volumeLevel


 menuText   (nur in Menüs mit Fließtext verfügbar)
 menuTitle  (nur in Menüs verfügbar)

Alles anzeigen

Code

Präfix: 
----------------------------------------
'music' (nur für das Music-Plugin)


Ausprägungen:
----------------------------------------
 Track
 Artist
 Album
 Genre
 Year
 Filename
 Comment
 Frequence
 Bitrate
 StereoMode
 Index
 Count
 CurrentTrack
 PlayStatus
 CoverName
 Rating
 Loop
 Timer
 Copy
 Lyrics
 Shuffle
 Shutdown
 Recording
 ButtonRed
 ButtonGreen
 ButtonYellow
 ButtonBlue

Alles anzeigen

Grüße Jörg

massi · 15. November 2013

Danke, damit kann man was anfangen!

massi · 6. Februar 2014

Bei der Bearbeitung eines Themes bin ich über dies hier gestolpert:

PartingLine

Was macht das genau? Irgendwie sehe ich keinen Unterschied ob das drin ist oder nicht.

massi

CKone · 6. Februar 2014

soweit ich mich erinnere ist das ne Trennlinie...

Christian

horchi · 6. Februar 2014

damit stellt man ein wie die Trennlinien die das epgsearch Plugin den EPG Menüs hinzufügt aussehen sollen.

massi · 6. Februar 2014

O.K., danke!

horchi · 6. Februar 2014

wenn es die bei epgsearch auch auf dem OSD nicht gibt müssen sie im epgsearch Setup konfiguriert werden

massi · 27. Februar 2014

Da ich mal wieder ein wenig an meinem Eigenbau-Theme gebastelt habe, bin ich mal wieder über was gestolpert.:-)

Beim abspielen soll das zugehörige EPG Bild angezeigt werden, das habe ich mir aus einem anderen Theme geklaut und sieht so aus:

Code

Image x=1110,y=100,width=170,height=170, 
      path=
      {replayPath}/thumbnail_(0-9).jpg 
      :{replayPath}/{replayEventId}_(0-9).jpg 
      :{varImagesPath_2}/{replayTitle}.jpg 
      :{varImagesPath_1}/{replayTitle}.jpg
      :symbols/video.png,fit=yes,aspect_ratio=yes,delay=5,overlay=yes;

Soweit so gut, die Frage dabei ist, wieso versucht der das Bild aus dem {replayPath} zu holen, da sind bei mir noch nie Bilder gewesen oder anders gefragt, wer oder was soll die denn dahin kopiert haben?
Ich bekomme nämlich immer nur das video.png angezeigt, nie ein EPG Bild.

TheChief · 27. Februar 2014

Geht um Aufnahmen nehm ich an?!

Normalerweise kopiert ein recording-hook bei/nach Aufnahme die Bilder aus dem epgimages-Pfad in den Aufnahmepfad, denn im epgimages-Pfad wird ab und an aufgeräumt und die Bilder würden verloren gehen.

horchi · 27. Februar 2014

ja, sofern die verwendete Distribution ein solchen Skript mitbringt, ansonsten muss man selbst eines erstellen

massi · 27. Februar 2014

Zitat

Geht um Aufnahmen nehm ich an?!

Ja.

Zitat

Normalerweise kopiert ein recording-hook bei/nach Aufnahme die Bilder aus dem epgimages-Pfad in den Aufnahmepfad

Muß man sich den selber basteln oder gibt's den schon irgendwo fertig?

Zitat

denn im epgimages-Pfad wird ab und an aufgeräumt und die Bilder würden verloren gehen.

Das war mir schon klar, sonst hätte ich den Pfad ja einfach auf den epgimages Pfad setzen können aber wenn ich nach 3 Monaten eine Aufnahme ansehe habe ich dann auch verloren.:-)

massi · 27. Februar 2014

Hab den recording-hook unter /usr/share/vdr/recording-hooks gefunden, danke für den Stups in die richtige Richtung!

TheChief · 27. Februar 2014

Muss mal schauen, ob der auch mehrere Bilder unterstützt, ansonsten such mal im Forum.

Der graphtftng Konfigurationsthread

Jetzt mitmachen!

Teilen

Benutzer online in diesem Thema