Difference between revisions of "Video API Extensions.Ru"
From ElphelWiki
m |
|||
| (One intermediate revision by one other user not shown) | |||
| Line 1: | Line 1: | ||
| + | {{Manual legacy_pages}} | ||
| + | |||
{{ru|en=Video_API_Extensions|cn=Video_API_Extensions.cn}} | {{ru|en=Video_API_Extensions|cn=Video_API_Extensions.cn}} | ||
| Line 6: | Line 8: | ||
== Включение расширений == | == Включение расширений == | ||
По умолчанию расширения Video API заблокированы. Чтобы их разблокировать необходимо установить соответствующую переменную: | По умолчанию расширения Video API заблокированы. Чтобы их разблокировать необходимо установить соответствующую переменную: | ||
| − | <nowiki>http://192.168.0.9/axis-cgi/admin/param.cgi?action=update</nowiki> | + | <nowiki>http://192.168.0.9/axis-cgi/admin/param.cgi?action=update&ElphelExtensions.Enabled=yes</nowiki> |
| + | |||
| + | |||
| + | == Получение статических и динамических изображений == | ||
| + | Стандартный интерфейс получения статических и динамических изображений в форматах JPEG и MJPG имеет ряд дополнительных параметров. | ||
| + | |||
| + | {| border="0" cellpadding="2" | ||
| + | |- | ||
| + | |e_dcm_hor ||-|| horisontal decimation (resolution/image size reduction) | ||
| + | |- | ||
| + | |e_dcm_vert ||-|| vertical decimation (resolution/image size reduction) | ||
| + | |- | ||
| + | |e_bin_hor ||-|| horizontal binning (sensitivity for lower resolution) | ||
| + | |- | ||
| + | |e_bin_vert ||-|| vertical binning (sensitivity for lower resolution) | ||
| + | |- | ||
| + | |e_woi_width ||-|| sensor active window width (before decimation) | ||
| + | |- | ||
| + | |e_woi_height ||-|| sensor active window height (before decimation) | ||
| + | |- | ||
| + | |e_woi_left ||-|| sensor active window left margin (before decimation) | ||
| + | |- | ||
| + | |e_woi_top ||-|| sensor active window top margin (before decimation) | ||
| + | |- | ||
| + | |e_virt_width ||-|| virtual frame width | ||
| + | |- | ||
| + | |e_virt_height ||-|| virtual frame height | ||
| + | |- | ||
| + | |e_fliph ||-|| flip (mirror) image horizontally (uses in-sensor capabilities) | ||
| + | |- | ||
| + | |e_flipv ||-|| flip (mirror) image vertically (uses in-sensor capabilities) | ||
| + | |- | ||
| + | |e_quality ||-|| JPEG Quality (%) | ||
| + | |- | ||
| + | |} | ||
| + | |||
| + | === Примеры === | ||
| + | Пример получения статического изображения с использованием данных параметров: | ||
| + | <nowiki>http://192.168.0.9/axis-cgi/jpg/image.cgi?e_dcm_hor=2&e_dcm_vert=2&e_woi_width=1000&e_woi_height=900&e_woi_left=600</nowiki> | ||
| + | |||
| + | Пример получения динамического изображения (MPJPG) с использованием данных параметров: | ||
| + | |||
| + | <nowiki>http://192.168.0.9/axis-cgi/mjpg/video.cgi?e_dcm_hor=2&e_dcm_vert=2&e_woi_width=1000&e_woi_height=900&e_woi_left=600</nowiki> | ||
| + | |||
| + | Этот видеопоток можно воспроизвести, например, программой mplayer (более подробно см. [[Using Mplayer With Video API.Ru]]) : | ||
| + | |||
| + | <nowiki>$mplayer -demuxer lavf "http://192.168.0.9/axis-cgi/mjpg/video.cgi?e_dcm_hor=2&e_dcm_vert=2&e_woi_width=1000&e_woi_height=900&e_woi_left=600&bogus.mjpg"</nowiki> | ||
| + | |||
| + | Если какой-то из параметров не указан, то используется значение по умолчанию. Узнать эти значения можно по адресу : | ||
| + | <nowiki>http://192.168.0.9/axis-cgi/admin/param.cgi?action=list&group=ImageSource.I0.Sensor</nowiki> | ||
| + | '''Примечание'''. Все расширения API имеют префикс "E_". | ||
| + | |||
| + | Изменить значение по умолчанию можно стандартным для Axis Video API способом. Например : | ||
| + | <nowiki>http://192.168.0.9/axis-cgi/admin/param.cgi?action=update&ImageSource.I0.Sensor.E_DcmHor=1</nowiki> | ||
| + | |||
| + | == Вывод информации о сотоянии системы и значениях по умолчанию == | ||
| + | Чтобы получить информацию о переменных состояния системы, нужно использовать путь: | ||
| + | <nowiki>http://192.168.0.9/axis-cgi/admin/param.cgi?action=list&group=ImageSource.I0.E_CurrentState</nowiki> | ||
| + | |||
| + | Кроме стандартного формата вывода "'''rfc'''" есть также вывод в виде XML. Для этого необходимо использовать параметр '''responseformat'''. Например : | ||
| + | <nowiki>http://192.168.0.9/axis-cgi/admin/param.cgi?action=list&group=ImageSource.I0.E_CurrentState&responseformat=xml</nowiki> | ||
| + | '''Примечание'''. Если responseformat не указан или указан неверно, то используется значение по умолчанию '''"rfc".''' | ||
| + | |||
| + | |||
| + | == Потоковое видео RTP/MJPG и RTP/Theora == | ||
| + | Камеры Elphel могут передавать потоковое видео по протоколу RTP. | ||
| + | === RTP/MJPG === | ||
| + | === RTP/Theora === | ||
| + | |||
| + | |||
| + | == Управление экспозицией == | ||
| + | Камеры Elphel поддерживают как стандартный так и расширенный интерфейс управления экспозицией. О стандартных настройках см. [[Video_API.Ru]] | ||
| + | |||
| + | Чтобы включить автоавтоэкспозицию необходимо дать следующую команду : | ||
| + | |||
| + | <nowiki>http://192.168.0.9/axis-cgi/admin/param.cgi?action=update&ImageSource.I0.Sensor.Exposure=auto</nowiki> | ||
| + | |||
| + | Включить ручное управление экспозицией : | ||
| + | <nowiki>http://192.168.0.9/axis-cgi/admin/param.cgi?action=update&ImageSource.I0.Sensor.Exposure=manual</nowiki> | ||
| + | |||
| + | Получить сведения о состоянии экспозиции можно так : | ||
| + | <nowiki>http://192.168.0.9/axis-cgi/admin/param.cgi?action=list&group=ImageSource.I0.E_CurrentState.E_Exposure</nowiki> | ||
| + | |||
| + | Установить параметры окна: | ||
| + | <nowiki>http://192.168.0.9/axis-cgi/admin/param.cgi?action=update&ImageSource.I0.Sensor.E_Exposure.E_WinWidth=30&ImageSource.I0.Sensor.E_Exposure.E_WinHeight=45&ImageSource.I0.Sensor.E_Exposure.E_WinLeft=10&ImageSource.I0.Sensor.E_Exposure.E_WinTop=20</nowiki> | ||
| + | |||
| + | Максимальные значения экспозиции : | ||
| + | <nowiki>http://192.168.0.9/axis-cgi/admin/param.cgi?action=update&ImageSource.I0.Sensor.E_Exposure.E_Max=3000&ImageSource.I0.Sensor.E_Exposure.E_OverMax=30</nowiki> | ||
Latest revision as of 09:43, 8 April 2009
This is a legacy page. The information bellow is not compatible with Elphel 393 or 353/363 series cameras.
in English | autotranslate | по-русски | 中文版
Данная реализация Video API имеет ряд возможностей, которые отсутствуют в стандартном Axis Video API.
Contents
Включение расширений
По умолчанию расширения Video API заблокированы. Чтобы их разблокировать необходимо установить соответствующую переменную:
http://192.168.0.9/axis-cgi/admin/param.cgi?action=update&ElphelExtensions.Enabled=yes
Получение статических и динамических изображений
Стандартный интерфейс получения статических и динамических изображений в форматах JPEG и MJPG имеет ряд дополнительных параметров.
| e_dcm_hor | - | horisontal decimation (resolution/image size reduction) |
| e_dcm_vert | - | vertical decimation (resolution/image size reduction) |
| e_bin_hor | - | horizontal binning (sensitivity for lower resolution) |
| e_bin_vert | - | vertical binning (sensitivity for lower resolution) |
| e_woi_width | - | sensor active window width (before decimation) |
| e_woi_height | - | sensor active window height (before decimation) |
| e_woi_left | - | sensor active window left margin (before decimation) |
| e_woi_top | - | sensor active window top margin (before decimation) |
| e_virt_width | - | virtual frame width |
| e_virt_height | - | virtual frame height |
| e_fliph | - | flip (mirror) image horizontally (uses in-sensor capabilities) |
| e_flipv | - | flip (mirror) image vertically (uses in-sensor capabilities) |
| e_quality | - | JPEG Quality (%) |
Примеры
Пример получения статического изображения с использованием данных параметров:
http://192.168.0.9/axis-cgi/jpg/image.cgi?e_dcm_hor=2&e_dcm_vert=2&e_woi_width=1000&e_woi_height=900&e_woi_left=600
Пример получения динамического изображения (MPJPG) с использованием данных параметров:
http://192.168.0.9/axis-cgi/mjpg/video.cgi?e_dcm_hor=2&e_dcm_vert=2&e_woi_width=1000&e_woi_height=900&e_woi_left=600
Этот видеопоток можно воспроизвести, например, программой mplayer (более подробно см. Using Mplayer With Video API.Ru) :
$mplayer -demuxer lavf "http://192.168.0.9/axis-cgi/mjpg/video.cgi?e_dcm_hor=2&e_dcm_vert=2&e_woi_width=1000&e_woi_height=900&e_woi_left=600&bogus.mjpg"
Если какой-то из параметров не указан, то используется значение по умолчанию. Узнать эти значения можно по адресу :
http://192.168.0.9/axis-cgi/admin/param.cgi?action=list&group=ImageSource.I0.Sensor
Примечание. Все расширения API имеют префикс "E_".
Изменить значение по умолчанию можно стандартным для Axis Video API способом. Например :
http://192.168.0.9/axis-cgi/admin/param.cgi?action=update&ImageSource.I0.Sensor.E_DcmHor=1
Вывод информации о сотоянии системы и значениях по умолчанию
Чтобы получить информацию о переменных состояния системы, нужно использовать путь:
http://192.168.0.9/axis-cgi/admin/param.cgi?action=list&group=ImageSource.I0.E_CurrentState
Кроме стандартного формата вывода "rfc" есть также вывод в виде XML. Для этого необходимо использовать параметр responseformat. Например :
http://192.168.0.9/axis-cgi/admin/param.cgi?action=list&group=ImageSource.I0.E_CurrentState&responseformat=xml
Примечание. Если responseformat не указан или указан неверно, то используется значение по умолчанию "rfc".
Потоковое видео RTP/MJPG и RTP/Theora
Камеры Elphel могут передавать потоковое видео по протоколу RTP.
RTP/MJPG
RTP/Theora
Управление экспозицией
Камеры Elphel поддерживают как стандартный так и расширенный интерфейс управления экспозицией. О стандартных настройках см. Video_API.Ru
Чтобы включить автоавтоэкспозицию необходимо дать следующую команду :
http://192.168.0.9/axis-cgi/admin/param.cgi?action=update&ImageSource.I0.Sensor.Exposure=auto
Включить ручное управление экспозицией :
http://192.168.0.9/axis-cgi/admin/param.cgi?action=update&ImageSource.I0.Sensor.Exposure=manual
Получить сведения о состоянии экспозиции можно так :
http://192.168.0.9/axis-cgi/admin/param.cgi?action=list&group=ImageSource.I0.E_CurrentState.E_Exposure
Установить параметры окна:
http://192.168.0.9/axis-cgi/admin/param.cgi?action=update&ImageSource.I0.Sensor.E_Exposure.E_WinWidth=30&ImageSource.I0.Sensor.E_Exposure.E_WinHeight=45&ImageSource.I0.Sensor.E_Exposure.E_WinLeft=10&ImageSource.I0.Sensor.E_Exposure.E_WinTop=20
Максимальные значения экспозиции :
http://192.168.0.9/axis-cgi/admin/param.cgi?action=update&ImageSource.I0.Sensor.E_Exposure.E_Max=3000&ImageSource.I0.Sensor.E_Exposure.E_OverMax=30
