Difference between revisions of "GenReS(плагин)"

Revision as of 02:40, 23 January 2007

in English | autotranslate | по-русски | 中文版

GenReS - универсальный плагин для браузеров основанных на Mozilla. Он позволяет использовать внешние программы для отображения HTML-тэгов EMBED и OBJECT либо запускать их в полном окне браузера.

Плагин вызывает скрипты-посредники которые запускают нужные программы-просмотрщики и позволяют управлять ими и контролировать состояние из JavaScript. Наборы функций и вызываемых программ могут быть изменены и дополнены путём изменения существующих и создания новых управляющих скриптов.

Существующий набор скриптов позволяет демонстрировать электронные документы с помощью OpenOffice.org, видео, аудио и статические изображения, используюя программы display из ImageMagick, mplayer, mencoder и ElphelOgm. Изображения и видео можно масштабировать, зеркально отражать, и вращать. Для звуковых и видео файлов и потоков работают функции приостановки, продолжения, пошагового просмотра, позицирования, записи в виде набора файлов, а также другие описанные ниже.

Конфигурирование

Конфигурационные файлы "~/.mozilla/genres/genres.conf" или "/etc/genres.conf" содержат основные настройки. Дополнительные настройки для для программ mplayer, mencoder и ElphelOgm содержатся в файле "~/.mozilla/genres/mplayer.conf", который используется управляющим скриптом mplayer.pl. Файлы могут содержать комментарии начинающиеся с # как в shell.

Настройки в genres.conf

mozillastreams={1|0} 

использовать или нет потоки (и кэш) браузера для протоколов, которые он поддерживает (http, https и ftp);

debuglevel={1|0} 

включить/выключить вывод отладочной информации;

background={-1|0|1} 

цвет объекта во аремя загрузки: 0 - чёрный, 1 - белый, -1 - по-умолчанию (серый).

Настройки в mplayer.conf

out_file_once=шаблон 

шаблон для имени фудио/видеофайла;

out_file_jpegs=шаблон 

то же для сохранения видео по кадрам в виде отдельных картинок (saveformat=jpeg);

out_file=шаблон 

шаблон для имени файла для тэгов с параметром save=auto;

out_file_jpegs_auto=шаблон 

шаблон для комбинации saveformat=jpeg save=auto;

vo={x11, xv} 

видео-драйверы (см. man mplayer о параметре -vo);

ao={arts, esd, alsa, oss} 

аудио-драйверы (см. man mplayer о параметре -ao);

not_ask={1|0} 

больше не спрашивать имя файла для сохранения для тэгов с параметром save=auto;

not_ask_jpegs={1|0} 

то же для save=auto и saveformat=jpeg;

frames=число 

максимальное количество кадров в одном файле при записи для разбития на несколько файлов.

Cтатические параметры тегов

lowres 

параметр прореживания для ускоренного DCT [0-3], 0-полное разрешение, 3-1/8

width 

ширина окна

loop 

повтор проигрывания (0 или не указано - бесконечно)

fps 

частота кадров

frameskip 

пропуск n кадров из каждых n+1 (только для rtp/mjpeg через ElphelOgm)

framedelay 

количество полных кадров удерживаемых в буфере (только для rtp/mjpeg через ElphelOgm)

rotate 

угол поворота изображения по часовой стрелке в градусах (0|90|180|270)

mirror 

зеркальносимметричное отображение относительно вертикальной оси (true|false)

flip 

то же относительно горизонтали (true|false); установка flip и mirror одновременно эквивалентна rotate=180

saveformat=jpeg|ogm|avi 

формат для записи видео (jpeg, ogm - только для rtp/mjpeg через ElphelOgm)

Динамически изменяемые переменные (можно указывать и как параметры тегов)

href 

url файла или потока;

src 

пока просто другое имя для href;

pause=1 или play=0 

приостановить проигрывание;

pause=0 или play=1 

продолжить проигрывание;

filepos=sec 

переместиться на указанное время от начала в секундах или в процентах, может не работать, если mplayer по этому файлу не перемещается;

framestep=что-нибудь 

показать следующий кадр и остановиться (пошаговый просмотр);

run=1 

запустить плеер если он прекратил работу (по ошибке или концу файла);

run=0 

завершить плеер;

save 

запустить запись вместо показа;

save=ask 

всегда спрашивать имя файла для записи;

save=auto 

не спрашивать если пользователь укажет в диалоге.

Переменные статуса

Это то что выдаёт mplayer или mencoder, в настоящий момент стороки просто разделяются на две части по первому из символов '=' или ':'. То что слева - имя переменной (пробелы и нелатинские буквы удаляются), справа - значение.

frame 

сообщение плеера/рекордера о последнем кадре

error 

последнее сообщение об ошибке

информация о статических картинках (от display)

imgtype 

формат (JPEG, TIFF и т.д.)

imgsize 

размер картинки (например 800x600)

filelength 

длина файла (например 89kb)

Возможны другие но они пока не используются.

run 

особая переменная - состояние плеера 0 - незапущен, 1 - запущен, для режима записи становится в 0 когда пользователь отказался указать файл;

pause, play 

аналогично - состояние приостановки проигрывания, в том числе и по framestep.

Callback функции

По приходу данных от плеера они передаются в переменные объекта и становятся доступны из javascript. При этом если задана соответствующая функция с именем "on<имя переменной>", она будет вызвана.

onrun

вызывается по запуску и остановке видеоплеера или процесса записи

onerror

по приходу сообщения об ошибке

onframe

при очередном кадре

onmousedown и др стандартные callback функции

уже предоставлены браузером и не нуждаются в какой-то обработке внутри плагина

Back-end программы

В настоящий момент задействованы:

• mplayer (компилировать с live555);
• mencoder из пакета mplayer;
• ElphelOgm - для получения mjpeg видео по чистому multicast или unicast rtp;
• display из пакета ImageMagick - для показа статических картинок;
• ooffice (OpenOffice.org) для показа документов.

Чтобы задействовать ElphelOgm, должен быть установлен mime-type начинающийся с video/m и URL должен быть вида: rtp://ip:port/ , где:

ip -

multicast ip потока

port -

multicast port

Unicast тоже можно принимать, для этого указывается адрес и порт получателя, и сервер также должен быть сконфигурирован чтобы постоянно слать udp видеопоток на этот адрес и порт. Динамическое изменение URL не поддерживается для RTP. Вместо этого используйте последовательность команд: obj.run=0; obj.src=...; obj.run=1;

Диагностика ошибок установки

Запустите скрипт mplayer.pl из командной строки. Он находится в /usr/lib/genres. Если все необходимые perl модули установлены, он должен напечатать несколько строк вида: "переменная=значение" и ожидать ввода. Если вместо этого вы получите сообщение "Can't locate Gtk2.pm in @INC" значит необходимо установить этот модуль из вашего дистрибутива или с CPAN. Другие ссылки: проект gtk2-perl, gtk2-perl на CPAN, gtk2-perl на freshmeat.

Введите параметры как они представлены в HTML теге, но только по одному на строке и в конце добавьте run=1. Например:

type=video/mjpeg
url=rtp://232.168.0.9:20000/
run=1

Если MPlayer запустился, то эта часть работает, попробуйте посмотреть страницу примера входящую в состав пакета genres с помощью браузера mozilla или firefox. Если вместо окна с видео вы видите серый прямоугольник, значит возможно надо исправить URL на доступный.

Проверьте список установленных плагинов: about:plugins если GenReS отсутствует, возможно genres.so лежит не втом месте.

Плагин выдаёт много отладочной информации. Для её сбора запустите firefox из командной строки с перенаправлением вывода в файл. Mozilla надо запускать с ключом -debug:

mozilla -debug >& moz.log

Если причина не ясна, сожмите файл с помощью Gzip или bzip2 и отправьте мне на изучение.

--Sergey Khlutchin 15:49, 11 February 2006 (CST)

Создание управляющих скриптов

Для каждого тэга плагин запускает отдельный процесс-посредник. Обмен данными осуществляется через трубы (стандартные для юникса неименованные каналы). Для процесса-посредника каналы присоединены к стандартным вводу и выводу. Стандартный вывод ошибок совпадает со стандартным выводом. Файловый дескриптор №3 открыт для ввода (так же через трубу) данных из файла, на который указывает параметр тэга SRC. (Этот параметр распознаётся браузером.) Если он содержит URL с поддерживаемым протоколом и включен параметр mozillastreams, файл будет передаваться через эту трубу. Данные через стандартные ввод/вывод передаются в виде текстовых строк по одной команде в строке.