This repository has been archived by the owner on Jan 20, 2021. It is now read-only.
-
Notifications
You must be signed in to change notification settings - Fork 1
/
Copy pathREADME
433 lines (357 loc) · 20.3 KB
/
README
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
This is a "plugin" for the Video Disk Recorder (VDR).
Written by: Louis Braun <louis DOT braun AT gmx DOT de>
Project's homepage: http://projects.vdr-developer.org/projects/skin-nopacity/
Latest version available at: http://projects.vdr-developer.org/projects/skin-nopacity/files
This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.
See the file COPYING for more information.
Requirements
------------
- VDR version >= 1.7.34
- Installed ImageMagick or GraphicsMagick for displaying png/jpg Icons, Channel Logos
and EPG Images
- for scaling the video picture to fit into the VDR menu window please use
softhddevice plugin revision 87c1c7be (2013-01-01) or newer.
- epgsearch Git since commit ba7c6277 (2013-01-03) to correctly replace the schedules
menu with epgsearch
Description
-----------
"nOpacity" is a highly customizable native true color skin for the Video Disc Recorder.
Installation
------------
After "normal" Plugin installation you have to care about the paths for the
used Icons, the channel logos and epg images. The following paths can be set
at startup:
-i path, --iconpath=path
Path to the icons (Default: <ResourceDirectory>/plugins/skinnopacity/icons/)
-l path, --logopath=path
Path to the logos (Default: <ResourceDirectory>/plugins/skinnopacity/logos/)
-e path, --epgimages=path
Path to the epgimages (Default: <CacheDirectory>/plugins/skinnopacity/epgimages/)
ResourceDirectory and CacheDirectory are taken from your VDR configuration (make.config
or vdr.pc).
During a "make install" the Icons are automatically copied from <SkinSourceDirectory>/icons/
to the default path. Included Theme files are also copied from <SkinSourceDirectory>/themes/
to <ConfigDirectory>/themes/
Additionally with a "make install" also the theme specific configuration files
(see chapter "Theme specific configurations" below) are copied automatically
from <SkinSourceDirectory>/conf/ to the plugin config directory
(<VDRConfigDir>/plugins/skinnopacity/themeconfigs).
I recommend to use channel logos from https://github.com/3PO/Senderlogos
To download them just change in the directory you want to place the logos
and do a:
git clone https://github.com/3PO/Senderlogos.git logos
An update of the logos can then be done with a "git pull" just inside this
directory.
If directories for channel logos, icons or epg images are set via startup
parameters, images are searched first in these directories. If the image
is not available, an additional search in the according default directory
will be performed.
With this it is possible to use user images and images provided by a
package maintainer or distributor in parallel.
For S2-6400 Users: Disable High Level OSD, otherwise the plugin will not be
loaded because lack of true color support
For Xine-Plugin Users: Set "Blend scaled Auto" as OSD display mode to achieve
an suitable true color OSD.
For Xineliboutput Users: Start vdr-sxfe with the --hud option enabled
Usage
-----
After installation first activate then skin in the VDR OSD menu. nOpacity scales to
every screen resolution, but in lower resolutions than 1920 * 1080 it may be necessary
to change some default settings for dimensions and font sizes to achieve the best result
(see "setup options" below). In the folder "screenResSetup" in the plugin source directory
exemplarily setup options for SD and HDReady resolutions are provided.
nOpacity respects the OSD settings for OSD top, left, width and height. If these values
are not set to top&left: 0, width&height: 100, you'll get a border around every displayed
skin element. Additionally you are able to configure an individual border for almost every
displayed skin element (channel switching, recordings, volume, audio tracks) in the
skin setup. Only the menu uses the full screen if not configured differently in the
OSD settings.
As already mentioned, font sizes are customizable via the skins setup menu. The skin
calculates the font sizes for the used screen resolution individually. The value
for the different font sizes in the setup options is always the delta to the calculated
(default) values. If you set a value for a font size of -2 for instance, the default
font size is decreased by 2, analogue the font size will be increased by setting a
positive value.
As described in "installation", you should use a special channel logo pack with transparent
channel logos. In this logo pack all files are named only with lower case letters.
nOpacity uses the channel name CONVERTED TO LOWER CASE LETTERS to search for an
appropriate channel logo. With this, approximately 90% of the channel logos should work
immediately after placing the channel logos in the correct place. So if you have to change
the name of a channel logo (may be by inserting a space or a hyphen) so that it fits to
the channel name, only use lower case letters, and not the name of the channel with upper
and lower letters as displayed inside VDR.
If no logo is found for the channel name, additionally a search for a logo named as the
ChannelID is performed. Analog to the channel name the ChannelID is also converted to lower
case letters. This allows channel logos for channels with changing names (for instance
Sky Feed Channels).
Additional hint: some channels have slashes in their name (in germany nick/comedy for instance).
In this example, as a dirty hack just create a folder in your channel logo directory named
"nick" and place an image named "comedy.png" inside this folder.
In the folder "logoconverter" a script and some backgrounds are provided to create logos
with fancy backgrounds from the transparent logos. Before running the script, just adapt the
config variables in the header of the script according to your needs. If you place the newly
created logos in a subfolder of your logo directory named exactly as the used Theme name,
nOpacity uses these logos only for the appropriate theme automatically.
Themes, Theme types, Theme specific Configurations and Icons
------------------------------------------------------------
nOpacity is fully themable with different "theme types". Examples for theme files with all
possible color settings are included in <SkinSourceDirectory>/themes/. As already mentioned
these themes are automatically copied during a "make install" into the VDR themes directory
and can be choosed in VDRs OSD setup menu.
The following skin characteristics are theme dependend:
- theme default configuration
- theme configuration
- theme colors
- graphical skin elements (for "graphical" themes, see below)
- theme icons and images
Theme types:
............
nOpacity supports three different theme types named "flat", "blending" and "graphical". This
type can be set with the config option "displayType" (flat: displayType = 0, blending:
displayType = 1, graphical: displayType = 2) which has to be provided via the theme specific
configuration file (see below). If this value is not provided by the theme designer, the default
value "blending" is used.
flat style: "basic" skin type with almost no effects, areas are just filled with plain colors
blended style: skin elemements like menu items are drawn with a main and a blended color which
are provided via the color theme file, skin elements are drawn with a blended effect.
graphical style: almost all skin elements are drawn by using dedicated PNG images. These PNGs
have to be placed in the <themename>/skinElements/ icon directory. See the default theme for
examples for this style and the used images.
Theme specific configuration:
.............................
Because the "look&feel" of nOpacity is strongly dependend of the choosen setup configuration
options.
On the one hand it is possible for the theme designer to provide a dedicated default
config for every theme. This theme configuration has to be named "theme-<themename>.conf" and
has to be placed in <VDRConfigDir>/plugins/skinnopacity/themeconfigs. As already mentioned all
theme configs which are available in the skin source directory <SkinSourceDirectory>/conf/ are
copied automatically to the destination directory with a "make install". The syntax for this
theme configuration file is just straight forward a "configoption = value" per line. The possible
configuration options and the default values can be checked in the file config.c in the function
cNopacityConfig::LoadDefaults(void).
On the other hand, all configuration changes done by the user are only valid for the currently
choosen theme. That means that every theme has it's individual configuration. If the theme is
changed via the VDR Setup/OSD Menu, the configuration for this theme is loaded in the following way:
- first the general default settings from cNopacityConfig::LoadDefaults() are used
- after that the settings from the theme config file (if available) are looked up, every available
config option in this file replaces the default config option
- after that the settings the user has individually customized are used and replace the corresponding
default settings
Theme specific icons and images:
................................
Icons and images are first looked up in <IconPath>/<ThemeName>/. If there is no appropriate
icon found, <IconPath>/ is used. With that it is possible to use specific icons for every
different theme.
Two types of icons are used:
- statically named icons for standard main and setup menu entries, recording folders,
active timers and other menu decorations.
- icons for plugins with a main menu entry: if a plugin has a main menu entry, the icon
has to be named as the plugin name so that the appropriate icon will be shown in the
main menu.
Image Caching
-------------
nOpacity uses an image cache to achieve best performance also on systems with low performance.
The image cache loads all necessary images (icons, skin elements, channel logos) at startup and
also after a change in screen resolution or leaving the nOpacity setup menu. Depending on the
system hardware and the configured number of channel logos to cache (see below) this cache reload
can need some seconds.
In the plugin setup menu in the submenu "image caching" it is possible to configure the number of
channel logos to be cached at startup and the maximum number of channel logos to cache. Channel logos
are always cached in the order the channels appear in your channels.conf file. If you configure for
example to cache 50 logos and you set the maximum number of logos to 100, the logos for the first 50
channels in your channels.conf are cached at startup. If logos from channels 51 - 100 are needed,
the image is created once, all further requests for that logo are fulfilled by the cache. Logos for
channels > 100 are not cached and are always created from the source PNGs on your storage medium.
In the "image cache" setup sub menu the current cache usage for the different types of images and the
memory used is displayed as additional information.
Customizing, Skin Setup Options
-------------------------------
* General Options (only non self-explanatory options are described)
- Font: Used Font, all Fonts installed on your system are shown
* VDR menu: Common Settings:
- Create Log Messages for image loading: show log message for each image loading process. Usefull
for debugging, but causes many log entries
- Number of Default Menu Entries: Number of menu items for the default menu view.
- Adjust Font Size - Default Menu Item
- Adjustment of narrow menus: the narrow menus (main, schedules, channels, timers,
setup) can either be adjusted left or right.
- Scale Video size to fit into menu window: no / yes / auto: with "auto" the video window is resized
when the detailed EPG Window is displayed in Schedules and Recordings menu to be completely visible.
- Header Height (% of OSD Height): Default: 7%
- Header Icon Size (Square Header Menu Icons)
- Footer Height (% of OSD Height): Default: 7%
- Rounded Corners for menu items and buttons
- Radius of rounded corners: if rounded corners are used, radius in px.
- Use Channel Logo background: display theme specific background (clrMenuChannelLogoBack) for channel
logos in menus what's on now / next, channels, timers
- Fade-In Time in ms (Zero for switching off fading): Default 0, active fading
for main menu caused sometimes trouble in some special setups. Activate on
own risk ;)
- Menu Items Scroll Style: "Carriage Return" after scrolling is complete, or "Forward and Back again"
- Menu Items Scrolling Speed
- Menu Items Scrolling Delay in s: period which menu element has to be selected
till scrolling starts
- Adjust Font Size - Header
- Adjust Font Size - Date
- Adjust Font Size - Color Buttons: Font for color buttons
- Adjust Font Size - Messages
- Adjust Font Size - Detail View Text: Font for detailed EPG & recordings view text
- Adjust Font Size - Detail View Header: Font for Header date/time and short text
- Adjust Font Size - Detail View Header Large: Font for detailed EPG & recordings
view title
* VDR Menu: Main and Setup Menu
- Use narrow main menu: display main menu in narrow or standard style
- Width (Percent of OSD Width): if displayed narrow, width of this menu
- Use narrow setup menu: display setup menu in narrow or standard style
- Width (Percent of OSD Width): if displayed narrow, width of this menu
- Number of entires per page: number of menu items shown per screen
- Use menu icons: yes/no
- Main menu title style: way how VDR version in menu header is displayed:
"VDR" plus VDR version, only VDR version, no title
- Display Disk Usage: Display Disk Usage in Main Menu
- Size (square, Percent of OSD Width)
- Free Disc Display: free time in hours (estimated) or free disc space in GB
- Adjust Font Size - free
- Adjust Font Size - percent
- Display Timers: Display active Timers in Main Menu: "yes", "small without channel
logos", "no"
- Maximum number of timers to show in main menu
- Width of Timers (% of OSD Width)
- Width of channel logos (% of timers width)
- Adjust Font Size - Header
- Adjust Font Size - Title
- Show Timer Conflicts
- Header Logo Width / Height: Header Logo is scaled to fit into the header, these
values are used for correct scaling
- Adjust Font Size - Menu Items
* VDR Menu: Schedules Menu
- Use narrow menu: display menu in narrow or standard style
- Width (Percent of OSD Width): if displayed narrow, width of this menu
- Number of entires per page
- Mode of EPG Window: "small window" with settings for fade in and scroll speed / delay
or "full screen"
- EPG Window Fade-In Time in ms (Zero for switching off fading)
- EPG Window Display Delay in s: period which schedules menu element has to be
selected till fade in of epg window starts
- EPG Window Scroll Delay in s: period which epg window has to be opened till
window text starts to scroll
- Height of EPG Info Window (Percent of OSD Height): Height of text window which
is shown for schedules menu elements
- Border around detailed EPG view: border to be displayed in detailed EPG view
- Display Reruns in detailed EPG View: via epgsearch service
- Number of reruns to display: Default 5
- Use Subtitle for reruns
- Display additional EPG Pictures in detailed EPG View: if set to yes, additional
EPG pictures will be shown at the end of the detailed EPG view. The pictures have
to be named as eventid_number.jpg with number from 1 to 9.
- Number of EPG pictures to display
- Detail EPG View EPG Image Width: Default 210px
- Detail EPG View EPG Image Height: Default 160px
- Detail EPG View additional EPG Image Width: Default: 525 px
- Detail EPG View additional EPG Image Height: Default: 400 px
- Adjust Font Size - Menu Item
- Adjust Font Size - Menu Item Small
- Adjust Font Size - EPG Info Window
- Adjust Font Size - EPG Info Window Header
* VDR Menu: Channels Menu
- Use narrow menu: display menu in narrow or standard style
- Width (Percent of OSD Width): if displayed narrow, width of this menu
- Menu Items display mode: Transponder Information / Current Schedule / None
- If "Current Schedule": Schedules with time information
- Number of EPG Entries in Schedules Info Window
- Adjust Font Size - Menu Item
- Adjust Font Size - Menu Item Small
* VDR Menu: Timers Menu
- Use narrow menu: display menu in narrow or standard style
- Width (Percent of OSD Width): if displayed narrow, width of this menu
- Adjust Font Size - Menu Item
- Adjust Font Size - Menu Item Small
* VDR Menu: Recordings Menu
- Use narrow menu: display menu in narrow or standard style
- Width (Percent of OSD Width): if displayed narrow, width of this menu
- Number of entires per page
- Mode of recording Window: window / full screen
- Border around detailed recording view: analogue to "detailed EPG Info"
- Display additional EPG Pictures in detailed recording View: if set to yes, additional
pictures will be shown at the end of the detailed recording view. All jpegs in the
recording directory will be used.
- Number of EPG pictures to display
- Use folder poster if available: use folder poster provided by tvscraper
- Width / Height of manually set recording poster: used for correct scaling
- Adjust Font Size - Menu Item
- Adjust Font Size - Menu Item Small
* Channel Switching:
- Fade-In Time in ms (Zero for switching off fading): Default 300ms
- Height of Channel Display (% of OSD Height): Default 25%
- Left & Right Border Width: Default 15px
- Bottom Border Height: Default 15px
- Background Transparency in Percent: for graphical themes, sets transparency of background
- Background Style: only for non graphical themes, transparent logo background or not
- Channel Logo Position: left / right / do not display. If set to "do not display",
the whole screen width is used for channel display.
- Channel Logo original Width: Default 260px (used for correct scaling)
- Channel Logo original Height: Default 200px (used for correct scaling)
- Use Channel Logo background: use theme specific image (skinElements/channellogoback.png)
as backgrond image for channel logos
- Kind of time display for current schedule: elapsed or remaining time
- Display Source Information: display Channel Source Information (used Satelite)
- Display Signal Strength & Quality: Set this to Zero if you want to disable the
display of signal strength & quality (for instance if your dvb drivers does not
deliver this values)
- Display Poster or Fanart from TVScraper
- Border in px around poster / fanart
- Display previous and next Channel Group
- Adjust Font Size - Header: Font for Channel / Channelgroup Name
- Adjust Font Size - Date
- Adjust Font Size - EPG Text
- Adjust Font Size - EPG Infotext
- Adjust Font Size - Channel Source Info
- Adjust Font Size - Channel Group
- Adjust Font Size - Next/Prev Channel Group
* Replay:
- Fade-In Time in ms (Zero for switching off fading)
- Height of Replay Display (% of OSD Height)
- Left & Right Border Width
- Bottom Border Height
- Adjust Font Size - Header
- Adjust Font Size - Text
* Audio Tracks:
- Fade-In Time in ms (Zero for switching off fading)
- Width of Tracks Display (% of OSD Height)
- Height of Tracks Display (% of OSD Height)
- Position (0: bot. center, 1: bot. left, ... , 7: bot. right): The following
positions are possible, starting at bottom middle:
0: bottom center
1: bottom left
2: middle left
3: top left
4: top middle
5: top right
6: middle right
7: bottom right
- Border Top / Bottom
- Border Left / Right
- Adjust Font Size - Header
- Adjust Font Size - Buttons
* Messages:
- Fade-In Time in ms (Zero for switching off fading): Default 300ms
- Width of Message Display (% of OSD Height): Default 90%
- Height of Message Display (% of OSD Height): Default 10%
- Bottom Border Height: Default 10px
Remark: with different sizes and a large value for the bottom border height you
are able to achieve a positioning for the messages box analogue to the positioning
of the audio tracks display.
- Adjust Font Size
* Volume Display:
- Fade-In Time in ms (Zero for switching off fading): Default 300ms
- Width of Volume Display (% of OSD Height): Default 40%
- Height of Volume Display (% of OSD Height): Default 10%
- Bottom Border Height: Default 10px
Remark: the volume display is always positioned in the center of the screen,
with bottom border it can be moved to the top.
- Adjust Font Size
Legal Remark: some of the menu icons used in this skin are from http://icons8.com/
Thanks @icons8.com for provide these icons for free.