======================================================================
On Screen HTML for ProgDVB Version 1.0.1 Beta
======================================================================

Этот модуль позволяет создавать OSD экраны используя для этого
(D)HTML и скриптовые языки (такие как JavaScript, VBScript и т.п.) и,
в определенных пределах, контролировать ProgDVB.

По желанию, модуль может быть использован вместо встроенного OSD.



Требования
==========
1. Microsoft Internet Explorer версии 6.0 или выше
2. ProgDVB версии 4.51.1 или выше (программный режим с ProgDVB Video Renderer)
3. Girder версии 3.2.9 или выше (опционально)



Установка
=========
1. Распакуйте папку "OSH" из архива в каталог "Modules" ProgDVB.
   Скопируйте файл "OSH.module" из каталога "OSH\Module"
   в каталог "Modules" ProgDVB.

   - или -

   Распакуйте папку "OSH" из архива в какое-нибудь другое место.
   Скопируйте файлы "OSH.module" и "OSH.ini" из каталога "OSH\Module"
   в каталог "Modules" ProgDVB. Раскомментируйте и исправьте в файле
   "OSH.ini" ключ "HtmlRootFolder" так, чтобы он указывал на каталог
   "OSH\Html".
   
2. Измените файл конфигурации "OSH.config" расположенный в каталоге
   "OSH\Html" так, чтобы следующие ключи имели верные значения:

   htmlRootFolder      - абсолютный путь к каталогу "OSH\Html"
                         (например: "C:\ProgDVB\Modules\OSH\Html")
   rootFolder          - абсолютный путь к основному каталогу ProgDVB
                         (например: "C:\ProgDVB")
   favoriteChannelTree - название файла с деревом фаворитных каналов
                         (например: "ChannelList1.tree")

3. Запустив ProgDVB убедитесь что OSH модуль отмечен в диалогах
   "Настройки\Модули" и "Настройки\Настройки OSD".

4. Если Вы используете Girder для управления ProgDVB скопируйте плагин
   "SetWinText.dll" из каталога "OSH\Girder" в каталог "Plugins"
   Girder. Разрешите загрузку плагина в диалоге "Settings" Girder.



Использование
=============

Запуск
------
Простейший способ активировать модуль - вызвать на экран главное
OSD меню (клавиша 'O' по умолчанию) и выбрать соответствующий пункт.

После этого можно использовать стандартные клавиши навигации и цифры   
для управления модулем:
   UP/DOWN - выбор пункта меню
   RETURN  - активация пункта меню
   LEFT    - вернуться назад (на предыдущий OSD экран)
   0-9     - ввод номера канала (доступно на экране QuickInfo)
   RIGHT/PAGE UP/PAGE DOWN - пока не используется

Когда модуль загружен (даже если он невидим) он реагирует на некоторые
события ProgDVB: смена канала, начало/окончание записи, обновление EPG.
В результате этого происходит переход между OSD экранами или обновление
их содержимого.
Наблюдать эти изменения можно в основном окне модуля
("Сервис\OSH" или "Настройки\Модули\Свойства").

Некоторые события ProgDVB (например, смена канала) приводят к активации
модуля и отображении им QuickInfo экрана. Но эти событя также приводят
к активации встроенного OSD, которое может отобразиться немного раньше
или немного позже. Чтобы модули не конфликтовали между собой необходимо
отключить ненужные OSD окна (диалог "Настройки\Настройки OSD").


Управление
----------
Не все команды, поддерживаемые ProgDVB, передаются OSD модулю для
обработки когда он активен. Когда модуль не активен он вообще их
не получает.
Для того, чтобы модуль мог получать и реагировать на все передаваемые
ProgDVB команды, они должны быть отправлены специальным образом.
Проще всего это сделать с помощью одной из программ автоматизации
(например Girder).

Команды могут быть отправлены тремя различными способами.
1. Используя параметры командной строки ProgDVB.
2. Отправляя сообщения интерпретатору команд ProgDVB.
3. Отправляя сообщения интерпретатору команд OSH модуля.

Первый способ самый простой и одновременно самый медленный, используйте
его если нет другой возможности.

Два других способа похожи и основаны на отправки сообщения WM_SETTEXT
скрытому окну с передачей текста команды в качестве параметра сообщения.
Для отправки команд ProgDVB нужно отправлять сообщения окну
"ProgDVB_CmdParser", для отправки команд OSH модулю - "OSH_CmdParser".

С Girder для отправки этих сообщений может быть использован плагин
SetWinText.

Команды переданные первым и вторым способами имеют одинаковый формат.
Их полный список можно найти в диалоге "Настройки\Управление".
OSH модуль может перехватить и передать в скрипт информацию об этих
командах, но он не может помешать ProgDVB выполнить их.

Если принятая команда должна быть выполнена только при определенных
условиях или перед ее выполнением должно быть выполнено дополнительное
действие, то такие команды лучше отправлять напрямую OSH модулю
(скрипту) и после обработки, при необходимости, передавать ее ProgDVB.
Этим же способом рекомендуется отправлять и команды предназначенные
исключительно OSH модулю (скрипту), например, команды навигации к
нужному OSD экрану.


Известные проблемы
------------------

1. После каждого перезапуска ProgDVB модуль не может отобразиться на
   экране самостоятельно, например, в ответ на какое-то событие, и его
   требуется активизировать через главное OSD меню ProgDVB (вручную
   или автоматически - отправив последовательность команд).

2. Часть команд (например, команды перехода на другой канал, папку,
   дерево каналов) не может быть отправлена ProgDVB пока модуль
   активен (отображен на экране). Перед отправкой таких команд модуль
   должен быть скрыт.



======================================================================
ОТСУТСТВИЕ ГАРАНТИЙ
----------------------------------------------------------------------
ЭТО ПРОГРАММНОЕ ОБЕСПЕЧЕНИЕ ПРЕДОСТАВЛЯЕТСЯ "КАК ЕСТЬ" БЕЗ КАКИХ-ЛИБО
ЯВНЫХ И ПОДРАЗУМЕВАЕМЫХ ГАРАНТИЙ, ВКЛЮЧАЯ, НО НЕ ОГРАНИЧИВАЯ
ПОДРАЗУМЕВАЕМЫЕ ГАРАНТИИ РАБОТОСПОСОБНОСТИ И ПРИГОДНОСТИ В ЛЮБОЙ
ОБЛАСТИ ПРИМЕНЕНИЯ. ВЕСЬ РИСК ИСПОЛЬЗОВАНИЯ ПРОГРАММЫ ЛЕЖИТ НА ВАС.
ЕСЛИ БУДЕТ ДОКАЗАНА НЕРАБОТОСПОСОБНОСТЬ ПРОГРАММЫ, ВЫ ПРИНИМАЕТЕ НА
СЕБЯ ВСЕ РАСХОДЫ ПО ВОЗМЕЩЕНИЮ СТОИМОСТИ НЕОБХОДИМОГО ОБСЛУЖИВАНИЯ,
РЕМОНТА, ВОССТАНОВЛЕНИЯ И ИСПРАВЛЕНИЙ. 
======================================================================