This is a plugin for the Video Disk Recorder (VDR).

Written by: Alexander Rieger <Alexander DOT Rieger AT inka DOT de>

Project's homepage: http://sites.inka.de/~seca/vdr

Latest version available at the homepage.

Contents:
=========

1.  Description
2.  SVDRP
3.  Service interface
4.  Examples
5.  License / Disclaimer


1. Description
==============

SwitchOSDPos is a plugin for the VDR to switch OSD position and size
manually.

Clarification: No automatic detection of the video-format is implemented.
This plugin is simply for switching OSD settings manually. Furthermore
the plugin only modifies VDR's settings of the OSD. If a plugin does
create its own OSD object and does not use the settings of VDR, switching
position/size with this plugin has no effect (e.g. yaepg, timeline,
femon, clock).

Multiple presets (name, position and size) may be defined in the
configuration menu. These presets are stored in a file OSDPresets.conf
in the configuration directory of the plugin.

Upon startup of the vdr the first preset may be activated (configurable).

The function of the MainMenuAction may be configured to either

- show a menu to select one of the presets
- simply switch to the next preset.

2. SVDRP
========

The plugin implements two svdrp-commands to query and set presets from
outside of vdr:

- LSTP to query the configured presets
- SETP to query the active preset or to activate a preset

See "svdrpsend.pl plug switchosdpos help" for more information.

3. Service interface
====================

The plugin implements a service-interface to query and set presets from
within vdr.

See AxSwitchOSDPosServiceTyes.h for more information.

4. Examples
===========

Two sample preset files are provided in the exapmples directory:

OSDPresets.conf-letterbox
- I'm using this on my 16:9 tv to toggle between 'letterbox' and
  'normal' osd position/size.

OSDPresets.conf-many
- I'm using this to test the word wrapping in the Mailbox plugin.


5. License / Disclaimer
=======================

SwitchOSDPos is a plugin for the VDR
Copyright (C) 2006 Alexander Rieger

This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License version 2
as published by the Free Software Foundation.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
