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

From ElphelWiki
Jump to: navigation, search
(Динамически изменяемые переменные (можно указывать и как параметры тегов))
(Динамически изменяемые переменные (можно указывать и как параметры тегов))
Line 37: Line 37:
 
;run=1 : запустить плеер если он прекратил работу (по ошибке или концу файла);
 
;run=1 : запустить плеер если он прекратил работу (по ошибке или концу файла);
 
;run=0 : завершить плеер;
 
;run=0 : завершить плеер;
;save : запустить записи вместо показа;
+
;save : запустить запись вместо показа;
 
:;save=ask : всегда спрашивать имя файла для записи;
 
:;save=ask : всегда спрашивать имя файла для записи;
 
:;save=auto : не спрашивать если пользователь укажет в диалоге.
 
:;save=auto : не спрашивать если пользователь укажет в диалоге.

Revision as of 05:13, 17 September 2006

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

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

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

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

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 - для показа статических картинок.

Чтобы задействовать 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;

Поддерживаемые MIME-типы и вызываемые программы
MIME-тип Протокол Приложение

application/x-display image/tiff image/x-tiff image/x-tif image/sun-raster image/x-sun-raster image/x-rgb image/x-portable-pixmap image/x-portable-graymap image/x-portable-bitmap image/x-portable-anymap application/photoshop application/x-photoshop image/x-xcf image/xcf application/x-gimp application/gimp

http ftp file display

video/ogg video/x-ogg application/x-elphel-ogm video/x-theora video/theora video/mpeg video/mjpeg video/x-mpeg video/x-mpeg2 video/quicktime video/x-quicktime application/x-quicktimeplayer video/msvideo video/x-msvideo application/x-drm-v2 application/x-mplayer2 video/x-ms-asf video/x-ms-wm video/x-ms-wmv video/x-ms-wvx video/sgi-movie video/x-sgi-movie video/dl video/x-dl video/sgi-movie video/x-sgi-movie video/anim video/x-anim video/fli video/x-fli

audio/mp3 audio/x-mp3 audio/mpeg2 audio/x-mpeg2 audio/mpeg3 audio/x-mpeg3 audio/mpeg audio/x-mpeg application/ogg application/x-ogg audio/ogg audio/x-ogg audio/x-ms-wax audio/wav audio/x-wav audio/x-pn-wav audio/x-pn-windows-acm

http ftp file mplayer mencoder

application/x-elphel-ogm video/mjpeg

rtp mplayer ElphelOgm

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

Запустите скрипт 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)