LargoSwitch V 1.0 - english short guide
Modul for DVBDream V 1.3 and above.


===== ATTENTION =====
Decoding and watching Premiere-Programs without a valid subsription and 
certificated hardware is illegal./ not allowed !



What is LargoSwitch ?
=====================
LargoSwitch is a tool like the wellknown plugin 'Greenbutton' what will list
the different programs of Premiere-Portals for simple and faster selection,

It is intended only for use with portals/programs of the german Pay-TV-provider 
'Premiere' which are receivable via satellite on ASTRA 19.2 and in many german 
Cable-TV-Networks.

Additional there is an option to create own favorites in the list.

This little tool did NOT decode anything ! It's only a little helper.


Installation
============
Simply copy the files 'LargoSwitch.ini' and 'LargoSwitch.mod' to the subdir
'\Modules' of your DVBDream-installation - that's all.
DVBDream must be restartet to read and recognize the new module.

For correct function the according Premiere transponders have to scanned 
in DVBDream (befor) and should all be available in the programm-list..
It's not neccessary to rename 'NameLess'-programs.


Handling
========
Select 'Modules' from DVBDream's main-menu and then click 'Largoswitch'.
A Window will open and shows the several portals with teir actual programs
in a tree-list like the file-explorer.
Depending on your configuration several groups/programs can be listed too.

With a double-click (left mouse key) to a portal or program will trigger
DVBDream to display it.
A double-click on a self created group will NOT work !

A single click with right mouse-key will fade in or out the programs of
the selected protal/group.

The list's state and actual position, width and height of the window will
be saved and restored on next start.

Selecting 'New Scan' from the menu will cause reading program-data again
and update the list.
This can be done automaticly when you select 'Timer' in menu 'More'.
The entry will be checked - Clicking again will uncheck the entry.

Addtional items on menu 'More':
- Channel-Info
  Shows internal DVBDream-internal programm-information of the selcted
  portal.
  Does not work on self created groups.
- Save Buffer
  Save raw data of the collected information to a file.
  Only for debugging.
- Timer
  See abaove. Value in brackets is the time to repeat update.
  Interval is defined in the INI-file.

NOTE:
When LargoSwitch is started it automatically searches for neccessary data.
If DVBDream actual shows a 'non-Premiere-program' (e.g. ARD, RTL, etc) a
short switch to the next available Premiere-transponder will be made.
Depending on the speed of DVB-hardware this can take several seconds.
As soon as all neccessary data has been readed DVBDream will switch back 
to the pervious watched program automatically.

Hotkeys:
Ctrl + Alt + D, S or E displays / hides the Premiere-protals Direkt, Sport 
or Eorik in the list.


Configuration
=============
Several parameters and self defined groups/programs will be saved in an 
initialisation file (LargoSwitch.ini).
This is an easy to handle text file which normally will be opened with
Windosw Notedpad editor.

This file holds the several sections:
- [Pos]
  The following entries defines position and size of the window.
  You can make manual changes here but this will normally be done by the program.
- [Timer]
  Enabled=0 means that the timer in not actice.
  A '1' activates the automatic update.
  Interval=60 defines the time in seconds between updates.
  A value less 60 is less suggestive.
- [View]
  DP, SP and EP describes the dependent portals:Direkt-, Sport- und Erotik-Portal.
  A value of =1 will cause the portal (and all dependent programs) to be displayed
  in the list. '0' will hide displaying.
  Lists= defines the section-names of self defined groups - E.g. =Prem,Std and 
  must be comma-sparated.
  For every definiton you have to create a separate section with same name/title.
- [Prem] / [Std]
  These are self sections of self denied groups. Names must correspondent as 
  described above for Lists=.
  Title= defines the name as shown in the list.
  List= defines a list of so called Service-ID's - also comma-separated.
  Service-ID's are numbers which are specified explicitly to a programm.
  You will find these/needed SID's in DVBDream a follows:
  - Select and activate (!) a program as desired
    (URGEND - otherwise you will get the wrong properties !)
  - Right click on the program-entry and select Channel Properties
  - You will find the SID in the upper right edge of the Window
  The programs name will be readed from DVBDream's internal database.
  Names will be listed in same order as the SID's are placed.
- [Collapse]
  This section describe the display-state of portals/groups if they should be shown 
  collapsed or not on start.
  Descriptions are the same as in [View].
  ?P=1 will collapse the portal/group - ?P='0' shows all programms of a portal/goup.
